get_filters
Call get_filters at the start of a session to learn which category, brand, color, material, gender, occasion, season, style, silhouette, pattern, and currency values exist in the current catalog. Returns the categoryTree (a flat DFS-ordered list of { value, label } entries — every value can be passed directly as discover_products.category) plus available filter values and the price range. Request only the dimensions you need via fields to keep responses fast and compact.
Parameters
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
fields | string[] | No | all | Which dimensions to return. Omit for all. Only requested fields are queried. |
brand_search | string | No | — | Search brands by name (case-insensitive, prefix matches first). |
brand_page | number | No | 1 | Page number for brands (12 per page). |
gender | string | No | — | Scope categoryTree to this gender (women, men, unisex, girls, boys). Omit for merged union. |
Valid fields values: categoryTree, brands, colors, materials, genders, occasions, seasons, styles, silhouettes, patterns, 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.
{
"categoryTree": [
{ "value": "clothing", "label": "Clothing" },
{ "value": "clothing/jackets", "label": "Jackets" },
{ "value": "clothing/jackets/blazers", "label": "Blazers" },
{ "value": "clothing/jackets/bomber-jackets", "label": "Bomber Jackets" },
"..."
],
"brands": ["Reformation", "Grenson", "..."],
"colors": ["black", "white", "navy", "sage", "..."],
"materials": ["cotton", "silk", "leather", "..."],
"genders": ["women", "men", "unisex", "girls", "boys"],
"occasions": ["casual", "formal", "business", "..."],
"seasons": ["spring", "summer", "fall", "winter", "all-season"],
"styles": ["minimalist", "elegant", "streetwear", "..."],
"silhouettes": ["fitted", "oversized", "relaxed", "..."],
"patterns": ["solid", "stripe", "checked", "floral", "..."],
"currencies": ["USD", "EUR", "PLN", "..."],
"priceRange": { "min": null, "max": null }
}
Response fields
| Field | Description |
|---|---|
categoryTree | Flat DFS-ordered list of { value, label } entries. Hierarchy is encoded in the value slug (e.g. clothing/jackets/bomber-jackets); parents appear before descendants. Every value can be passed as discover_products.category. |
brands | All available brand names |
colors / materials | Valid values for the colors and materials filters in discover_products |
genders / occasions / seasons | Valid enum values for discover_products filters |
styles / silhouettes | Valid values for style and silhouette filters in discover_products |
patterns | Valid values for the pattern filter in discover_products |
currencies | Currency codes supported by catalog pricing and price filters |
priceRange | Shape of the price filter. Each bound is a positive USD float with up to 2 decimal places, or null for no bound. When both are set, max should be greater than min. Always returns { min: null, max: null } — the field documents the contract, not catalog state. |
Examples
Get everything (default):
{
"name": "get_filters",
"arguments": {}
}
Request only specific dimensions:
{
"name": "get_filters",
"arguments": {
"fields": ["categoryTree", "colors", "priceRange"]
}
}
Scope categoryTree to a single gender:
{
"name": "get_filters",
"arguments": {
"fields": ["categoryTree"],
"gender": "women"
}
}
Related tools
The values returned here are the valid inputs to the equivalent filters on discover_products. For brand discovery against the brand profiles rather than just the brand-name list, use discover_brands.