Back to Browse

Postals MCP Server

Developer ToolsLow Risk10.0MCP RegistryLocal
Free

Server data from the Official MCP Registry

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

About

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

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (3 strong, 3 medium validity signals). No known CVEs in dependencies. Package registry verified. Imported from the Official MCP Registry.

3 files analyzed · 1 issue found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

HTTP Network Access

Connects to external APIs or services over the internet.

env_vars

Check that this permission is expected for this type of plugin.

What You'll Need

Set these up before or after installing:

Your Handwrytten API key (v1.0) or Postals API key (v1.1+).Required

Environment variable: POSTALS_API_KEY

Default sender full name for return address.Optional

Environment variable: POSTALS_SENDER_NAME

Default sender street address.Optional

Environment variable: POSTALS_SENDER_ADDRESS

Default sender city.Optional

Environment variable: POSTALS_SENDER_CITY

Default sender 2-letter US state code.Optional

Environment variable: POSTALS_SENDER_STATE

Default sender 5-digit ZIP (or 5+4 format).Optional

Environment variable: POSTALS_SENDER_ZIP

Default card front image URL (HTTPS, PNG or JPEG, landscape 7x5 preferred).Optional

Environment variable: POSTALS_DEFAULT_CARD_IMAGE

Default handwriting font. Default: Joyful Jennifer.Optional

Environment variable: POSTALS_HANDWRITING_STYLE

Max cards per day (safety net). Default: 50.Optional

Environment variable: POSTALS_DAILY_LIMIT

Set to 'true' for test mode (validates inputs, no cards actually sent).Optional

Environment variable: POSTALS_TEST_MODE

Optional. Enables AI message generation via Cloudflare Workers AI.Optional

Environment variable: CLOUDFLARE_ACCOUNT_ID

Optional. Required together with CLOUDFLARE_ACCOUNT_ID for AI message generation.Required

Environment variable: CLOUDFLARE_API_TOKEN

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-coopergwrenn-postals-mcp": {
      "env": {
        "POSTALS_API_KEY": "your-postals-api-key-here",
        "POSTALS_TEST_MODE": "your-postals-test-mode-here",
        "POSTALS_SENDER_ZIP": "your-postals-sender-zip-here",
        "POSTALS_DAILY_LIMIT": "your-postals-daily-limit-here",
        "POSTALS_SENDER_CITY": "your-postals-sender-city-here",
        "POSTALS_SENDER_NAME": "your-postals-sender-name-here",
        "CLOUDFLARE_API_TOKEN": "your-cloudflare-api-token-here",
        "POSTALS_SENDER_STATE": "your-postals-sender-state-here",
        "CLOUDFLARE_ACCOUNT_ID": "your-cloudflare-account-id-here",
        "POSTALS_SENDER_ADDRESS": "your-postals-sender-address-here",
        "POSTALS_HANDWRITING_STYLE": "your-postals-handwriting-style-here",
        "POSTALS_DEFAULT_CARD_IMAGE": "your-postals-default-card-image-here"
      },
      "args": [
        "-y",
        "postals-mcp"
      ],
      "command": "npx"
    }
  }
}

Reviews

No reviews yet

Be the first to review this server!