Postals MCP server
io.github.coopergwrenn/postals-mcp·v1.0.0·2 starsSend physical handwritten postcards from any AI agent. Real pen & ink, USPS, $4.99/card.
2 stars59 downloads/wk
Reviews
Write oneNobody has reviewed Postals yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Postals tools (2, 1 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
generate_messageGenerate a personalized handwritten message for a postcard based on context about the recipient.
send_postcardwrite actionSend a physical handwritten postcard to a US mailing address.
Public scan report
scanner v0.1.9 · 2026-09-27 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitystatic API keys via environment variables6/15
- Maintenancelast push 165 days ago8/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Postals compares
Against every graded AI and agents MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 72/100
- higher than 40% of 4,460 AI and agents servers
- Tools
- 2
- the typical AI and agents server has 6
- Tools that change things
- 50%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 2
- more than 65% of 2,711 AI and agents servers
- Downloads a week
- 59
- more than 49% of 1,538 AI and agents servers with a package
What its tools let an agent do: 1 create · 1 send or post
Install Postals in Claude Code, Cursor or VS Code
Runs npx -y postals-mcp on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add postals-mcp -- npx -y postals-mcp
What the publisher says
From the Postals repository's README, as published. We do not edit it. Read it on GitHub
Postals
The agent skill that turns any AI into a direct mail machine.
One tool call. Real handwritten postcards. Delivered by USPS.
Send physical handwritten postcards from any MCP-compatible AI agent — Claude Desktop, Cursor, Claude Code, OpenClaw, n8n, LangChain, CrewAI, or your own code. Postals handles image upload, card creation, robotic handwriting (real pen and ink), and USPS mailing.
Website: postals.ai
- 💌 $4.99 per card — no subscriptions, no monthly minimums
- ✍️ Real handwriting — robotic pens hold real ink (not font simulation)
- 📬 3–5 business days — printed and mailed via USPS
- 🤖 Built for agents — one tool call, spend controls, idempotency, test mode
- 🌎 US + international — worldwide delivery, pricing varies by destination
Table of Contents
- Why this exists
- Quick start (under 5 minutes)
- Client configuration
- Tools reference
- The pool builder workflow
- Message generation
- Image handling
- Test mode
- Spend control
- Error handling
- Configuration reference
- Handwriting styles
Why this exists
A new pattern is emerging in the AI agent ecosystem: autonomous bots that scan the world (satellite imagery, social media, public records), identify opportunities, and reach out with real physical mail. Pool builders, landscapers, roofers, solar installers, real estate agents — they're closing five- and six-figure deals from postcards mailed by bots.
Before Postals, every builder hand-rolled their own mailing stack: image upload, card templating, print API, address validation, USPS handoff, tracking. It took weeks and was fragile.
We ship this as one tool. Your agent calls send_postcard with a recipient and a message. We do the rest.
Quick start
1. Sign up and get an API key
Coming soon — the developer portal at postals.ai/developers is launching shortly. Once live, the flow is:
1. Go to postals.ai/developers
2. Create an account with your email (one-click magic link — no password)
3. Fund your wallet ($25 / $50 / $100 / $250 via Stripe or crypto)
4. Copy your postalslive API key
5. Paste it into your MCP config (see step 2 below)
That's it. No external accounts needed. Just Postals.
2. Add the server to your MCP client
Option A — ask your coding agent to install it (fastest path)
If you're in Claude Code, Cursor, Continue, Aider, or any other MCP client with filesystem access, just tell your agent:
Install the postals-mcp MCP server for this client. My Postals API key is: PASTEYOURKEY_HERE. Start in test mode so I can verify the setup before sending real cards.
Your agent will locate your MCP config file, merge the postals entry into your existing mcpServers (preserving any other servers you have), wire up the env vars, and tell you to restart the client. You never touch JSON.
Optional — add return-address details to the same prompt so send_postcard works without per-call overrides:
...and use Jane Smith, 123 Main St, Austin TX 78701 as my return address.
Then fully quit and relaunch the client (Cmd+Q on macOS — just closing the window isn't enough).
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Postals: common questions
- Is Postals MCP server safe?
- Mostly: it is graded B (72/100). Read the Postals safety report
- How do I install Postals?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Postals need an API key?
- Yes. The registry entry asks for
POSTALS_API_KEY,CLOUDFLARE_API_TOKEN. - Is Postals maintained?
- The last commit was 202 days ago (2026-04-16). The latest release is v1.0.0.
- How does Postals compare with other AI and agents MCP servers?
- safety score 72/100 (higher than 40% of 4,460 AI and agents servers); tools 2 (the typical AI and agents server has 6); tools that change things 50% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.