# MailAgents

MailAgents is an email inbox, sending, search, task triage, and E2EE workflow service for AI agents.

Primary agent entry points:
- Agent guide: https://mailagents.net/agent-guide
- MCP discovery: https://mailagents.net/api/mcp
- MCP endpoint: https://mailagents.net/mcp
- OpenAPI schema: https://mailagents.net/api/agent/v1/openapi.json
- Full agent notes: https://mailagents.net/llms-full.txt
- Agent manifest: https://mailagents.net/.well-known/mailagents-agent.json

Authentication:
- Preferred for agents: mailbox token in the X-Agent-Token header.
- OAuth is available for MCP clients that support protected-resource metadata.
- Use the smallest mailbox-token scope that fits the task: send, read, or read+send.

Agent quickstart:
1. Create a mailbox token in the MailAgents UI with send or read+send scope.
2. Discover MCP: GET https://mailagents.net/api/mcp
3. Confirm identity: POST https://mailagents.net/mcp with X-Agent-Token and tools/call whoami.
4. Send mail: tools/call send_email with to, subject, text or html, and idempotencyKey.
5. Verify delivery: tools/call list_emails with direction=sent; check status, createdAt, errorMessage, and delivery metadata.
6. For encrypted mail: follow decryptAction, requiredHeaders, canDecryptLocally, and oldMessageRecoverable from get_email.