Servd Agentic Ordering

Check payment and fulfillment state for an order created by place_order, or verify a signed sandbox simulation. The result intentionally omits diner contact, address, notes, and line items. Poll while state is awaiting_payment; stop when it becomes paid, preparing, ready, out_for_delivery, completed, cancelled, or expired.

Find restaurants on Servd. Returns each venue’s slug, name and city — the slug is what every other tool needs. Pass `query` to filter by name or city.

Get a venue’s full live menu. Use item ids in validate_cart and place_order. Prices are major-unit decimal strings in the menu currency; required modifier groups declare min and max selections. promotions includes fixed-price combos, item alternatives, required and included modifier rules, and eligible offers. Use combo ids and component_modifiers in cart tools; amounts inside promotion rules are MINOR units. Keep branch_id and fulfillment consistent through menu, quote, and order.

Get one venue’s opening hours, current open state, pickup and delivery availability, published policies, and available agent-order payment mode.

Create a REAL restaurant order only after showing the latest validate_cart result and receiving explicit diner confirmation. A venue explicitly marked agentOrdering.sandbox instead returns a no-charge, no-kitchen simulation with sandbox=true and createsProductionOrder=false. Pass that result’s confirmation.token so the server can prove the cart and live quote did not change. The server recalculates all prices. Use a unique idempotency key, show orderNumber and the labeled customerLinks, and poll check_order for payment and fulfillment status. Unpaid online orders expire after 30 minutes.

Validate a proposed cart and calculate authoritative lines, discounts, fees, tax and total without creating an order. Call this immediately before asking the diner to confirm. Send only the minimum diner contact and fulfillment data required for this order.