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
• Troubleshooting
• FAQ
• What's next (roadmap)
• Contributing
• License

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 postals_live_ 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: PASTE_YOUR_KEY_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).

Option B — edit your MCP config

... View full README on GitHub