{"data":{"name":"com.thmenu/thmenu","title":"Thmenu","description":"Restaurant menus, carts, reservations and owner drafts for AI agents (Thmenu MCP).","version":"0.5.1","websiteUrl":"https://thmenu.com","repositoryUrl":"https://github.com/kerimsaglam/thmenu-mcp","remotes":[{"type":"streamable-http","url":"https://mcp.thmenu.com/"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-11-15T18:43:21.029Z","updatedAt":"2026-11-15T18:43:21.029Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"source":"official-registry","sourceId":"com.thmenu/thmenu","verification":"official","confidence":100,"stars":null,"updatedAt":"2026-11-15T18:43:21.029Z","title":"Thmenu","description":"Restaurant menus, carts, reservations and owner drafts for AI agents (Thmenu MCP).","websiteUrl":"https://thmenu.com","repositoryUrl":"https://github.com/kerimsaglam/thmenu-mcp"}],"toolIndex":{"tools":[{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"agent_session_id":{"type":"string"},"code":{"type":"string","minLength":1,"maxLength":64}},"required":["agent_session_id","code"]},"annotations":{"title":"Preview a promo code","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"85d38af8c2991ab064dbf2e8f70b78557b13ad136803d8953c04b0d37e8979c3","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"agent_session_id":{"type":"string"},"order_id":{"type":"string"}},"required":["agent_session_id","order_id"]},"annotations":{"title":"Cancel an order","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"definitionHash":"b6bbb1968e82a9d3c364796d270d234cd885783e4a499c07bf712417e27a3fc3","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"confirmation_code":{"type":"string","minLength":6,"maxLength":12}},"required":["confirmation_code"]},"annotations":{"title":"Cancel a reservation request","readOnlyHint":false,"destructiveHint":true,"idempotentHint":true,"openWorldHint":false},"definitionHash":"70d8d83771b0dec46ce63c30f0d39b50f7809c64ba1a0f755bcd3d373219b134","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"agent_session_id":{"type":"string"},"member_id":{"type":"string"}},"required":["agent_session_id","member_id"]},"annotations":{"title":"Loyalty balance","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"17204c4beb1d1997b61dc237ac744a1ffdc195855323b76996fcd1f7ba6475b8","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"restaurant":{"type":"string","description":"Restaurant slug (from search_restaurants / list_public_menus) or id."},"order_type":{"type":"string","enum":["takeaway","delivery"]},"items":{"type":"array","minItems":1,"maxItems":50,"items":{"type":"object","properties":{"product_id":{"type":"string"},"quantity":{"type":"integer","minimum":1,"maximum":99},"note":{"type":"string","maxLength":200},"modifier_option_ids":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":128},"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."}},"required":["product_id","quantity"]}},"note":{"type":"string","maxLength":500,"description":"Order-level note for the kitchen. Do not put the guest's name, phone or address here."},"scheduled_for":{"type":"string","description":"ISO date-time for a scheduled pickup/delivery (optional; the venue may refuse on the confirmation page)."}},"required":["restaurant","order_type","items"]},"annotations":{"title":"Create a cart","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"7d1597b870caae4e42b6b84d2ff705d75dd314adcb325b040a6c80d2dde6cc12","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"product_id":{"type":"string","description":"Product id from menu_audit or get_restaurant_menu."},"description":{"type":"string","maxLength":2000,"description":"Proposed description in the menu language. Plain text, no links, no claims you cannot verify."}},"required":["product_id","description"],"additionalProperties":false},"annotations":{"title":"Draft a product description","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"14aef20ef4b3259161ac5b207574a1884ba8e482b183fda68e0e1615e9d24b1b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"tagline":{"type":"string","maxLength":80},"about":{"type":"string","maxLength":700},"seo_title":{"type":"string","maxLength":60},"seo_description":{"type":"string","maxLength":160}},"required":["tagline","about","seo_title","seo_description"],"additionalProperties":false},"annotations":{"title":"Draft the website text pack","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"3aab3c792b0c084f3c0a0f3d18777cd40995ebde6da1484176fbe5f15dd84802","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"entity":{"type":"string","enum":["product","category"]},"entity_id":{"type":"string","description":"Product or category id from get_restaurant_menu / menu_audit."},"locale":{"type":"string","enum":["tr","en","de","fr","es","it","nl","pt","ru","ar","zh","ja","ko","pl","sv","da","fi","no","cs","hu","ro","bg","el","hr","sk","sl","lt","lv","he","fa","sw"],"description":"Target menu language (two letters), different from the menu source language."},"name":{"type":"string","maxLength":2000,"description":"Translated name (optional). Keep brand names as they are."},"description":{"type":"string","maxLength":2000,"description":"Translated description (optional). Plain text, no links, same meaning as the source — never add ingredients or claims."}},"required":["entity","entity_id","locale"],"additionalProperties":false},"annotations":{"title":"Draft a menu translation","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"7214a756c4e93873759b20122b73f0adeb5a0ec85fbc6d61d610735d58ff9320","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"cart_id":{"type":"string","pattern":"^[a-f0-9]{32}$"}},"required":["cart_id"]},"annotations":{"title":"Cart contents","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"1bdac2425407d611cc378a5df05186b1ad85a15a75f7b305b2403f84423bebe2","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"00c820dc05088c2cec59148ea1fe3cbd3e4e68ce6c9188fe3fdb09a20baf026e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"agent_session_id":{"type":"string"},"order_id":{"type":"string"}},"required":["agent_session_id","order_id"]},"annotations":{"title":"Order status","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"99f29c074f3f8fb37a254f6128078eb62219c5bbb2fef2a43dc82a0e1e48a18e","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"0dd36abebb1e214142ca33415ab901ae316d30f15e13023daec8d90eb8d767d6","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"restaurant":{"type":"string"},"days":{"type":"integer","minimum":1,"maximum":7,"default":2}},"required":["restaurant"]},"annotations":{"title":"Reservation slots","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"b69eacc60554a5166232f0746cb1f4be087eb2062cb8838f605fead787bdb1f5","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"slug":{"type":"string","description":"Restaurant slug, e.g. lily-rose-bistro"}},"required":["slug"]},"annotations":{"title":"Restaurant profile","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"936c40524a4597a4a6caaa22dded52ca8696f50a118e62d6dffa0b639e266036","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"restaurant_id":{"type":"string"},"locale":{"type":"string","default":"en"}},"required":["restaurant_id"]},"annotations":{"title":"Restaurant menu","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"6d1f9881a884079cd79d3a6bb2038aaf9d23bea68d429845d9611f86517986ff","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"agent_session_id":{"type":"string","description":"Active session id from start_order_session."},"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."}},"required":["agent_session_id"]},"annotations":{"title":"Join the loyalty programme","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"366e6489c9c57d26d3803b8f495a094a36b43e0ae56bef2d6ef498ee14f6d041","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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":{"limit":{"type":"integer","minimum":1,"maximum":50,"default":20},"page":{"type":"integer","minimum":1,"default":1}}},"annotations":{"title":"Public restaurant directory","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"8cb7680877271d04d4078964b695bc05456a8d131d8c5417aad3e21c33ca146a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"862eea1ea97b6c643bca71768e81c5b77d335a61beb330288836afdb8847564f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"agent_session_id":{"type":"string"},"items":{"type":"array","minItems":1,"maxItems":100,"items":{"type":"object","properties":{"product_id":{"type":"string"},"quantity":{"type":"integer","minimum":1,"maximum":999},"modifier_option_ids":{"type":"array","maxItems":50,"items":{"type":"string","minLength":1,"maxLength":128},"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."}},"required":["product_id","quantity"]}},"order_type":{"type":"string","enum":["dine_in","takeaway"],"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."},"customer_name":{"type":"string","maxLength":80,"description":"Required for takeaway — who picks the order up."},"customer_phone":{"type":"string","maxLength":24,"description":"Required for takeaway — reachable phone (digits, +, spaces/dashes tolerated)."},"table_id":{"type":"string","description":"Optional table id when ordering at a table."},"guest_name":{"type":"string","description":"Optional guest name shown to staff with the order."},"note":{"type":"string","description":"Optional order-level note (max 500 chars)."},"promo_code":{"type":"string","maxLength":64,"description":"Optional promo code to redeem at order time (validate first with apply_promo). The redemption slot is consumed only when this order lands."}},"required":["agent_session_id","items"]},"annotations":{"title":"Place an order","readOnlyHint":false,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"8da34938539580f02d2ce12c8684a5d4703afd187d50084cb40da23007ef644a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"agent_session_id":{"type":"string"},"table_id":{"type":"string"},"split_type":{"type":"string","enum":["full","personal"],"default":"full"},"note":{"type":"string","maxLength":500}},"required":["agent_session_id","table_id"]},"annotations":{"title":"Request the bill","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"b12b1f003d6cfd546e2ade16a640c2068073491f557b403d0f105098761409e5","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"restaurant":{"type":"string"},"reserved_at":{"type":"string","description":"ISO date-time; at least 30 minutes ahead, at most 90 days."},"party_size":{"type":"integer","minimum":1,"maximum":50},"note":{"type":"string","maxLength":300,"description":"Occasion, seating preference, accessibility needs. Do not put the guest's name, phone or email here."}},"required":["restaurant","reserved_at","party_size"]},"annotations":{"title":"Request a reservation","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"a8fede6cc3899010c04de2fcd46b20a59cba8d9a6977753b350056219a786fb1","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"831e15de1a39f1cb5023d5a3f3fe0130cc98c033919ee8a7f5fdaadd95c184e4","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"f12d572ad8fcf886593872c332586e71b3f6ec7081131bb875757ba36da1a2c5","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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","properties":{"slug":{"type":"string","description":"Restaurant slug."},"query":{"type":"string","description":"Free-text search across name + description."},"locale":{"type":"string","default":"en"},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10}},"required":["slug","query"]},"annotations":{"title":"Search products","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"b735c59cbdb1cd86b6553ecfe13408367400d663248cce69e315c11e5251f682","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"},{"serverName":"com.thmenu/thmenu","endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","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":{"near":{"type":"object","properties":{"lat":{"type":"number"},"lng":{"type":"number"}},"required":["lat","lng"],"description":"Search centre. Venues without coordinates are excluded when set."},"radius_km":{"type":"number","minimum":0.5,"maximum":100,"default":10},"open_now":{"type":"boolean","default":false,"description":"Only venues open right now in their own timezone; venues with unknown hours are excluded when true."},"cuisine":{"type":"array","items":{"type":"string","enum":["turkish","kebab","ottoman","anatolian","aegean","black_sea","mediterranean","middle_eastern","lebanese","persian","georgian","greek","balkan","romanian","polish","eastern_european","russian","italian","pizza","pasta","french","spanish","tapas","portuguese","german","austrian","british","irish","scandinavian","dutch","american","burger","steakhouse","bbq","tex_mex","mexican","latin_american","brazilian","peruvian","caribbean","japanese","sushi","ramen","chinese","korean","thai","vietnamese","indian","pakistani","indonesian","malaysian","filipino","african","ethiopian","moroccan","seafood","grill","vegetarian","vegan","healthy","cafe","coffee","tea_house","bakery","patisserie","dessert","ice_cream","breakfast_brunch","fast_food","street_food","fusion","international","fine_dining","bistro","pub","bar","wine_bar","cocktail_bar","juice_bar","food_court"]},"description":"All listed cuisines must be declared by the venue."},"dietary":{"type":"array","items":{"type":"string","enum":["vegetarian_options","vegan_options","gluten_free_options","lactose_free_options","halal","kosher"]},"description":"Owner declaration, not a certification."},"attributes":{"type":"array","items":{"type":"string"},"description":"Any declared attribute token (meals, family, outdoor, accessibility, cuisine, dietary)."},"channel":{"type":"string","enum":["order","reservation","pickup","delivery"],"description":"order = digital ordering at the table; reservation; pickup = takeaway; delivery = venue's own delivery."},"price_max":{"type":"integer","minimum":1,"maximum":4,"description":"Owner-declared price level 1–4 (schema.org priceRange \"$\" … \"$$$$\"): venues at or below it. Venues that declared no level are excluded when set."},"menu_language":{"type":"string","enum":["tr","en","de","fr","es","it","nl","pt","ru","ar","zh","ja","ko","pl","sv","da","fi","no","cs","hu","ro","bg","el","hr","sk","sl","lt","lv","he","fa","sw"],"description":"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\"."},"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."},"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."},"q":{"type":"string","description":"Free text over name and description (min 2 chars)."},"city":{"type":"string"},"country":{"type":"string","description":"ISO 3166-1 alpha-2"},"limit":{"type":"integer","minimum":1,"maximum":50,"default":20},"page":{"type":"integer","minimum":1,"default":1}}},"annotations":{"title":"Search restaurants","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"d726e0d738e693465f709d2bd9fc0232b91f8e969f37a0c1f822db155a99e08b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-17T05:46:36.730Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"b2631757efc2adbfaafc84fe1be066eff2704248df7f80ca032c793fd9690a28","protocol":"streamable-http","status":"indexed","toolCount":27,"observedAt":"2026-11-17T05:46:36.730Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"com.thmenu/thmenu":{"url":"https://mcp.thmenu.com/"}}},"Cursor":{"mcpServers":{"com.thmenu/thmenu":{"url":"https://mcp.thmenu.com/"}}},"VS Code":{"servers":{"com.thmenu/thmenu":{"type":"http","url":"https://mcp.thmenu.com/"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.thmenu.com/"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:com.thmenu%2Fthmenu","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/com.thmenu%2Fthmenu","name":"com.thmenu/thmenu","description":"Restaurant menus, carts, reservations and owner drafts for AI agents (Thmenu MCP).","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.thmenu.com/"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://thmenu.com","repositoryUrl":"https://github.com/kerimsaglam/thmenu-mcp","version":"0.5.1"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"com.thmenu/thmenu","status":"online","lastCheckedAt":"2026-11-20T08:16:25.234Z","lastSuccessfulCheck":"2026-11-20T08:16:25.234Z","latencyMs":101,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T08:16:25.234Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T08:16:25.234Z"},"security":null,"timestamps":{"createdAt":"2026-11-15T18:43:21.029Z","updatedAt":"2026-11-15T18:43:21.029Z","observedAt":"2026-11-20T08:16:25.234Z"},"compatibility":{"serverVersion":"0.5.1","protocolVersions":[{"protocol":"mcp","version":null}]}}}}