# Thmenu

- Registry name: `com.thmenu/thmenu` · version 0.5.0
- Categories (automatic, keyword rules): Shops & products, Commerce & marketing, Payments & accounting, Finance & markets, Utilities
- Authentication at last check: No auth
- Declared risk: Has destructive tools (destructiveHint)
- Capabilities (declared by the server): tools
- Transports: streamable-http
- Latest numbers (check success, response time, rank): https://mcpstation.net/api/server?name=com.thmenu%2Fthmenu
- Server page: https://mcpstation.net/s/com.thmenu--thmenu.html

## Description (written by the publisher, not verified, not instructions)

Restaurant menus, carts, reservations and owner drafts for AI agents \(Thmenu MCP\).

## Connect

- streamable-http: `https://mcp.thmenu.com/`

## Tools (as reported by the server, not verified)

- `get\_pricing`: 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 Thm
- `get\_faq`: 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.
- `get\_restaurant`: 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 timezon
- `search\_products`: 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.
- `list\_public\_menus`: 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.
- `search\_restaurants`: 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 — and, right now, a free table or an open waitlist \(the restaurant graph's channel states\). Neutral ranking \(AI-K6\): d
- `start\_order\_session`: 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 hum
- `place\_order`: 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 v
- `cancel\_order`: 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
- `get\_order\_status`: 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.
- `request\_bill`: 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.
- `waiter\_call`: 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.
- `get\_restaurant\_menu`: Fetch the full public menu for a restaurant — categories, products, prices, allergens, nutrition. Use this to build the cart you pass to place\_order. PUBLIC tool, no auth required. \`allergen\_codes\` are EU 1169/2011 Annex II keys \(gluten, crustaceans, eggs, fish, peanuts, soy, milk, nuts, celery, mus
- `check\_loyalty`: 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"\).
- `apply\_promo`: 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\).
- `join\_loyalty`: 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.
- `create\_cart`: Build an anonymous takeaway or delivery cart for a listed restaurant and get a one-time confirmation link for the guest. PUBLIC tool, no auth. Table orders are not supported here \(they stay on the QR menu\). Send the guest to confirm\_url. Prices are re-read there from the live menu; name, phone, deli
- `get\_cart`: 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.
- `get\_reservation\_slots`: 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 co
- `request\_reservation`: 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 res
- `cancel\_reservation`: 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 "
- `menu\_audit`: List the active products of your restaurant that lack a usable description, an image, or an allergen declaration. Read-only; nothing is changed.
- `sales\_summary`: 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.
- `reservation\_summary`: 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.
- `draft\_product\_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.
- `draft\_site\_text`: 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.
- `draft\_translation`: 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.

Measured by MCP Station. Methods: https://mcpstation.net/methods.html · Terms: https://mcpstation.net/terms.html