Servd Agentic Ordering

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 one venue’s opening hours, current open state, pickup and delivery availability, published policies, and available agent-order payment mode.

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.

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.

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.

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.