Claude MarketplacesSubmit
coopergwrenn avatar

Postals Mcp

coopergwrenn/postals-mcp

Connects Claude and other MCP clients to Postals.ai's physical postcard API. Exposes two tools: send_postcard for ordering real handwritten cards ($4.99 each, robotic pen and ink, USPS delivery) and generate_message for drafting personalized copy. Built for autonomous agents that need to send direct mail at scale. Includes test mode, spend controls, and idempotency keys. The pool builder workflow in the docs shows the canonical use case: agents scan satellite imagery for pools without enclosures, generate targeted outreach, and mail postcards to homeowners. Works in Claude Desktop, Cursor, n8n, LangChain, or any stdio transport. Requires a Postals API key from their developer portal. Ships via npx, so no separate installation step.

GitHub stars
1
tools
2
auth
Secret needed
transport
STDIO
env vars
12
last updated
Apr 15, 2026
View on GitHub

Tools

2 tools

Public tool metadata for what this MCP can expose to an agent.

send_postcardMails one physical handwritten postcard to a US address.

Mails one physical handwritten postcard to a US address.

No parameter schema in public metadata yet.

generate_messageAI-drafts a personalized postcard message. Uses Cloudflare AI if configured; otherwise returns a structured prompt your agent can use to self-generate (which is often just as good, since the agent is already an LLM).

AI-drafts a personalized postcard message. Uses Cloudflare AI if configured; otherwise returns a structured prompt your agent can use to self-generate (which is often just as good, since the agent is already an LLM).

No parameter schema in public metadata yet.

Sponsors

Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthlyAgent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any language

Configuration

POSTALS_API_KEY*secret

Your Handwrytten API key (v1.0) or Postals API key (v1.1+).

POSTALS_SENDER_NAME

Default sender full name for return address.

POSTALS_SENDER_ADDRESS

Default sender street address.

POSTALS_SENDER_CITY

Default sender city.

POSTALS_SENDER_STATE

Default sender 2-letter US state code.

POSTALS_SENDER_ZIP

Default sender 5-digit ZIP (or 5+4 format).

POSTALS_DEFAULT_CARD_IMAGE

Default card front image URL (HTTPS, PNG or JPEG, landscape 7x5 preferred).

POSTALS_HANDWRITING_STYLE

Default handwriting font. Default: Joyful Jennifer.

POSTALS_DAILY_LIMIT

Max cards per day (safety net). Default: 50.

POSTALS_TEST_MODE

Set to 'true' for test mode (validates inputs, no cards actually sent).

CLOUDFLARE_ACCOUNT_ID

Optional. Enables AI message generation via Cloudflare Workers AI.

CLOUDFLARE_API_TOKENsecret

Optional. Required together with CLOUDFLARE_ACCOUNT_ID for AI message generation.

Readme

Postals

The agent skill that turns any AI into a direct mail machine. One tool call. Real handwritten postcards. Delivered by USPS.

npm version MCP compatible License

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

View the full README on GitHub

Details

Repository
github.com/coopergwrenn/postals-mcp
Category
AI & LLM Tools
Package
postals-mcp
Transport
STDIO
Auth
Required
Registry
MCP registry, active

Related AI & LLM Tools MCP servers

View all
1duhokim avatarNebulamindduhokim/nebulamindAI astronomy wiki with open agent peer-review. Vote on evidence, propose edits, earn reputation.1stars
2gong8 avatarKnownissuegong8/knownissueShared debugging memory for AI coding agents1stars
3inferensys avatarContextfulinferensys/contextfulEfficient context management: code search, evidence packs, and memory for coding agents.1stars
4aakashbhardwaj27 avatarAI Scanneraakashbhardwaj27/ai-scanner-mcpScan codebases for LLM/AI SDK usage, exposed API tokens, and hardcoded secrets.1stars
5alexanderlawson17 avatarRevettr Mcpalexanderlawson17/revettr-pythonCounterparty risk scoring for agentic commerce via x402 micropayments.0stars
6dingdawg avatarDingdawg Code Reviewdingdawg/dingdawg-agent-1AI code review — security, quality, performance. Learns your patterns. Receipted.0stars