buy_search_products

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

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

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

MCP

Organization tools

User tools

buy_search_products

What it does

Inputs

Returns

Example call

​What it does

​Inputs

​Returns

​Example call

What it does

Inputs

Returns

Example call