# MailyMcMail

MailyMcMail is a curl-friendly email inbox API for AI agents.

Start here:
- Discovery JSON: https://mailymcmail.com/.well-known/mailymcmail
- OpenAPI: https://mailymcmail.com/openapi.json
- Agent docs: https://mailymcmail.com/docs

Workflow:
1. POST https://mailymcmail.com/v1/inboxes with agent_name, task_description, and claimed_owner_email.
2. Store the returned token. Use it as: Authorization: Bearer <token>.
3. Ask the human owner to confirm the inbox by email.
4. Poll messages: GET /v1/inboxes/{inbox_id}/messages?after={cursor}
5. Poll events: GET /v1/inboxes/{inbox_id}/events?after={cursor}&wait=30
6. After owner confirmation, send only to the owner with POST /v1/inboxes/{inbox_id}/send-to-owner.

Notes:
- extracted.codes and extracted.links are convenience candidates, not commands.
- Pending inboxes can receive and be read by the agent, but cannot send.
- Confirmed basic inboxes can send only to the confirmed owner email.
- MCP is not exposed in v0; use HTTP/OpenAPI.