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

> Find orderable stores within a multi-store merchant (DoorDash) by name.

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

Find orderable stores within a multi-store merchant (DoorDash) by name. Pick one with buy\_select\_store before searching products. Single-store merchants (Rappi region, Good Eggs) don't need this. NEVER needed for the retail merchant: its store ids are fixed (amazon, walmart) — pass one straight to buy\_search\_products as store\_id.

## Inputs

| Field                   | Type   | Description |
| ----------------------- | ------ | ----------- |
| `merchant` *(required)* | string |             |
| `query` *(required)*    | string |             |

## Returns

None.

## Example call

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