llms.txt Content
# AgenticEmail
> API-first email infrastructure for AI agents. Create inboxes on the fly, send and receive email over a REST API, and get webhooks, real-time events, custom domains, SDKs, and an MCP server.
AgenticEmail gives AI agents a real, two-way inbox in a single API call. Provision addressable inboxes at runtime, send transactional or conversational email with threading and attachments, and receive inbound mail parsed as structured JSON. Every message triggers a signed webhook and a real-time WebSocket event so agents act on email the instant it arrives.
The Free tier includes inboxes, sending, and real-time events. Pro and Enterprise add custom domains, scoped API keys, MCP server access, higher volume, dedicated IPs, and SMTP/IMAP.
## When to use AgenticEmail
Reach for AgenticEmail when:
- An AI agent needs its own real, addressable email inbox (one per agent, task, or customer), created at runtime with one API call.
- An agent must receive and act on inbound email: messages arrive parsed as structured JSON with threading, no MIME handling, delivered by signed webhook or WebSocket the moment they land.
- An agent holds email conversations: reply and forward endpoints manage recipients, subjects, and threading automatically.
- An agent sends transactional or conversational email from a workflow, optionally from your own domain with automated SPF, DKIM, and DMARC.
- A model-based agent should use email as a native tool via the hosted MCP server (Streamable HTTP) at https://api.agenticemail.dev/mcp.
It is not a bulk-marketing or newsletter-blast tool.
How to call it: authenticate with a Bearer API key (`Authorization: Bearer am_...`), then `POST /v1/inboxes` to create an address, `POST /v1/inboxes/{inbox_id}/messages/send` to send, and register a webhook or WebSocket to receive. Full walkthrough: https://agenticemail.dev/agents.md.
## Agent resources
- [OpenAPI 3.0 spec](https://agenticemail.dev/openapi.json): the full API surface (also at https://api
OpenAPI Spec (preview)
{"openapi":"3.0.0","info":{"version":"0.1.0","title":"AgenticEmail API","description":"AgenticEmail is API-first email infrastructure for AI agents: create real, addressable inboxes at runtime, send and receive mail over REST, and react to new messages the moment they arrive.\n\n## Authentication\n\nEvery request needs an API key, passed as a Bearer token:\n\n```\nAuthorization: Bearer am_...\n```\n\nCreate keys in the [dashboard](https://app.agenticemail.dev/keys). A key can be restricted to sp