# CarlyEmail documentation > Real email inboxes for AI agents. Create an inbox with one API call, then > send, receive, thread and reply over REST or MCP. ## For agents reading this - Append `.md` to any documentation URL for the clean Markdown source. - The OpenAPI spec is at https://docs.carlyemail.com/openapi.json and describes every endpoint. - The MCP server is at https://api.carlyemail.com/mcp — 28 tools, OAuth with dynamic client registration, or an API key as a bearer token. - Start an account with one unauthenticated call: `POST https://api.carlyemail.com/v0/agent/sign-up` with `{"human_email": "...", "username": "..."}`. ## Documentation - [Give your agent an email address](https://docs.carlyemail.com/index.md): A real inbox your agent owns. It receives mail, you get a signed event, it replies in the thread. - [Quickstart](https://docs.carlyemail.com/quickstart.md): A working inbox and a sent email, in two calls. - [Examples](https://docs.carlyemail.com/examples.md): Agents with a real email address, each one run for real, with the mail they sent in the README. - [Authentication](https://docs.carlyemail.com/authentication.md): API keys, scopes and permissions. - [Inboxes](https://docs.carlyemail.com/concepts/inboxes.md): A real address on a real domain. - [Messages](https://docs.carlyemail.com/concepts/messages.md): Sent and received mail. - [Threads](https://docs.carlyemail.com/concepts/threads.md): Conversations, assembled automatically. - [Drafts](https://docs.carlyemail.com/concepts/drafts.md): Compose now, send later. - [Attachments](https://docs.carlyemail.com/concepts/attachments.md): Files on messages and drafts. - [Labels](https://docs.carlyemail.com/concepts/labels.md): How mail is classified and filtered. - [Pods](https://docs.carlyemail.com/concepts/pods.md): Multi-tenancy, when your customers each need their own mail. - [Sending](https://docs.carlyemail.com/guides/sending.md): Getting mail out, and what can stop it. - [Receiving](https://docs.carlyemail.com/guides/receiving.md): What happens between the sender pressing send and your API call. - [Your own domain](https://docs.carlyemail.com/guides/custom-domains.md): Send and receive on a domain you own, so mail comes from your brand rather than ours. - [Deliverability](https://docs.carlyemail.com/guides/deliverability.md): Staying out of the spam folder. - [Allow and block lists](https://docs.carlyemail.com/guides/lists.md): Who you will accept mail from, and who you will write to. - [Events](https://docs.carlyemail.com/guides/events.md): The record of everything that happened. - [Webhooks](https://docs.carlyemail.com/guides/webhooks.md): Events pushed to your endpoint, and how to verify them. - [WebSockets](https://docs.carlyemail.com/guides/websockets.md): Subscribe to mail and delivery events over one authenticated real-time connection. - [Make your agent reply to email](https://docs.carlyemail.com/integrations/agent-email.md): Give the agent an inbox, give it email tools, and wake it when mail arrives. - [Agent frameworks](https://docs.carlyemail.com/integrations/frameworks.md): Keep your agent framework. Add a real inbox, live email tools, signed inbound events, and thread continuity. - [SDKs](https://docs.carlyemail.com/integrations/sdks.md): Typed clients for TypeScript and Python. - [Toolkits](https://docs.carlyemail.com/integrations/toolkit.md): CarlyEmail's tools as native function tools for the OpenAI Agents SDK, LangChain, LiveKit Agents and the Vercel AI SDK. - [LangChain and LangGraph](https://docs.carlyemail.com/integrations/langchain.md): Load CarlyEmail's hosted MCP tools, invoke a LangGraph agent from verified mail, and preserve one graph thread per email thread. - [OpenAI Agents SDK](https://docs.carlyemail.com/integrations/openai-agents.md): Give an OpenAI Agents SDK agent email tools and invoke it from signed incoming-mail events. - [Vercel AI SDK](https://docs.carlyemail.com/integrations/vercel-ai-sdk.md): Attach CarlyEmail's MCP tools to a ToolLoopAgent and invoke it from a signed incoming-email route. - [Claude Agent SDK](https://docs.carlyemail.com/integrations/claude-agent-sdk.md): Connect CarlyEmail as a remote MCP server, allow its tools, and wake Claude from signed incoming-email events. - [Claude Managed Agents](https://docs.carlyemail.com/integrations/managed-agents.md): Email an address and a Claude session starts with a shell, a filesystem, and the web. The answer comes back as a reply. - [Mastra](https://docs.carlyemail.com/integrations/mastra.md): Turn a Mastra agent into an email agent with MCP tools, a signed webhook route, and one memory thread per email thread. - [Vercel eve](https://docs.carlyemail.com/integrations/eve.md): Give an eve agent a CarlyEmail MCP connection and a native, durable email channel. - [Cloudflare Agents](https://docs.carlyemail.com/integrations/cloudflare-agents.md): Route signed inbound mail to a durable Agent instance, keyed by inbox or thread. - [MCP](https://docs.carlyemail.com/guides/mcp.md): Drive your mail from Claude, ChatGPT or any MCP client. - [CLI](https://docs.carlyemail.com/integrations/cli.md): Every part of the API from a terminal, with no install. - [Errors](https://docs.carlyemail.com/reference/errors.md): One error shape, everywhere. - [Pagination](https://docs.carlyemail.com/reference/pagination.md): Cursors, not offsets. - [Idempotency](https://docs.carlyemail.com/reference/idempotency.md): Retrying a create without creating twice. - [Plans and limits](https://docs.carlyemail.com/reference/limits.md): What each tier allows, and where limits are enforced. - [FAQ](https://docs.carlyemail.com/faq.md): Short answers to the things that come up before and during a first integration. - [Support](https://docs.carlyemail.com/support.md): How to get help. - [Privacy policy](https://docs.carlyemail.com/legal/privacy.md): What CarlyEmail collects, how it is used, and how long it is kept. - [Terms of service](https://docs.carlyemail.com/legal/terms.md): The agreement for using CarlyEmail. - [API reference](https://docs.carlyemail.com/api-reference): Every endpoint, rendered from the OpenAPI spec. - [OpenAPI specification](https://docs.carlyemail.com/openapi.json): The machine-readable source of truth.