MCP Server for Direct Mail

Agent Mail is the Model Context Protocol server that lets any MCP-aware agent send physical letters and postcards. Connection details, tool list, and pricing.

mcpdirect-mailreference

· Updated

What is this

Agent Mail is an MCP server. It exposes a small, well-typed set of tools for sending physical mail and gets out of the way. Any client that speaks Model Context Protocol — Claude Desktop, Claude Code, Cursor, Codex CLI, the OpenAI Agents SDK, custom hosts — can use it.

Tools

  • send_letter: compose and mail a physical letter to any US address.
  • send_postcard: send a postcard with a custom front image.
  • get_mail_status: check delivery state by ID.
  • list_sent_mail: paginate through everything the agent has sent.

Full schemas live in /llms-full.txt and /openapi.json.

Connection

Transport: streamable HTTP. The endpoint is published in the setup page, which has copy-paste config for every major client.

Pricing

Free sandbox for testing — letters render to PDF previews but aren't actually mailed. Production is pay-per-piece, no subscription. Bulk discounts apply automatically over volume thresholds.

If you're evaluating direct-mail-from-agents and want a real conversation, email hello@agentmail.dev.

Wire Mailsnail into your agent

Drop this into your client's MCP config (or use /setup for one-line installs).

mcp.json
{
  "mcpServers": {
    "mailsnail": {
      "command": "npx",
      "args": [
        "-y",
        "physical-mail-mcp"
      ],
      "env": {
        "MAIL_PROVIDER": "managed",
        "MAIL_API_BASE_URL": "https://api.mailsnail.dev"
      }
    }
  }
}

See also

Send Physical Mail from Claude Code

Wire Agent Mail into Claude Code with one command and your terminal-resident agent can drop letters in the mail. End-to-end setup, tool reference, and a worked example.

Lob Alternative for AI Agents

Lob is great for batch-mode direct mail. Agent Mail is built for the opposite shape: one piece at a time, decided and sent autonomously by an AI agent. Here's how they compare.

Send Letters from Cursor

Cursor's MCP support means your IDE-resident agent can take real-world actions. Here's how to wire Agent Mail in so Cursor can put a letter in the mail.

← All recipes