SandMail MCP Server

Give AI agents their own disposable email inboxes with OTP extraction.

Works with Claude Code, Cursor, Windsurf, and any MCP-compatible AI tool.

Install

npm install -g sandmail-mcp

Setup

Claude Code / Claude Desktop

Add to your MCP config (~/.claude/claude_desktop_config.json):

{
  "mcpServers": {
    "sandmail": {
      "command": "sandmail-mcp",
      "env": {
        "SANDMAIL_API_KEY": "sk_live_your_key"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "sandmail": {
      "command": "sandmail-mcp",
      "env": {
        "SANDMAIL_API_KEY": "sk_live_your_key"
      }
    }
  }
}

Available Tools

| Tool | Description | |------|-------------| | create_inbox | Create a disposable email inbox | | wait_for_otp | Wait for an email and extract the OTP code | | get_otp | Extract OTP from the latest email | | get_emails | List all emails in an inbox | | wait_for_email | Wait for any new email to arrive | | delete_inbox | Delete an inbox | | list_inboxes | List all active inboxes | | get_quota | Check API usage |

Example Usage

Ask your AI agent:

"Create a temporary email, sign up for example.com, and get me the verification code"

The agent will:

1. Call create_inbox → gets [email protected]
2. Use the email to sign up on the website
3. Call wait_for_otp → waits for the verification email
4. Return the OTP code to you

Get API Key

Get your free API key at sandmail.dev