Mailsnail

Name: Mailsnail
Author: iancollins27

by iancollins27version 0.6.0i★ –iRuns on your computer

Registry nameio.github.iancollins27/mailsnail

Install

Overview

Description from the maker (original English)

Send USPS letters, postcards & certified mail from any agent. No signup; pay-per-piece via Stripe.

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Online shops & payments
You need to fill in: MAIL_PROVIDER, CLICK2MAIL_PASSWORD, LOB_API_KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: MAIL_PROVIDER, MAIL_API_BASE_URL, CLICK2MAIL_USERNAME, CLICK2MAIL_PASSWORD, LOB_API_KEY, MAIL_MCP_ALLOW_LIVE, MAIL_MCP_SPEND_CAP_USD

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

npmNode.js installed (for the npx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

{
  "mcpServers": {
    "mailsnail": {
      "command": "npx",
      "args": [
        "-y",
        "mailsnail"
      ],
      "env": {
        "MAIL_PROVIDER": "your-value",
        "MAIL_API_BASE_URL": "your-value",
        "CLICK2MAIL_USERNAME": "your-value",
        "CLICK2MAIL_PASSWORD": "your-value",
        "LOB_API_KEY": "your-value",
        "MAIL_MCP_ALLOW_LIVE": "your-value",
        "MAIL_MCP_SPEND_CAP_USD": "your-value"
      }
    }
  }
}

Run this in your terminal

claude mcp add mailsnail --env MAIL_PROVIDER=your-value --env MAIL_API_BASE_URL=your-value --env CLICK2MAIL_USERNAME=your-value --env CLICK2MAIL_PASSWORD=your-value --env LOB_API_KEY=your-value --env MAIL_MCP_ALLOW_LIVE=your-value --env MAIL_MCP_SPEND_CAP_USD=your-value -- npx -y mailsnail

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

{
  "mcpServers": {
    "mailsnail": {
      "command": "npx",
      "args": [
        "-y",
        "mailsnail"
      ],
      "env": {
        "MAIL_PROVIDER": "your-value",
        "MAIL_API_BASE_URL": "your-value",
        "CLICK2MAIL_USERNAME": "your-value",
        "CLICK2MAIL_PASSWORD": "your-value",
        "LOB_API_KEY": "your-value",
        "MAIL_MCP_ALLOW_LIVE": "your-value",
        "MAIL_MCP_SPEND_CAP_USD": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

{
  "servers": {
    "mailsnail": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mailsnail"
      ],
      "env": {
        "MAIL_PROVIDER": "your-value",
        "MAIL_API_BASE_URL": "your-value",
        "CLICK2MAIL_USERNAME": "your-value",
        "CLICK2MAIL_PASSWORD": "your-value",
        "LOB_API_KEY": "your-value",
        "MAIL_MCP_ALLOW_LIVE": "your-value",
        "MAIL_MCP_SPEND_CAP_USD": "your-value"
      }
    }
  }
}

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

MAIL_PROVIDER required env
Where to mail from: 'managed' (default, no signup, pay-per-piece via Stripe), 'click2mail' (BYO account), or 'lob' (BYO key).
MAIL_API_BASE_URL env
Hosted Mailsnail backend. Required when MAIL_PROVIDER=managed.
CLICK2MAIL_USERNAME env
Click2Mail account username. Required when MAIL_PROVIDER=click2mail.
CLICK2MAIL_PASSWORD secret env
Click2Mail account password. Required when MAIL_PROVIDER=click2mail.
LOB_API_KEY secret env
Lob API key. Required when MAIL_PROVIDER=lob. test_* is free; live_* actually mails.
MAIL_MCP_ALLOW_LIVE env
Set to '1' to actually mail in BYOK modes. Default '0' is dry-run.
MAIL_MCP_SPEND_CAP_USD env
Per-session estimated spend cap. Server refuses sends past this.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 7, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account iancollins27, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Online shops & paymentsi

More stars than 0% of the other 1751 servers in this category
Published to the registry more recently than 21% of the other 1751 servers in this category
Basic checks equal to or better than 100% of the other 1751 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is Mailsnail safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: MAIL_PROVIDER, CLICK2MAIL_PASSWORD, LOB_API_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.6.0) reached the registry 4 months ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Node.js on your computer.

What can I use instead?

In the same category: Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spree Commerce: open-source B2B and marketplace ecommerce

by spree

Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.

Runs in the cloud★ 15,812BSD-3-ClauseUpdated 7 days ago

Install

Stripe MCP

by stripe

Stripe’s official server lets AI view and manage customers, products, payments and invoices. Connect to Stripe’s cloud and sign in with OAuth.

Runs in the cloud★ 2,043MITUpdated 12 months ago

Install

MCP Cn Commerce

by TonyWang-hub

8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending

Runs on your computer★ 96MITUpdated 28 days ago

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

Mailsnail

Open-source, provider-agnostic physical mail for AI agents.

Agents have every channel except one. They can email, text, call, and post to every feed — but until now, putting a real, postmarked envelope in a mailbox meant a human signing up for a print-provider account, provisioning API keys, and wiring billing. Mailsnail closes that gap:

Nothing to install. Add one URL to Claude, ChatGPT, Cursor or any MCP client and sign in. Pay for one letter by card or fund a balance, priced at our cost: from $1.21 first-class and $8.61 certified, no subscription. Agents that can mint a Stripe Shared Payment Token can also pay per piece with no account, over the Machine Payments Protocol (HTTP 402).
No lock-in, ever. The provider layer is open and swappable: bring your own Click2Mail or Lob account, self-host the whole gateway, or chain providers for failover. The managed service is a convenience, not a cage.
Built for compliance mail. Certified letters with extra_service: "certified" — the mail that legally *must* be physical (preliminary lien notices, legal notices) and must not miss its deadline because one print API had a bad day.

claude mcp add -t http mailsnail https://api.mailsnail.dev/mcp

then /mcp → mailsnail → Authenticate, and: "Mail a thank-you letter to my aunt."

In Claude Desktop or ChatGPT, add https://api.mailsnail.dev/mcp as a custom connector. Steps for every app: mailsnail.dev/setup. Running your own Click2Mail or Lob account instead? See Ways to run it.

Hosted connector and plugins

The quickest start needs no install. Add https://api.mailsnail.dev/mcp as a custom connector in Claude, ChatGPT, Cursor or any MCP client that supports remote servers, then sign in. Each app's setup steps are at mailsnail.dev/setup.

plugins/mailsnail packages that connector with skills for sending letters, sending certified mail and tracking mail. It works in Claude (chat, Cowork and Claude Code) and in Cursor. To install it in Claude Code:

/plugin marketplace add iancollins27/mailsnail

/plugin install mailsnail@mailsnail

Packages

Package	What it is
`mailsnail`	MCP server — 11 tools (`doctor`, `verify_address`, `preview_letter`, `send_letter`, `send_postcard`, `get_balance`, `top_up`, `get_letter`, `get_postcard`, `list_letters`, `cancel_letter`) over any provider below. Works in Claude Code, Claude Desktop, Cursor, Codex CLI, OpenAI Agents SDK.
`@mailsnail/core`	Provider-agnostic core: adapters (Click2Mail, Lob, any Mailsnail gateway), multi-provider failover router, request validation. Zero dependencies.
`@mailsnail/gateway`	Self-hostable REST API: BYO provider credentials, `body_text`→PDF rendering, proofs, invocation logging. The managed service at `api.mailsnail.dev` runs the same wire protocol.
`spec/`	The provider-neutral mail-piece schema + the failover-safety contract. Implement it and anything — including a print shop — becomes a Mailsnail-compatible node.

Ways to run it

Mode	Credentials	Paying	Good for
hosted connector (`api.mailsnail.dev/mcp`)	none; you sign in	you, per letter by card or from a balance	people in Claude, ChatGPT, Cursor; zero-setup
managed (stdio default)	none	agent, per piece (Stripe SPT)	agents that can mint an SPT
gateway	your own, on your server	your provider account	teams; PII stays in your infra
click2mail / lob (BYOK)	yours, local env	your provider account	direct control, one provider
failover chain	yours, per provider	your provider accounts	mail that must not miss deadlines

Failover is deliberately conservative: a send moves to the next provider only when the failed provider guarantees nothing entered production and no money moved (safeToRetry — see the spec). A duplicate certified letter is worse than an error.

Running behind an egress proxy or allowlist

Sandboxed agents — CI runners, enterprise agent platforms, hosted agent sessions — usually sit behind an egress allowlist, and that is the environment managed mode is *for*. Two minutes of setup:

npx mailsnail doctor      # says exactly what it can and can't reach, and why. Free; never mails.

Allow this host:

Mode	Host to permit	Port
managed (default)	`api.mailsnail.dev`	443 (TCP / HTTPS `CONNECT`)
self-hosted gateway	whatever `MAIL_API_BASE_URL` points at	its port
click2mail (BYOK)	`rest.click2mail.com`	443
lob (BYOK)	`api.lob.com`	443

Allowlist by hostname, not IP: the managed gateway runs on managed infrastructure and its addresses change without notice. If your policy is IP-only, self-host @mailsnail/gateway on an address you control — that escape hatch is the whole point of the open provider layer.

Through an HTTP proxy. Node's fetch ignores HTTPS_PROXY unless you tell it not to, so an allowlisted gateway can still time out silently. Either:

export NODE_USE_ENV_PROXY=1        # Node >= 22.21

export HTTPS_PROXY=http://proxy.example:8080

or install undici alongside mailsnail (npm i undici) and Mailsnail routes through HTTPS_PROXY/HTTP_PROXY/ALL_PROXY itself, honoring NO_PROXY. mailsnail doctor tells you which of these is actually in effect.

TLS-inspecting proxy? Point NODE_EXTRA_CA_CERTS at your organization's CA bundle.

When it's blocked anyway, the failure says so instead of guessing: transport errors carry a code of unreachable, egress_blocked, or tls_untrusted, plus the exact host:port to permit. Any of those codes means the request never reached the backend — nothing mailed, nothing was charged, and the fix is network policy, not your account.

Safety

Dry-run by default everywhere; live mail requires an explicit MAIL_MCP_ALLOW_LIVE=1.
Per-session spend caps in the MCP server; auto-refund in managed mode when a paid piece fails to mail.
preview_letter returns a proof PDF and exact price before anything is charged — show it to your user first.
Don't use this for spam, harassment, or fraud. Provider terms and USPS regulations apply; managed mode enforces its own abuse screening.

Why open source

You're letting software put paper in mailboxes and spend money doing it. Read the code. Run it yourself with your own provider account for free. Use managed mode when you'd rather not hold credentials at all. If we ever disappoint you, MAIL_PROVIDER=click2mail and your mail keeps moving — that's the deal, and it's enforceable because this repo exists.

Status

Early. US-only today. Letters, certified letters, and postcards. The managed API, MCP server, self-host gateway, and Click2Mail/Lob adapters are live; additional adapters (PostGrid, Stannp) are next — CONTRIBUTING.md has the adapter guide if you want one sooner.

License

MIT.

Mailsnail

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Online shops & paymentsi

Common questions

Alternatives

Spree Commerce: open-source B2B and marketplace ecommerce

Stripe MCP

MCP Cn Commerce

README from the maker

Mailsnail

then /mcp → mailsnail → Authenticate, and: "Mail a thank-you letter to my aunt."

Hosted connector and plugins

Packages

Ways to run it

Running behind an egress proxy or allowlist

Safety

Why open source

Status

License