Skip to main content
EmailAgent hosts a streamable HTTP MCP endpoint.

​
Endpoint

  • https://app.emailagent.dev/mcp
Methods used by MCP clients:
  • POST /mcp
  • GET /mcp
  • DELETE /mcp
Important: use app.emailagent.dev for MCP. docs.emailagent.dev is documentation-only and will not serve MCP sessions.

​
Auth

All requests must include: 
Authorization: Bearer <emailagent_api_key>
Session-bound requests must keep the same token per mcp-session-id.

​
Security notes

  • v1 auth is API key only.
  • OAuth is deferred to a later version.
  • Configure origin/host guardrails in app env:
    • MCP_ALLOWED_ORIGINS
    • MCP_ALLOWED_HOSTS

​
Troubleshooting

  • 401 missing/invalid bearer token.
  • 403 session token mismatch.
  • 404 invalid mcp-session-id.
  • 500 upstream or transport failure.