api.email — disposable inboxes for automated tests and coding agents.
Base URL: https://api.email

Get a key: POST /v1/signup (no auth) -> { api_key, namespace, example_address }
Auth: Authorization: Bearer ae_... on every other endpoint.
MCP: claude mcp add --transport http api-email https://api.email/mcp

REST endpoints (under /v1; bearer auth required unless noted "no auth"):
POST   /v1/signup  (no auth)
GET    /v1/messages
GET    /v1/messages/{id}
DELETE /v1/messages/{id}
GET    /v1/messages/{id}/attachments/{n}
GET    /v1/wait
GET    /v1/namespaces
POST   /v1/namespaces
GET    /v1/keys
POST   /v1/keys
DELETE /v1/keys/{id}
GET    /v1/usage
POST   /v1/billing/checkout
POST   /v1/billing/portal
POST   /v1/stripe/webhook  (no auth)

MCP tools (POST https://api.email/mcp, Streamable HTTP):
signup            Create a free api.email account: a namespace plus an api_key. (no auth)
create_inbox      Generate a fresh unique address in your namespace. Any tag works without registration.
get_usage         Current month email count and the plan limits for the authenticated account.
list_messages     List received emails, newest first. Filter by tag, tag_prefix, namespace, since.
get_message       Fetch one email by id (from list_messages/wait_for_message), including extracted OTP codes and links.
wait_for_message  Long-poll for the next email matching the filter (up to 55s). since defaults to now.

Docs: https://api.email/docs
OpenAPI: https://api.email/openapi.json
Full reference (signatures, examples, error codes with hints): https://api.email/llms-full.txt