Tolstoy Shopper

Search the catalog by a specific free-text query (e.g. a product name, material, or occasion the shopper named). In marketplace mode, searches across every brand store on Tolstoy — one catalog, no store selection needed. Use this only when the shopper names something specific to look for. For open-ended browsing, featured, best sellers, or a collection, use browse_products instead. When shopping a single brand, the optional `filters` (category/productType/tag) narrow the results. Each result carries a `productRef`; pass it to get_product for full details.

{
  "type": "object",
  "properties": {
    "query": {
      "type": "string",
      "minLength": 1,
      "description": "What the shopper is looking for."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 12,
      "description": "Maximum number of products to return."
    },
    "cursor": {
      "type": "string",
      "description": "Pagination cursor from a previous search result."
    },
    "filters": {
      "type": "object",
      "properties": {
        "category": {
          "type": "string",
          "description": "Restrict to a product category."
        },
        "productType": {
          "type": "string",
          "description": "Restrict to a product type."
        },
        "tag": {
          "type": "string",
          "description": "Restrict to products carrying this tag."
        }
      },
      "additionalProperties": false
    }
  },
  "required": [
    "query"
  ],
  "additionalProperties": false
}

Load full details for one product by its `productRef` (from search_products or browse_products): description, price, media, the brand's real product videos, size guide, per-variant stock, and buy links. Returns each variant's id and options (size/color). Use it to resolve the exact `variantId` the shopper wants before calling build_cart, and to answer fit/sizing questions from the size guide. The response includes the product image so it can be seen directly.

{
  "type": "object",
  "properties": {
    "productRef": {
      "type": "string",
      "minLength": 1,
      "description": "Product reference token from search_products."
    }
  },
  "required": [
    "productRef"
  ],
  "additionalProperties": false
}

Opens an interactive virtual try-on for a product (by `productRef` from `search_products`): the shopper uploads their photo and gets a photorealistic image of themselves wearing the actual product — true to the real garment. Only available for brands that enabled marketplace try-on; when unavailable, the response says so and the product can still be viewed via its store link.

{
  "type": "object",
  "properties": {
    "productRef": {
      "type": "string",
      "minLength": 1,
      "description": "Product reference token from search_products."
    }
  },
  "required": [
    "productRef"
  ],
  "additionalProperties": false
}