get_filters

get_filters

Returns all available filter values in the catalog: categories, subcategories, brands, colors, materials, genders, occasions, seasons, styles, silhouettes, and the price range. Call this at the start of a session so the agent knows what's available before searching.

Parameters

None. This tool takes no parameters.

Response

{
  "totalProducts": 12847,
  "categories": [
    "Accessories",
    "Activewear",
    "Apparel",
    "Bags",
    "Beauty",
    "Footwear",
    "Home",
    "Intimates",
    "Jewelry",
    "Outerwear",
    "Swimwear"
  ],
  "subcategories": [
    "backpacks",
    "belts",
    "bikinis",
    "blazers",
    "blouses",
    "boots",
    "bracelets",
    "candles",
    "clutches",
    "coats",
    "crossbody bags",
    "dresses",
    "earrings",
    "flats",
    "heels",
    "hoodies",
    "jackets",
    "jeans",
    "leggings",
    "loafers",
    "necklaces",
    "pants",
    "rings",
    "sandals",
    "shirts",
    "shorts",
    "skirts",
    "sneakers",
    "sweaters",
    "t-shirts",
    "tops",
    "watches"
  ],
  "brands": [
    "Aritzia",
    "COS",
    "Everlane",
    "Grenson",
    "Kith",
    "Madewell",
    "Reformation",
    "Stussy"
  ],
  "colors": [
    "beige",
    "black",
    "blue",
    "brown",
    "burgundy",
    "camel",
    "charcoal",
    "coral",
    "cream",
    "gold",
    "green",
    "grey",
    "ivory",
    "khaki",
    "lavender",
    "mint",
    "navy",
    "nude",
    "olive",
    "orange",
    "peach",
    "pink",
    "purple",
    "red",
    "rose",
    "rust",
    "sage",
    "sand",
    "silver",
    "tan",
    "teal",
    "terracotta",
    "white",
    "yellow"
  ],
  "materials": [
    "canvas",
    "cashmere",
    "chiffon",
    "cotton",
    "denim",
    "elastane",
    "faux leather",
    "fleece",
    "jersey",
    "lace",
    "leather",
    "linen",
    "mesh",
    "modal",
    "nylon",
    "polyester",
    "rayon",
    "satin",
    "silk",
    "suede",
    "velvet",
    "viscose",
    "wool"
  ],
  "genders": ["kids", "men", "unisex", "women"],
  "occasions": [
    "athletic",
    "business",
    "casual",
    "evening",
    "formal",
    "loungewear",
    "outdoor",
    "streetwear",
    "wedding"
  ],
  "seasons": ["all-season", "fall", "spring", "summer", "winter"],
  "styles": ["bohemian", "classic", "minimalist", "preppy", "romantic", "streetwear", "utility", "vintage"],
  "silhouettes": ["a-line", "fitted", "oversized", "relaxed", "slim", "straight", "tailored", "wide"],
  "priceRange": { "min": 8, "max": 4200 }
}

Response fields

FieldDescription
totalProductsTotal number of active products in the catalog
categoriesValid values for the category parameter in search/discover tools
subcategoriesAll available subcategories (lowercase)
brandsAll available brand names
colors / materialsValid values for the colors and materials filters in discover_products
genders / occasions / seasonsValid enum values for discover_products filters
styles / silhouettesValid values for style and silhouette filters in discover_products
priceRangeMin and max prices across the entire catalog

Example

{
  "name": "get_filters",
  "arguments": {}
}

When to use

Call get_filters at the start of a session to understand the catalog scope. This tells agents what values are valid for the category, gender, occasion, season, style, and silhouette parameters, and gives context about available brands, colors, materials, and price range.