SandMail — Disposable Email API For AI Agents

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