catalog_search

Search the unbranded master catalog.

Searches the master_products catalog — the unbranded LT/wholesale catalog that store owners publish into their stores. Returns up to 100 products per call. No auth required.

Request

arguments
{
  "q": "string?",
  "category": "string?",
  "gender": "string?",
  "color_hex": "string?",
  "price_band_cents": "string?  // e.g. \"1000-3000\"",
  "material": "string?",
  "sizes": "string[]?",
  "brand_slug": "string?",
  "vendor": "string?",
  "base_cost_max": "number?",
  "limit": "number  // 1-100, default 24",
  "page": "number  // default 1",
  "sort": "\"relevance\" | \"newest\" | \"price_asc\" | \"price_desc\" | \"title\""
}

Response

content[0].text (JSON-parsed)
{
  "results": [
    {
      "id": "uuid",
      "slug": "string",
      "title": "string",
      "base_cost_cents": "number",
      "hero_image_url": "string",
      "colors": [{ "name": "string", "hex": "string" }],
      "sizes": "string[]"
    }
  ],
  "page": "number",
  "total": "number"
}

Example

tool call
{
  "name": "catalog_search",
  "arguments": {
    "q": "tee",
    "category": "tops",
    "color_hex": "#000000",
    "limit": 12
  }
}

Related tools