postals-mcp

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.coopergwrenn/postals-mcp",
  "description": "Send physical handwritten postcards from any AI agent. Real pen & ink, USPS, $4.99/card.",
  "repository": {
    "url": "https://github.com/coopergwrenn/postals-mcp",
    "source": "github"
  },
  "version": "1.0.0",
  "packages": [
    {
      "registryType": "npm",
      "identifier": "postals-mcp",
      "version": "1.0.0",
      "transport": {
        "type": "stdio"
      },
      "environmentVariables": [
        {
          "description": "Your Handwrytten API key (v1.0) or Postals API key (v1.1+).",
          "isRequired": true,
          "format": "string",
          "isSecret": true,
          "name": "POSTALS_API_KEY"
        },
        {
          "description": "Default sender full name for return address.",
          "format": "string",
          "name": "POSTALS_SENDER_NAME"
        },
        {
          "description": "Default sender street address.",
          "format": "string",
          "name": "POSTALS_SENDER_ADDRESS"
        },
        {
          "description": "Default sender city.",
          "format": "string",
          "name": "POSTALS_SENDER_CITY"
        },
        {
          "description": "Default sender 2-letter US state code.",
          "format": "string",
          "name": "POSTALS_SENDER_STATE"
        },
        {
          "description": "Default sender 5-digit ZIP (or 5+4 format).",
          "format": "string",
          "name": "POSTALS_SENDER_ZIP"
        },
        {
          "description": "Default card front image URL (HTTPS, PNG or JPEG, landscape 7x5 preferred).",
          "format": "string",
          "name": "POSTALS_DEFAULT_CARD_IMAGE"
        },
        {
          "description": "Default handwriting font. Default: Joyful Jennifer.",
          "format": "string",
          "name": "POSTALS_HANDWRITING_STYLE"
        },
        {
          "description": "Max cards per day (safety net). Default: 50.",
          "format": "string",
          "name": "POSTALS_DAILY_LIMIT"
        },
        {
          "description": "Set to 'true' for test mode (validates inputs, no cards actually sent).",
          "format": "string",
          "name": "POSTALS_TEST_MODE"
        },
        {
          "description": "Optional. Enables AI message generation via Cloudflare Workers AI.",
          "format": "string",
          "name": "CLOUDFLARE_ACCOUNT_ID"
        },
        {
          "description": "Optional. Required together with CLOUDFLARE_ACCOUNT_ID for AI message generation.",
          "format": "string",
          "isSecret": true,
          "name": "CLOUDFLARE_API_TOKEN"
        }
      ]
    }
  ]
}