mcpindex.aiv0
← Index

io.github.coopergwrenn/postals-mcp

io.github.coopergwrenn/postals-mcp·v1.0.0·Other
Quality Score
85
/100

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

Repository →
§01  Install
Claude Desktop (claude_desktop_config.json)
{
  "mcpServers": {
    "postals-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "postals-mcp"
      ],
      "env": {
        "POSTALS_API_KEY": "<your-postals_api_key>",
        "POSTALS_SENDER_NAME": "<postals_sender_name>",
        "POSTALS_SENDER_ADDRESS": "<postals_sender_address>",
        "POSTALS_SENDER_CITY": "<postals_sender_city>",
        "POSTALS_SENDER_STATE": "<postals_sender_state>",
        "POSTALS_SENDER_ZIP": "<postals_sender_zip>",
        "POSTALS_DEFAULT_CARD_IMAGE": "<postals_default_card_image>",
        "POSTALS_HANDWRITING_STYLE": "<postals_handwriting_style>",
        "POSTALS_DAILY_LIMIT": "<postals_daily_limit>",
        "POSTALS_TEST_MODE": "<postals_test_mode>",
        "CLOUDFLARE_ACCOUNT_ID": "<cloudflare_account_id>",
        "CLOUDFLARE_API_TOKEN": "<your-cloudflare_api_token>"
      }
    }
  }
}
Cursor (.cursor/mcp.json)
{
  "mcpServers": {
    "postals-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "postals-mcp"
      ],
      "env": {
        "POSTALS_API_KEY": "<your-postals_api_key>",
        "POSTALS_SENDER_NAME": "<postals_sender_name>",
        "POSTALS_SENDER_ADDRESS": "<postals_sender_address>",
        "POSTALS_SENDER_CITY": "<postals_sender_city>",
        "POSTALS_SENDER_STATE": "<postals_sender_state>",
        "POSTALS_SENDER_ZIP": "<postals_sender_zip>",
        "POSTALS_DEFAULT_CARD_IMAGE": "<postals_default_card_image>",
        "POSTALS_HANDWRITING_STYLE": "<postals_handwriting_style>",
        "POSTALS_DAILY_LIMIT": "<postals_daily_limit>",
        "POSTALS_TEST_MODE": "<postals_test_mode>",
        "CLOUDFLARE_ACCOUNT_ID": "<cloudflare_account_id>",
        "CLOUDFLARE_API_TOKEN": "<your-cloudflare_api_token>"
      }
    }
  }
}
Cline (cline_mcp_settings.json)
npx -y postals-mcp
§02  Environment variables
POSTALS_API_KEY
requiredsecret

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
secret

Optional. Required together with CLOUDFLARE_ACCOUNT_ID for AI message generation.

§03  MCP Quality Score  ·  methodology
freshness
25
completeness
10
installability
25
documentation
15
stability
10
§04  Alternatives in Other
agency.lona/trading
agency.lona/trading

AI-powered trading strategy development: backtesting, market data, and portfolio analysis

ABMeter
ai.abmeter/abmeter

Feature flagging and A/B testing platform with AI-first experimentation workflows.

AdAdvisor MCP Server
ai.adadvisor/mcp-server

Query Meta Ads performance data — accounts, campaigns, ad sets, ads, metrics & settings.