ucp_list_products
Search and browse the product catalog. ALWAYS include a search term when the user names a product, brand, or type — never call this tool without a search on stores with large catalogs. Returns product objects each with an "id" field — use these IDs in line_items when calling create_checkout. Each product includes a "price" object with "amount" (minor units integer, e.g. 1000 for €10.00), "formatted" (display-ready string like "€10.00"), and "currency" code. Use limit=10 unless the user needs more.
Input Schema
{
"type": "object",
"required": [],
"properties": {
"page": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Page number for pagination"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Number of products to return. Default 10. Use 10 unless user asks for more \u2014 higher values bloat context."
},
"query": {
"type": "string",
"description": "Alias for search parameter"
},
"search": {
"type": "string",
"description": "Search query for product name or description (alias: query)"
},
"category": {
"type": "string",
"description": "Filter by category slug or ID"
},
"in_stock": {
"type": "boolean",
"description": "Filter by stock availability"
},
"max_price": {
"type": "number",
"minimum": 0,
"description": "Maximum price filter in major currency units (e.g., 100.00 for \u20ac100)"
},
"min_price": {
"type": "number",
"minimum": 0,
"description": "Minimum price filter in major currency units (e.g., 10.00 for \u20ac10)"
}
}
}
Stores exposing the ucp_list_products tool
Get the agentic commerce digest every Monday
Real adoption data, ecosystem trends, new spec versions, and the stores that broke or recovered this week. Read by founders and engineers building the next generation of commerce.
