Thmenu is an MCP server published by com.thmenu, hosted at mcp.thmenu.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 27 tools, including get_pricing, get_faq, get_restaurant, search_products, list_public_menus.
Restaurant menus, carts, reservations and owner drafts for AI agents (Thmenu MCP).
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Return Thmenu's commercial model as structured facts: free forever, every feature included, no subscription and no trial; the only charge is a platform fee in basis points on payment volume processed through Thmenu (the payment processor's own fee is separate); cash or external payments carry no Thmenu fee. Generated from the code that charges it — safe to cache.
No parameters.
{
"name": "get_pricing",
"title": "Pricing model",
"description": "Return Thmenu's commercial model as structured facts: free forever, every feature included, no subscription and no trial; the only charge is a platform fee in basis points on payment volume processed through Thmenu (the payment processor's own fee is separate); cash or external payments carry no Thmenu fee. Generated from the code that charges it — safe to cache.",
"inputSchema": {
"type": "object",
"properties": {}
},
"annotations": {
"title": "Pricing model",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| locale | string |
{
"name": "get_faq",
"title": "Frequently asked questions",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"locale": {
"type": "string",
"default": "en"
}
}
},
"annotations": {
"title": "Frequently asked questions",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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, and `graph` — the canonical Restaurant Graph node's agent fields: verification state (UNCLAIMED · CLAIMED · SUSPENDED · HIDDEN; VERIFIED only when a human verified it), channel_states (each channel true/false/null with a reason — null means unknown, never "no"; TABLE_AVAILABLE only from tables staff confirmed ready), menu languages with coverage, and payment availability. Only restaurants opted into the public directory are visible.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Restaurant slug, e.g. lily-rose-bistro |
{
"name": "get_restaurant",
"title": "Restaurant profile",
"description": "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, and `graph` — the canonical Restaurant Graph node's agent fields: verification state (UNCLAIMED · CLAIMED · SUSPENDED · HIDDEN; VERIFIED only when a human verified it), channel_states (each channel true/false/null with a reason — null means unknown, never \"no\"; TABLE_AVAILABLE only from tables staff confirmed ready), menu languages with coverage, and payment availability. Only restaurants opted into the public directory are visible.",
"inputSchema": {
"type": "object",
"required": [
"slug"
],
"properties": {
"slug": {
"type": "string",
"description": "Restaurant slug, e.g. lily-rose-bistro"
}
}
},
"annotations": {
"title": "Restaurant profile",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| slug * | string | Restaurant slug. |
| limit | integer | |
| query * | string | Free-text search across name + description. |
| locale | string |
{
"name": "search_products",
"title": "Search products",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"slug",
"query"
],
"properties": {
"slug": {
"type": "string",
"description": "Restaurant slug."
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 20,
"minimum": 1
},
"query": {
"type": "string",
"description": "Free-text search across name + description."
},
"locale": {
"type": "string",
"default": "en"
}
}
},
"annotations": {
"title": "Search products",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | |
| limit | integer |
{
"name": "list_public_menus",
"title": "Public restaurant directory",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
}
}
},
"annotations": {
"title": "Public restaurant directory",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Search the public directory (opt-in venues only) by location, opening status, cuisine, dietary options, declared attributes, ordering channel, declared price level and menu language — whether a guest can pay online through Thmenu and, right now, a free table or an open waitlist (the restaurant graph's channel states). Neutral ranking (AI-K6): distance in 0.5 km bands when `near` is given → availability (open now first; unknown hours before closed; a venue in holiday mode counts as closed) → profile freshness (owner-verified within 90 days first) → name. Payment to Thmenu never affects order. Cuisine, dietary, price level and other attributes are owner declarations, not verified facts; venues without a declaration are excluded only when an attribute or price 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; false while the venue is in holiday mode), channels (order · reservation · pickup · delivery), declared attributes, freshness and the menu URL. Paginated.
| Parameter | Type | Description |
|---|---|---|
| q | string | Free text over name and description (min 2 chars). |
| city | string | |
| near | object | Search centre. Venues without coordinates are excluded when set. |
| page | integer | |
| limit | integer | |
| channel | string | order = digital ordering at the table; reservation; pickup = takeaway; delivery = venue's own delivery. |
| country |
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.
| Parameter | Type | Description |
|---|---|---|
| restaurant_id * | string | Canonical restaurant id from get_restaurant or search_products. |
{
"name": "start_order_session",
"title": "Start an order session",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"restaurant_id"
],
"properties": {
"restaurant_id": {
"type": "string",
"description": "Canonical restaurant id from get_restaurant or search_products."
}
}
},
"annotations": {
"title": "Start an order session",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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 and optionally redeems a promo code. The guest pays at the venue (payment_status 'unpaid'). At a venue that takes payment before preparing (pay_first: true) the order is held as 'awaiting' and payment_url is returned: give it to the guest — they pay on the restaurant's own checkout, exactly like a guest ordering from the table; the kitchen gets the order once it is paid, and an unpaid order expires. This tool never charges anything itself. Options (size, doneness, extras …): get_restaurant_menu lists each dish's option_groups; send the chosen option ids per line as modifier_option_ids — each option's price_delta is added to the dish price on the server. A group with required: true needs at least max(1, min_select) of its options and no group takes more than max_select. A line that breaks this is refused and nothing is ordered: modifier_required (a required group left empty), modifier_too_many, modifier_unknown_option (an id the dish does not offer), modifier_malformed (not a list of option ids); the error data names the product_id and group_id. Ask the guest, or leave that dish out. Returns order_id, total_cents (tax-inclusive), currency, promo_discount and, when pay_first, payment_url. Idempotency-Key header REQUIRED.
| Parameter | Type | Description |
|---|---|---|
| note | string | Optional order-level note (max 500 chars). |
| items * | array | |
| table_id | string | Optional table id when ordering at a table. |
| guest_name | string | Optional guest name shown to staff with the order. |
| order_type | string |
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.
| Parameter | Type | Description |
|---|---|---|
| order_id * | string | |
| agent_session_id * | string |
{
"name": "cancel_order",
"title": "Cancel an order",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"agent_session_id",
"order_id"
],
"properties": {
"order_id": {
"type": "string"
},
"agent_session_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Cancel an order",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}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.
| Parameter | Type | Description |
|---|---|---|
| order_id * | string | |
| agent_session_id * | string |
{
"name": "get_order_status",
"title": "Order status",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"agent_session_id",
"order_id"
],
"properties": {
"order_id": {
"type": "string"
},
"agent_session_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Order status",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| note | string | |
| table_id * | string | |
| split_type | string | one of ["full","personal"] |
| agent_session_id * | string |
{
"name": "request_bill",
"title": "Request the bill",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"agent_session_id",
"table_id"
],
"properties": {
"note": {
"type": "string",
"maxLength": 500
},
"table_id": {
"type": "string"
},
"split_type": {
"enum": [
"full",
"personal"
],
"type": "string",
"default": "full"
},
"agent_session_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Request the bill",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| message | string | |
| table_id * | string | |
| agent_session_id * | string |
{
"name": "waiter_call",
"title": "Call a waiter",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"agent_session_id",
"table_id"
],
"properties": {
"message": {
"type": "string",
"maxLength": 500
},
"table_id": {
"type": "string"
},
"agent_session_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Call a waiter",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Fetch the full public menu for a restaurant — categories, products, prices, option groups, allergens, nutrition. Use this to build the cart you pass to place_order. PUBLIC tool, no auth required. Each product carries `option_groups` (id, name, required, min_select, max_select, options[{id, name, price_delta}]); pass the chosen option ids as items[].modifier_option_ids to place_order or to create_cart (the anonymous cart the guest confirms) — a required group must be filled or the order or cart is refused. `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".
| Parameter | Type | Description |
|---|---|---|
| locale | string | |
| restaurant_id * | string |
{
"name": "get_restaurant_menu",
"title": "Restaurant menu",
"description": "Fetch the full public menu for a restaurant — categories, products, prices, option groups, allergens, nutrition. Use this to build the cart you pass to place_order. PUBLIC tool, no auth required. Each product carries `option_groups` (id, name, required, min_select, max_select, options[{id, name, price_delta}]); pass the chosen option ids as items[].modifier_option_ids to place_order or to create_cart (the anonymous cart the guest confirms) — a required group must be filled or the order or cart is refused. `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\".",
"inputSchema": {
"type": "object",
"required": [
"restaurant_id"
],
"properties": {
"locale": {
"type": "string",
"default": "en"
},
"restaurant_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Restaurant menu",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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").
| Parameter | Type | Description |
|---|---|---|
| member_id * | string | |
| agent_session_id * | string |
{
"name": "check_loyalty",
"title": "Loyalty balance",
"description": "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\").",
"inputSchema": {
"type": "object",
"required": [
"agent_session_id",
"member_id"
],
"properties": {
"member_id": {
"type": "string"
},
"agent_session_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Loyalty balance",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| code * | string | |
| agent_session_id * | string |
{
"name": "apply_promo",
"title": "Preview a promo code",
"description": "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).",
"inputSchema": {
"type": "object",
"required": [
"agent_session_id",
"code"
],
"properties": {
"code": {
"type": "string",
"maxLength": 64,
"minLength": 1
},
"agent_session_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Preview a promo code",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}Loyalty sign-up for a guest. The guest must confirm their own e-mail, so joining happens on the restaurant's menu (My thmenu → Loyalty); this tool answers with that instruction and never reveals whether an e-mail or phone is already enrolled. Requires an active agent_session_id.
| Parameter | Type | Description |
|---|---|---|
| string | Not used for a lookup; the guest confirms their e-mail on the menu. | |
| phone | string | Not used for a lookup. |
| display_name | string | Not used. |
| agent_session_id * | string | Active session id from start_order_session. |
{
"name": "join_loyalty",
"title": "Join the loyalty programme",
"description": "Loyalty sign-up for a guest. The guest must confirm their own e-mail, so joining happens on the restaurant's menu (My thmenu → Loyalty); this tool answers with that instruction and never reveals whether an e-mail or phone is already enrolled. Requires an active agent_session_id.",
"inputSchema": {
"type": "object",
"required": [
"agent_session_id"
],
"properties": {
"email": {
"type": "string",
"description": "Not used for a lookup; the guest confirms their e-mail on the menu."
},
"phone": {
"type": "string",
"description": "Not used for a lookup."
},
"display_name": {
"type": "string",
"description": "Not used."
},
"agent_session_id": {
"type": "string",
"description": "Active session id from start_order_session."
}
}
},
"annotations": {
"title": "Join the loyalty programme",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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). Options (size, doneness, extras …): get_restaurant_menu lists each dish's option_groups; send the chosen option ids per line as items[].modifier_option_ids — the quote adds each option's price_delta and the confirmation page orders the same choice. A group with required: true needs at least max(1, min_select) of its options and no group takes more than max_select; a line that breaks this refuses the cart and nothing is created: modifier_required (a required group left empty), modifier_too_many, modifier_unknown_option (an id the dish does not offer), or invalid_input with detail.reason modifier_malformed (not a list of option ids); the error detail names the product_id and group_id. The same dish with different options goes on separate lines. 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.
| Parameter | Type | Description |
|---|---|---|
| note | string | Order-level note for the kitchen. Do not put the guest's name, phone or address here. |
| items * | array | |
| order_type * | string | one of ["takeaway","delivery"] |
| restaurant * | string | Restaurant slug (from search_restaurants / list_public_menus) or id. |
| scheduled_for | string | ISO date-time for a scheduled pickup/delivery (optional; the venue may refuse on the confirmation page). |
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.
| Parameter | Type | Description |
|---|---|---|
| cart_id * | string |
{
"name": "get_cart",
"title": "Cart contents",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"cart_id"
],
"properties": {
"cart_id": {
"type": "string",
"pattern": "^[a-f0-9]{32}$"
}
}
},
"annotations": {
"title": "Cart contents",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| days | integer | |
| restaurant * | string |
{
"name": "get_reservation_slots",
"title": "Reservation slots",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"restaurant"
],
"properties": {
"days": {
"type": "integer",
"default": 2,
"maximum": 7,
"minimum": 1
},
"restaurant": {
"type": "string"
}
}
},
"annotations": {
"title": "Reservation slots",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| note | string | Occasion, seating preference, accessibility needs. Do not put the guest's name, phone or email here. |
| party_size * | integer | |
| restaurant * | string | |
| reserved_at * | string | ISO date-time; at least 30 minutes ahead, at most 90 days. |
{
"name": "request_reservation",
"title": "Request a reservation",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"restaurant",
"reserved_at",
"party_size"
],
"properties": {
"note": {
"type": "string",
"maxLength": 300,
"description": "Occasion, seating preference, accessibility needs. Do not put the guest's name, phone or email here."
},
"party_size": {
"type": "integer",
"maximum": 50,
"minimum": 1
},
"restaurant": {
"type": "string"
},
"reserved_at": {
"type": "string",
"description": "ISO date-time; at least 30 minutes ahead, at most 90 days."
}
}
},
"annotations": {
"title": "Request a reservation",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| confirmation_code * | string |
{
"name": "cancel_reservation",
"title": "Cancel a reservation request",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"confirmation_code"
],
"properties": {
"confirmation_code": {
"type": "string",
"maxLength": 12,
"minLength": 6
}
}
},
"annotations": {
"title": "Cancel a reservation request",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}List the active products of your restaurant that lack a usable description, an image, or an allergen declaration. Read-only; nothing is changed.
No parameters.
{
"name": "menu_audit",
"title": "Menu completeness audit",
"description": "List the active products of your restaurant that lack a usable description, an image, or an allergen declaration. Read-only; nothing is changed.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Menu completeness audit",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": 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.
No parameters.
{
"name": "sales_summary",
"title": "Orders summary (7 and 30 days)",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Orders summary (7 and 30 days)",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": 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.
No parameters.
{
"name": "reservation_summary",
"title": "Upcoming reservations",
"description": "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.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
},
"annotations": {
"title": "Upcoming reservations",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": 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.
| Parameter | Type | Description |
|---|---|---|
| product_id * | string | Product id from menu_audit or get_restaurant_menu. |
| description * | string | Proposed description in the menu language. Plain text, no links, no claims you cannot verify. |
{
"name": "draft_product_description",
"title": "Draft a product description",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"product_id",
"description"
],
"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."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Draft a product description",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": 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.
| Parameter | Type | Description |
|---|---|---|
| about * | string | |
| tagline * | string | |
| seo_title * | string | |
| seo_description * | string |
{
"name": "draft_site_text",
"title": "Draft the website text pack",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"tagline",
"about",
"seo_title",
"seo_description"
],
"properties": {
"about": {
"type": "string",
"maxLength": 700
},
"tagline": {
"type": "string",
"maxLength": 80
},
"seo_title": {
"type": "string",
"maxLength": 60
},
"seo_description": {
"type": "string",
"maxLength": 160
}
},
"additionalProperties": false
},
"annotations": {
"title": "Draft the website text pack",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": 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.
| Parameter | Type | Description |
|---|---|---|
| name | string | Translated name (optional). Keep brand names as they are. |
| entity * | string | one of ["product","category"] |
| locale * | string | Target menu language (two letters), different from the menu source language. |
| entity_id * | string | Product or category id from get_restaurant_menu / menu_audit. |
| description | string | Translated description (optional). Plain text, no links, same meaning as the source — never add ingredients or claims. |
{
"name": "draft_translation",
"title": "Draft a menu translation",
"description": "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.",
"inputSchema": {
"type": "object",
"required": [
"entity",
"entity_id",
"locale"
],
"properties": {
"name": {
"type": "string",
"maxLength": 2000,
"description": "Translated name (optional). Keep brand names as they are."
},
"entity": {
"enum": [
"product",
"category"
],
"type": "string"
},
"locale": {
"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"
],
"type": "string",
"description": "Target menu language (two letters), different from the menu source language."
},
"entity_id": {
"type": "string",
"description": "Product or category id from get_restaurant_menu / menu_audit."
},
"description": {
"type": "string",
"maxLength": 2000,
"description": "Translated description (optional). Plain text, no links, same meaning as the source — never add ingredients or claims."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Draft a menu translation",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| string |
| ISO 3166-1 alpha-2 |
| cuisine | array | All listed cuisines must be declared by the venue. |
| dietary | array | Owner declaration, not a certification. |
| open_now | boolean | Only venues open right now in their own timezone; venues with unknown hours are excluded when true. |
| waitlist | boolean | Only venues whose waitlist is open now (WAITLIST_AVAILABLE): the reservations switch, which also opens the waitlist, and the venue open now — not in holiday mode. |
| price_max | integer | Owner-declared price level 1–4 (schema.org priceRange "$" … "$$$$"): venues at or below it. Venues that declared no level are excluded when set. |
| radius_km | number |
| attributes | array | Any declared attribute token (meals, family, outdoor, accessibility, cuisine, dietary). |
| menu_language | string | The menu can be read in this language: it is the menu's source language, or at least 90 % of the guest menu's dish names are translated into it (the restaurant graph's rule). |
| table_available | boolean | Only venues open now with a table that staff marked ready on the live table board (TABLE_AVAILABLE). Venues not using the board are excluded: unknown is not "available". |
| payment_available | boolean | Only venues where a guest can pay online through Thmenu (PAYMENT_AVAILABLE): the venue's online-payment switch is on, online payment through Thmenu works in its country, and the payment provider has not reported the account unable to take payments. |
{
"name": "search_restaurants",
"title": "Search restaurants",
"description": "Search the public directory (opt-in venues only) by location, opening status, cuisine, dietary options, declared attributes, ordering channel, declared price level and menu language — whether a guest can pay online through Thmenu and, right now, a free table or an open waitlist (the restaurant graph's channel states). Neutral ranking (AI-K6): distance in 0.5 km bands when `near` is given → availability (open now first; unknown hours before closed; a venue in holiday mode counts as closed) → profile freshness (owner-verified within 90 days first) → name. Payment to Thmenu never affects order. Cuisine, dietary, price level and other attributes are owner declarations, not verified facts; venues without a declaration are excluded only when an attribute or price 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; false while the venue is in holiday mode), channels (order · reservation · pickup · delivery), declared attributes, freshness and the menu URL. Paginated.",
"inputSchema": {
"type": "object",
"properties": {
"q": {
"type": "string",
"description": "Free text over name and description (min 2 chars)."
},
"city": {
"type": "string"
},
"near": {
"type": "object",
"required": [
"lat",
"lng"
],
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
}
},
"description": "Search centre. Venues without coordinates are excluded when set."
},
"page": {
"type": "integer",
"default": 1,
"minimum": 1
},
"limit": {
"type": "integer",
"default": 20,
"maximum": 50,
"minimum": 1
},
"channel": {
"enum": [
"order",
"reservation",
"pickup",
"delivery"
],
"type": "string",
"description": "order = digital ordering at the table; reservation; pickup = takeaway; delivery = venue's own delivery."
},
"country": {
"type": "string",
"description": "ISO 3166-1 alpha-2"
},
"cuisine": {
"type": "array",
"items": {
"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",
"food_court"
],
"type": "string"
},
"description": "All listed cuisines must be declared by the venue."
},
"dietary": {
"type": "array",
"items": {
"enum": [
"vegetarian_options",
"vegan_options",
"gluten_free_options",
"lactose_free_options",
"halal",
"kosher"
],
"type": "string"
},
"description": "Owner declaration, not a certification."
},
"open_now": {
"type": "boolean",
"default": false,
"description": "Only venues open right now in their own timezone; venues with unknown hours are excluded when true."
},
"waitlist": {
"type": "boolean",
"default": false,
"description": "Only venues whose waitlist is open now (WAITLIST_AVAILABLE): the reservations switch, which also opens the waitlist, and the venue open now — not in holiday mode."
},
"price_max": {
"type": "integer",
"maximum": 4,
"minimum": 1,
"description": "Owner-declared price level 1–4 (schema.org priceRange \"$\" … \"$$$$\"): venues at or below it. Venues that declared no level are excluded when set."
},
"radius_km": {
"type": "number",
"default": 10,
"maximum": 100,
"minimum": 0.5
},
"attributes": {
"type": "array",
"items": {
"type": "string"
},
"description": "Any declared attribute token (meals, family, outdoor, accessibility, cuisine, dietary)."
},
"menu_language": {
"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"
],
"type": "string",
"description": "The menu can be read in this language: it is the menu's source language, or at least 90 % of the guest menu's dish names are translated into it (the restaurant graph's rule)."
},
"table_available": {
"type": "boolean",
"default": false,
"description": "Only venues open now with a table that staff marked ready on the live table board (TABLE_AVAILABLE). Venues not using the board are excluded: unknown is not \"available\"."
},
"payment_available": {
"type": "boolean",
"default": false,
"description": "Only venues where a guest can pay online through Thmenu (PAYMENT_AVAILABLE): the venue's online-payment switch is on, online payment through Thmenu works in its country, and the payment provider has not reported the account unable to take payments."
}
}
},
"annotations": {
"title": "Search restaurants",
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}| Channel: 'dine_in' (default — at a table) or 'takeaway' (pickup; requires customer_name + customer_phone, ignores table_id, only when the restaurant has takeaway enabled — else channel_not_available). Delivery is not offered to agents. |
| promo_code | string | Optional promo code to redeem at order time (validate first with apply_promo). The redemption slot is consumed only when this order lands. |
| customer_name | string | Required for takeaway — who picks the order up. |
| customer_phone | string | Required for takeaway — reachable phone (digits, +, spaces/dashes tolerated). |
| agent_session_id * | string |
{
"name": "place_order",
"title": "Place an order",
"description": "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 and optionally redeems a promo code. The guest pays at the venue (payment_status 'unpaid'). At a venue that takes payment before preparing (pay_first: true) the order is held as 'awaiting' and payment_url is returned: give it to the guest — they pay on the restaurant's own checkout, exactly like a guest ordering from the table; the kitchen gets the order once it is paid, and an unpaid order expires. This tool never charges anything itself. Options (size, doneness, extras …): get_restaurant_menu lists each dish's option_groups; send the chosen option ids per line as modifier_option_ids — each option's price_delta is added to the dish price on the server. A group with required: true needs at least max(1, min_select) of its options and no group takes more than max_select. A line that breaks this is refused and nothing is ordered: modifier_required (a required group left empty), modifier_too_many, modifier_unknown_option (an id the dish does not offer), modifier_malformed (not a list of option ids); the error data names the product_id and group_id. Ask the guest, or leave that dish out. Returns order_id, total_cents (tax-inclusive), currency, promo_discount and, when pay_first, payment_url. Idempotency-Key header REQUIRED.",
"inputSchema": {
"type": "object",
"required": [
"agent_session_id",
"items"
],
"properties": {
"note": {
"type": "string",
"description": "Optional order-level note (max 500 chars)."
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_id",
"quantity"
],
"properties": {
"quantity": {
"type": "integer",
"maximum": 999,
"minimum": 1
},
"product_id": {
"type": "string"
},
"modifier_option_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"maxItems": 50,
"description": "Chosen option ids for this line, from the dish's option_groups in get_restaurant_menu (all groups flat). Required groups must be filled; omit when the dish has no option the guest chose."
}
}
},
"maxItems": 100,
"minItems": 1
},
"table_id": {
"type": "string",
"description": "Optional table id when ordering at a table."
},
"guest_name": {
"type": "string",
"description": "Optional guest name shown to staff with the order."
},
"order_type": {
"enum": [
"dine_in",
"takeaway"
],
"type": "string",
"description": "Channel: 'dine_in' (default — at a table) or 'takeaway' (pickup; requires customer_name + customer_phone, ignores table_id, only when the restaurant has takeaway enabled — else channel_not_available). Delivery is not offered to agents."
},
"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."
},
"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)."
},
"agent_session_id": {
"type": "string"
}
}
},
"annotations": {
"title": "Place an order",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "create_cart",
"title": "Create a cart",
"description": "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). Options (size, doneness, extras …): get_restaurant_menu lists each dish's option_groups; send the chosen option ids per line as items[].modifier_option_ids — the quote adds each option's price_delta and the confirmation page orders the same choice. A group with required: true needs at least max(1, min_select) of its options and no group takes more than max_select; a line that breaks this refuses the cart and nothing is created: modifier_required (a required group left empty), modifier_too_many, modifier_unknown_option (an id the dish does not offer), or invalid_input with detail.reason modifier_malformed (not a list of option ids); the error detail names the product_id and group_id. The same dish with different options goes on separate lines. 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.",
"inputSchema": {
"type": "object",
"required": [
"restaurant",
"order_type",
"items"
],
"properties": {
"note": {
"type": "string",
"maxLength": 500,
"description": "Order-level note for the kitchen. Do not put the guest's name, phone or address here."
},
"items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_id",
"quantity"
],
"properties": {
"note": {
"type": "string",
"maxLength": 200
},
"quantity": {
"type": "integer",
"maximum": 99,
"minimum": 1
},
"product_id": {
"type": "string"
},
"modifier_option_ids": {
"type": "array",
"items": {
"type": "string",
"maxLength": 128,
"minLength": 1
},
"maxItems": 50,
"description": "Chosen option ids for this line, from the dish's option_groups in get_restaurant_menu (all groups flat). Required groups must be filled; omit when the guest chose no option."
}
}
},
"maxItems": 50,
"minItems": 1
},
"order_type": {
"enum": [
"takeaway",
"delivery"
],
"type": "string"
},
"restaurant": {
"type": "string",
"description": "Restaurant slug (from search_restaurants / list_public_menus) or id."
},
"scheduled_for": {
"type": "string",
"description": "ISO date-time for a scheduled pickup/delivery (optional; the venue may refuse on the confirmation page)."
}
}
},
"annotations": {
"title": "Create a cart",
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}