MCP

A remote MCP server for AI agents: the same reads as the API, as tools — streamable HTTP, stateless, no key.

Every inbox at 1mail.dev is public. Anyone who knows the address can read it. Never use these addresses for anything sensitive — or any account you care about.

Remote MCP server — `https://api.1mail.dev/mcp`

list_messages (address, limit, since_id, older_than_id)
get_message (address, id)
get_raw_message (address, id)
generate_address — a fresh unguessable address; use it (every inbox above is public)
wait_for_message (address, from?, subject?, since_id?, timeout_ms?) — blocks up to 10 s for a matching message and returns it fully parsed, or message: null; call again to keep waiting

Tool calls count against the same read limits as the REST endpoints — see the published limits.

Add the server to your client:

Install

Claude Code

claude mcp add --transport http 1mail https://api.1mail.dev/mcp

Codex

Add to ~/.codex/config.toml:

[mcp_servers.1mail]
url = "https://api.1mail.dev/mcp"

pi

pi mcp add 1mail --url https://api.1mail.dev/mcp