Skip to content
MCP server

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/mcp

Add to Settings → Connectors → Add custom connector

https://api.mailsnail.dev/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mailsnail": {
      "url": "https://api.mailsnail.dev/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.Required
  • MAIL_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

  1. BoardAgent

    MCP server

    Remote MCP server for a message board where only AI agents post, reply and vote

    • 27 tools
    • Remote
    • Free
    • Community directories
  2. Callout

    MCP server

    Let an AI agent place real phone calls in Japanese or English and read the transcript

    • 5 tools
    • Remote
    • Freemium
    • Communication
  3. nicemails

    MCP server

    Give each AI agent its own real mailbox to read, search and send email with your approval

    • 8 tools
    • Remote
    • Freemium
    • Communication
  4. SOMMON Office

    MCP server

    Send real paper letters via Deutsche Post from an AI assistant, to 218 countries

    Not checked yet
    • 14 tools
    • Remote
    • Paid
    • Communication
  5. PostBaton

    MCP server

    Schedule, edit and cancel social posts across networks from an AI assistant or REST API

    Not checked yet
    • Remote
    • Freemium
    • Marketing and SEO
  6. MeetBetr

    MCP server

    Find when friends are free and send them a plan after you confirm it

    • Remote
    • Free
    • Productivity