buy_get_item_options

Connect to https://mcp.agentcard.sh/mcp with the user’s connection token (or a buy_token for org-owned accounts). Behavior: read-only, idempotent.

Not in the default tools/list. It is still callable by exact name, and appears when the client sends the x-expert-tools: 1 header.

What it does

For a restaurant item where buy_search_products reported hasOptions=true, or the user asked to customize/modify an item, or buy_add_to_cart failed with options_required: fetch its customization option groups (e.g. “Choose Your Filling” — required, pick 1 of N) so the user can choose before adding. Returns groups [{id, name, min, max, required, options:[{id, name, priceCents, nested}]}] — an option can carry its OWN required nested groups (a combo side’s size, a drink’s flavor); every required group AND required nested group needs a selection. Pass the chosen option ids to buy_add_to_cart as options. Not for grocery items.

Inputs

Field	Type	Description
`merchant` (required)	string	Merchant slug, e.g. ‘doordash’.
`product_id` (required)	string	Product id from buy_search_products.
`store_id`	string	Store id (from buy_search_stores) when the item was found at a specific store.

Returns

None.

Example call

{
  "tool": "buy_get_item_options",
  "arguments": {
    "merchant": "\u2026",
    "product_id": "\u2026"
  }
}

MCP

Organization tools

User tools

buy_get_item_options

What it does

Inputs

Returns

Example call

​What it does

​Inputs

​Returns

​Example call

What it does

Inputs

Returns

Example call