Open-source B2B and marketplace ecommerce; new stores include an MCP server for AI agents.
Mailsnail
Überblick
Beschreibung vom Entwickler (englisches Original)
Send USPS letters, postcards & certified mail from any agent. No signup; pay-per-piece via Stripe.
Die drei Säulen von PopNx MCP
Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.
- Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
- Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
- NutzungiNoch nicht gemessen★ –
Was du damit machen kannst
Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.
- Verbindung: Läuft auf deinem Computer
- Transport: stdio
- Kategorie: Onlineshops & Zahlungen
- Das musst du eintragen: MAIL_PROVIDER, CLICK2MAIL_PASSWORD, LOB_API_KEY
Installation
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Bevor du installierst
- Basischecks: 1 von 1 bestanden
- Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
- Das trägst du selbst ein:
MAIL_PROVIDER,MAIL_API_BASE_URL,CLICK2MAIL_USERNAME,CLICK2MAIL_PASSWORD,LOB_API_KEY,MAIL_MCP_ALLOW_LIVE,MAIL_MCP_SPEND_CAP_USD
Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.
Du brauchst
- npmNode.js installiert (für den Befehl npx)
Welche App nutzt du?
Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.
Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein
{
"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"
}
}
}
}Führe das in deinem Terminal aus
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 mailsnailTrag die leeren Werte ein, bevor du ihn startest.
Oder kopier die Einstellungen selbst
In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen
{
"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"
}
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
Oder kopier die Einstellungen selbst
In .vscode/mcp.json in deinem Projekt einfügen
{
"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"
}
}
}
}Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.
Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.
Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.
Werte, die du selbst einträgst
- Where to mail from: 'managed' (default, no signup, pay-per-piece via Stripe), 'click2mail' (BYO account), or 'lob' (BYO key).
MAIL_API_BASE_URLenvHosted Mailsnail backend. Required when MAIL_PROVIDER=managed.CLICK2MAIL_USERNAMEenvClick2Mail account username. Required when MAIL_PROVIDER=click2mail.- Click2Mail account password. Required when MAIL_PROVIDER=click2mail.
- Lob API key. Required when MAIL_PROVIDER=lob. test_* is free; live_* actually mails.
MAIL_MCP_ALLOW_LIVEenvSet to '1' to actually mail in BYOK modes. Default '0' is dry-run.MAIL_MCP_SPEND_CAP_USDenvPer-session estimated spend cap. Server refuses sends past this.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Was er kann
Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.
Basischecksi
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026
- ✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto iancollins27 bestätigt, dem das Repo gehört
- … Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
- … Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
- – Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
- – Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
- … Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen
Im Vergleich mit anderen in Onlineshops & Zahlungeni
- Mehr Sterne als 0 % der anderen 1748 Server in dieser Kategorie
- Neuer in der Registry veröffentlicht als 21 % der anderen 1748 Server in dieser Kategorie
- Basischecks gleich gut wie oder besser als bei 100 % der anderen 1748 Server in dieser Kategorie
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Häufige Fragen
Ist Mailsnail sicher?
Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Welche Schlüssel oder Codes braucht er?
Das musst du eintragen: MAIL_PROVIDER, CLICK2MAIL_PASSWORD, LOB_API_KEY
Läuft er auf meinem Computer oder in der Cloud?
Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).
Wird er noch gepflegt?
Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.6.0) kam vor 4 Monaten in die Registry.
Welche Apps können ihn nutzen?
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.
Was kann ich stattdessen nutzen?
In derselben Kategorie: Spree Commerce: open-source B2B and marketplace ecommerce, Stripe MCP, MCP Cn Commerce
Alternativen
Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.
So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
Stripe MCP
MCP server integrating with Stripe - tools for customers, products, payments, and more.
MCP Cn Commerce
8 read-only MCP platform entries; support is operation-specific; merchant live acceptance pending
README vom Entwickler
README öffnen
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
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_letterreturns 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.