{"name":"world-products","protocol":"mcp","jsonrpc":"2.0","transport":"http","methods":["initialize","tools/list","tools/call"],"tools":[{"name":"search_catalog","description":"Semantic recommendation search over the World Products catalog. Use this for specific shopper intent; returns best-ranked matches, not the full catalog."},{"name":"browse_catalog","description":"Paginated catalog browse/search. Use this for broad category queries and when an agent needs more products beyond recommendations. Returns products plus nextCursor for pagination."},{"name":"ask_catalog","description":"Agentic catalog search for nuanced / multi-constraint requests (e.g. 'a minimalist ceramic tea cup under $15 for a small apartment, not a full set'). Runs a multi-step loop: parses intent (keywords, price, persona, must-haves, exclusions), retrieves semantically, reasons over candidates to keep only true matches, broadens and re-queries if results are thin, and returns a short answer plus the ranked products. Slower than search_catalog; use when the request has constraints or context."},{"name":"get_product","description":"Fetch full agent-readable detail for one product by its handle (from search_catalog results): title, price, variants, agentic summary, target personas, use cases, and the product URL + add-to-cart URL."}],"note":"POST JSON-RPC 2.0. tools: search_catalog (ranked recommendations), browse_catalog (paginated catalog), ask_catalog (agentic multi-step), get_product."}