Skip to content

Book a Served venue from an AI assistant

A venue on Served can let AI assistants check its free times and request a table for a guest. Each venue has its own endpoint that speaks the Model Context Protocol (MCP). It is off until the venue's owner or manager switches it on, and it needs no key.

What an assistant can do

  • Venue facts get_venue

    The venue’s public facts: name, address, phone, website, cuisine, price range, opening hours for the next 14 days with any changed dates, and its online booking limits (largest party, notice and how far ahead).

  • Menu get_menu

    The venue’s published menus: each dish or drink with its description, price where the venue shows prices, allergens and dietary flags (vegetarian, vegan, gluten free). Allergen information comes from the venue; the guest should confirm it with staff.

  • Check availability check_availability

    The start times the venue takes online bookings for on a date, for a party size. Nothing is held: a time can be gone when the booking is requested.

    • date (string, required) The date, YYYY-MM-DD, on the venue’s own calendar.
    • party (integer, required) How many people, the guest included.
  • Request a booking request_booking

    Books a table on the guest’s behalf, with the guest’s consent, under the venue’s own booking rules. The answer is confirmed, or requested when the venue confirms bookings itself, with a reference and a link where the guest manages the booking. When the venue takes a deposit or a card guarantee the answer carries a payment link the guest must open and complete by the time given; until then the table is only held.

    • name (string, required) The guest’s name, as the venue should greet them.
    • phone (string, required) The guest’s phone number, with the country code.
    • email (string, optional) Optional. Where the venue sends the confirmation.
    • notes (string, optional) Optional. Anything the venue should know, such as an occasion.
    • party (integer, required) How many people, the guest included.
    • date (string, required) The date, YYYY-MM-DD, on the venue’s own calendar.
    • time (string, required) The start time, HH:mm on the venue’s clock, one of the times check_availability gave.

Connect

  • Endpoint: https://served.global/api/mcp/{venueSlug}, one per venue.
  • JSON-RPC 2.0 over streamable HTTP. Send each message as a POST. The answer is JSON; the endpoint keeps no session and opens no event stream.
  • MCP protocol versions: 2025-06-18, 2025-03-26.
  • No key and no account. The limits below apply to everyone.
curl -s https://served.global/api/mcp/{venueSlug} \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
curl -s https://served.global/api/mcp/{venueSlug} \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"check_availability","arguments":{"date":"2026-12-05","party":2}}}'

Which venues

Only venues that switched AI assistant booking on. The machine-readable listing at https://served.global/api/mcp names them with their endpoints, next to the tools, their schemas and the limits. A venue that switched it on also names its endpoint in the llms.txt of its own site. Every other venue answers Not found.

Booking rules

  • Ask the guest first. A booking is requested on the guest's behalf, with their consent.
  • A booking goes through the same path as the venue's own booking page, so the venue's limits, deposits and seating all apply.
  • Checking free times holds nothing. A time can be gone when the booking is requested.
  • The answer is confirmed, or requested when the venue confirms bookings itself, and carries a reference.
  • The venue sees that the booking came from an AI assistant.

Limits

  • 600 requests an hour from one address, across all venues.
  • 120 requests an hour from one address to one venue.
  • 20 booking requests an hour for one venue, from all assistants together.
  • A message of up to 64 KB.
  • Past a limit the endpoint answers 429. Wait and try again.

Privacy

The endpoint writes no message, argument or answer to a log, and Served sends nothing from it to an AI model. A booking is stored at the venue like any other booking. See the privacy policy.

For venues

In Served, open Visibility, then AI assistants, and switch on Let AI assistants book. Only an owner or a manager can change it. Served is not listed in any assistant's own directory yet: an assistant reaches your venue when its user or its developer adds your endpoint.

Optional analytics helps us improve Served: Google Analytics on this site, product analytics in the app and, on venue booking pages, the venue’s ad pixels (Meta, Google, TikTok). Declining does not limit any feature. Cookie Policy