> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agentcard.sh/llms.txt
> Use this file to discover all available pages before exploring further.

# buy_get_item_options

> 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…

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.

<Note>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.</Note>

## 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

```json theme={null}
{
  "tool": "buy_get_item_options",
  "arguments": {
    "merchant": "\u2026",
    "product_id": "\u2026"
  }
}
```