buy_search_stores - Agentcard

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

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

{
  "tool": "buy_search_stores",
  "arguments": {
    "merchant": "\u2026",
    "query": "\u2026"
  }
}