io.github.coopergwrenn
postals-mcp
Send physical handwritten postcards from any AI agent. Real pen & ink, USPS, $4.99/card.
stdiocommunityservice
Package Details
postals-mcp
Transportstdio
Environment Variables
POSTALS_API_KEY(str)
RequiredSecret
Your Handwrytten API key (v1.0) or Postals API key (v1.1+).
POSTALS_SENDER_NAME(str)
Default sender full name for return address.
POSTALS_SENDER_ADDRESS(str)
Default sender street address.
POSTALS_SENDER_CITY(str)
Default sender city.
POSTALS_SENDER_STATE(str)
Default sender 2-letter US state code.
POSTALS_SENDER_ZIP(str)
Default sender 5-digit ZIP (or 5+4 format).
POSTALS_DEFAULT_CARD_IMAGE(str)
Default card front image URL (HTTPS, PNG or JPEG, landscape 7x5 preferred).
POSTALS_HANDWRITING_STYLE(str)
Default handwriting font. Default: Joyful Jennifer.
POSTALS_DAILY_LIMIT(str)
Max cards per day (safety net). Default: 50.
POSTALS_TEST_MODE(str)
Set to 'true' for test mode (validates inputs, no cards actually sent).
CLOUDFLARE_ACCOUNT_ID(str)
Optional. Enables AI message generation via Cloudflare Workers AI.
CLOUDFLARE_API_TOKEN(str)
Secret
Optional. Required together with CLOUDFLARE_ACCOUNT_ID for AI message generation.