Servers Playground How we check Add a server Log in

Realry — fashion price comparison

Working · 1.5 s

com.realry/mcpv1.0.0 Domain verified

Search fashion across 1,000+ retailers; compare prices, sizes and stock by country.

Commerce

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://realry.com/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

compare_products Read-only

Compare multiple fashion products side-by-side on Realry.com — shows best price, discount rate, and number of stores for each. Use Product IDs from search_products results. Ideal for "which is cheaper?" or "help me decide between these" questions.

product_idsarray, required

List of 2–5 Product IDs to compare (shown as "Product ID: `xxx`" in search results)

countrystring

Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.

Realry — fashion price comparison MCP server | mcptry

Tools (11)

compare_products

read-only

Argument	Type	Description
country	string	Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.
product_ids*	array	List of 2–5 Product IDs to compare (shown as "Product ID: `xxx`" in search results)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "product_ids"
  ],
  "properties": {
    "country": {
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ],
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market."
    },
    "product_ids": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "List of 2–5 Product IDs to compare (shown as \"Product ID: `xxx`\" in search results)"
    }
  }
}

find_similar

Find fashion products similar to a given product on Realry.com. Useful for "show me more like this" or "find alternatives" requests. Use the Product ID from search_products results.

read-only

Argument	Type	Description
country	string	Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.
product_id*	string	Product ID to find similar items for (shown as "Product ID: `xxx`" in search results)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "product_id"
  ],
  "properties": {
    "country": {
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ],
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market."
    },
    "product_id": {
      "type": "string",
      "description": "Product ID to find similar items for (shown as \"Product ID: `xxx`\" in search results)"
    }
  }
}

get_brand_products

Get featured products from a specific fashion brand on Realry.com. Use search_brands first to find the brand_id.

read-only

Argument	Type	Description
country	string	Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.
brand_id*	string	Brand ID from search_brands result (shown as "Brand ID: `xxx`")

Input schema (JSON)

{
  "type": "object",
  "required": [
    "brand_id"
  ],
  "properties": {
    "country": {
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ],
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market."
    },
    "brand_id": {
      "type": "string",
      "description": "Brand ID from search_brands result (shown as \"Brand ID: `xxx`\")"
    }
  }
}

get_deals

Browse the hottest deals and discounted fashion products on Realry.com. Optionally filter by gender.

read-only

Argument	Type	Description
gender	string	Who the deals are for. Omit for all.
country	string	Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.
page_length	number	Number of results to return (default: 5, max: 36)

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "gender": {
      "enum": [
        "women",
        "men"
      ],
      "type": "string",
      "description": "Who the deals are for. Omit for all."
    },
    "country": {
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ],
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market."
    },
    "page_length": {
      "type": "number",
      "description": "Number of results to return (default: 5, max: 36)"
    }
  }
}

get_new_arrivals

Browse the latest new arrivals on Realry.com, sorted by newest first. Optionally filter by keyword, price, gender, or color.

read-only

Argument	Type	Description
page	number	Page number (default: 1)
sort	string	Sort order. Omit for best match (default). "new" (newest), "likes" (most liked), "views" (most viewed), "sales" (highest discount), "pricelow" (cheapest first), "pricehigh" (most expensive first).
brand	string	Brand name or slug, e.g. "Nike", "new-balance". Also keep the brand in query together with the model (query "le labo santal 33", brand "Le Labo"): an unknown brand is dropped, and query then still finds it.
query	string	Optional product as a short noun phrase, 1-4 words (e.g. "sneakers", "wool coat"). No gender, price, colour or filler words — use the other parameters.
colors	string	Colour filter, English colour names, comma-separated (e.g. "black" or "black,white"). Use this instead of putting the colour in query.
gender	string	Who the item is for. Use this instead of writing "women's"/"men's" in query.
country	string	Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.

get_price_comparison

Compare prices for a specific fashion product across all stores on Realry.com. Returns stores sorted cheapest first with direct purchase links, the sizes each store lists, and how fresh each store's stock data is.

read-only

Argument	Type	Description
country	string	Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.
product_id*	string	Product ID from search_products result (shown as "Product ID: `xxx`")

Input schema (JSON)

{
  "type": "object",
  "required": [
    "product_id"
  ],
  "properties": {
    "country": {
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ],
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market."
    },
    "product_id": {
      "type": "string",
      "description": "Product ID from search_products result (shown as \"Product ID: `xxx`\")"
    }
  }
}

get_price_history

Get the price history of a specific fashion product on Realry.com over the past 30 days. Helps users decide if now is a good time to buy.

read-only

Argument	Type	Description
country	string	Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.
product_id*	string	Product ID to get price history for (shown as "Product ID: `xxx`" in search results)

Input schema (JSON)

{
  "type": "object",
  "required": [
    "product_id"
  ],
  "properties": {
    "country": {
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ],
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market."
    },
    "product_id": {
      "type": "string",
      "description": "Product ID to get price history for (shown as \"Product ID: `xxx`\" in search results)"
    }
  }
}

get_sale_products

Find sale and discounted fashion products on Realry.com. Optionally filter by keyword, minimum discount percentage, price range, gender, or color.

read-only

Argument	Type	Description
page	number	Page number (default: 1)
sort	string	Sort order. Omit for best match (default). "new" (newest), "likes" (most liked), "views" (most viewed), "sales" (highest discount), "pricelow" (cheapest first), "pricehigh" (most expensive first).
brand	string	Brand name or slug, e.g. "Nike", "new-balance". Also keep the brand in query together with the model (query "le labo santal 33", brand "Le Labo"): an unknown brand is dropped, and query then still finds it.
query	string	Optional product as a short noun phrase, 1-4 words (e.g. "sneakers", "wool coat"). No gender, price, colour or filler words — use the other parameters.
colors	string	Colour filter, English colour names, comma-separated (e.g. "black" or "black,white"). Use this instead of putting the colour in query.
gender	string	Who the item is for. Use this instead of writing "women's"/"men's" in query.
country	string	Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.

get_trending_products

Discover the most popular and trending fashion products on Realry.com, ranked by user likes. Optionally filter by keyword, price, gender, or color.

read-only

Argument	Type	Description
page	number	Page number (default: 1)
sort	string	Sort order. Omit for best match (default). "new" (newest), "likes" (most liked), "views" (most viewed), "sales" (highest discount), "pricelow" (cheapest first), "pricehigh" (most expensive first).
brand	string	Brand name or slug, e.g. "Nike", "new-balance". Also keep the brand in query together with the model (query "le labo santal 33", brand "Le Labo"): an unknown brand is dropped, and query then still finds it.
query	string	Optional product as a short noun phrase, 1-4 words (e.g. "sneakers", "wool coat"). No gender, price, colour or filler words — use the other parameters.
colors	string	Colour filter, English colour names, comma-separated (e.g. "black" or "black,white"). Use this instead of putting the colour in query.
gender	string	Who the item is for. Use this instead of writing "women's"/"men's" in query.
country	string	Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market.

search_brands

Search for fashion brands on Realry.com by name. Returns brand IDs that can be used with get_brand_products.

read-only

Argument	Type	Description
limit	number	Number of results (default: 8)
query*	string	Brand name to search for (e.g. "nike", "gucci", "zara")

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Number of results (default: 8)"
    },
    "query": {
      "type": "string",
      "description": "Brand name to search for (e.g. \"nike\", \"gucci\", \"zara\")"
    }
  }
}

search_products

Search fashion products on Realry.com. Put only the product itself in `query`, as a short noun phrase ("running shoes", "linen dress", "crossbody bag"), and put gender, price_min/price_max, colors, brand, sale_only/min_discount in their own parameters; use `category` only when the shopper asked for a whole category or the product type is ambiguous. `query` is matched against product text, so sentences and extra words ("for a wedding", "under $100", "cheap", "women's") make it miss. Bad: {"query": "women's black linen summer dress under $100"} Good: {"query": "linen dress", "gender": "women", "colors": "black", "price_max": 100} Good: {"query": "patagonia fleece", "brand": "Patagonia"} Returns product name, price, discount info, seller, and links. Use the Product ID with get_price_comparison to compare prices across all stores. When every store's stock is unconfirmed for 5+ days, those results are listed after fresher ones, so rank is not strict price order under price sorts.

read-only

Argument	Type	Description
page	number	Page number (default: 1)
sort	string	Sort order. Omit for best match (default). "new" (newest), "likes" (most liked), "views" (most viewed), "sales" (highest discount), "pricelow" (cheapest first), "pricehigh" (most expensive first).
brand	string	Brand name or slug, e.g. "Nike", "new-balance". Also keep the brand in query together with the model (query "le labo santal 33", brand "Le Labo"): an unknown brand is dropped, and query then still finds it.
query*	string	The product as a short noun phrase, 1-4 words (e.g. "sneakers", "wool coat", "air force 1"). No gender, price, colour or filler words — use the other parameters. When the shopper named a brand, keep it in query too and also set `brand`.

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "page": {
      "type": "number",
      "description": "Page number (default: 1)"
    },
    "sort": {
      "type": "string",
      "description": "Sort order. Omit for best match (default). \"new\" (newest), \"likes\" (most liked), \"views\" (most viewed), \"sales\" (highest discount), \"pricelow\" (cheapest first), \"pricehigh\" (most expensive first)."
    },
    "brand": {
      "type": "string",
      "description": "Brand name or slug, e.g. \"Nike\", \"new-balance\". Also keep the brand in query together with the model (query \"le labo santal 33\", brand \"Le Labo\"): an unknown brand is dropped, and query then still finds it."
    },
    "query": {
      "type": "string",
      "description": "Optional product as a short noun phrase, 1-4 words (e.g. \"sneakers\", \"wool coat\"). No gender, price, colour or filler words — use the other parameters."
    },
    "colors": {
      "type": "string",
      "description": "Colour filter, English colour names, comma-separated (e.g. \"black\" or \"black,white\"). Use this instead of putting the colour in query."
    },
    "gender": {
      "enum": [
        "women",
        "men",
        "kids"
      ],
      "type": "string",
      "description": "Who the item is for. Use this instead of writing \"women's\"/\"men's\" in query."
    },
    "country": {
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ],
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market."
    },
    "category": {
      "enum": [
        "CLOTHING",
        "SHOES",
        "BAG",
        "ACC"
      ],
      "type": "string",
      "description": "Top-level category. Set it only when the shopper asked for a whole category (\"show me bags\") or query alone is ambiguous; leave it unset when query already names the product type. ACC = accessories, jewellery, watches, eyewear, hats, fragrance and beauty."
    },
    "price_max": {
      "type": "number",
      "description": "Maximum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. \"under $100\"), not in query."
    },
    "price_min": {
      "type": "number",
      "description": "Minimum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. a floor of $50), not in query."
    },
    "sale_only": {
      "type": "boolean",
      "description": "Show sale items only"
    },
    "page_length": {
      "type": "number",
      "description": "Results per page (default: 5, max: 36)"
    },
    "min_discount": {
      "type": "number",
      "description": "Minimum discount percentage (e.g. 30 for 30% off or more)"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "page": {
      "type": "number",
      "description": "Page number (default: 1)"
    },
    "sort": {
      "type": "string",
      "description": "Sort order. Omit for best match (default). \"new\" (newest), \"likes\" (most liked), \"views\" (most viewed), \"sales\" (highest discount), \"pricelow\" (cheapest first), \"pricehigh\" (most expensive first)."
    },
    "brand": {
      "type": "string",
      "description": "Brand name or slug, e.g. \"Nike\", \"new-balance\". Also keep the brand in query together with the model (query \"le labo santal 33\", brand \"Le Labo\"): an unknown brand is dropped, and query then still finds it."
    },
    "query": {
      "type": "string",
      "description": "Optional product as a short noun phrase, 1-4 words (e.g. \"sneakers\", \"wool coat\"). No gender, price, colour or filler words — use the other parameters."
    },
    "colors": {
      "type": "string",
      "description": "Colour filter, English colour names, comma-separated (e.g. \"black\" or \"black,white\"). Use this instead of putting the colour in query."
    },
    "gender": {
      "enum": [
        "women",
        "men",
        "kids"
      ],
      "type": "string",
      "description": "Who the item is for. Use this instead of writing \"women's\"/\"men's\" in query."
    },
    "country": {
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ],
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market."
    },
    "category": {
      "enum": [
        "CLOTHING",
        "SHOES",
        "BAG",
        "ACC"
      ],
      "type": "string",
      "description": "Top-level category. Set it only when the shopper asked for a whole category (\"show me bags\") or query alone is ambiguous; leave it unset when query already names the product type. ACC = accessories, jewellery, watches, eyewear, hats, fragrance and beauty."
    },
    "price_max": {
      "type": "number",
      "description": "Maximum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. \"under $100\"), not in query."
    },
    "price_min": {
      "type": "number",
      "description": "Minimum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. a floor of $50), not in query."
    },
    "sale_only": {
      "type": "boolean",
      "description": "Show sale items only"
    },
    "page_length": {
      "type": "number",
      "description": "Results per page (default: 5, max: 36)"
    },
    "min_discount": {
      "type": "number",
      "description": "Minimum discount percentage (e.g. 30 for 30% off or more)"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "properties": {
    "page": {
      "type": "number",
      "description": "Page number (default: 1)"
    },
    "sort": {
      "type": "string",
      "description": "Sort order. Omit for best match (default). \"new\" (newest), \"likes\" (most liked), \"views\" (most viewed), \"sales\" (highest discount), \"pricelow\" (cheapest first), \"pricehigh\" (most expensive first)."
    },
    "brand": {
      "type": "string",
      "description": "Brand name or slug, e.g. \"Nike\", \"new-balance\". Also keep the brand in query together with the model (query \"le labo santal 33\", brand \"Le Labo\"): an unknown brand is dropped, and query then still finds it."
    },
    "query": {
      "type": "string",
      "description": "Optional product as a short noun phrase, 1-4 words (e.g. \"sneakers\", \"wool coat\"). No gender, price, colour or filler words — use the other parameters."
    },
    "colors": {
      "type": "string",
      "description": "Colour filter, English colour names, comma-separated (e.g. \"black\" or \"black,white\"). Use this instead of putting the colour in query."
    },
    "gender": {
      "enum": [
        "women",
        "men",
        "kids"
      ],
      "type": "string",
      "description": "Who the item is for. Use this instead of writing \"women's\"/\"men's\" in query."
    },
    "country": {
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ],
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market."
    },
    "category": {
      "enum": [
        "CLOTHING",
        "SHOES",
        "BAG",
        "ACC"
      ],
      "type": "string",
      "description": "Top-level category. Set it only when the shopper asked for a whole category (\"show me bags\") or query alone is ambiguous; leave it unset when query already names the product type. ACC = accessories, jewellery, watches, eyewear, hats, fragrance and beauty."
    },
    "price_max": {
      "type": "number",
      "description": "Maximum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. \"under $100\"), not in query."
    },
    "price_min": {
      "type": "number",
      "description": "Minimum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. a floor of $50), not in query."
    },
    "sale_only": {
      "type": "boolean",
      "description": "Show sale items only"
    },
    "page_length": {
      "type": "number",
      "description": "Results per page (default: 5, max: 36)"
    },
    "min_discount": {
      "type": "number",
      "description": "Minimum discount percentage (e.g. 30 for 30% off or more)"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "number",
      "description": "Page number (default: 1)"
    },
    "sort": {
      "type": "string",
      "description": "Sort order. Omit for best match (default). \"new\" (newest), \"likes\" (most liked), \"views\" (most viewed), \"sales\" (highest discount), \"pricelow\" (cheapest first), \"pricehigh\" (most expensive first)."
    },
    "brand": {
      "type": "string",
      "description": "Brand name or slug, e.g. \"Nike\", \"new-balance\". Also keep the brand in query together with the model (query \"le labo santal 33\", brand \"Le Labo\"): an unknown brand is dropped, and query then still finds it."
    },
    "query": {
      "type": "string",
      "description": "The product as a short noun phrase, 1-4 words (e.g. \"sneakers\", \"wool coat\", \"air force 1\"). No gender, price, colour or filler words — use the other parameters. When the shopper named a brand, keep it in query too and also set `brand`."
    },
    "colors": {
      "type": "string",
      "description": "Colour filter, English colour names, comma-separated (e.g. \"black\" or \"black,white\"). Use this instead of putting the colour in query."
    },
    "gender": {
      "enum": [
        "women",
        "men",
        "kids"
      ],
      "type": "string",
      "description": "Who the item is for. Use this instead of writing \"women's\"/\"men's\" in query."
    },
    "country": {
      "enum": [
        "AE",
        "AU",
        "CA",
        "DE",
        "ES",
        "FR",
        "GB",
        "HK",
        "ID",
        "IE",
        "IN",
        "IT",
        "JP",
        "KR",
        "NL",
        "SG",
        "US"
      ],
      "type": "string",
      "description": "Two-letter market code deciding shipping availability, prices and currency. Defaults to US when omitted or unrecognised. Pass the shopper's own country — prices and stock differ per market."
    },
    "category": {
      "enum": [
        "CLOTHING",
        "SHOES",
        "BAG",
        "ACC"
      ],
      "type": "string",
      "description": "Top-level category. Set it only when the shopper asked for a whole category (\"show me bags\") or query alone is ambiguous; leave it unset when query already names the product type. ACC = accessories, jewellery, watches, eyewear, hats, fragrance and beauty."
    },
    "price_max": {
      "type": "number",
      "description": "Maximum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. \"under $100\"), not in query."
    },
    "price_min": {
      "type": "number",
      "description": "Minimum price in the market currency for `country` (USD for US, GBP for GB, EUR for euro markets, JPY for JP, KRW for KR). Put shopper-stated limits here (e.g. a floor of $50), not in query."
    },
    "sale_only": {
      "type": "boolean",
      "description": "Show sale items only"
    },
    "page_length": {
      "type": "number",
      "description": "Results per page (default: 5, max: 36)"
    },
    "min_discount": {
      "type": "number",
      "description": "Minimum discount percentage (e.g. 30 for 30% off or more)"
    }
  }
}