Servd Agentic Ordering

Working · 1.2 s

io.github.yh919/servd-agent-orderingv1.6.0

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

Local Services

Source Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://app.getservd.me/api/v1/agent/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

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.

order_idstring, required

The machine-facing orderId from place_order.

Tools (6)

check_order

read-only

Argument	Type	Description
order_id*	string	The machine-facing orderId from place_order.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "order_id"
  ],
  "properties": {
    "order_id": {
      "type": "string",
      "description": "The machine-facing orderId from place_order."
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
limit	integer
query	string	Optional name or city filter, case-insensitive.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "default": 25,
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Optional name or city filter, case-insensitive."
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
slug*	string	The venue slug.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "The venue slug."
    }
  },
  "additionalProperties": false
}

get_venue

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

read-only

Argument	Type	Description
slug*	string	The venue slug.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "slug"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "description": "The venue slug."
    }
  },
  "additionalProperties": false
}

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.

destructive

Argument	Type	Description
slug*	string	The venue slug returned by find_venues.
items	array
combos	array
customer*	object	The diner’s minimum contact details required by the venue.
delivery	object	For delivery, street is required and coordinates may be needed for fees/radius.
confirmed*	boolean	Set true only after the diner explicitly confirms the latest validate_cart result.
tip_amount	number

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.

read-only

Argument	Type	Description
slug*	string	The venue slug returned by find_venues.
items	array
combos	array
customer	object
delivery	object
tip_amount	number	Major currency units.
fulfillment*	string
payment_method	string

Input schema (JSON)

{
  "type": "object",
  "anyOf": [
    {
      "required": [
        "items"
      ]
    },
    {
      "required": [
        "combos"
      ]
    }
  ],
  "required": [
    "slug",
    "fulfillment"
  ],
  "properties": {
    "slug": {
      "type": "string",
      "maxLength": 160,
      "minLength": 1,
      "description": "The venue slug returned by find_venues."
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "menu_item_id",
          "quantity"
        ],
        "properties": {
          "quantity": {
            "type": "integer",
            "maximum": 99,
            "minimum": 1
          },
          "menu_item_id": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1,
            "description": "The item id returned by get_menu."
          },
          "selected_modifiers": {
            "type": "array",
            "items": {
              "type": "object",
              "required": [
                "group",
                "name"
              ],
              "properties": {
                "name": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "group": {
                  "type": "string",
                  "maxLength": 200,
                  "minLength": 1
                },
                "price_adj": {
                  "type": "number",
                  "description": "Informational major-unit amount from get_menu; the server recalculates it."
                }
              },
              "additionalProperties": false
            },
            "maxItems": 50
          },
          "special_instructions": {
            "type": "string",
            "maxLength": 1000
          }
        },
        "additionalProperties": false
      },
      "maxItems": 100,
      "minItems": 1
    },
    "combos": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "combo_id",
          "quantity"
        ],
        "properties": {
          "combo_id": {
            "type": "string",
            "maxLength": 128,
            "minLength": 1
          },
          "quantity": {
            "type": "integer",
            "maximum": 99,
            "minimum": 1
          }
        },
        "additionalProperties": false
      },
      "maxItems": 100,
      "minItems": 1
    },
    "customer": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "maxLength": 200
        },
        "email": {
          "type": "string",
          "format": "email",
          "maxLength": 320
        },
        "phone": {
          "type": "string",
          "maxLength": 64
        }
      },
      "additionalProperties": false
    },
    "delivery": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string",
          "maxLength": 200
        },
        "floor": {
          "type": "string",
          "maxLength": 200
        },
        "street": {
          "type": "string",
          "maxLength": 500
        },
        "building": {
          "type": "string",
          "maxLength": 200
        },
        "latitude": {
          "type": "number",
          "maximum": 90,
          "minimum": -90
        },
        "apartment": {
          "type": "string",
          "maxLength": 200
        },
        "longitude": {
          "type": "number",
          "maximum": 180,
          "minimum": -180
        }
      },
      "additionalProperties": false
    },
    "tip_amount": {
      "type": "number",
      "minimum": 0,
      "description": "Major currency units."
    },
    "fulfillment": {
      "enum": [
        "pickup",
        "delivery"
      ],
      "type": "string"
    },
    "payment_method": {
      "enum": [
        "cash",
        "online"
      ],
      "type": "string",
      "default": "online"
    }
  },
  "additionalProperties": false
}

{ "type": "object", "anyOf": [ { "required": [ "items" ] }, { "required": [ "combos" ] } ], "required": [ "slug", "fulfillment", "customer", "confirmed", "confirmation_token", "idempotency_key" ], "properties": { "slug": { "type": "string", "maxLength": 160, "minLength": 1, "description": "The venue slug returned by find_venues." }, "items": { "type": "array", "items": { "type": "object", "required": [ "menu_item_id", "quantity" ], "properties": { "quantity": { "type": "integer", "maximum": 99, "minimum": 1 }, "menu_item_id": { "type": "string", "maxLength": 128, "minLength": 1, "description": "The item id returned by get_menu." }, "selected_modifiers": { "type": "array", "items": { "type": "object", "required": [ "group", "name" ], "properties": { "name": { "type": "string", "maxLength": 200, "minLength": 1 }, "group": { "type": "string", "maxLength": 200, "minLength": 1 }, "price_adj": { "type": "number", "description": "Informational major-unit amount from get_menu; the server recalculates it." } }, "additionalProperties": false }, "maxItems": 50 }, "special_instructions": { "type": "string", "maxLength": 1000 } }, "additionalProperties": false }, "maxItems": 100, "minItems": 1 }, "combos": { "type": "array", "items": { "type": "object", "required": [ "combo_id", "quantity" ], "properties": { "combo_id": { "type": "string", "maxLength": 128, "minLength": 1 }, "quantity": { "type": "integer", "maximum": 99, "minimum": 1 } }, "additionalProperties": false }, "maxItems": 100, "minItems": 1 }, "customer": { "type": "object", "required": [ "name", "phone" ], "properties": { "name": { "type": "string", "maxLength": 200 }, "email": { "type": "string", "format": "email", "maxLength": 320 }, "phone": { "type": "string", "maxLength": 64 } }, "description": "The diner’s minimum contact details required by the venue.", "additionalProperties": false }, "delivery": { "type": "object", "properties": { "city": { "type": "string", "maxLength": 200 }, "floor": { "type": "string", "maxLength": 200 }, "street": { "type": "string", "maxLength": 500 }, "building": { "type": "string", "maxLength": 200 }, "latitude": { "type": "number", "maximum": 90, "minimum": -90 }, "apartment": { "type": "string", "maxLength": 200 }, "longitude": { "type": "number", "maximum": 180, "minimum": -180 } }, "description": "For delivery, street is required and coordinates may be needed for fees/radius.", "additionalProperties": false }, "confirmed": { "type": "boolean", "const": true, "description": "Set true only after the diner explicitly confirms the latest validate_cart result." }, "tip_amount": { "type": "number", "minimum": 0, "description": "Major currency units." }, "fulfillment": { "enum": [ "pickup", "delivery" ], "type": "string" }, "payment_method": { "enum": [ "cash", "online" ], "type": "string", "default": "online" }, "idempotency_key": { "type": "string", "maxLength": 255, "minLength": 1, "description": "Use validate_cart.confirmation.idempotencyKey exactly; reuse it for retries of this confirmed order." }, "confirmation_token": { "type": "string", "maxLength": 2048, "minLength": 1, "description": "The short-lived confirmation.token from the exact validate_cart result shown to the diner." } }, "additionalProperties": false }