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
| Parameter | Type | Required | Default | Description |
|---|---|---|---|---|
fields | string[] | No | all | Which dimensions to return. Omit for all. Only requested fields are queried. |
category | string | No | — | Scope subcategories to a category (e.g. footwear returns only footwear subcategories). |
brand_search | string | No | — | Search brands by name (case-insensitive, prefix matches first). |
brand_page | number | No | 1 | Page 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
| Field | Description |
|---|---|
categories | Valid values for the category parameter in search/discover tools |
subcategories | All available subcategories (lowercase) |
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 |
currencies | Currency codes supported by catalog pricing and price filters |
priceRange | Min 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.