Just Eat

Show the full menu for a Just Eat restaurant as an interactive widget, allowing the user to browse categories and add items to their basket. Call this after search_restaurants when the user wants to explore a restaurant's menu. Requires seoName from a search_restaurants result and the delivery postcode (or lat/lng). Pass basketId when the user already has a basket at this restaurant to show the basket count. This widget is the COMPLETE interface for browsing and selecting. After it renders, reply with at most ONE short sentence (e.g. "Here's the menu for <restaurant>."). Do NOT also: call get_catalogue_item, describe or re-list individual items in text, build a shortlist, or generate your own option-picker / "build your order" form — the user selects and configures items directly in the widget.

jetms-browse_menu

Use this tool to clarify or confirm the user's delivery location BEFORE searching for restaurants. Call this whenever: (1) no location has been provided, (2) the location is vague (e.g. 'near me', a city name), or (3) you have GPS coordinates but haven't confirmed the city with the user yet. Do NOT call search_restaurants until this tool returns a confirmed postcode or city. This tool returns text only — it will never show a widget.

jetms-confirm_delivery_location

Get the full details for a single Just Eat menu item — pricing, size variations, and the complete customisation tree. Call this AFTER search_restaurants and BEFORE basket(add), using the seoName and product id from the search result. When requires_configuration is true, the response includes configuration_steps: every step the customer must answer (size, sauces, sides, meal parts, deal choices) with its available_options, min_choices and max_choices. Present ALL required steps to the user in one message, collect their choices, then pass them to basket(add) as answers in a SINGLE call — do NOT call basket(add) step by step. For items with more than one size, use modifier_steps_by_variation_id, keyed by the variation_id of the size the user chose, to show only the modifiers that apply to that size. Do NOT call basket(add) for an item until you have called this tool and confirmed whether it needs configuration — basket(add) will reject an unconfigured item. All prices are in pounds (GBP). This tool returns text only — it will never show a widget.

jetms-get_catalogue_item

Build and manage the user's Just Eat delivery basket. Set the operation field: 'add' — Add a menu item. Requires seoName + itemId, plus postcode (or lat + lng) for the delivery address. If get_catalogue_item reported requires_configuration=true for the item, you MUST include answers for every required configuration step in this same call — basket(add) does NOT return the option list. Omit basketId to start a new basket; pass basketId to add another item to the basket you already started. 'view' — Show the basket: items, productIds, quantities, subtotal, delivery charge and total. Requires basketId. 'remove' — Remove one line. Requires basketId + productId taken from a 'view' response. 'clear' — Empty the basket. Use when the user changes their mind or switches restaurant. Requires basketId. Ordering: search_restaurants → get_catalogue_item → basket(add). Do NOT call basket(add) before search_restaurants has given you a seoName. Do NOT call basket(add) for a configurable item before get_catalogue_item has given you its configuration_steps. A basket belongs to exactly one restaurant — to order from a different restaurant, start a new basket by omitting basketId. All prices are in pence (GBP minor units); divide by 100 when telling the user. This tool does not place an order or take payment: give the user the checkout_url so they can review and pay on just-eat.co.uk. add/view/remove operations return a basket widget. clear returns text only.

jetms-basket

Search for products available for delivery from Just Eat partners (restaurants). Only call this tool when the delivery location is already confirmed — either the user provided a postcode, or they confirmed their city via confirm_delivery_location. Never call this tool as a first step when location is unknown or unconfirmed. Pass what the customer wants as a structured products array. This renders a restaurant results widget that is the COMPLETE interface for choosing a restaurant. After it returns, reply with at most ONE short sentence (e.g. "Here are burger places near <postcode>."). Do NOT also: re-list the restaurants as a text table or shortlist, or generate your own option-picker / "build your order" form — the user picks a restaurant directly in the widget. Use the returned seoName/product ids only for your own follow-up tool calls (browse_menu, get_catalogue_item), not as user-facing text.

jetms-search_restaurants