# e2a

> e2a is an authenticated email gateway for AI agents: it gives an agent its own
> verified email inbox to send, receive, reply, and forward, with SPF/DKIM
> verification. Connect
> over a hosted MCP server (OAuth, no API key), the REST API, or the SDKs.

## Start here

- [e2a.md](https://e2a.dev/e2a.md): What e2a is, how an agent connects (one MCP command), and what it can do. Read this first.

## Connecting & auth

- [auth.md](https://e2a.dev/auth.md): Authentication — OAuth 2.1 + Dynamic Client Registration (RFC 8414/7591, PKCE) so an agent can self-register with no human-supplied secret. Bearer API keys (account vs agent scope) also covered.

## API & SDKs

- [sdk.md](https://e2a.dev/sdk.md): TypeScript (`@e2a/sdk`) and Python (`e2a`) quick-start with code examples — send, receive (webhook → fetch → reply), and real-time streaming — plus a Raw-REST section (base URL, auth, conventions) for other languages.
- [openapi.yaml](https://e2a.dev/openapi.yaml): The full OpenAPI 3.1 contract — every endpoint, field, enum, and error, generated from the live handlers. Authoritative for exact signatures.
- [templates.md](https://e2a.dev/templates.md): Email templates (beta) — server-rendered reusable emails with `{{variable}}` interpolation, a prebuilt starter catalog (`from_starter`), validation, and send-by-alias. Includes a copy-paste setup prompt for coding agents.

## MCP & plugin

- [Agent plugin + skills](https://github.com/tokencanopy/e2a/tree/main/plugins/e2a): The `e2a` plugin bundles the hosted MCP server config and agent guidance for Claude Code, Codex, and Cursor.
- MCP endpoint: `https://api.e2a.dev/mcp` (Streamable HTTP, OAuth 2.1). Add with `claude mcp add --transport http --scope user e2a https://api.e2a.dev/mcp`, then run `/mcp` to authorize (`--scope user` installs it globally; drop it for current-directory only). Per-client config (Cursor, VS Code, Codex, …) is in [e2a.md](https://e2a.dev/e2a.md).

## Source

- [GitHub: tokencanopy/e2a](https://github.com/tokencanopy/e2a): Open-source core — Go backend, TS/Python SDKs, CLI, MCP server, Next.js dashboard.