Skip to main content

Documentation Index

Fetch the complete documentation index at: https://drin.mintlify.app/llms.txt

Use this file to discover all available pages before exploring further.

The Drin MCP server (@drin/mcp) exposes the whole API as 54 tools over the Model Context Protocol. Any MCP client — Claude Desktop, Claude Code, Cursor, or your own agent — can send and receive email, manage domains and inboxes, and read metrics with a single API key.

Run it

The server speaks MCP over stdio. It needs one environment variable, DRIN_API_KEY:
DRIN_API_KEY=drin_xxx npx -y @drin/mcp
VariableRequiredPurpose
DRIN_API_KEYYesYour API key (Bearer credential).
DRIN_SENDERAccount-wide keysDefault project external id (the X-Drin-Product value).
DRIN_BASE_URLNoOverride the API origin. Defaults to https://api.drin.run.
Already using the CLI? It bundles the same server — npx @drin/cli mcp is equivalent to running @drin/mcp directly.

Add it to a client

{
  "mcpServers": {
    "drin": {
      "command": "npx",
      "args": ["-y", "@drin/mcp"],
      "env": { "DRIN_API_KEY": "drin_xxx" }
    }
  }
}
Restart the client and your agent can call tools like send_email, list_threads, and reply_email.

What the agent can do

The 54 tools cover every surface of the API:
GroupToolsExamples
Sending3send_email, send_batch, reply_email
Reading messages4list_emails, get_email, get_email_body, list_email_attachments
Domains7add_domain, verify_domain, set_domain_receiving, delete_domain
Inboxes & threads7create_inbox, list_threads, get_thread, simulate_inbound
Contacts7create_contact, unsubscribe_contact, resubscribe_contact
Templates8create_template, render_template, list_template_gallery
Suppressions3list_suppressions, add_suppression, remove_suppression
Webhooks5create_webhook, update_webhook, delete_webhook
API keys3list_api_keys, create_api_key, revoke_api_key
Metrics & account2get_metrics, list_account_messages
Integrations5install_integration, list_integrations, uninstall_integration
The MCP server acts with the full authority of the API key you give it. Scope the key to a single project where you can, and prefer a key with only the access the agent actually needs.

Prefer a CLI?

Every tool is also a command — npx @drin/cli send … --json.