MCP Overview - EmailAgent Docs

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

Namespace	Tools
Inboxes	`inboxes_list`, `inboxes_create`, `inboxes_update`, `inboxes_delete`
Emails	`emails_send`, `emails_list`, `emails_mark_read`, `emails_delete`
Domains	`domains_list`, `domains_create`, `domains_verify`, `domains_delete`
API Keys	`api_keys_list`, `api_keys_create`, `api_keys_rotate`, `api_keys_revoke`
Metrics	`metrics_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
  }
}