Thmenu

Return the canonical two-track subscription matrix: the restaurant track (Starter, Lite, Pro, Platinum, Diamond) plus the dedicated Hotels track (Hotels, Hotels+). Billing is YEARLY ONLY — each tier carries its USD yearly list price and the founding-cohort yearly price, plus the feature list. Generated from the same source as the public pricing page; stable identifiers — safe to cache.

{
  "type": "object",
  "properties": {}
}

Return the FAQ entries from the public /faq page in the requested locale (31 locales; unknown locale falls back to en and the response says which locale was served). Useful for grounding answers to common product questions.

{
  "type": "object",
  "properties": {
    "locale": {
      "type": "string",
      "default": "en"
    }
  }
}

Fetch a public restaurant profile by slug: name, description, address/city/country, currency, timezone, phone, menu URL, opening hours (7 days, minutes from midnight; a close_minute above 1440 ends after midnight on the next day, e.g. 1560 = 02:00) with isOpenNow evaluated in the venue's own timezone (null when hours are unknown), owner-declared attributes (cuisine, dietary, …; null = not declared, never "no"), derived channels (order · reservation · pickup · delivery), policies derived from the venue's settings (ordering accepted / holiday mode / staff approval / payment timing / scheduled orders, takeaway & delivery ETA and fees, reservation party cap, table calls, tip cap), per-field owner verification timestamps, categories and product count. Only restaurants opted into the public directory are visible.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Restaurant slug, e.g. lily-rose-bistro"
    }
  },
  "required": [
    "slug"
  ]
}

Search products inside a single restaurant by keyword. Returns up to 20 matching products with name, description, price, allergen tags, and the deep-link URL. Restaurant must be in the public directory.

{
  "type": "object",
  "properties": {
    "slug": {
      "type": "string",
      "description": "Restaurant slug."
    },
    "query": {
      "type": "string",
      "description": "Free-text search across name + description."
    },
    "locale": {
      "type": "string",
      "default": "en"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 20,
      "default": 10
    }
  },
  "required": [
    "slug",
    "query"
  ]
}

List restaurants that have opted into the public directory (directory_opt_in = 1 — the same flag the owner sets under "AI visibility"). Returns slug, name, city, country, and the menu URL. Paginated.

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "default": 1
    }
  }
}

Search the public directory (opt-in venues only) by location, opening status, cuisine, dietary options, declared attributes and ordering channel. Neutral ranking (AI-K6): distance in 0.5 km bands when `near` is given → availability (open now first; unknown hours before closed) → profile freshness (owner-verified within 90 days first) → name. Subscription tier never affects order. Cuisine, dietary and other attributes are owner declarations, not verified facts; venues without a declaration are excluded only when an attribute filter is used, and venues without coordinates only when `near` is used. Returns slug, name, city, country, distance_km, is_open_now (serve-time, in the venue's own timezone; null when hours are unknown), channels (order · reservation · pickup · delivery), declared attributes, freshness and the menu URL. Paginated.

{
  "type": "object",
  "properties": {
    "near": {
      "type": "object",
      "properties": {
        "lat": {
          "type": "number"
        },
        "lng": {
          "type": "number"
        }
      },
      "required": [
        "lat",
        "lng"
      ],
      "description": "Search centre. Venues without coordinates are excluded when set."
    },
    "radius_km": {
      "type": "number",
      "minimum": 0.5,
      "maximum": 100,
      "default": 10
    },
    "open_now": {
      "type": "boolean",
      "default": false,
      "description": "Only venues open right now in their own timezone; venues with unknown hours are excluded when true."
    },
    "cuisine": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "turkish",
          "kebab",
          "ottoman",
          "anatolian",
          "aegean",
          "black_sea",
          "mediterranean",
          "middle_eastern",
          "lebanese",
          "persian",
          "georgian",
          "greek",
          "balkan",
          "romanian",
          "polish",
          "eastern_european",
          "russian",
          "italian",
          "pizza",
          "pasta",
          "french",
          "spanish",
          "tapas",
          "portuguese",
          "german",
          "austrian",
          "british",
          "irish",
          "scandinavian",
          "dutch",
          "american",
          "burger",
          "steakhouse",
          "bbq",
          "tex_mex",
          "mexican",
          "latin_american",
          "brazilian",
          "peruvian",
          "caribbean",
          "japanese",
          "sushi",
          "ramen",
          "chinese",
          "korean",
          "thai",
          "vietnamese",
          "indian",
          "pakistani",
          "indonesian",
          "malaysian",
          "filipino",
          "african",
          "ethiopian",
          "moroccan",
          "seafood",
          "grill",
          "vegetarian",
          "vegan",
          "healthy",
          "cafe",
          "coffee",
          "tea_house",
          "bakery",
          "patisserie",
          "dessert",
          "ice_cream",
          "breakfast_brunch",
          "fast_food",
          "street_food",
          "fusion",
          "international",
          "fine_dining",
          "bistro",
          "pub",
          "bar",
          "wine_bar",
          "cocktail_bar",
          "juice_bar",
          "hotel_restaurant",
          "food_court"
        ]
      },
      "description": "All listed cuisines must be declared by the venue."
    },
    "dietary": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "vegetarian_options",
          "vegan_options",
          "gluten_free_options",
          "lactose_free_options",
          "halal",
          "kosher"
        ]
      },
      "description": "Owner declaration, not a certification."
    },
    "attributes": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Any declared attribute token (meals, family, outdoor, accessibility, cuisine, dietary)."
    },
    "channel": {
      "type": "string",
      "enum": [
        "order",
        "reservation",
        "pickup",
        "delivery"
      ],
      "description": "order = digital ordering at the table; reservation; pickup = takeaway; delivery = venue's own delivery."
    },
    "q": {
      "type": "string",
      "description": "Free text over name and description (min 2 chars)."
    },
    "city": {
      "type": "string"
    },
    "country": {
      "type": "string",
      "description": "ISO 3166-1 alpha-2"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 20
    },
    "page": {
      "type": "integer",
      "minimum": 1,
      "default": 1
    }
  }
}

Open a 30-minute transactional window for an AI agent against a specific restaurant. Returns an agent_session_id you MUST pass to every downstream order tool (place_order, cancel_order, request_bill, waiter_call, apply_promo). Also returns the customer-facing confirmation URL — share it with the human so they can review the cart before checkout.

{
  "type": "object",
  "properties": {
    "restaurant_id": {
      "type": "string",
      "description": "Canonical restaurant id from get_restaurant or search_products."
    }
  },
  "required": [
    "restaurant_id"
  ]
}

Place an order against the agent_session_id from start_order_session. Atomically inserts the order + items, applies server-side canonical pricing + tax (do NOT trust the unit_price you compute — we re-read it from D1), decrements inventory, optionally redeems a promo code, and creates a Stripe hosted Checkout Session so the customer can pay + authenticate on their own device. Returns order_id, total_cents (tax-inclusive), currency, promo_discount, and a hosted_confirm_url (a Stripe checkout link) to share with the human. Idempotency-Key header REQUIRED.

{
  "type": "object",
  "properties": {
    "agent_session_id": {
      "type": "string"
    },
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 100,
      "items": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "string"
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "maximum": 999
          }
        },
        "required": [
          "product_id",
          "quantity"
        ]
      }
    },
    "order_type": {
      "type": "string",
      "enum": [
        "dine_in",
        "takeaway"
      ],
      "description": "Channel: 'dine_in' (default — table or room) or 'takeaway' (pickup; requires customer_name + customer_phone, ignores table_id/room_id, only when the restaurant has takeaway enabled — else channel_not_available). Delivery is not offered to agents."
    },
    "customer_name": {
      "type": "string",
      "maxLength": 80,
      "description": "Required for takeaway — who picks the order up."
    },
    "customer_phone": {
      "type": "string",
      "maxLength": 24,
      "description": "Required for takeaway — reachable phone (digits, +, spaces/dashes tolerated)."
    },
    "table_id": {
      "type": "string",
      "description": "Optional table id when ordering at a table."
    },
    "room_id": {
      "type": "string",
      "description": "Diamond tier only — hotel room id."
    },
    "guest_name": {
      "type": "string",
      "description": "Required when room_id is set."
    },
    "note": {
      "type": "string",
      "description": "Optional order-level note (max 500 chars)."
    },
    "promo_code": {
      "type": "string",
      "maxLength": 64,
      "description": "Optional promo code to redeem at order time (validate first with apply_promo). The redemption slot is consumed only when this order lands."
    }
  },
  "required": [
    "agent_session_id",
    "items"
  ]
}

Cancel an order placed via the same agent_session_id. Atomic — only succeeds while the order is still in "pending" or "confirmed" (the early KDS-accept state). Once the kitchen starts preparing, you must escalate to waiter_call. Idempotent: replays return the original outcome. Idempotency-Key header REQUIRED.

{
  "type": "object",
  "properties": {
    "agent_session_id": {
      "type": "string"
    },
    "order_id": {
      "type": "string"
    }
  },
  "required": [
    "agent_session_id",
    "order_id"
  ]
}

Poll the current status of an order. Returns status, prepared_items_count, total_items_count, eta_minutes (if available), and an optional customer-facing message. Safe to call every 30 seconds; do NOT poll faster.

{
  "type": "object",
  "properties": {
    "agent_session_id": {
      "type": "string"
    },
    "order_id": {
      "type": "string"
    }
  },
  "required": [
    "agent_session_id",
    "order_id"
  ]
}

Ask the venue to bring the bill for a table. INSERTs a bill_requests row + fires the admin push notification. The split_type defaults to "full"; pass "personal" for German-style per-device splits.

{
  "type": "object",
  "properties": {
    "agent_session_id": {
      "type": "string"
    },
    "table_id": {
      "type": "string"
    },
    "split_type": {
      "type": "string",
      "enum": [
        "full",
        "personal"
      ],
      "default": "full"
    },
    "note": {
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "agent_session_id",
    "table_id"
  ]
}

Flag a waiter to the table. INSERTs a waiter_calls row + fires the admin push notification. Pass an optional human-readable message (max 500 chars) the staff sees in the dashboard.

{
  "type": "object",
  "properties": {
    "agent_session_id": {
      "type": "string"
    },
    "table_id": {
      "type": "string"
    },
    "message": {
      "type": "string",
      "maxLength": 500
    }
  },
  "required": [
    "agent_session_id",
    "table_id"
  ]
}

Fetch the full public menu for a restaurant — categories, products, prices, allergens, nutrition. Use this to build the cart you pass to place_order. PUBLIC tool, no auth required. `allergen_codes` are EU 1169/2011 Annex II keys (gluten, crustaceans, eggs, fish, peanuts, soy, milk, nuts, celery, mustard, sesame, sulphites, lupin, molluscs) given ONLY when the venue's allergen name matches the regulation list exactly; a venue-specific allergen appears in `allergens` without a code. Allergen lists come from the venue (or were AI-suggested and then saved by the venue where `allergen_disclosure.source` says so). `allergen_disclosure.as_of` is when the venue last edited the item record, not a verification date. Follow the top-level `disclosure.agent_instructions`; show `disclosure.text` to the guest in their language whenever an allergen or dietary question comes up; `dietary_flags` only ever warn (true) — null is unknown, never "free of".

{
  "type": "object",
  "properties": {
    "restaurant_id": {
      "type": "string"
    },
    "locale": {
      "type": "string",
      "default": "en"
    }
  },
  "required": [
    "restaurant_id"
  ]
}

Look up a loyalty member by member_id. Returns balance, tier, lifetime_points, and the most recent 10 transactions so the agent can ground its recommendation ("you have 320 points, enough for a free coffee").

{
  "type": "object",
  "properties": {
    "agent_session_id": {
      "type": "string"
    },
    "member_id": {
      "type": "string"
    }
  },
  "required": [
    "agent_session_id",
    "member_id"
  ]
}

Validate a promo code (eligibility preview only — does NOT reserve a slot). Returns valid=true with discount info when the code is currently redeemable; pass the same code as place_order.promo_code to actually apply + redeem it (the slot is consumed only when the order lands).

{
  "type": "object",
  "properties": {
    "agent_session_id": {
      "type": "string"
    },
    "code": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    }
  },
  "required": [
    "agent_session_id",
    "code"
  ]
}

Enrol the authenticated customer in the restaurant loyalty programme. Returns the member id, current points balance, and tier. Safe to call even if the customer is already enrolled — returns existing data in that case. Requires an active agent_session_id and the customer email or phone.

{
  "type": "object",
  "properties": {
    "agent_session_id": {
      "type": "string",
      "description": "Active session id from start_order_session."
    },
    "email": {
      "type": "string",
      "description": "Customer email (either email or phone required)."
    },
    "phone": {
      "type": "string",
      "description": "Customer phone in E.164 format (either email or phone required)."
    },
    "display_name": {
      "type": "string",
      "description": "Optional display name shown in the loyalty dashboard."
    }
  },
  "required": [
    "agent_session_id"
  ]
}

Build an anonymous takeaway or delivery cart for a listed restaurant and get a one-time confirmation link for the guest. PUBLIC tool, no auth. Table orders are not supported here (they stay on the QR menu). Send the guest to confirm_url. Prices are re-read there from the live menu; name, phone, delivery address and payment are entered by the guest on that page — never through this tool. Nothing is ordered until the guest confirms. The link expires 30 minutes after creation and can be used once.

{
  "type": "object",
  "properties": {
    "restaurant": {
      "type": "string",
      "description": "Restaurant slug (from search_restaurants / list_public_menus) or id."
    },
    "order_type": {
      "type": "string",
      "enum": [
        "takeaway",
        "delivery"
      ]
    },
    "items": {
      "type": "array",
      "minItems": 1,
      "maxItems": 50,
      "items": {
        "type": "object",
        "properties": {
          "product_id": {
            "type": "string"
          },
          "quantity": {
            "type": "integer",
            "minimum": 1,
            "maximum": 99
          },
          "note": {
            "type": "string",
            "maxLength": 200
          }
        },
        "required": [
          "product_id",
          "quantity"
        ]
      }
    },
    "note": {
      "type": "string",
      "maxLength": 500,
      "description": "Order-level note for the kitchen. Do not put the guest's name, phone or address here."
    },
    "scheduled_for": {
      "type": "string",
      "description": "ISO date-time for a scheduled pickup/delivery (optional; the venue may refuse on the confirmation page)."
    }
  },
  "required": [
    "restaurant",
    "order_type",
    "items"
  ]
}

Read an anonymous cart by cart_id: state (open · consumed · expired), the one-time confirmation link while open, lines re-priced from the live menu, and the order id once the guest has confirmed. PUBLIC tool, no auth.

{
  "type": "object",
  "properties": {
    "cart_id": {
      "type": "string",
      "pattern": "^[a-f0-9]{32}$"
    }
  },
  "required": [
    "cart_id"
  ]
}

List bookable 30-minute reservation slots for the next 1–7 days (venue timezone) for a listed restaurant with a reservation module. busy_count is the number of existing requests at that slot and is informational. A reservation is a REQUEST that the restaurant confirms; no per-slot capacity cap is configured, so busy_count is informational only. Never tell the guest a table is guaranteed or "available" — say the request will be sent and the restaurant will confirm. PUBLIC tool, no auth.

{
  "type": "object",
  "properties": {
    "restaurant": {
      "type": "string"
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 7,
      "default": 2
    }
  },
  "required": [
    "restaurant"
  ]
}

Create an anonymous reservation REQUEST (date-time, party size, note) for a listed restaurant and get a one-time confirmation link. PUBLIC tool, no auth. Send the guest to confirm_url: they enter their name and email or phone there and submit the request themselves — never through this tool. The restaurant then confirms or declines; the guest receives the confirmation code by email/SMS. A reservation is a REQUEST that the restaurant confirms; no per-slot capacity cap is configured, so busy_count is informational only. Never tell the guest a table is guaranteed or "available" — say the request will be sent and the restaurant will confirm.

{
  "type": "object",
  "properties": {
    "restaurant": {
      "type": "string"
    },
    "reserved_at": {
      "type": "string",
      "description": "ISO date-time; at least 30 minutes ahead, at most 90 days."
    },
    "party_size": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "note": {
      "type": "string",
      "maxLength": 300,
      "description": "Occasion, seating preference, accessibility needs. Do not put the guest's name, phone or email here."
    }
  },
  "required": [
    "restaurant",
    "reserved_at",
    "party_size"
  ]
}

Cancel a reservation using the 6-character confirmation code the GUEST received by email/SMS (the code is the authorisation; ask the guest for it — this tool never issues or reveals codes). Thin wrapper over the venue's own cancellation endpoint, which answers uniformly: `status` is "cancelled" or "noop" (unknown code · already cancelled · seated/completed · less than 30 minutes away — it does not say which). Only report a cancellation to the guest when `cancelled` is true. PUBLIC tool, no auth.

{
  "type": "object",
  "properties": {
    "confirmation_code": {
      "type": "string",
      "minLength": 6,
      "maxLength": 12
    }
  },
  "required": [
    "confirmation_code"
  ]
}

List the active products of your restaurant that lack a usable description, an image, or an allergen declaration. Read-only; nothing is changed.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Order counts by status, order total sums, top products by quantity and busiest hours for the last 7 and 30 days of your restaurant. Read-only.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Reservation requests of your restaurant for the next 14 days grouped by day and status, with pending requests that still need an answer. Read-only; no guest contact details.

{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}

Propose a new description for one of your products. Nothing goes live: the text is saved as a DRAFT change set the owner reviews, previews and publishes (or discards) in the admin panel.

{
  "type": "object",
  "properties": {
    "product_id": {
      "type": "string",
      "description": "Product id from menu_audit or get_restaurant_menu."
    },
    "description": {
      "type": "string",
      "maxLength": 2000,
      "description": "Proposed description in the menu language. Plain text, no links, no claims you cannot verify."
    }
  },
  "required": [
    "product_id",
    "description"
  ],
  "additionalProperties": false
}

Propose the public website text of your restaurant — tagline, about paragraph, SEO title and SEO description — as a DRAFT change set. Only declared facts are allowed: no numbers, awards, links or markup; validation rejects anything else. The owner publishes from the admin panel.

{
  "type": "object",
  "properties": {
    "tagline": {
      "type": "string",
      "maxLength": 80
    },
    "about": {
      "type": "string",
      "maxLength": 700
    },
    "seo_title": {
      "type": "string",
      "maxLength": 60
    },
    "seo_description": {
      "type": "string",
      "maxLength": 160
    }
  },
  "required": [
    "tagline",
    "about",
    "seo_title",
    "seo_description"
  ],
  "additionalProperties": false
}

Propose a translation (name and/or description) of one product or category into one menu language. Nothing goes live: it is saved as a DRAFT change set the owner reviews and publishes in the admin panel; manual translations override machine translation once published.

{
  "type": "object",
  "properties": {
    "entity": {
      "type": "string",
      "enum": [
        "product",
        "category"
      ]
    },
    "entity_id": {
      "type": "string",
      "description": "Product or category id from get_restaurant_menu / menu_audit."
    },
    "locale": {
      "type": "string",
      "enum": [
        "tr",
        "en",
        "de",
        "fr",
        "es",
        "it",
        "nl",
        "pt",
        "ru",
        "ar",
        "zh",
        "ja",
        "ko",
        "pl",
        "sv",
        "da",
        "fi",
        "no",
        "cs",
        "hu",
        "ro",
        "bg",
        "el",
        "hr",
        "sk",
        "sl",
        "lt",
        "lv",
        "he",
        "fa",
        "sw"
      ],
      "description": "Target menu language (two letters), different from the menu source language."
    },
    "name": {
      "type": "string",
      "maxLength": 2000,
      "description": "Translated name (optional). Keep brand names as they are."
    },
    "description": {
      "type": "string",
      "maxLength": 2000,
      "description": "Translated description (optional). Plain text, no links, same meaning as the source — never add ingredients or claims."
    }
  },
  "required": [
    "entity",
    "entity_id",
    "locale"
  ],
  "additionalProperties": false
}