{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "paperagent.dev",
    "site": "paperagent.dev",
    "addresses": [
      {
        "address": "104.21.71.51",
        "endpoints": 2,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.64.0/20",
          "country": "US"
        }
      },
      {
        "address": "172.67.169.125",
        "endpoints": 2,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.160.0/20",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3031::6815:4733",
        "endpoints": 2,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3031::/48",
          "country": "US"
        }
      },
      {
        "address": "2606:4700:3035::ac43:a97d",
        "endpoints": 2,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "2606:4700:3035::/48",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "104.21.71.51",
          "172.67.169.125",
          "2606:4700:3031::6815:4733",
          "2606:4700:3035::ac43:a97d"
        ],
        "first_seen": "2026-11-22T17:31:02.562Z",
        "last_seen": "2026-11-22T17:31:02.562Z",
        "checks": 1
      },
      {
        "addresses": [
          "172.67.169.125",
          "104.21.71.51",
          "2606:4700:3035::ac43:a97d",
          "2606:4700:3031::6815:4733"
        ],
        "first_seen": "2026-11-21T12:30:04.075Z",
        "last_seen": "2026-11-21T12:30:04.075Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "paperagent",
      "version": "0.1.0",
      "protocol_version": "2025-06-18"
    },
    "headers": {
      "server": "cloudflare"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 1,
      "sample": [
        {
          "id": "16053",
          "url": "https://snagcast.com/mcp",
          "server_name": "com.snagcast/snagcast",
          "last_state": "listed",
          "last_checked_at": "2026-11-22T16:28:03.248Z"
        }
      ]
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "dev.paperagent",
      "total": 0,
      "sample": []
    },
    "same_repository": null,
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "20469",
    "server_name": "dev.paperagent/letters",
    "url": "https://paperagent.dev/mcp",
    "host": "paperagent.dev",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T17:31:02.562Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "78a322b3781068951c5c357534cf35c345dd26698245f3baf29ca4bda53a8473",
    "first_listed_at": "2026-11-21T12:30:04.075Z",
    "created_at": "2026-11-21T07:25:09.162Z",
    "resolved_addresses": [
      "104.21.71.51",
      "172.67.169.125",
      "2606:4700:3031::6815:4733",
      "2606:4700:3035::ac43:a97d"
    ]
  },
  "server": {
    "name": "dev.paperagent/letters",
    "title": "PaperAgent — Send Physical Mail",
    "description": "Mail one-off USPS letters from ChatGPT or Claude after you approve the preview and price. US only.",
    "version": "0.1.0",
    "registry_status": "active",
    "repository_url": null,
    "website_url": "https://paperagent.dev",
    "published_at": "2026-10-18T20:35:11.797Z",
    "updated_at": "2026-10-18T20:35:11.797Z",
    "first_seen": "2026-11-21T07:25:08.540Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T15:31:13.647Z"
  },
  "operator": {
    "key": "paperagent.dev",
    "name": "paperagent.dev",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 2,
    "answered": 2,
    "answered_percent": 100,
    "avg_listing_latency_ms": 358,
    "first_check_in_window": "2026-11-21T12:30:04.075Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      },
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "78a322b3781068951c5c357534cf35c345dd26698245f3baf29ca4bda53a8473",
    "tools": 8,
    "resources": 4,
    "prompts": 0,
    "first_seen": "2026-11-21T12:30:04.522Z",
    "tool_names": [
      "get_pricing",
      "validate_address",
      "create_draft",
      "update_draft",
      "preview_draft",
      "send_letter",
      "get_letter_status",
      "list_letters"
    ],
    "declared": {
      "tools": [
        {
          "name": "get_pricing",
          "title": "Get Letter Pricing",
          "description": "Return the published price list for mailing physical letters through USPS: the products on sale, what each one costs, how many pages it covers, and when sales tax applies. Amounts are in US cents. Every letter is one of these prices — there is no volume discount, no per-page charge and no colour printing — so quote the tier total and say New York sales tax is added, whatever the destination. Call this before telling a user what a letter will cost. This creates nothing and mails nothing.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {}
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "version",
              "effective_from",
              "currency",
              "country",
              "tiers",
              "add_ons",
              "page_rules",
              "tax"
            ],
            "properties": {
              "tax": {
                "type": "object",
                "required": [
                  "origin_state",
                  "note"
                ],
                "properties": {
                  "note": {
                    "type": "string"
                  },
                  "origin_state": {
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "tiers": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "tier",
                    "title",
                    "description",
                    "delivery_confirmation",
                    "total"
                  ],
                  "properties": {
                    "tier": {
                      "enum": [
                        "standard",
                        "proof_of_mailing",
                        "certified",
                        "certified_err",
                        "registered"
                      ],
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "total": {
                      "type": "object",
                      "required": [
                        "amount_cents",
                        "currency",
                        "display"
                      ],
                      "properties": {
                        "display": {
                          "type": "string",
                          "description": "The amount formatted for a person, with a currency symbol."
                        },
                        "currency": {
                          "type": "string",
                          "const": "USD"
                        },
                        "amount_cents": {
                          "type": "integer",
                          "maximum": 9007199254740991,
                          "minimum": -9007199254740991,
                          "description": "The amount in whole US cents."
                        }
                      },
                      "description": "An amount of money. Always read amount_cents; display is for showing the user.",
                      "additionalProperties": false
                    },
                    "description": {
                      "type": "string"
                    },
                    "delivery_confirmation": {
                      "type": "boolean",
                      "description": "False for every tier USPS does not scan at delivery. Never claim otherwise."
                    }
                  },
                  "additionalProperties": false
                }
              },
              "add_ons": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "code",
                    "description",
                    "unit_amount"
                  ],
                  "properties": {
                    "code": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    },
                    "unit_amount": {
                      "type": "object",
                      "required": [
                        "amount_cents",
                        "currency",
                        "display"
                      ],
                      "properties": {
                        "display": {
                          "type": "string",
                          "description": "The amount formatted for a person, with a currency symbol."
                        },
                        "currency": {
                          "type": "string",
                          "const": "USD"
                        },
                        "amount_cents": {
                          "type": "integer",
                          "maximum": 9007199254740991,
                          "minimum": -9007199254740991,
                          "description": "The amount in whole US cents."
                        }
                      },
                      "description": "An amount of money. Always read amount_cents; display is for showing the user.",
                      "additionalProperties": false
                    }
                  },
                  "additionalProperties": false
                }
              },
              "country": {
                "type": "string"
              },
              "version": {
                "type": "string"
              },
              "currency": {
                "type": "string"
              },
              "page_rules": {
                "type": "object",
                "required": [
                  "included_pages",
                  "max_pages",
                  "pages_per_sheet"
                ],
                "properties": {
                  "max_pages": {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "minimum": -9007199254740991
                  },
                  "included_pages": {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "minimum": -9007199254740991
                  },
                  "pages_per_sheet": {
                    "type": "integer",
                    "maximum": 9007199254740991,
                    "minimum": -9007199254740991
                  },
                  "additional_ounce": {
                    "type": "object",
                    "required": [
                      "amount_cents",
                      "currency",
                      "display"
                    ],
                    "properties": {
                      "display": {
                        "type": "string",
                        "description": "The amount formatted for a person, with a currency symbol."
                      },
                      "currency": {
                        "type": "string",
                        "const": "USD"
                      },
                      "amount_cents": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "The amount in whole US cents."
                      }
                    },
                    "description": "An amount of money. Always read amount_cents; display is for showing the user.",
                    "additionalProperties": false
                  }
                },
                "additionalProperties": false
              },
              "effective_from": {
                "type": "string"
              },
              "volume_pricing": {
                "type": "object",
                "required": [
                  "applies_to",
                  "window",
                  "tiers"
                ],
                "properties": {
                  "tiers": {
                    "type": "array",
                    "items": {
                      "type": "object",
                      "required": [
                        "min_letters",
                        "max_letters",
                        "total"
                      ],
                      "properties": {
                        "total": {
                          "type": "object",
                          "required": [
                            "amount_cents",
                            "currency",
                            "display"
                          ],
                          "properties": {
                            "display": {
                              "type": "string",
                              "description": "The amount formatted for a person, with a currency symbol."
                            },
                            "currency": {
                              "type": "string",
                              "const": "USD"
                            },
                            "amount_cents": {
                              "type": "integer",
                              "maximum": 9007199254740991,
                              "minimum": -9007199254740991,
                              "description": "The amount in whole US cents."
                            }
                          },
                          "description": "An amount of money. Always read amount_cents; display is for showing the user.",
                          "additionalProperties": false
                        },
                        "max_letters": {
                          "anyOf": [
                            {
                              "type": "integer",
                              "maximum": 9007199254740991,
                              "minimum": -9007199254740991
                            },
                            {
                              "type": "null"
                            }
                          ]
                        },
                        "min_letters": {
                          "type": "integer",
                          "maximum": 9007199254740991,
                          "minimum": -9007199254740991
                        }
                      },
                      "additionalProperties": false
                    }
                  },
                  "window": {
                    "type": "string"
                  },
                  "applies_to": {
                    "type": "array",
                    "items": {
                      "enum": [
                        "standard",
                        "proof_of_mailing",
                        "certified",
                        "certified_err",
                        "registered"
                      ],
                      "type": "string"
                    }
                  }
                },
                "additionalProperties": false
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get Letter Pricing",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "validate_address",
          "title": "Validate a US Postal Address",
          "description": "Check a US postal address and return it in the normalized form the envelope will be printed with, plus any warnings. The address is checked against the Google Address Validation service, which receives the address and nothing else. Use this before create_draft whenever the address came from a person rather than from an earlier tool result. Requires a complete street address: this does not look up, append or find an address from a name, and it does not handle addresses outside the United States. This creates nothing and mails nothing.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "address"
            ],
            "properties": {
              "address": {
                "type": "object",
                "required": [
                  "name",
                  "line1",
                  "city",
                  "state",
                  "postal_code"
                ],
                "properties": {
                  "city": {
                    "type": "string",
                    "minLength": 1
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The person or company the letter is addressed to."
                  },
                  "line1": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Street number and street name, or PO box."
                  },
                  "line2": {
                    "type": "string",
                    "description": "Apartment, suite, floor or unit."
                  },
                  "state": {
                    "type": "string",
                    "maxLength": 2,
                    "minLength": 2,
                    "description": "Two-letter US state or territory code, such as NY."
                  },
                  "postal_code": {
                    "type": "string",
                    "description": "Five-digit ZIP or ZIP+4, such as 10001 or 10001-2345."
                  }
                },
                "description": "A complete US postal address. US domestic addresses only."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "deliverable",
              "address",
              "corrections",
              "message"
            ],
            "properties": {
              "address": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "line1",
                      "city",
                      "state",
                      "postal_code",
                      "country"
                    ],
                    "properties": {
                      "city": {
                        "type": "string"
                      },
                      "line1": {
                        "type": "string"
                      },
                      "line2": {
                        "type": "string"
                      },
                      "state": {
                        "type": "string"
                      },
                      "country": {
                        "type": "string",
                        "const": "US"
                      },
                      "postal_code": {
                        "type": "string",
                        "description": "ZIP+4 where USPS supplied one, otherwise the five-digit ZIP."
                      }
                    },
                    "description": "The address as USPS holds it. Pass these fields back verbatim when you create a draft.",
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Null when USPS could not answer about the address at all."
              },
              "message": {
                "type": "string",
                "description": "The sentence to act on. Read it before answering the user."
              },
              "corrections": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "What USPS changed. Tell the user if it corrected anything material."
              },
              "deliverable": {
                "type": "boolean"
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Validate a US Postal Address",
            "readOnlyHint": true,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "create_draft",
          "title": "Create a Letter Draft",
          "description": "Create a draft of a physical letter to be printed on paper and mailed through USPS, and return its draft_id, page count and total price. A letter is at most 6 printed pages, at the same price whatever its length: up to 3 pages print one-sided, 4 to 6 print on both sides. Write the body to fit, or split a longer document into two letters, because a body that renders to 7 or more pages is refused rather than trimmed. This is NOT email, fax or text message — nothing reaches the recipient electronically, and the only way this letter arrives is on paper in an envelope. The body is plain text or Markdown. The draft freezes the content and the price for 24 hours and costs nothing; no paper is printed and no postage is bought until send_letter is called. US domestic addresses only. Call preview_draft next so the user can see the letter and the total.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "to",
              "body_markdown"
            ],
            "properties": {
              "to": {
                "type": "object",
                "required": [
                  "name",
                  "line1",
                  "city",
                  "state",
                  "postal_code"
                ],
                "properties": {
                  "city": {
                    "type": "string",
                    "minLength": 1
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The person or company the letter is addressed to."
                  },
                  "line1": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Street number and street name, or PO box."
                  },
                  "line2": {
                    "type": "string",
                    "description": "Apartment, suite, floor or unit."
                  },
                  "state": {
                    "type": "string",
                    "maxLength": 2,
                    "minLength": 2,
                    "description": "Two-letter US state or territory code, such as NY."
                  },
                  "postal_code": {
                    "type": "string",
                    "description": "Five-digit ZIP or ZIP+4, such as 10001 or 10001-2345."
                  }
                },
                "description": "Who the letter is mailed to."
              },
              "tier": {
                "enum": [
                  "standard",
                  "proof_of_mailing",
                  "certified",
                  "certified_err",
                  "registered"
                ],
                "type": "string",
                "description": "Defaults to standard. Call get_pricing first and pass a tier it lists: standard is a plain First-Class letter. certified, certified_err, proof_of_mailing and registered are other products the current price card may not sell, and a tier it does not sell is refused, not substituted — so do not describe one to the user until get_pricing has listed it."
              },
              "colour": {
                "type": "boolean",
                "description": "Omit this. The current price card prints every letter black & white, so passing true is refused rather than billed — call get_pricing for what it does sell. The field remains because letters priced on an older card carry it."
              },
              "body_file": {
                "type": "object",
                "required": [
                  "download_url",
                  "file_id"
                ],
                "properties": {
                  "file_id": {
                    "type": "string",
                    "description": "The host's identifier for the uploaded file."
                  },
                  "file_name": {
                    "type": "string",
                    "description": "The name the file was uploaded under."
                  },
                  "mime_type": {
                    "type": "string",
                    "description": "The file's media type, e.g. application/pdf."
                  },
                  "download_url": {
                    "type": "string",
                    "description": "A short-lived URL the file can be fetched from."
                  }
                },
                "description": "A file the user attached, as the host delivers it. Not accepted yet — create_draft refuses an attachment and asks for the letter as body_markdown text."
              },
              "body_markdown": {
                "type": "string",
                "minLength": 1,
                "description": "The text of the letter, as plain text or Markdown. It must render to 6 printed pages or fewer — roughly 2,400 words of body text."
              },
              "from_address_id": {
                "type": "string",
                "description": "Omit this. The account's own verified return address is used by default; only pass an id the account holder gave you."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "draft_id",
              "page_count",
              "sheet_count",
              "tier",
              "tier_title",
              "included_pages",
              "quote",
              "expires_at",
              "note"
            ],
            "properties": {
              "note": {
                "type": "string",
                "description": "The next call to make. Read it before answering the user."
              },
              "tier": {
                "enum": [
                  "standard",
                  "proof_of_mailing",
                  "certified",
                  "certified_err",
                  "registered"
                ],
                "type": "string",
                "description": "The product this draft is priced as, as passed to create_draft or update_draft."
              },
              "quote": {
                "type": "object",
                "required": [
                  "quote_id",
                  "expires_at",
                  "version",
                  "subtotal",
                  "tax",
                  "total"
                ],
                "properties": {
                  "tax": {
                    "type": "object",
                    "required": [
                      "collected",
                      "destination_state"
                    ],
                    "properties": {
                      "collected": {
                        "type": "object",
                        "required": [
                          "amount_cents",
                          "currency",
                          "display"
                        ],
                        "properties": {
                          "display": {
                            "type": "string",
                            "description": "The amount formatted for a person, with a currency symbol."
                          },
                          "currency": {
                            "type": "string",
                            "const": "USD"
                          },
                          "amount_cents": {
                            "type": "integer",
                            "maximum": 9007199254740991,
                            "minimum": -9007199254740991,
                            "description": "The amount in whole US cents."
                          }
                        },
                        "description": "New York sales tax on this letter. We mail from New York, so a few cents apply wherever the letter goes, and more when it is going to New York.",
                        "additionalProperties": false
                      },
                      "destination_state": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  },
                  "total": {
                    "type": "object",
                    "required": [
                      "amount_cents",
                      "currency",
                      "display"
                    ],
                    "properties": {
                      "display": {
                        "type": "string",
                        "description": "The amount formatted for a person, with a currency symbol."
                      },
                      "currency": {
                        "type": "string",
                        "const": "USD"
                      },
                      "amount_cents": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "The amount in whole US cents."
                      }
                    },
                    "description": "Subtotal plus sales tax. This is the number send_letter requires in confirm_total_cents.",
                    "additionalProperties": false
                  },
                  "version": {
                    "type": "string",
                    "description": "The published price card this total came from."
                  },
                  "quote_id": {
                    "type": "string",
                    "description": "Identifier for this quote, for support and receipts."
                  },
                  "subtotal": {
                    "type": "object",
                    "required": [
                      "amount_cents",
                      "currency",
                      "display"
                    ],
                    "properties": {
                      "display": {
                        "type": "string",
                        "description": "The amount formatted for a person, with a currency symbol."
                      },
                      "currency": {
                        "type": "string",
                        "const": "USD"
                      },
                      "amount_cents": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "The amount in whole US cents."
                      }
                    },
                    "description": "What the letter costs, before sales tax.",
                    "additionalProperties": false
                  },
                  "expires_at": {
                    "type": "string",
                    "description": "ISO 8601 instant after which this total is re-computed from the live price card. Call preview_draft for a fresh quote before sending if it has passed."
                  }
                },
                "description": "A priced letter. State total.display to the user before sending, and pass total.amount_cents as confirm_total_cents.",
                "additionalProperties": false
              },
              "draft_id": {
                "type": "string",
                "description": "Pass this to preview_draft, update_draft and send_letter."
              },
              "expires_at": {
                "type": "string",
                "description": "ISO 8601 instant the draft is deleted. Nothing is charged if it expires."
              },
              "page_count": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991,
                "description": "Printed pages, as counted by the renderer. Never more than 6 — a longer body is refused."
              },
              "tier_title": {
                "type": "string",
                "description": "What the price card in force calls that product, such as Standard. Use this name when you tell the user what they are buying."
              },
              "sheet_count": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991,
                "description": "Sheets of paper this letter is printed on: one page per sheet, one side each, up to 3 pages; a letter of 4 to 6 pages is printed on both sides, so it is never more than 3 sheets."
              },
              "included_pages": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991,
                "description": "Printed pages the headline price covers. This draft is priced at that total up to this many pages."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Create a Letter Draft",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "update_draft",
          "title": "Update a Letter Draft",
          "description": "Change the recipient, body, tier or colour of a draft that has not been sent, and re-price it. Returns a new page count and a new quote, so the previous total is void — state the new total to the user before sending. The 6-printed-page maximum applies to the new body as well: a replacement that renders to 7 or more pages is refused and the draft is left as it was. This creates nothing and mails nothing.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "draft_id"
            ],
            "properties": {
              "to": {
                "type": "object",
                "required": [
                  "name",
                  "line1",
                  "city",
                  "state",
                  "postal_code"
                ],
                "properties": {
                  "city": {
                    "type": "string",
                    "minLength": 1
                  },
                  "name": {
                    "type": "string",
                    "minLength": 1,
                    "description": "The person or company the letter is addressed to."
                  },
                  "line1": {
                    "type": "string",
                    "minLength": 1,
                    "description": "Street number and street name, or PO box."
                  },
                  "line2": {
                    "type": "string",
                    "description": "Apartment, suite, floor or unit."
                  },
                  "state": {
                    "type": "string",
                    "maxLength": 2,
                    "minLength": 2,
                    "description": "Two-letter US state or territory code, such as NY."
                  },
                  "postal_code": {
                    "type": "string",
                    "description": "Five-digit ZIP or ZIP+4, such as 10001 or 10001-2345."
                  }
                },
                "description": "A complete US postal address. US domestic addresses only."
              },
              "tier": {
                "enum": [
                  "standard",
                  "proof_of_mailing",
                  "certified",
                  "certified_err",
                  "registered"
                ],
                "type": "string",
                "description": "Which product to buy. Call get_pricing first and pass a tier it lists: standard is a plain First-Class letter. certified, certified_err, proof_of_mailing and registered are other products the current price card may not sell, and a tier it does not sell is refused rather than substituted — so do not describe one to the user until get_pricing has listed it."
              },
              "colour": {
                "type": "boolean",
                "description": "Omit this. The current price card prints black & white only; true is refused."
              },
              "draft_id": {
                "type": "string",
                "description": "The draft_id returned by create_draft."
              },
              "body_markdown": {
                "type": "string",
                "minLength": 1,
                "description": "Replaces the whole letter text. It must render to 6 printed pages or fewer — roughly 2,400 words of body text."
              },
              "from_address_id": {
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "draft_id",
              "page_count",
              "sheet_count",
              "tier",
              "tier_title",
              "included_pages",
              "quote",
              "expires_at",
              "note"
            ],
            "properties": {
              "note": {
                "type": "string",
                "description": "The next call to make. Read it before answering the user."
              },
              "tier": {
                "enum": [
                  "standard",
                  "proof_of_mailing",
                  "certified",
                  "certified_err",
                  "registered"
                ],
                "type": "string",
                "description": "The product this draft is priced as, as passed to create_draft or update_draft."
              },
              "quote": {
                "type": "object",
                "required": [
                  "quote_id",
                  "expires_at",
                  "version",
                  "subtotal",
                  "tax",
                  "total"
                ],
                "properties": {
                  "tax": {
                    "type": "object",
                    "required": [
                      "collected",
                      "destination_state"
                    ],
                    "properties": {
                      "collected": {
                        "type": "object",
                        "required": [
                          "amount_cents",
                          "currency",
                          "display"
                        ],
                        "properties": {
                          "display": {
                            "type": "string",
                            "description": "The amount formatted for a person, with a currency symbol."
                          },
                          "currency": {
                            "type": "string",
                            "const": "USD"
                          },
                          "amount_cents": {
                            "type": "integer",
                            "maximum": 9007199254740991,
                            "minimum": -9007199254740991,
                            "description": "The amount in whole US cents."
                          }
                        },
                        "description": "New York sales tax on this letter. We mail from New York, so a few cents apply wherever the letter goes, and more when it is going to New York.",
                        "additionalProperties": false
                      },
                      "destination_state": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  },
                  "total": {
                    "type": "object",
                    "required": [
                      "amount_cents",
                      "currency",
                      "display"
                    ],
                    "properties": {
                      "display": {
                        "type": "string",
                        "description": "The amount formatted for a person, with a currency symbol."
                      },
                      "currency": {
                        "type": "string",
                        "const": "USD"
                      },
                      "amount_cents": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "The amount in whole US cents."
                      }
                    },
                    "description": "Subtotal plus sales tax. This is the number send_letter requires in confirm_total_cents.",
                    "additionalProperties": false
                  },
                  "version": {
                    "type": "string",
                    "description": "The published price card this total came from."
                  },
                  "quote_id": {
                    "type": "string",
                    "description": "Identifier for this quote, for support and receipts."
                  },
                  "subtotal": {
                    "type": "object",
                    "required": [
                      "amount_cents",
                      "currency",
                      "display"
                    ],
                    "properties": {
                      "display": {
                        "type": "string",
                        "description": "The amount formatted for a person, with a currency symbol."
                      },
                      "currency": {
                        "type": "string",
                        "const": "USD"
                      },
                      "amount_cents": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "The amount in whole US cents."
                      }
                    },
                    "description": "What the letter costs, before sales tax.",
                    "additionalProperties": false
                  },
                  "expires_at": {
                    "type": "string",
                    "description": "ISO 8601 instant after which this total is re-computed from the live price card. Call preview_draft for a fresh quote before sending if it has passed."
                  }
                },
                "description": "A priced letter. State total.display to the user before sending, and pass total.amount_cents as confirm_total_cents.",
                "additionalProperties": false
              },
              "draft_id": {
                "type": "string",
                "description": "Pass this to preview_draft, update_draft and send_letter."
              },
              "expires_at": {
                "type": "string",
                "description": "ISO 8601 instant the draft is deleted. Nothing is charged if it expires."
              },
              "page_count": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991,
                "description": "Printed pages, as counted by the renderer. Never more than 6 — a longer body is refused."
              },
              "tier_title": {
                "type": "string",
                "description": "What the price card in force calls that product, such as Standard. Use this name when you tell the user what they are buying."
              },
              "sheet_count": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991,
                "description": "Sheets of paper this letter is printed on: one page per sheet, one side each, up to 3 pages; a letter of 4 to 6 pages is printed on both sides, so it is never more than 3 sheets."
              },
              "included_pages": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991,
                "description": "Printed pages the headline price covers. This draft is priced at that total up to this many pages."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Update a Letter Draft",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": false,
            "destructiveHint": false
          }
        },
        {
          "name": "preview_draft",
          "title": "Preview a Letter Draft",
          "description": "Return a link to the rendered PDF of a draft together with its page count and current total price. Refreshes the stored price quote when pricing has changed. Use this to show the user exactly what will be printed and exactly what it costs before calling send_letter. The total in the response is the number send_letter requires as confirm_total_cents. This does not create an order or mail a letter.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "draft_id"
            ],
            "properties": {
              "draft_id": {
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "draft_id",
              "preview_url",
              "page_count",
              "tier",
              "tier_title",
              "included_pages",
              "quote",
              "expires_at",
              "requirements"
            ],
            "properties": {
              "tier": {
                "enum": [
                  "standard",
                  "proof_of_mailing",
                  "certified",
                  "certified_err",
                  "registered"
                ],
                "type": "string",
                "description": "The product this draft is priced as, as passed to create_draft."
              },
              "quote": {
                "type": "object",
                "required": [
                  "quote_id",
                  "expires_at",
                  "version",
                  "subtotal",
                  "tax",
                  "total"
                ],
                "properties": {
                  "tax": {
                    "type": "object",
                    "required": [
                      "collected",
                      "destination_state"
                    ],
                    "properties": {
                      "collected": {
                        "type": "object",
                        "required": [
                          "amount_cents",
                          "currency",
                          "display"
                        ],
                        "properties": {
                          "display": {
                            "type": "string",
                            "description": "The amount formatted for a person, with a currency symbol."
                          },
                          "currency": {
                            "type": "string",
                            "const": "USD"
                          },
                          "amount_cents": {
                            "type": "integer",
                            "maximum": 9007199254740991,
                            "minimum": -9007199254740991,
                            "description": "The amount in whole US cents."
                          }
                        },
                        "description": "New York sales tax on this letter. We mail from New York, so a few cents apply wherever the letter goes, and more when it is going to New York.",
                        "additionalProperties": false
                      },
                      "destination_state": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  },
                  "total": {
                    "type": "object",
                    "required": [
                      "amount_cents",
                      "currency",
                      "display"
                    ],
                    "properties": {
                      "display": {
                        "type": "string",
                        "description": "The amount formatted for a person, with a currency symbol."
                      },
                      "currency": {
                        "type": "string",
                        "const": "USD"
                      },
                      "amount_cents": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "The amount in whole US cents."
                      }
                    },
                    "description": "Subtotal plus sales tax. This is the number send_letter requires in confirm_total_cents.",
                    "additionalProperties": false
                  },
                  "version": {
                    "type": "string",
                    "description": "The published price card this total came from."
                  },
                  "quote_id": {
                    "type": "string",
                    "description": "Identifier for this quote, for support and receipts."
                  },
                  "subtotal": {
                    "type": "object",
                    "required": [
                      "amount_cents",
                      "currency",
                      "display"
                    ],
                    "properties": {
                      "display": {
                        "type": "string",
                        "description": "The amount formatted for a person, with a currency symbol."
                      },
                      "currency": {
                        "type": "string",
                        "const": "USD"
                      },
                      "amount_cents": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "The amount in whole US cents."
                      }
                    },
                    "description": "What the letter costs, before sales tax.",
                    "additionalProperties": false
                  },
                  "expires_at": {
                    "type": "string",
                    "description": "ISO 8601 instant after which this total is re-computed from the live price card. Call preview_draft for a fresh quote before sending if it has passed."
                  }
                },
                "description": "A priced letter. State total.display to the user before sending, and pass total.amount_cents as confirm_total_cents.",
                "additionalProperties": false
              },
              "draft_id": {
                "type": "string"
              },
              "expires_at": {
                "type": "string"
              },
              "page_count": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991
              },
              "tier_title": {
                "type": "string",
                "description": "What the price card in force calls that product, such as Standard. Use this name when you tell the user what they are buying."
              },
              "preview_url": {
                "type": "string",
                "description": "A time-limited link to the exact PDF that will be printed. Give it to the user; it dies with the draft."
              },
              "requirements": {
                "type": "array",
                "items": {
                  "type": "string"
                },
                "description": "What the user is agreeing to: how USPS requires the envelope to be printed, and what this particular letter is. State these to the user before calling send_letter."
              },
              "included_pages": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991,
                "description": "Printed pages the headline price covers. This draft is priced at that total up to this many pages."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Preview a Letter Draft",
            "readOnlyHint": false,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "send_letter",
          "title": "Send a Physical Letter (USPS)",
          "description": "Create an order for a real, physical letter through the United States Postal Service. It returns a payment link; no paper is printed, postage is bought, or letter is mailed until payment completes. Use this whenever the user asks to mail, post, send by post, or physically send a letter, notice, or document to a street address. This is NOT email — use an email tool for email. US domestic addresses only. Requires a draft_id from create_draft and confirm_total_cents matching the current quote. The letter becomes irreversible once we print it.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "draft_id",
              "confirm_total_cents",
              "idempotency_key"
            ],
            "properties": {
              "draft_id": {
                "type": "string",
                "description": "The draft_id returned by create_draft or preview_draft."
              },
              "idempotency_key": {
                "type": "string",
                "minLength": 1,
                "description": "A key you generate once for this send. Retrying with the same draft_id and the same key returns the original letter instead of mailing a second one."
              },
              "confirm_total_cents": {
                "type": "integer",
                "maximum": 9007199254740991,
                "minimum": -9007199254740991,
                "description": "The exact total.amount_cents from the current quote, including sales tax. Say the total out loud to the user first; if it does not match the live quote this call fails and no letter is sent."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "letter_id",
              "order_id",
              "status",
              "checkout_url",
              "quote",
              "mail_date_estimate",
              "message"
            ],
            "properties": {
              "quote": {
                "type": "object",
                "required": [
                  "quote_id",
                  "expires_at",
                  "version",
                  "subtotal",
                  "tax",
                  "total"
                ],
                "properties": {
                  "tax": {
                    "type": "object",
                    "required": [
                      "collected",
                      "destination_state"
                    ],
                    "properties": {
                      "collected": {
                        "type": "object",
                        "required": [
                          "amount_cents",
                          "currency",
                          "display"
                        ],
                        "properties": {
                          "display": {
                            "type": "string",
                            "description": "The amount formatted for a person, with a currency symbol."
                          },
                          "currency": {
                            "type": "string",
                            "const": "USD"
                          },
                          "amount_cents": {
                            "type": "integer",
                            "maximum": 9007199254740991,
                            "minimum": -9007199254740991,
                            "description": "The amount in whole US cents."
                          }
                        },
                        "description": "New York sales tax on this letter. We mail from New York, so a few cents apply wherever the letter goes, and more when it is going to New York.",
                        "additionalProperties": false
                      },
                      "destination_state": {
                        "type": "string"
                      }
                    },
                    "additionalProperties": false
                  },
                  "total": {
                    "type": "object",
                    "required": [
                      "amount_cents",
                      "currency",
                      "display"
                    ],
                    "properties": {
                      "display": {
                        "type": "string",
                        "description": "The amount formatted for a person, with a currency symbol."
                      },
                      "currency": {
                        "type": "string",
                        "const": "USD"
                      },
                      "amount_cents": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "The amount in whole US cents."
                      }
                    },
                    "description": "Subtotal plus sales tax. This is the number send_letter requires in confirm_total_cents.",
                    "additionalProperties": false
                  },
                  "version": {
                    "type": "string",
                    "description": "The published price card this total came from."
                  },
                  "quote_id": {
                    "type": "string",
                    "description": "Identifier for this quote, for support and receipts."
                  },
                  "subtotal": {
                    "type": "object",
                    "required": [
                      "amount_cents",
                      "currency",
                      "display"
                    ],
                    "properties": {
                      "display": {
                        "type": "string",
                        "description": "The amount formatted for a person, with a currency symbol."
                      },
                      "currency": {
                        "type": "string",
                        "const": "USD"
                      },
                      "amount_cents": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "The amount in whole US cents."
                      }
                    },
                    "description": "What the letter costs, before sales tax.",
                    "additionalProperties": false
                  },
                  "expires_at": {
                    "type": "string",
                    "description": "ISO 8601 instant after which this total is re-computed from the live price card. Call preview_draft for a fresh quote before sending if it has passed."
                  }
                },
                "description": "A priced letter. State total.display to the user before sending, and pass total.amount_cents as confirm_total_cents.",
                "additionalProperties": false
              },
              "status": {
                "enum": [
                  "pending_payment",
                  "pending_moderation",
                  "held_for_review",
                  "queued",
                  "printed",
                  "postage_applied",
                  "accepted_by_usps",
                  "in_transit",
                  "arrived_at_destination_facility",
                  "expected_delivery",
                  "delivered",
                  "blocked",
                  "cancelled",
                  "payment_abandoned",
                  "returned"
                ],
                "type": "string",
                "description": "The current letter status, including on an idempotent replay. Nothing is printed or mailed until payment completes."
              },
              "message": {
                "type": "string",
                "description": "What to tell the user. Relay the link and the total."
              },
              "order_id": {
                "type": "string"
              },
              "letter_id": {
                "type": "string"
              },
              "checkout_url": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Give this link to the user. The letter is mailed once payment completes. Null when this call replayed a send whose payment has already completed — there is then nothing to pay and nothing to relay."
              },
              "mail_date_estimate": {
                "type": "string",
                "description": "The calendar date (YYYY-MM-DD, New York time) this piece goes to USPS if the payment lands before that day’s 14:30 cutoff."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Send a Physical Letter (USPS)",
            "readOnlyHint": false,
            "openWorldHint": true,
            "idempotentHint": true,
            "destructiveHint": true
          }
        },
        {
          "name": "get_letter_status",
          "title": "Get Letter Status",
          "description": "Return the current state of one letter: where it is, the date it goes to USPS, and the estimated delivery date. USPS does not scan plain First-Class letters at delivery, so a Standard letter ends at an expected delivery date and never reports delivery — do not tell the user a letter arrived unless the status itself says so. This creates nothing and mails nothing.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "letter_id"
            ],
            "properties": {
              "letter_id": {
                "type": "string"
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "letter_id",
              "livemode",
              "tier",
              "status",
              "description",
              "mail_date",
              "expected_delivery_estimate",
              "delivery_confirmation",
              "disclosure",
              "scans",
              "created_at",
              "cancelled_at",
              "payment"
            ],
            "properties": {
              "tier": {
                "enum": [
                  "standard",
                  "proof_of_mailing",
                  "certified",
                  "certified_err",
                  "registered"
                ],
                "type": "string"
              },
              "scans": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "phase",
                    "scanned_at",
                    "description"
                  ],
                  "properties": {
                    "phase": {
                      "type": "integer",
                      "maximum": 9007199254740991,
                      "minimum": -9007199254740991,
                      "description": "The USPS processing phase this scan came from, 0 through 4."
                    },
                    "scanned_at": {
                      "type": "string"
                    },
                    "description": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "status": {
                "enum": [
                  "pending_payment",
                  "pending_moderation",
                  "held_for_review",
                  "queued",
                  "printed",
                  "postage_applied",
                  "accepted_by_usps",
                  "in_transit",
                  "arrived_at_destination_facility",
                  "expected_delivery",
                  "delivered",
                  "blocked",
                  "cancelled",
                  "payment_abandoned",
                  "returned"
                ],
                "type": "string",
                "description": "Where the letter is. expected_delivery is the last state a standard or proof-of-mailing letter reaches; only certified tiers ever reach delivered."
              },
              "payment": {
                "type": "object",
                "required": [
                  "order_id",
                  "order_status",
                  "paid_at",
                  "total"
                ],
                "properties": {
                  "total": {
                    "type": "object",
                    "required": [
                      "amount_cents",
                      "currency",
                      "display"
                    ],
                    "properties": {
                      "display": {
                        "type": "string",
                        "description": "The amount formatted for a person, with a currency symbol."
                      },
                      "currency": {
                        "type": "string",
                        "const": "USD"
                      },
                      "amount_cents": {
                        "type": "integer",
                        "maximum": 9007199254740991,
                        "minimum": -9007199254740991,
                        "description": "The amount in whole US cents."
                      }
                    },
                    "description": "An amount of money. Always read amount_cents; display is for showing the user.",
                    "additionalProperties": false
                  },
                  "paid_at": {
                    "anyOf": [
                      {
                        "type": "string"
                      },
                      {
                        "type": "null"
                      }
                    ]
                  },
                  "order_id": {
                    "type": "string"
                  },
                  "checkout_url": {
                    "type": "string",
                    "description": "Present only while the letter is waiting for payment. Give it to the user."
                  },
                  "order_status": {
                    "enum": [
                      "pending",
                      "awaiting_payment",
                      "paid",
                      "failed",
                      "refunded",
                      "disputed",
                      "abandoned"
                    ],
                    "type": "string"
                  }
                },
                "additionalProperties": false
              },
              "livemode": {
                "type": "boolean",
                "description": "False for sandbox letters, which are never mailed."
              },
              "letter_id": {
                "type": "string"
              },
              "mail_date": {
                "type": "string",
                "description": "The calendar date (YYYY-MM-DD, New York time) this piece goes to USPS."
              },
              "created_at": {
                "type": "string"
              },
              "disclosure": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Say this to the user whenever an expected delivery date is shown."
              },
              "description": {
                "type": "string",
                "description": "One sentence for the user about where this letter is."
              },
              "cancelled_at": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ]
              },
              "delivered_at": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Certified tiers only, and absent entirely for the tiers USPS does not scan."
              },
              "tracking_url": {
                "type": "string",
                "description": "Direct USPS tracking link. Share it with the user when available."
              },
              "tracking_number": {
                "type": "string",
                "description": "USPS Certified Mail tracking number, present once the operator saves it."
              },
              "delivery_confirmation": {
                "type": "boolean",
                "description": "False for every tier USPS does not scan at delivery. Never claim otherwise."
              },
              "expected_delivery_estimate": {
                "anyOf": [
                  {
                    "type": "object",
                    "required": [
                      "earliest",
                      "latest"
                    ],
                    "properties": {
                      "latest": {
                        "type": "string"
                      },
                      "earliest": {
                        "type": "string"
                      }
                    },
                    "description": "The window (YYYY-MM-DD, New York time) USPS is expected to deliver in. USPS does not scan plain letters at delivery, so this is an estimate and never a confirmation.",
                    "additionalProperties": false
                  },
                  {
                    "type": "null"
                  }
                ]
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "Get Letter Status",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        },
        {
          "name": "list_letters",
          "title": "List Letters",
          "description": "Return this account's letters, newest first, with the status, mail date and total for each. Use this to answer questions about what has already been sent. This creates nothing, changes nothing and mails nothing.",
          "inputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "properties": {
              "limit": {
                "type": "integer",
                "maximum": 100,
                "minimum": 1,
                "description": "Defaults to 20."
              },
              "starting_after": {
                "type": "string",
                "description": "The next_cursor from the previous call, to read the following page."
              }
            }
          },
          "outputSchema": {
            "type": "object",
            "$schema": "https://json-schema.org/draft/2020-12/schema",
            "required": [
              "letters",
              "has_more",
              "next_cursor"
            ],
            "properties": {
              "letters": {
                "type": "array",
                "items": {
                  "type": "object",
                  "required": [
                    "letter_id",
                    "status",
                    "tier",
                    "created_at",
                    "mail_date",
                    "total",
                    "destination_state"
                  ],
                  "properties": {
                    "tier": {
                      "enum": [
                        "standard",
                        "proof_of_mailing",
                        "certified",
                        "certified_err",
                        "registered"
                      ],
                      "type": "string"
                    },
                    "total": {
                      "type": "object",
                      "required": [
                        "amount_cents",
                        "currency",
                        "display"
                      ],
                      "properties": {
                        "display": {
                          "type": "string",
                          "description": "The amount formatted for a person, with a currency symbol."
                        },
                        "currency": {
                          "type": "string",
                          "const": "USD"
                        },
                        "amount_cents": {
                          "type": "integer",
                          "maximum": 9007199254740991,
                          "minimum": -9007199254740991,
                          "description": "The amount in whole US cents."
                        }
                      },
                      "description": "An amount of money. Always read amount_cents; display is for showing the user.",
                      "additionalProperties": false
                    },
                    "status": {
                      "enum": [
                        "pending_payment",
                        "pending_moderation",
                        "held_for_review",
                        "queued",
                        "printed",
                        "postage_applied",
                        "accepted_by_usps",
                        "in_transit",
                        "arrived_at_destination_facility",
                        "expected_delivery",
                        "delivered",
                        "blocked",
                        "cancelled",
                        "payment_abandoned",
                        "returned"
                      ],
                      "type": "string",
                      "description": "Where the letter is. expected_delivery is the last state a standard or proof-of-mailing letter reaches; only certified tiers ever reach delivered."
                    },
                    "letter_id": {
                      "type": "string"
                    },
                    "mail_date": {
                      "type": "string"
                    },
                    "created_at": {
                      "type": "string"
                    },
                    "destination_state": {
                      "type": "string"
                    }
                  },
                  "additionalProperties": false
                }
              },
              "has_more": {
                "type": "boolean"
              },
              "next_cursor": {
                "anyOf": [
                  {
                    "type": "string"
                  },
                  {
                    "type": "null"
                  }
                ],
                "description": "Pass this back as starting_after for the next page."
              }
            },
            "additionalProperties": false
          },
          "annotations": {
            "title": "List Letters",
            "readOnlyHint": true,
            "openWorldHint": false,
            "idempotentHint": true,
            "destructiveHint": false
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [
        {
          "name": "letter-card",
          "uri": "ui://paperagent/letter-card.html?v=7",
          "mimeType": "text/html;profile=mcp-app",
          "description": "The letter as it will be printed: the page-one image, who it is addressed to, the price with sales tax and the total, and a Send button that asks the host to collect the payment."
        },
        {
          "name": "status-timeline",
          "uri": "ui://paperagent/status-timeline.html?v=7",
          "mimeType": "text/html;profile=mcp-app",
          "description": "Where one letter has got to: the states it has passed through, the date it goes to USPS, and the expected delivery window with the note that a Standard letter is never scanned at delivery."
        },
        {
          "name": "pricing-table",
          "uri": "ui://paperagent/pricing-table.html?v=7",
          "mimeType": "text/html;profile=mcp-app",
          "description": "The published price list: each tier with its total and whether USPS confirms delivery, the per-page and colour add-ons, the volume price table, and the page and weight limits."
        },
        {
          "name": "letters-list",
          "uri": "ui://paperagent/letters-list.html?v=7",
          "mimeType": "text/html;profile=mcp-app",
          "description": "The account's letters, newest first, with the status, mail date and total for each, and a control to open one of them."
        }
      ],
      "prompts": []
    },
    "instructions": "PaperAgent prints and mails real paper letters through the United States Postal Service from New York City. It is not email.\n\nReach for these tools only when the user wants something delivered on paper. If the user asks to email, fax or text something, none of these tools apply — say that this connector only mails physical letters, and ask whether they would like one sent instead of assuming. If the user asks you to write, draft or print something they will handle themselves, write it in your reply and stop there; offering to mail it afterwards is welcome, drafting it here first is not. When the request does not say how it should reach the recipient, ask before creating a draft.\n\nWork in this order: validate_address, then create_draft, then preview_draft, and show the user the letter and the exact total before calling send_letter. send_letter requires that total echoed back as confirm_total_cents plus an idempotency_key you generate once. It charges nothing and prints nothing: it answers with a payment link to give the user, and the letter is printed and mailed on its own once that payment completes. Do not call send_letter a second time for the same letter. Once we print the letter, the piece is irreversible. US domestic addresses only.\n\nget_pricing and validate_address work without signing in. Every other tool needs authorization and answers 401 until the user connects."
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}