English Français العربية

io.github.mbilalawan926-sys/best-tempmail-mcp

Official registry Productivity

Disposable email inboxes for AI agents: create, wait for mail, extract verification codes

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package best-tempmail-mcp
Claude Code 
claude mcp add best-tempmail-mcp -e 'BTM_API_KEY=<your btm_api_key>' -- npx -y best-tempmail-mcp@1.0.2
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "best-tempmail-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "best-tempmail-mcp@1.0.2"
            ],
            "env": {
                "BTM_API_KEY": "<your btm_api_key>"
            }
        }
    }
}

Environment variables

  • BTM_API_KEY secret Optional paid plan key. Without it the free tier applies, which needs no key but cannot extract verification codes.

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. best-tempmail-mcp
  2. Install
  3. Tools
  4. Without an API key
  5. What it looks like in use
  6. Configuration
  7. Notes
  8. Links
  9. License

best-tempmail-mcp

MCP server for Best Temp Mail. Gives an AI assistant its own disposable email inboxes, so it can sign up for things, wait for the mail, and read the verification code back to you.

"Create a temp email, sign me up for that newsletter, and tell me the confirmation code."

Install

Add this to your MCP host's configuration. No installation step: npx fetches it on first run.

Claude Desktop (claude\_desktop\_config.json):

{
  "mcpServers": {
    "best-tempmail": {
      "command": "npx",
      "args": \["-y", "best-tempmail-mcp"]
    }
  }
}

With an API key, for higher limits and verification code extraction:

{
  "mcpServers": {
    "best-tempmail": {
      "command": "npx",
      "args": \["-y", "best-tempmail-mcp"],
      "env": { "BTM\_API\_KEY": "btm\_sk\_live\_..." }
    }
  }
}

The same shape works in Cursor, VS Code, Claude Code, and other MCP hosts.

Restart the host after editing the config.

Tools

|Tool|What it does| |-|-| |create\_inbox|Create a disposable address| |wait\_for\_email|Wait up to 55s for mail to arrive| |get\_verification\_code|Pull the OTP out of a message (paid key)| |list\_messages|See what has already arrived| |read\_message|Read the full body and attachment list| |list\_domains|Available domains| |delete\_inbox|Delete an inbox and its contents|

Without an API key

Everything works except get\_verification\_code, on the free tier: 150 requests per hour and 3 inboxes per day. That is enough to try it properly.

A paid key raises the limit to 2,000 requests per hour, unlocks code extraction, and allows commercial use. See pricing.

What it looks like in use

\\*You:\\* Make me a temp email and sign up for the newsletter at example.com

The assistant calls create\_inbox, gets abc1234@dextde.site, fills in the form, then calls wait\_for\_email.

\\*Assistant:\\* Signed up with abc1234@dextde.site. The confirmation email arrived; your code is 889231.

Configuration

|Variable|Purpose| |-|-| |BTM\_API\_KEY|Optional. Paid plan key.| |BTM\_BASE\_URL|Optional. Override the API base, for testing.|

Notes

Inboxes expire on their own: 2 hours on the free and Developer plans, 24 hours on Pro. They are receive-only, so nothing can be sent from them.

If a verification code cannot be identified with confidence, the tool says so rather than guessing. A wrong code is worse than none, and the assistant can fall back to read\_message to look at the body itself.

License

MIT

Frequently asked questions

What is io.github.mbilalawan926-sys/best-tempmail-mcp?

Disposable email inboxes for AI agents: create, wait for mail, extract verification codes

How do I install io.github.mbilalawan926-sys/best-tempmail-mcp?

It runs on your machine. In Claude Code: claude mcp add best-tempmail-mcp -e 'BTM_API_KEY=<your btm_api_key>' -- npx -y best-tempmail-mcp@1.0.2. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.mbilalawan926-sys/best-tempmail-mcp need an API key?

Yes. It expects BTM_API_KEY, which you set in its configuration.

Is io.github.mbilalawan926-sys/best-tempmail-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.mbilalawan926-sys/best-tempmail-mcp?

It is published by mbilalawan926-sys. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.