io.github.yh919/servd-agent-ordering

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 passed

Reviewed 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.