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

> Add SEVERAL items to the cart in ONE call — use this instead of repeated buy_add_to_cart whenever the user wants a multi-item order (e.g.

Connect to `https://mcp.agentcard.sh/mcp` with the **user's connection token** (or a `buy_token` for org-owned accounts).

<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

Add SEVERAL items to the cart in ONE call — use this instead of repeated buy\_add\_to\_cart whenever the user wants a multi-item order (e.g. "two pizzas, a drink, and breadsticks"). Building the whole cart at once is REQUIRED for a guest (not-yet-linked) DoorDash cart, which can otherwise hold only one item. Each item is \{ product\_id, quantity?, options? } exactly like buy\_add\_to\_cart (for any item flagged hasOptions, call buy\_get\_item\_options first and pass the chosen ids). Returns the updated cart with subtotal; any item DoorDash rejected is listed under droppedLines so you can tell the user.

## Inputs

| Field                   | Type   | Description                   |
| ----------------------- | ------ | ----------------------------- |
| `merchant` *(required)* | string |                               |
| `items` *(required)*    | array  | the items to add, in one shot |

## Returns

None.

## Example call

```json theme={null}
{
  "tool": "buy_add_items",
  "arguments": {
    "merchant": "\u2026",
    "items": "\u2026"
  }
}
```