get_filters

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

Parameters

ParameterTypeRequiredDefaultDescription
fieldsstring[]NoallWhich dimensions to return. Omit for all. Only requested fields are queried.
categorystringNoScope subcategories to a category (e.g. footwear returns only footwear subcategories).
brand_searchstringNoSearch brands by name (case-insensitive, prefix matches first).
brand_pagenumberNo1Page number for brands (50 per page).

Valid fields values: categories, subcategories, brands, colors, materials, genders, occasions, seasons, styles, silhouettes, currencies, priceRange.

Response

Returns a JSON object with every filterable dimension and its current values. The response is dynamic — values reflect what's actually in the catalog right now.

{
  "categories": ["apparel", "footwear", "accessories", "bags", "..."],
  "subcategories": ["dresses", "sneakers", "crossbody bags", "..."],
  "brands": ["Reformation", "Grenson", "..."],
  "colors": ["black", "white", "navy", "sage", "..."],
  "materials": ["cotton", "silk", "leather", "..."],
  "genders": ["women", "men", "unisex", "kids"],
  "occasions": ["casual", "formal", "athletic", "..."],
  "seasons": ["spring", "summer", "fall", "winter", "all-season"],
  "styles": ["minimalist", "bohemian", "streetwear", "..."],
  "silhouettes": ["fitted", "oversized", "relaxed", "..."],
  "currencies": ["USD", "EUR", "PLN", "..."],
  "priceRange": { "min": 8, "max": 4200 }
}

Response fields

FieldDescription
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
currenciesCurrency codes supported by catalog pricing and price filters
priceRangeMin and max prices across the entire catalog

Example

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

When to use

Call get_filters when you need to know what values are valid for a specific dimension — e.g. fields: ["colors", "brands"] before filtering by color. Request only the fields you need to keep responses fast and compact.