Summary
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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
POSTALS_API_KEY*secretYour Handwrytten API key (v1.0) or Postals API key (v1.1+).
POSTALS_SENDER_NAMEDefault sender full name for return address.
POSTALS_SENDER_ADDRESSDefault sender street address.
POSTALS_SENDER_CITYDefault sender city.
POSTALS_SENDER_STATEDefault sender 2-letter US state code.
POSTALS_SENDER_ZIPDefault sender 5-digit ZIP (or 5+4 format).
POSTALS_DEFAULT_CARD_IMAGEDefault card front image URL (HTTPS, PNG or JPEG, landscape 7x5 preferred).
POSTALS_HANDWRITING_STYLEDefault handwriting font. Default: Joyful Jennifer.
POSTALS_DAILY_LIMITMax cards per day (safety net). Default: 50.
POSTALS_TEST_MODESet to 'true' for test mode (validates inputs, no cards actually sent).
CLOUDFLARE_ACCOUNT_IDOptional. Enables AI message generation via Cloudflare Workers AI.
CLOUDFLARE_API_TOKENsecretOptional. Required together with CLOUDFLARE_ACCOUNT_ID for AI message generation.
Categories
Registryactive
Packagepostals-mcp
TransportSTDIO
AuthRequired
UpdatedApr 15, 2026
