Set up in 2 minutes.

Postals is an MCP server. Install it, paste it into your agent's config, fund your wallet, and your agent can send real handwritten postcards via USPS.

1. 01

   Install the package.

   One command. The package is published on npm and works in every MCP-compatible client: Claude Desktop, Cursor, Claude Code, OpenClaw, n8n, LangChain, and anything else that speaks the protocol.

   npm install -g postals-mcp Copied
2. 02

   Add it to your config.

   Paste this into your MCP client's config file. The shape is identical in every client. Just point it at the postals-mcp binary you installed above. The API key goes in POSTALS_API_KEY; you'll get one in step three.

   { "mcpServers": { "postals": { "command": "npx", "args": ["-y", "postals-mcp"], "env": { "POSTALS_API_KEY": "postals_live_..." } } } } Copied

   Need the file path? Claude Desktop config lives at ~/Library/Application Support/Claude/claude_desktop_config.json on macOS. Other clients have their own; check their docs.

3. 03

   Fund your wallet.

   $4.99 per card. $5 minimum deposit. Prepaid credits, no subscription, no monthly fee. The balance sits there until your agent spends it. Stripe checkout takes about a minute.

   Open dashboard →

   The dashboard is also where you set spend limits (“max 25 cards a day”), enable auto-reload, and revoke API keys if anything goes sideways.