Servd Agentic Ordering

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

Discover Servd venues, browse menus, validate carts, place confirmed orders, and track status.

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "Servd Agentic Ordering": {
      "url": "https://app.getservd.me/api/v1/agent/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (6)

• find_venues read-only

  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.

  Parameters:

  • limit — integer
  • query — string — Optional name or city filter, case-insensitive.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_venue read-only

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

  Parameters:

  • slug (required) — string — The venue slug.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• get_menu read-only

  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.

  Parameters:

  • slug (required) — string — The venue slug.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• validate_cart read-only

  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.

  Parameters:

  • slug (required) — string — The venue slug returned by find_venues.
  • fulfillment (required) — string
  • items — array
  • combos — array
  • customer — object
  • delivery — object
  • tip_amount — number — Major currency units.
  • payment_method — string

  Hints: read-only yes · destructive no · idempotent yes · open-world no

• place_order destructive

  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.

  Parameters:

  • slug (required) — string — The venue slug returned by find_venues.
  • fulfillment (required) — string
  • customer (required) — object — The diner’s minimum contact details required by the venue.
  • confirmed (required) — boolean — Set true only after the diner explicitly confirms the latest validate_cart result.
  • confirmation_token (required) — string — The short-lived confirmation.token from the exact validate_cart result shown to the diner.
  • idempotency_key (required) — string — Use validate_cart.confirmation.idempotencyKey exactly; reuse it for retries of this confirmed order.
  • items — array
  • combos — array
  • delivery — object — For delivery, street is required and coordinates may be needed for fees/radius.
  • tip_amount — number — Major currency units.
  • payment_method — string

  Hints: read-only no · destructive yes · idempotent yes · open-world yes

• check_order read-only

  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.

  Parameters:

  • order_id (required) — string — The machine-facing orderId from place_order.

  Hints: read-only yes · destructive no · idempotent yes · open-world no

Publisher website Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.