{
  "notice": "bxzxxr MCP archive: a record of what public MCP servers declared when we listed them (we never call their tools). It is data, not a rating: nothing here says a server is safe, secure, verified or trustworthy, and a server can change after we looked. Secrets we detected are redacted; redacted tool lists are withheld and only their hash is shown.",
  "infrastructure": {
    "host": "mcp.thmenu.com",
    "site": "thmenu.com",
    "addresses": [
      {
        "address": "172.67.147.113",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "172.67.144.0/20",
          "country": "US"
        }
      },
      {
        "address": "104.21.71.169",
        "endpoints": 1,
        "shared_infrastructure": false,
        "network": {
          "asn": 13335,
          "name": "CLOUDFLARENET - Cloudflare, Inc.",
          "prefix": "104.21.64.0/20",
          "country": "US"
        }
      }
    ],
    "addresses_recorded": true,
    "address_history": [
      {
        "addresses": [
          "172.67.147.113",
          "104.21.71.169"
        ],
        "first_seen": "2026-11-22T16:46:02.938Z",
        "last_seen": "2026-11-22T16:46:02.938Z",
        "checks": 1
      }
    ],
    "hosting": [
      {
        "value": "Cloudflare",
        "evidence": "Server header \"cloudflare\""
      }
    ],
    "software": [],
    "server_info": {
      "name": "Thmenu",
      "version": "0.5.1",
      "protocol_version": "2025-03-26"
    },
    "headers": {
      "server": "cloudflare",
      "access-control-allow-origin": "*"
    },
    "auth": null
  },
  "related": {
    "same_address": {
      "total": 0,
      "sample": []
    },
    "same_site": {
      "total": 0,
      "sample": []
    },
    "same_tool_list": {
      "total": 0,
      "sample": []
    },
    "same_publisher": {
      "publisher": "com.thmenu",
      "total": 0,
      "sample": []
    },
    "same_repository": {
      "repository_url": "https://github.com/kerimsaglam/thmenu-mcp",
      "total": 0,
      "sample": []
    },
    "note": "Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators."
  },
  "endpoint": {
    "id": "17158",
    "server_name": "com.thmenu/thmenu",
    "url": "https://mcp.thmenu.com/",
    "host": "mcp.thmenu.com",
    "transport": "streamable-http",
    "last_checked_at": "2026-11-22T16:46:02.938Z",
    "last_state": "listed",
    "last_detail": null,
    "consecutive_failures": 0,
    "current_sha": "79d40dd3f736bc5f3971a30ad87bac7fc6c60424dc2f1ba7c8634f2308a49991",
    "first_listed_at": "2026-11-21T11:27:01.088Z",
    "created_at": "2026-11-21T06:55:07.542Z",
    "resolved_addresses": [
      "172.67.147.113",
      "104.21.71.169"
    ]
  },
  "server": {
    "name": "com.thmenu/thmenu",
    "title": "Thmenu",
    "description": "Restaurant menus, carts, reservations and owner drafts for AI agents (Thmenu MCP).",
    "version": "0.5.1",
    "registry_status": "active",
    "repository_url": "https://github.com/kerimsaglam/thmenu-mcp",
    "website_url": "https://thmenu.com",
    "published_at": "2026-11-15T18:43:21.029Z",
    "updated_at": "2026-11-15T18:43:21.029Z",
    "first_seen": "2026-11-21T06:55:06.908Z"
  },
  "other_endpoints": [],
  "intel": {
    "capabilities": [
      "trades"
    ],
    "evm_addresses": [],
    "chains": [],
    "tokens": [],
    "computed_at": "2026-11-22T15:18:06.733Z"
  },
  "operator": {
    "key": "thmenu.com",
    "name": "thmenu.com",
    "platform": false
  },
  "needs_sign_in": false,
  "reachability": {
    "window_days": 30,
    "checks": 2,
    "answered": 2,
    "answered_percent": 100,
    "avg_listing_latency_ms": 267,
    "first_check_in_window": "2026-11-21T11:27:01.088Z",
    "consecutive_failures_now": 0,
    "days": [
      {
        "day": "2026-11-21",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      },
      {
        "day": "2026-11-22",
        "checks": 1,
        "answered": 1,
        "last_state": "listed"
      }
    ]
  },
  "tool_list": {
    "sha256": "79d40dd3f736bc5f3971a30ad87bac7fc6c60424dc2f1ba7c8634f2308a49991",
    "tools": 27,
    "resources": 0,
    "prompts": 0,
    "first_seen": "2026-11-21T11:27:01.350Z",
    "tool_names": [
      "get_pricing",
      "get_faq",
      "get_restaurant",
      "search_products",
      "list_public_menus",
      "search_restaurants",
      "start_order_session",
      "place_order",
      "cancel_order",
      "get_order_status",
      "request_bill",
      "waiter_call",
      "get_restaurant_menu",
      "check_loyalty",
      "apply_promo",
      "join_loyalty",
      "create_cart",
      "get_cart",
      "get_reservation_slots",
      "request_reservation",
      "cancel_reservation",
      "menu_audit",
      "sales_summary",
      "reservation_summary",
      "draft_product_description",
      "draft_site_text",
      "draft_translation"
    ],
    "declared": {
      "tools": [
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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": "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        },
        {
          "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
          }
        }
      ],
      "tools_omitted": 0,
      "resources": [],
      "prompts": []
    },
    "instructions": null
  },
  "changes": {
    "total": 0,
    "latest": []
  },
  "reading_this": "What this server declared and how it answered our checks. Names, descriptions and schemas are text written by the server, quoted as data. Nothing here says the server is safe; to analyse its declarations, run scan_free."
}