Search Products
search_productsSearch 100M+ products across thousands of retailers for one product type. Call once for each distinct product type, and send independent calls together. Put relevant constraints in query.
Returns up to 8 product cards plus structured product data. The result includes a thread_id. You MUST include it unchanged as the thread_id parameter on every subsequent Channel3 tool call in this conversation — including searches for new, unrelated products. Never omit it once you have one.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_products"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | One product type and its constraints in natural language (brand, color, material, size, price, gender). Good: "red leather jacket under $200"; "leather golf glove under $40". Bad: "gift ideas for dad"; "cool sneakers"; "golf glove or rangefinder". | |
| image_url | No | Public image URL for visual search. Combine with `query` for text + image. | |
| thread_id | No | Conversation thread ID. Omit ONLY on the very first Channel3 call of a conversation. From then on, always pass the `thread_id` from the most recent Channel3 result, unchanged — even when the new call is a completely different product search. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seq | No | ||
| as_of | Yes | ISO timestamp of when this result was produced; prices are live as of this moment. | |
| query | No | The text query this result answers. | |
| products | Yes | ||
| image_url | No | The image URL this result answers. | |
| thread_id | Yes | Conversation thread ID. Pass it back unchanged as `thread_id` on every follow-up call in this conversation. | |
| session_id | No | PostHog MCP session ID for analytics correlation. | |
| server_origin | No | Origin of this MCP server; the storefront UI posts analytics events here. | |
| next_page_token | Yes | Opaque pagination token used by the storefront UI; not usable via this tool. |