{
  "tools": [
    {
      "name": "price_paid_pack",
      "description": "Paid pack of HM Land Registry Price Paid sales for a UK postcode, postcode district (outward code e.g. M1 / DN1), or town/area name. Returns up to `size` recent sales (default 25, max 100): address, price, date, property type, tenure. Requires Stripe Checkout (£0.49) then a one-time bearer token. Data from landregistry.data.gov.uk Linked Data / SPARQL (England & Wales residential only; Scotland/NI not covered; monthly lag; town/outcode queries can be slow on first miss then KV-cached 24h).",
      "method": "POST",
      "path": "/v1/packs/price-paid",
      "body": {
        "area": "string (required) — full postcode, outward code, or town name",
        "size": "number (optional, default 25, max 100)"
      },
      "auth": "Authorization: Bearer <one-time-token> or ?token= after checkout"
    },
    {
      "name": "area_comps_pack",
      "description": "Paid compound comps pack for a UK postcode / outcode / town: Price Paid sample + summary stats (median/mean/min/max, by property type) + honest risk_flags (e.g. thin_sample, england_wales_only). Requires Stripe Checkout (£0.49) then a one-time bearer token. Soft-Offer outbound is OFF.",
      "method": "POST",
      "path": "/v1/packs/area-comps",
      "body": {
        "area": "string (required) — full postcode, outward code, or town name",
        "size": "number (optional, default 25, max 100)"
      },
      "auth": "Authorization: Bearer <one-time-token> or ?token= after checkout"
    },
    {
      "name": "redeem_pack",
      "description": "Redeem a paid Stripe Checkout session (success redirect). Returns price-paid or area-comps pack JSON once, based on session product.",
      "method": "GET",
      "path": "/v1/packs/redeem?session_id=cs_..."
    },
    {
      "name": "price_paid_discover",
      "description": "Free peek: up to 5 HM Land Registry Price Paid sales for a postcode / outcode / town (e.g. M1). Cached 24h. For MCP tool discovery / samples. Soft-Offer outbound is OFF.",
      "method": "GET",
      "path": "/v1/discover/price-paid?area=M1"
    }
  ],
  "mcp": {
    "endpoint": "/mcp",
    "transport": "streamable-http"
  },
  "how_agents_use_this": "BASE=https://uk-lr-mcp.donniertf.workers.dev\n\n# 1) Discover tools (free)\ncurl -s \"$BASE/tools\" | jq .\n\n# 2) Free peek (≤5 sales)\ncurl -s \"$BASE/v1/discover/price-paid?area=M1\" | jq .\n\n# 3) Buy a pack → Stripe Checkout URL (402)\ncurl -s -X POST \"$BASE/v1/packs/price-paid\" \\\n  -H 'content-type: application/json' \\\n  -d '{\"area\":\"M1 1AE\",\"size\":25}' | jq .\n\n# 4) After payment, redeem or POST with Bearer token\ncurl -s -X POST \"$BASE/v1/packs/price-paid\" \\\n  -H \"Authorization: Bearer $TOKEN\" \\\n  -H 'content-type: application/json' \\\n  -d '{\"area\":\"M1 1AE\"}' | jq ."
}