Mailsnail
Send real USPS letters and certified mail from an AI agent, priced per piece
- Pricing
- Paid
- Platforms
- API, CLI, self-hosted
- Runs
- Locally or Remotely
- Version
- 0.6.2
- Listing updated
- 2 days ago
About Mailsnail
Mailsnail is a paid MCP server for communication. It can run locally on your machine or as a hosted remote server.
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.
Install
Run in a terminal
claude mcp add --transport http mailsnail https://api.mailsnail.dev/mcpAdd to Settings → Connectors → Add custom connector
https://api.mailsnail.dev/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mailsnail": {
"url": "https://api.mailsnail.dev/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mailsnail": {
"type": "http",
"url": "https://api.mailsnail.dev/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mailsnail": {
"serverUrl": "https://api.mailsnail.dev/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mailsnail": {
"type": "http",
"url": "https://api.mailsnail.dev/mcp"
}
}
}Configuration
MAIL_PROVIDERFor self-hosting only; most people should add the hosted URL instead. 'click2mail' (your own account) or 'lob' (your own key). 'managed' needs a Stripe Shared Payment Token that most AI apps can't create.RequiredMAIL_API_BASE_URLHosted Mailsnail backend. Required when MAIL_PROVIDER=managed.CLICK2MAIL_USERNAMEClick2Mail account username. Required when MAIL_PROVIDER=click2mail.CLICK2MAIL_PASSWORDClick2Mail account password. Required when MAIL_PROVIDER=click2mail.LOB_API_KEYLob API key. Required when MAIL_PROVIDER=lob. test_* is free; live_* actually mails.MAIL_MCP_ALLOW_LIVESet to '1' to actually mail in BYOK modes. Default '0' is dry-run.MAIL_MCP_SPEND_CAP_USDPer-session estimated spend cap. Server refuses sends past this.
Tools this server provides (11)
Taken from the project documentation; the running server may differ.
- 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.
What it does
- 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
Pricing
Paid
Pay per piece: first-class from $1.21, certified from $8.61, no subscription
Prices change. Check mailsnail.dev before you buy.
Mailsnail 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 to Mailsnail

BoardAgent
MCP serverRemote MCP server for a message board where only AI agents post, reply and vote
- 27 tools
- Remote
- Free
- Community directories

Callout
MCP serverLet an AI agent place real phone calls in Japanese or English and read the transcript
- 5 tools
- Remote
- Freemium
- Communication

nicemails
MCP serverGive each AI agent its own real mailbox to read, search and send email with your approval
- 8 tools
- Remote
- Freemium
- Communication

SOMMON Office
MCP serverSend real paper letters via Deutsche Post from an AI assistant, to 218 countries
Not checked yet- 14 tools
- Remote
- Paid
- Communication

PostBaton
MCP serverSchedule, edit and cancel social posts across networks from an AI assistant or REST API
Not checked yet- Remote
- Freemium
- Marketing and SEO

MeetBetr
MCP serverFind when friends are free and send them a plan after you confirm it
- Remote
- Free
- Productivity