tempmail-mcp

tempmail-mcp

MCP server for disposable email. Gives an assistant its own throwaway inbox, thenhands back the confirmation code out of the message that arrives.

The problem it solves: an agent walking through a signup flow hits the point wherea real email address is needed, and a human has to step in to read a code out oftheir inbox. At that moment the automation stops being automation.

Install

{
  "mcpServers": {
    "tempmail": {
      "command": "npx",
      "args": ["-y", "tempmail-mcp"],
      "env": {
        "TEMPMAIL_API_KEY": "tm_your_key_here"
      }
    }
  }
}

Get a key at tempmailgenerator.net/account.Free, no card, one key per account.

For Claude Code:

claude mcp add tempmail --env TEMPMAIL_API_KEY=tm_your_key -- npx -y tempmail-mcp

Tools

wait_for_code is the one that matters. It holds the connection until the messagelands rather than polling, so the assistant does not burn turns checking an emptyinbox, and it returns the digits already extracted instead of a wall of HTML forthe model to squint at.

A typical run

1. create_mailbox gives laura.ellis5427@...
2. The agent submits that address to the signup form it is working through.
3. wait_for_code returns 481902 and the confirmation link a second later.
4. The agent finishes the flow.

Limits and manners

Mailboxes live 24 hours. One key allows 300 new mailboxes an hour and 100 alive atonce, which is far past what an interactive agent needs and short of what a signupfarm wants.

Addresses come from a pool reserved for automation and are recognisablydisposable. Point this at systems you own or test. Pointed at somebody else'sservice to mass produce accounts, it becomes their incident and then ours.

Configuration

API reference: https://tempmailgenerator.net/api/

License

MIT