{
  "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 in a destination — 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, cuisine, the venue's own short description (`about`), coordinates, `open_now` computed in the destination's timezone (true / false / null — null means Num has not verified the hours, NOT that it is closed), the booking platform and — only where a verified owner chose it — the venue's own booking page, a recently-read published price line where Num holds one, and up to 8 approved member photos plus the listing photo, each with its own `attribution` you MUST show alongside it."
    },
    {
      "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."
    },
    {
      "name": "get_menu",
      "description": "The venue's own published menu or list of offerings — dishes, treatments, tours — grouped by the venue's sections in the venue's order."
    },
    {
      "name": "get_reviews",
      "description": "A rating SUMMARY for one place, free (included in the no-fee free tier) — no review text and no reviewer identities, ever."
    },
    {
      "name": "directory_feed",
      "description": "Bulk, paged sync of every place Num lists in one destination — free (included in the no-fee free tier; one call returns up to 200 places), for keeping your own copy of the directory current instead of searching it call by call."
    }
  ],
  "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 session (send back the Mcp-Session-Id from initialize; without it, 12 per minute per IP), up to 600 per minute per IP, and is unattributed. Send a key for a partner-scoped ceiling and an attributed monthly quota — POST /api/partner/signup.",
  "pricing": {
    "free": "10,000 calls a month. No monthly fee. The directory, place details, menus, the reviews summary and booking links are all free within it. Attribution required on every rendered result.",
    "paid": "directory $0.002/call, concierge $0.03/call, platform $299/mo to 1,000,000 calls + 10% rev-share",
    "compare": "OpenTable's Booking API is $8,000/month and its Reviews API $3,335/month. Num's directory, menus, reviews summary and booking requests have no monthly fee.",
    "tiers": {
      "free": {
        "monthly_limit": 10000,
        "per_min": 30,
        "note": "No monthly fee. The directory, place details, menus, the reviews summary and booking links are all free within it. Attribution required on every rendered result."
      },
      "partner": {
        "monthly_limit": 250000,
        "per_min": 120,
        "note": "Flat monthly tier. 120 calls/min. Attribution still required."
      },
      "directory": {
        "usd_per_call": 0.002,
        "per_min": 120,
        "note": "Directory reads past the free allowance: search_places, open_places, place_details, directory_feed, get_menu, get_reviews."
      },
      "concierge": {
        "usd_per_call": 0.03,
        "per_min": 60,
        "note": "concierge_answer — the whole product in one call."
      },
      "platform": {
        "usd_month": 299,
        "monthly_limit": 1000000,
        "per_min": 600,
        "rev_share_pct": 10,
        "note": "Flat to 1M calls + 10% rev-share on bookings originated."
      }
    },
    "signup": "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"
}