{
  "name": "paperplane-mail",
  "description": "Physical mail as an API: quote, confirm, and send real USPS letters (First-Class, Certified, Priority) via REST or MCP. Confirmation-token spend safety, free sandbox, no account required.",
  "version": "1.0.0",
  "serverUrl": "https://sendpaperplane.com/api/mcp",
  "serverInfo": {
    "name": "paperplane-mail",
    "version": "1.0.0"
  },
  "authentication": {
    "required": false
  },
  "tools": [
    {
      "name": "quote_letter",
      "description": "Prices a letter and mints the confirmation token send_letter requires. Creates nothing, costs nothing.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "get_letter_status",
      "description": "Reads the status of an existing order. Changes nothing.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "send_letter",
      "description": "Spends money and mails a physical object to a real address. Not reversible once printed. Requires a confirmation token from quote_letter, bound to the exact recipient, content, class and price.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "submit_feedback",
      "description": "Reports a wrong response, a docs mismatch or a missing feature to the paperplane team. Records one private report; spends nothing, mails nothing, and the same report sent twice is stored once. Open to every caller, including keys with no scopes.",
      "inputSchema": {
        "type": "object"
      }
    },
    {
      "name": "buy_credits",
      "description": "Spends a funded agent wallet's own USDC over x402 to buy a prepaid paperplane credit pack, no human checkout step. Mails nothing by itself — the minted credit_code is spent later by send_letter. Settlement on-chain is final; refunds are credit or a voluntary USDC return, never a chargeback.",
      "inputSchema": {
        "type": "object"
      }
    }
  ],
  "resources": [],
  "prompts": []
}