{"server":"musqet-agentic-mcp","protocolVersion":"2025-06-18","transport":"streamable-http","endpoint":"\/mcp","method":"POST","tools":[{"name":"search_catalog","description":"Search the merchant catalogue (UCP dev.ucp.shopping.catalog). Free-text `query` plus optional `filters` and `pagination`; returns matching products (price_range, media, variants) in the UCP catalog envelope.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Free-text search query. Optional \u2014 omit to browse the catalogue."},"filters":{"type":"object","description":"Optional criteria to narrow results.","properties":{"category_id":{"type":"integer","description":"Return only products in this category id (from product_list_categories). Enumerate a category without guessing keywords."}}},"pagination":{"type":"object","description":"Pagination: { first: <count 1-100>, cursor: <opaque from a previous response> }.","properties":{"first":{"type":"integer","minimum":1,"maximum":100},"cursor":{"type":"string"}}}},"additionalProperties":true}},{"name":"lookup_catalog","description":"Batch-look up products by identifier (UCP dev.ucp.shopping.catalog). Pass `ids` (array of SKUs); returns the matching products in the UCP catalog envelope, with a warning for any id not found.","inputSchema":{"type":"object","properties":{"ids":{"type":"array","items":{"type":"string"},"description":"Product identifiers (SKUs) to look up."},"filters":{"type":"object","description":"Optional filter criteria."}},"required":["ids"],"additionalProperties":true}},{"name":"get_product","description":"Fetch full detail for a single product by id\/SKU (UCP dev.ucp.shopping.catalog). Returns the product (full description, variants, configurable options) in the UCP catalog envelope.","inputSchema":{"type":"object","properties":{"id":{"type":"string","description":"Product or variant identifier (SKU)."},"selected":{"type":"array","description":"Option selections, e.g. [{name, value}] (optional)."},"preferences":{"type":"array","items":{"type":"string"},"description":"Relaxation priority when an exact match is unavailable (optional)."}},"required":["id"],"additionalProperties":true}},{"name":"product_search","description":"DEPRECATED alias of `search_catalog` (use that for UCP-spec compliance). Search the merchant catalogue by free-text query. Returns up to `limit` matching products with id, title, price range, media, and variant information.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Search terms \u2014 matched against product name and SKU. Optional: omit (or empty) to browse the whole catalogue."},"limit":{"type":"integer","minimum":1,"maximum":100,"default":20}},"additionalProperties":false}},{"name":"product_lookup","description":"DEPRECATED alias of `get_product` (use that for UCP-spec compliance). Fetch full detail for a single product by SKU. Returns title, full description, price range, media, variants and configurable options.","inputSchema":{"type":"object","properties":{"sku":{"type":"string","description":"Product SKU (the `id` field returned by product_search)."}},"required":["sku"],"additionalProperties":false}},{"name":"product_list_categories","description":"List every active storefront category with id, name, and full breadcrumb path. Used by agents to understand the catalogue's top-level shape before searching.","inputSchema":{"type":"object","properties":{},"additionalProperties":false}},{"name":"check_inventory","description":"Check whether a SKU is currently in stock. Pass `quantity` to verify a specific amount is available.","inputSchema":{"type":"object","properties":{"sku":{"type":"string"},"quantity":{"type":"integer","minimum":1,"default":1}},"required":["sku"],"additionalProperties":false}},{"name":"get_pricing","description":"Get the unit price and extended total for a SKU at a given quantity, in the store's currency. Reflects any active catalogue rules \/ sale prices.","inputSchema":{"type":"object","properties":{"sku":{"type":"string"},"quantity":{"type":"integer","minimum":1,"default":1}},"required":["sku"],"additionalProperties":false}},{"name":"get_policy","description":"Return the public URL of the merchant's policy document. Names: returns, shipping, privacy, agent_terms.","inputSchema":{"type":"object","properties":{"name":{"type":"string","enum":["returns","shipping","privacy","agent_terms"]}},"required":["name"],"additionalProperties":false}},{"name":"start_checkout","description":"Open a UCP checkout session for the supplied line items. Returns the session id and the UCP REST endpoint the agent then uses to update the session, pick payment, and complete the purchase.","inputSchema":{"type":"object","properties":{"items":{"type":"array","description":"Line items in UCP shape.","minItems":1,"items":{"type":"object","properties":{"sku":{"type":"string"},"quantity":{"type":"integer","minimum":1}},"required":["sku","quantity"],"additionalProperties":false}}},"required":["items"],"additionalProperties":false}}]}