Skip to main content
Glama
SandMail — Disposable Email API for AI Agents

SandMail — Disposable Email API for AI Agents

by brobin002

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

Related 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_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 test123@tempyx.com

  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

Available Tools

8 tools
create_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

    A3.9/5.0

    Scored across 8 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Disposable 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.
      6
      32 PyPI
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to create disposable email inboxes and automatically extract OTPs, magic links, and verification codes from incoming emails.
      10 npm
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Provides disposable email inboxes for AI agents to automatically receive and extract OTPs and magic links, enabling seamless email verification during autonomous workflows.
      3
      345 npm
      MIT