{
  "service": "Num for Partners",
  "mcp": "POST /api/partner/mcp (JSON-RPC 2.0, streamable-HTTP MCP)",
  "tools": [
    {
      "name": "search_places",
      "description": "Find real, currently-operating places near a location — restaurants, bars, beaches, spas, viewpoints, temples."
    },
    {
      "name": "concierge_answer",
      "description": "Ask Num the way a traveller would — \"where should we eat tonight near Kata?\", \"which beach for sunset?\" — and get a short concierge answer grounded in Num's verified directory, plus the places it names as structured data so you can render your own cards."
    },
    {
      "name": "list_destinations",
      "description": "Which destinations Num covers, with the number of verified places in each."
    },
    {
      "name": "place_details",
      "description": "Everything Num holds on one place, by place_id from search_places: contact details, hours, rating, review count, area, category and photo attribution."
    },
    {
      "name": "open_places",
      "description": "Places that are OPEN RIGHT NOW in a destination, computed in the destination's own timezone."
    },
    {
      "name": "booking_link",
      "description": "A booking page for one place with the party size, date and time ALREADY FILLED IN."
    }
  ],
  "auth": "Optional X-Partner-Key. Unkeyed calls work so you can evaluate before you sign anything: discovery (initialize, tools/list) is never throttled, and unkeyed tools/call is limited to 12 per minute per IP and is unattributed. Send a key for a partner-scoped ceiling and an attributed monthly quota — POST /api/partner/signup.",
  "bookings": {
    "note": "This surface never books, charges, or accepts personal data. Confirmed bookings live on a separate keyed surface.",
    "mcp": "POST /api/concierge/mcp (X-Partner-Key required)",
    "index": "GET /api/concierge"
  },
  "attribution": "Places © OpenStreetMap contributors (ODbL) and Google, verified by Num. This attribution must be displayed wherever these results are shown.",
  "contact": "partners@itsnum.com"
}