tempmail-mcp
MCP server for disposable email. Gives an assistant its own throwaway inbox, then hands back the confirmation code out of the message that arrives.
The problem it solves: an agent walking through a signup flow hits the point where a real email address is needed, and a human has to step in to read a code out of their 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 message
lands rather than polling, so the assistant does not burn turns checking an empty
inbox, and it returns the digits already extracted instead of a wall of HTML for
the model to squint at.
A typical run
create_mailboxgiveslaura.ellis5427@...- The agent submits that address to the signup form it is working through.
wait_for_codereturns481902and the confirmation link a second later.- The agent finishes the flow.
Limits and manners
Mailboxes live 24 hours. One key allows 300 new mailboxes an hour and 100 alive at once, which is far past what an interactive agent needs and short of what a signup farm wants.
Addresses come from a pool reserved for automation and are recognisably disposable. Point this at systems you own or test. Pointed at somebody else's service to mass produce accounts, it becomes their incident and then ours.
Configuration
API reference: https://tempmailgenerator.net/api/
License
MIT
