Postals-mcp Server

Send physical handwritten postcards from any AI agent. Real pen & ink, USPS, $4.99/card.

Local serverstdio

What is the Postals-mcp Server?

Postals-mcp is an MCP integration. Send physical handwritten postcards from any AI agent. Real pen & ink, USPS, $4.99/card.

Packages and local setup

The published npm package is postals-mcp, version 1.0.0. Its declared MCP transport is stdio.

The package declares POSTALS_API_KEY (required): 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_TOKEN: Optional. Required together with CLOUDFLARE_ACCOUNT_ID for AI message generation..

Before connecting

Check the maintainer’s instructions for account access, authentication and the supported client configuration. Once connected, inspect the tools your client receives and try a small task that matches the server’s stated purpose. The registry description does not include a verified, complete tool list.

Project and source

View the publisher’s registry entry · Project repository. This profile uses version 1.0.0 from the registry. Registration identifies the publisher namespace; it does not establish that this is a first-party integration for every service it connects.

Browse related developer tools MCP servers for tools that cover the same kind of work.

Configuration

VariableDescriptionRequired
POSTALS_API_KEYYour Handwrytten API key (v1.0) or Postals API key (v1.1+).Yes
POSTALS_SENDER_NAMEDefault sender full name for return address.Optional
POSTALS_SENDER_ADDRESSDefault sender street address.Optional
POSTALS_SENDER_CITYDefault sender city.Optional
POSTALS_SENDER_STATEDefault sender 2-letter US state code.Optional
POSTALS_SENDER_ZIPDefault sender 5-digit ZIP (or 5+4 format).Optional
POSTALS_DEFAULT_CARD_IMAGEDefault card front image URL (HTTPS, PNG or JPEG, landscape 7x5 preferred).Optional
POSTALS_HANDWRITING_STYLEDefault handwriting font. Default: Joyful Jennifer.Optional
POSTALS_DAILY_LIMITMax cards per day (safety net). Default: 50.Optional
POSTALS_TEST_MODESet to 'true' for test mode (validates inputs, no cards actually sent).Optional
CLOUDFLARE_ACCOUNT_IDOptional. Enables AI message generation via Cloudflare Workers AI.Optional
CLOUDFLARE_API_TOKENOptional. Required together with CLOUDFLARE_ACCOUNT_ID for AI message generation.Optional