{
  "intents": [
    "hotel.pick",
    "deal.pick",
    "world.pick"
  ],
  "intent": "hotel.pick",
  "describe": "https://pickthehotel.com/intents.md",
  "usage": "POST /intents { \"city\": \"zurich\", \"mode\": \"iconic|afflux|value|budget|family\", \"near\": \"<landmark>\"|{lat,lng}, \"children\": 1|2|3, \"limit\": 3 }. Or GET the same fields as query params. (iconic = the grande dames; afflux = affordable luxury.)",
  "usageGet": "GET /intents?city=zurich&mode=iconic  (also &near=, &children=, &limit=; &lat=&lng= for near-me now; &intent=world.pick for the world list)",
  "usagePath": "GET /intents/zurich/iconic  (path form: /intents/<city>[/<mode>], or /intents/world; survives fetch tools that strip query strings)",
  "usageDeal": "POST /intents { \"intent\": \"deal.pick\", \"city\": \"bangkok\" }  ->  genuine 5-star hotels at the season they're cheapest (the bargain date + % off vs peak), straight from precomputed data.",
  "citiesLive": [
    {
      "slug": "zurich",
      "name": "Zürich"
    },
    {
      "slug": "london",
      "name": "London"
    },
    {
      "slug": "paris",
      "name": "Paris"
    },
    {
      "slug": "newyork",
      "name": "New York"
    },
    {
      "slug": "tokyo",
      "name": "Tokyo"
    },
    {
      "slug": "bangkok",
      "name": "Bangkok"
    },
    {
      "slug": "dubai",
      "name": "Dubai"
    },
    {
      "slug": "singapore",
      "name": "Singapore"
    },
    {
      "slug": "istanbul",
      "name": "Istanbul"
    },
    {
      "slug": "hongkong",
      "name": "Hong Kong"
    }
  ],
  "modes": [
    "iconic",
    "afflux",
    "value",
    "budget",
    "family"
  ],
  "world": {
    "usage": "POST /intents { \"intent\": \"world.pick\" }  or  GET /intents?intent=world.pick",
    "returns": "the curated 'most iconic hotels in the world' list (editorial, one per country); an agent may also send city=world"
  },
  "note": "`near` accepts a famous place (\"Louvre\", \"Tower Hill\") OR coordinates { lat, lng } for \"a hotel near me now\": with coordinates you can omit `city` and we route to the nearest live city. Omit `near` to use the mode's default anchor. Family is pre-computed for 2 adults + 1, 2 or 3 children in one room. Prices are shown in each city's local currency. For the world's most iconic hotels (not a specific city), use the `world.pick` intent above."
}