EmptyInbox

emptyinbox-mcp

MCP server for EmptyInbox — create disposable email inboxes and read messages from AI agents.

Listed in the official MCP Registry as io.github.cnohall/emptyinbox.

Setup

Claude Code:

claude mcp add emptyinbox -- npx -y emptyinbox-mcp@latest

Any other MCP client — add to its config:

{

"mcpServers": { "emptyinbox": { "command": "npx", "args": ["-y", "emptyinbox-mcp@latest"] } } }

No setup: the first tool call that needs an account registers one automatically and saves the key to ~/.emptyinbox.json for future sessions. Starting the server on its own (as MCP hosts do to list tools) creates nothing.

Bring your own account (optional — to reuse an existing key):

{

"mcpServers": { "emptyinbox": { "command": "npx", "args": ["-y", "emptyinbox-mcp@latest"], "env": { "EMPTYINBOX_API_KEY": "your_api_key_here" } } } }

Get an API key at https://emptyinbox.me/settings.html

Tools

Example agent workflow

1. create_inbox → "clever.sunny.butterfly@emptyinbox.me"

1. [agent signs up to some service using that address]
2. wait_for_message(inbox="clever.sunny.butterfly@emptyinbox.me", timeout_seconds=60)
3. → returns the verification email with code/link

Payment

Every account starts with free inboxes. When they run out, create_inbox returns the prices and the agent can close the purchase without leaving the session:

1. the agent shows its user the bundles and the user picks one
2. buy_quota returns a pay_url — a page with a QR code, the exact amount and live status — plus the raw address, amount and BIP21 URI
3. the user pays from any Bitcoin wallet (or an agent with its own wallet pays the BIP21 URI)
4. check_payment with wait_seconds confirms the credit, usually within seconds of broadcast

buy_quota takes either a bundle id from list_bundles or a custom whole-dollar usd amount from $1 to $100, for an agent spending down whatever a wallet holds. A custom amount is priced at the best bundle rate it qualifies for. The network fee the payer adds on top is the same whatever the size of the payment, so it eats a far larger share of a dollar-sized top-up.

Quota is granted as soon as the payment is seen on the network, so there is no waiting for confirmations. Humans can also buy at https://emptyinbox.me/inboxes.html