SandMail — Disposable Email API for AI Agents
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-mcpRelated MCP server: courier-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 a disposable email inbox |
| Wait for an email and extract the OTP code |
| Extract OTP from the latest email |
| List all emails in an inbox |
| Wait for any new email to arrive |
| Delete an inbox |
| List all active inboxes |
| 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.comUse the email to sign up on the website
Call
wait_for_otp→ waits for the verification emailReturn the OTP code to you
Get API Key
Get your free API key at sandmail.dev
Available Tools
8 toolscreate_inboxA
Create a temporary disposable email inbox. Returns an email address that can receive emails. Use this when you need to sign up for a service, verify an account, or receive a one-time code.
Inputs: domain, custom_local, ttl_hours.
delete_inboxB
Delete a temporary email inbox and all its emails.
Inputs: email (required).
get_emailsC
List all emails received in an inbox, sorted by date (newest first).
Inputs: email (required).
get_otpA
Extract OTP/verification code from the latest email in an inbox. Use this when an email has already arrived and you need to extract the code.
Inputs: email (required), include_body.
get_quotaB
Check your API usage and remaining monthly quota.
Inputs: no named parameters.
list_inboxesB
List all your active temporary email inboxes.
Inputs: no named parameters.
wait_for_emailA
Wait for a new email to arrive in an inbox. Blocks until an email arrives or timeout is reached.
Inputs: email (required), timeout.
wait_for_otpA
Wait for an email to arrive and automatically extract the OTP/verification code. Blocks until an email with a code arrives or timeout is reached. This is the most useful tool for account verification flows.
Inputs: email (required), timeout.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Every tool has a clearly distinct purpose with no overlap. For example, create_inbox and delete_inbox handle inbox lifecycle, get_emails and get_otp focus on email retrieval vs. code extraction, and wait_for_email vs. wait_for_otp differentiate between general waiting and OTP-specific waiting. The descriptions reinforce these distinctions.
All tools follow a consistent verb_noun naming pattern (e.g., create_inbox, delete_inbox, get_emails). There are no deviations in style or convention, making the set predictable and easy to understand at a glance.
With 8 tools, this server is well-scoped for its disposable email API purpose. Each tool earns its place by covering distinct aspects like inbox management, email retrieval, OTP handling, and quota checking, without being overly sparse or bloated.
The tool surface provides complete coverage for the disposable email domain. It includes CRUD operations for inboxes (create, list, delete), email retrieval (get_emails, wait_for_email), OTP-specific utilities (get_otp, wait_for_otp), and quota management (get_quota), with no obvious gaps for typical agent workflows.
Maintenance
Related MCP Connectors
Disposable email inboxes for AI agents: create an address, wait for mail, read OTP codes and links.
Disposable email inboxes for AI agents: create an address, wait for the OTP or verify link.
Real email inboxes for AI agents: create inboxes, catch verification codes, extract OTPs, reply.
Disposable email inboxes for AI agents — read messages and verification codes.
Related MCP Servers
- AlicenseBqualityDmaintenanceDisposable email MCP server for autonomous AI agents. Create labeled temporary inboxes, wait for verification emails, extract OTP codes and confirmation links — zero human intervention required.632 PyPIMIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to create disposable email inboxes and automatically extract OTPs, magic links, and verification codes from incoming emails.10 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to generate temporary email addresses, receive emails, and automatically extract OTP codes and links from incoming messages for automation and testing workflows.MIT
- AlicenseAqualityCmaintenanceProvides disposable email inboxes for AI agents to automatically receive and extract OTPs and magic links, enabling seamless email verification during autonomous workflows.3345 npmMIT