Skip to main content
EmailAgent exposes MCP in two modes:
  • stdio server (local process)
  • hosted streamable HTTP endpoint at https://app.emailagent.dev/mcp

​
Install (stdio)

npm install -g emailagent-mcp-server
EMAILAGENT_API_KEY=<api_key> emailagent-mcp

​
Hosted endpoint

  • URL: https://app.emailagent.dev/mcp
  • Auth: Authorization: Bearer <emailagent_api_key>
Important: use the app domain endpoint above. Do not use the docs domain for MCP calls.

​
Tool surface

NamespaceTools
Inboxesinboxes_list, inboxes_create, inboxes_update, inboxes_delete
Emailsemails_send, emails_list, emails_mark_read, emails_delete
Domainsdomains_list, domains_create, domains_verify, domains_delete
API Keysapi_keys_list, api_keys_create, api_keys_rotate, api_keys_revoke
Metricsmetrics_get
Each tool returns a normalized payload: 
{
  "ok": true,
  "data": {},
  "requestId": "req_..."
}
Errors return: 
{
  "ok": false,
  "error": {
    "type": "forbidden",
    "status": 403,
    "message": "...",
    "requestId": "req_...",
    "retriable": false
  }
}