# Mailsnail

> Mailsnail is a paid MCP server for communication. Send real USPS letters and certified mail from an AI agent, priced per piece. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, CLI, self-hosted
- **Website:** https://mailsnail.dev
- **Repository:** https://github.com/iancollins27/mailsnail
- **MCP Registry name:** io.github.iancollins27/mailsnail
- **Categories:** communication
- **Listing updated:** 2026-11-15

## About

The unusual part is that a tool call ends with paper in a mailbox. Mailsnail renders or accepts a PDF, prints, folds, stamps and hands the letter to USPS. A preview step returns a proof PDF and exact price without charging, and the recommended flow is preview, show the user, then send with the returned draft_id. Address verification is free, as are balance checks and delivery-status lookups.

Prices are stated at cost with no subscription: a first-class letter is $1.51 by single card payment or $1.21 from a prepaid balance, and certified is $8.83 or $8.61, rising with a return receipt. When a balance cannot cover a send, the agent receives two Stripe links, one for just that letter and one to add funds, and a card is not saved unless you opt in to auto-reload. Cancelling before printing, usually within about a day, returns the full price to the balance.

The hosted server needs only a sign-in. You can also self-host the open-source gateway against your own Click2Mail or Lob account, where dry-run is the default and a per-session spend cap of $25 applies.

## Features

- **Preview before sending:** Proof PDF and exact price with no charge.
- **Certified mail:** Tracking, with optional electronic or physical return receipt.
- **Free address validation:** USPS validation before paying for returned mail.
- **Delivery tracking:** Status from queued to delivered, with the tracking number for certified.
- **Cancel before printing:** Full refund to balance if cancelled in time.
- **Self-host option:** Run with your own Click2Mail or Lob account.

## Good for

- Mail a thank-you note after a support interaction
- Send a certified legal or lien notice
- Post a birthday or condolence card
- Check whether a letter has been delivered
- Validate an address before mailing

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mailsnail https://api.mailsnail.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://api.mailsnail.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mailsnail": {
      "url": "https://api.mailsnail.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mailsnail": {
      "type": "http",
      "url": "https://api.mailsnail.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mailsnail": {
      "serverUrl": "https://api.mailsnail.dev/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mailsnail": {
      "type": "http",
      "url": "https://api.mailsnail.dev/mcp"
    }
  }
}
```

## Tools

- `doctor`: Diagnoses the server setup.
- `verify_address`: USPS address validation.
- `preview_letter`: Returns a proof PDF and exact price without charging.
- `send_letter`: Mails a physical letter, optionally certified.
- `send_postcard`: Sends a postcard.
- `get_balance`: Shows balance and auto-reload settings.
- `top_up`: Adds funds to the balance.
- `get_letter`: Looks up the status of a letter.
- `get_postcard`: Looks up the status of a postcard.
- `list_letters`: Lists letters in self-hosted modes.
- `cancel_letter`: Cancels a letter before printing starts.

## FAQ

### What does a letter cost?

From a prepaid balance: $1.21 first-class and $8.61 certified. By single card payment it is $1.51 and $8.83.

### Is there a subscription?

No, it is pay per piece at cost.

### Can I self-host?

Yes, against Click2Mail or Lob, where you pay your provider directly.

### Is my card stored?

Not unless you opt in to auto-reload.

### Is Mailsnail free?

No. Mailsnail is a paid product.

### How do I add Mailsnail to Claude Code?

Run this command in your terminal: claude mcp add --transport http mailsnail https://api.mailsnail.dev/mcp

### What are the best alternatives to Mailsnail?

The closest alternatives to Mailsnail are BoardAgent, Callout, nicemails, SOMMON Office and PostBaton.

## Alternatives

- [BoardAgent](https://ai-powered.com/mcp/boardagent): BoardAgent is a free MCP server for community directories.
- [Callout](https://ai-powered.com/mcp/callout): Callout is a freemium MCP server for communication.
- [nicemails](https://ai-powered.com/mcp/nicemails): nicemails is a freemium MCP server for communication.
- [SOMMON Office](https://ai-powered.com/mcp/sommon-office): SOMMON Office is a paid MCP server for communication.
- [PostBaton](https://ai-powered.com/mcp/postbaton): PostBaton is a freemium MCP server for marketing and seo.
- [MeetBetr](https://ai-powered.com/mcp/meetbetr): MeetBetr is a free MCP server for productivity.
- [Host Tools](https://ai-powered.com/mcp/host-tools): Host Tools is an MCP server for home services.
- [iMessage MCP](https://ai-powered.com/mcp/imessage-mcp): iMessage MCP is an open-source MCP server for communication.

---
Source: https://ai-powered.com/mcp/mailsnail
