Servd Agentic Ordering
Discover Servd venues, browse menus, validate carts, place confirmed orders, and track status.
- 1.6.0
- Version
- remote
- Transport
- 6
- Tools
Security review
Review passedReviewed Jan 1, 2000.
- tools: 6 tools scanned
- metadata: scanned
No findings.
Tools (6)
find_venues
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_venue
Get one venue’s opening hours, current open state, pickup and delivery availability, published policies, and available agent-order payment mode.
get_menu
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_cart
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.
place_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_order
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.