> ## Documentation Index
> Fetch the complete documentation index at: https://docs.emailagent.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Remote MCP

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:

```http theme={null}
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.