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

> Search a linked merchant for products by keyword.

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

Search a linked merchant for products by keyword. For the retail merchant the store ids are FIXED — amazon, walmart — so skip buy\_search\_stores/buy\_select\_store entirely and pass store\_id directly on the first search. For DoorDash, select a store first (buy\_select\_store) and then PASS store\_id ON EVERY SEARCH — the server-side store scope is volatile, and omitting it silently falls back to the nearest grocery store.

## Inputs

| Field                   | Type   | Description                                                                                                                                             |
| ----------------------- | ------ | ------------------------------------------------------------------------------------------------------------------------------------------------------- |
| `merchant` *(required)* | string |                                                                                                                                                         |
| `query` *(required)*    | string |                                                                                                                                                         |
| `store_id`              | string | multi-store merchants (DoorDash): the selected store's id from buy\_select\_store. Required after selecting a store — it pins the search to that store. |
| `store_kind`            | string | the selected store's kind from buy\_search\_stores (e.g. 'restaurant' \| 'grocery'), when known                                                         |

## Returns

None.

## Example call

```json theme={null}
{
  "tool": "buy_search_products",
  "arguments": {
    "merchant": "\u2026",
    "query": "\u2026"
  }
}
```