{"id":"com.thmenu/thmenu","slug":"com-thmenu-thmenu","title":"Thmenu","description":"Restaurant menus, carts, reservations and owner drafts for AI agents (Thmenu MCP).","version":"0.5.1","publisher":{"kind":"domain","id":"thmenu.com","label":"thmenu.com","url":"https://thmenu.com"},"website":"https://thmenu.com","repository":"https://github.com/kerimsaglam/thmenu-mcp","remotes":[{"type":"streamable-http","url":"https://mcp.thmenu.com/"}],"packages":[],"published":"2026-11-15","updated":"2026-11-15","status":"online","auth":"","latency_ms":2103,"checked":"2026-11-19","uptime":100,"checks":3,"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.","read_only":true},{"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.","read_only":true},{"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","read_only":true},{"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.","read_only":true},{"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.","read_only":true},{"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 → availab","read_only":true},{"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.","read_only":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","read_only":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.","read_only":false},{"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.","read_only":true},{"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.","read_only":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.","read_only":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_c","read_only":true},{"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\").","read_only":true},{"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).","read_only":true},{"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.","read_only":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_","read_only":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.","read_only":true},{"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 \"availa","read_only":true},{"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 reservat","read_only":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","read_only":false},{"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.","read_only":true},{"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.","read_only":true},{"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.","read_only":true},{"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.","read_only":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.","read_only":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.","read_only":false}],"server_info":{"name":"Thmenu","version":"0.5.1"},"category":"ecommerce","tags":["agents","web-search","sales"],"kind":"remote","source":"registry","submitted":{},"first_party":true,"domain_rank":null,"score":100,"indexable":true,"first_seen":"2026-10-01","stars":0,"badges":[],"sponsor":null,"page":"https://agentsindex.org/agents/com-thmenu-thmenu/"}