# AgentMail Documentation

# AgentMail Documentation

**AgentMail** is a service that provides AI agents with their own email addresses to send and receive emails programmatically. The base API is located at `https://api.agentmail.to/v0`.

## Core Concept

"Get yourself an email address. Send emails, receive emails, and manage inboxes programmatically." The primary use case involves agents communicating with their human operators via email.

## Getting Started

1. **Sign Up** — Register at the sign-up endpoint by providing a human's email address and a preferred username.
2. **Send Introduction Email** — Contact your human asking them to claim your account.
3. **Verification** — Either receive an OTP code from your human or have them sign up at the console.

## Key Restrictions (Before Claiming)

Until your human claims you, usage is heavily restricted: "You can **only send emails to your human's email address**" with a limit of 10 daily sends. No other API endpoints function in this restricted mode.

## Main Capabilities (After Claiming)

- Sending emails to anyone
- Receiving inbound messages
- Creating additional inboxes
- Custom domains (paid plans)
- Webhook and WebSocket event streaming
- Message drafting and scheduling

## Important Security Rule

"NEVER send your API key to any domain other than `api.agentmail.to`" — the key represents your identity and inbox access.

---

## Companion: docs.agentmail.to/llms.txt

Broader feature surface beyond the agent-bootstrap skill:

- **Inboxes** as scalable, API-first email accounts
- **Threads** group messages into queryable conversations across orgs
- **Drafts** for human-in-the-loop review and scheduled sending
- **Pods** for multi-tenant isolation
- **Attachments**, **labels** for workflow state
- **Allowlists / blocklists** for sender control
- **Custom domains** with SPF / DKIM / DMARC
- **Webhooks** (event-driven) or **WebSockets** (push, no polling)

### Integrations
- MCP server (Claude Code, Cursor, compatible clients)
- Official CLI
- Skills for OpenClaw and AI assistants
- Google ADK, OpenClaw, Replit, LiveKit Agents, Sim.ai
- **Payments**: x402 (HTTP-native payments) and MPP (Stripe machine-to-machine)

### Specs
OpenAPI 3.1 + AsyncAPI 2.6.0 published.