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:
- Call
create_inbox→ getstest123@tempyx.com - Use the email to sign up on the website
- Call
wait_for_otp→ waits for the verification email - Return the OTP code to you
Get API Key
Get your free API key at sandmail.dev