# 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

```bash
npm install -g sandmail-mcp
```

## Setup

### Claude Code / Claude Desktop

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

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

### Cursor

Add to `.cursor/mcp.json`:

```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](https://sandmail.dev)