@scavio/mcp-server 0.50.0 → 0.52.0

package/README.md

@@ -3,9 +3,9 @@
 ![GitHub Repo stars](https://img.shields.io/github/stars/scavio-ai/scavio-mcp?style=social)
 ![License](https://img.shields.io/github/license/scavio-ai/scavio-mcp)
 
-[Scavio](https://scavio.dev?utm_source=npm-mcp&utm_medium=package&utm_campaign=readme) is a unified [Web Search API](https://scavio.dev/docs/search-api?utm_source=npm-mcp&utm_medium=package&utm_campaign=readme) and MCP server that gives AI agents web search, page extraction, and structured data from e-commerce, social, travel, jobs, real-estate, app-store, ad-library and company-filing sources. 478 tools across 72 platforms plus Extract, Company Enrich, map, crawl and batch, one API key.
+[Scavio](https://scavio.dev?utm_source=npm-mcp&utm_medium=package&utm_campaign=readme) is a unified [Web Search API](https://scavio.dev/docs/search-api?utm_source=npm-mcp&utm_medium=package&utm_campaign=readme) and MCP server that gives AI agents web search, page extraction, and structured data from e-commerce, social, travel, jobs, real-estate, app-store, ad-library and company-filing sources. 493 tools across 73 platforms plus Extract, Company Enrich, map, crawl and batch, one API key.
 
-**The 22 platforms added in 0.13.0 are opt-in.** Registering all 478 tools puts ~628KB of tool definitions — roughly 90k tokens — into every session before you type anything. So the default is the platform set 0.12.x already had, plus Extract and Company Enrich: 143 tools, 114KB. Upgrading never removes a tool you were using. Everything else is one env var away: see [Choosing which tools load](#choosing-which-tools-load).
+**The 22 platforms added in 0.13.0 are opt-in.** Registering all 493 tools puts ~670KB of tool definitions — roughly 90k tokens — into every session before you type anything. So the default is the platform set 0.12.x already had, plus Extract and Company Enrich: 143 tools, 114KB. Upgrading never removes a tool you were using. Everything else is one env var away: see [Choosing which tools load](#choosing-which-tools-load).
 
 ## Remote MCP Server
 
@@ -207,7 +207,7 @@ Add to settings (`Cmd+,`):
 
 ## Choosing which tools load
 
-Scavio exposes 478 tools. Loading all of them costs ~628KB of `tools/list` —
+Scavio exposes 493 tools. Loading all of them costs ~670KB of `tools/list` —
 roughly 90k tokens of context in every session before the user has said anything,
 and more tools than some clients will accept at all. So the server registers a
 curated subset by default and lets you pick the rest. The sizes below are
@@ -218,7 +218,7 @@ measured, not estimated: `npm run toolslist` reproduces them.
 | Value | Registers |
 |-------|-----------|
 | *(unset)* or `default` | Every platform 0.12.x had, plus `extract` and `company` — **143 tools, 114KB** |
-| `all` | every platform — **478 tools, ~628KB** |
+| `all` | every platform — **493 tools, ~670KB** |
 | `extract,sec,g2` | just those platforms — 18 tools, 21KB |
 | `default,zillow,metaads` | the default set plus two more — 149 tools, 122KB |
 | `default,chatgpt,gemini` | the default set plus ChatGPT and Gemini — 145 tools, 117KB |
@@ -233,7 +233,7 @@ tells you to call to check the server works.
 
 **Platform keys:** `extract`, `company`, `google`, `chatgpt`, `gemini`, `youtube`, `tiktok`, `instagram`,
 `reddit`, `x`, `linkedin`, `threads`, `kuaishou`, `amazon`, `walmart`, `ebay`,
-`target`, `homedepot`, `costco`, `heb`, `kroger`, `decathlon`, `specs`, `lowes`, `samsclub`, `canadiantire`, `dollargeneral`, `sephora`, `ulta`, `aldi`, `microcenter`, `walgreens`, `cvs`, `wholefoods`, `harborfreight`, `petsmart`, `petco`, `iherb`, `chewy`, `menards`, `nordstrom`, `nordstromrack`, `bestbuy`, `tcgplayer`, `vinted`, `macys`, `saks`, `kohls`, `jcpenney`, `dicks`, `footlocker`, `fanatics`, `carrefour`, `allegro`, `mercadolibre`, `tiktok-shop`, `booking`, `airbnb`,
+`target`, `homedepot`, `costco`, `heb`, `kroger`, `decathlon`, `specs`, `lowes`, `samsclub`, `canadiantire`, `dollargeneral`, `sephora`, `ulta`, `aldi`, `microcenter`, `walgreens`, `cvs`, `wholefoods`, `harborfreight`, `petsmart`, `petco`, `iherb`, `chewy`, `menards`, `nordstrom`, `nordstromrack`, `bestbuy`, `tcgplayer`, `vinted`, `macys`, `saks`, `kohls`, `jcpenney`, `dicks`, `footlocker`, `fanatics`, `carrefour`, `allegro`, `olx`, `mercadolibre`, `tiktok-shop`, `booking`, `airbnb`,
 `tripadvisor`, `yelp`, `zillow`, `redfin`, `realtor`, `rightmove`, `indeed`, `glassdoor`,
 `appstore`, `googleplay`, `g2`, `capterra`, `trustpilot`, `googleads`, `metaads`, `sec`, `companieshouse`
 
@@ -1431,15 +1431,77 @@ Lokalnie as its own source, Smart! account data, seller revenue, seller
 addresses or tax ids, price history or reviews past the first 20: to track
 prices, poll and store your own.
 
-### Kroger
-
-| Tool | Description |
-|------|-------------|
-| `search_kroger` | Search Kroger grocery products: price (cents), promo/n-for deals, unit price, UPC, stock, SNAP, dietary info, rating |
-| `get_kroger_product` | Full detail: nutrition with allergens/ingredients, rating distribution, store aisle, dietary flags, SNAP, dimensions |
-
-2 credits per call. Kroger operates Kroger, Ralphs, Fred Meyer, Harris Teeter, King
-Soopers, Fry's and other banners. Pass `product_url` (from `search_kroger`) or `upc`.
+### OLX
+
+OLX Europe classifieds: used goods, cars, real estate and jobs, with sellers, category filters and similar ads (olx.pl, olx.ro, olx.pt, olx.bg, olx.ua, olx.kz and olx.uz). OLX Brasil, olx.in and other OLX-branded sites are not covered.
+
+| Tool | Description |
+|------|-------------|
+| `search_olx` | Search by keyword and / or category, up to 50 ads per page (promoted ads interleaved on top of these, flagged `is_promoted` with `promoted_position`): price (with `original_value` / `original_currency` when the site converts it), salary for jobs, condition, params, location with ids, `created_at` / `refreshed_at`, OLX delivery, seller id; sort by relevance, newest or price; filter by price, condition, private / business seller, OLX delivery, photos, region / city / district with a radius and the category's own `filter_*` keys; `total` and `total_capped` |
+| `get_olx_offer` | One ad by id or URL: full description, price, salary, every parameter, category breadcrumb, photos, location, dates, status, OLX delivery and the seller (id, `is_business`, `business_name` for businesses, `member_since`) |
+| `get_olx_seller` | One seller by id: `is_business`, `business_name` (business sellers only), `member_since`, `active_ads`, `ads_url` |
+| `get_olx_seller_ads` | One seller's live ads, with the search sorts and filters and an optional query |
+| `get_olx_filters` | A category's filters ready for `filters` (rooms, area, year, mileage ...): key, kind (range or choice), `send_as`, values with ad counts, plus ad counts per region and subcategory (not kz or uz) |
+| `get_olx_categories` | The category tree: top level with direct children, or one category's whole subtree, with active ad counts |
+| `search_olx_locations` | City and district autocomplete with `city_id`, `district_id` and `region_id` for search |
+| `get_olx_suggestions` | Search box suggestions, each with the category it is most searched in |
+| `get_olx_similar` | The ads OLX recommends next to one ad (about 30), in the search item shape (not kz or uz) |
+
+Platform key `olx`. 1 credit per call. Markets (`country`): pl (olx.pl, PLN,
+default), ro (olx.ro, RON), pt (olx.pt, EUR), bg (olx.bg, EUR), ua (olx.ua,
+UAH), kz (olx.kz, KZT) and uz (olx.uz, UZS) on every tool except
+`get_olx_filters` and `get_olx_similar` (pl, ro, pt, bg, ua). Titles, params
+and labels come back in the site's language: Polish on pl, Russian by default
+on kz and uz; `language` (`kk` on kz, `uz` on uz) switches search, seller ads
+and offer to Kazakh or Uzbek. `olx_delivery` is not available on kz and uz.
+OLX lets anyone page through the first 1,000 results of a search only
+(`total_capped`); kz and uz hide large totals (`total` null). `newest` orders
+by last refresh (sellers can refresh an ad), not first posting. Discover a
+category's `filter_*` keys with `get_olx_filters`, then pass them as
+`filters`. When the site converts a price (olx.uz y.e. to UZS, EUR to RON on
+ro, USD / EUR to UAH on ua), `price.value` is the converted figure and
+`original_value` / `original_currency` keep what the seller entered. Private
+sellers' names, phone numbers, emails, exact map positions, last-seen times
+and car VINs are never returned, and phone numbers and emails in ad text are
+replaced; `business_name` is set for business sellers only. Failed calls are
+not charged; a not-found is a charged 404, and an ended ad answers the same
+404 as a missing one ("not found or no longer active"). OLX shows no seller
+ratings or reviews. No view counts, phone numbers, messaging, delivery prices,
+checkout, average prices, notifications or price history: to watch for new
+listings or track prices, poll `newest` and store your own.
+
+### [Kroger](https://scavio.dev/docs/kroger-search?utm_source=npm-mcp&utm_medium=package&utm_campaign=readme)
+
+Kroger, QFC and Fred Meyer grocery data: product search, product detail, store-level prices, stores, category listings, weekly digital deals, digital coupons and search suggestions.
+
+| Tool | Description |
+|------|-------------|
+| `search_kroger` | Search by keyword: price, list / promo price with end date, n-for deals, unit price, size, UPC, stock, SNAP, dietary info, rating (average, count, star distribution); `total` and the `store` that priced the results |
+| `get_kroger_product` | One product by `product_url` or `upc`: nutrition, ingredients, allergens, description, images, country of origin, dimensions, store aisle, breadcrumbs |
+| `get_kroger_prices` | Price, promo, stock, available quantity, aisle and fulfillment for up to 25 UPCs at one store you choose (`store_id`) |
+| `find_kroger_stores` | Stores near a ZIP or city / address, or one by `store_id`: `location_id`, address, coordinates, hours, departments, pharmacy, fuel center, pickup, delivery, distance |
+| `get_kroger_category` | A category listing by `/pl/` URL or `taxonomy_id`, in the search item shape |
+| `get_kroger_deals` | This week's weekly digital deals (`deals_week` with its end date), in the search item shape |
+| `get_kroger_coupons` | Digital coupons at one store (`store_id` or `zip`), 24 per page, filter by department or text: savings (amount in cents or percent), terms, tags, valid_for, clip_by and expiry dates |
+| `get_kroger_suggestions` | Search box suggestions for a partial query |
+
+Platform key `kroger`. 2 credits for `search_kroger` and `get_kroger_product`, 3
+for `get_kroger_prices`, 1 for the rest. Banners (`banner`): `kroger` (kroger.com,
+default), `qfc` (QFC, qfc.com: Washington and Oregon) and `fred_meyer` (Fred
+Meyer, fredmeyer.com: the Pacific Northwest and Alaska, grocery plus general
+merchandise, apparel and home). Other Kroger banners (Ralphs, King Soopers,
+Fry's, Harris Teeter, Smith's...) are not supported yet. Prices are integer cents
+(`price` 399 = $3.99) and differ by banner and by store. Search, product,
+category and deals return the prices of a store the site chooses for the
+request (shown in `store`, it can change between calls); for a specific store,
+get a `location_id` from `find_kroger_stores` and pass it as `store_id` to
+`get_kroger_prices`. QFC store ids start with 705, Fred Meyer ids with 701.
+Search, category and deals serve the first page only (up to 24 products) with
+no sort; `page` above 1 is a 400 and is not charged. Ratings are average, count
+and star distribution; review text is not available. Fuel center locations are
+returned, fuel prices are not. Coupons are listed, never clipped (no account).
+The printed weekly ad circular is not available. Failed calls are not charged;
+an unknown UPC or store id is a charged 404.
 
 ### [Mercado Libre](https://scavio.dev/docs/mercadolibre-search?utm_source=npm-mcp&utm_medium=package&utm_campaign=readme)
 

package/dist/tools/index.d.ts

@@ -5,7 +5,7 @@ export declare const PLATFORM_KEYS: string[];
  * What registers when SCAVIO_PLATFORMS is unset.
  *
  * Registering everything is not an option any more. The full surface is 408
- * tools, which serialises to 628KB of tools/list (measured with
+ * tools, which serialises to 670KB of tools/list (measured with
  * `npm run toolslist`, not estimated) — roughly 90k tokens pushed into the
  * context of EVERY session before the user has typed anything, and past the
  * hard tool-count ceiling some clients enforce. The default set below is 143
@@ -29,7 +29,7 @@ export declare const DEFAULT_PLATFORMS: string[];
  * Turn a SCAVIO_PLATFORMS value into the canonical platform keys to register.
  *
  * Accepts a comma-separated list of platform keys, plus three keywords:
- *   all      — every platform (478 tools)
+ *   all      — every platform (493 tools)
  *   default  — expands to DEFAULT_PLATFORMS, so `default,sec,g2` is additive
  *   none     — no platform tools at all, leaving only get_usage
  *

package/dist/tools/index.js

@@ -52,6 +52,7 @@ import { registerFootlockerTools } from "./footlocker.js";
 import { registerFanaticsTools } from "./fanatics.js";
 import { registerCarrefourTools } from "./carrefour.js";
 import { registerAllegroTools } from "./allegro.js";
+import { registerOlxTools } from "./olx.js";
 import { registerMercadoLibreTools } from "./mercadolibre.js";
 import { registerTiktokShopTools } from "./tiktok-shop.js";
 import { registerBookingTools } from "./booking.js";
@@ -147,6 +148,7 @@ const PLATFORMS = {
     fanatics: registerFanaticsTools,
     carrefour: registerCarrefourTools,
     allegro: registerAllegroTools,
+    olx: registerOlxTools,
     mercadolibre: registerMercadoLibreTools,
     "tiktok-shop": registerTiktokShopTools,
     // Travel and local
@@ -182,7 +184,7 @@ export const PLATFORM_KEYS = Object.keys(PLATFORMS);
  * What registers when SCAVIO_PLATFORMS is unset.
  *
  * Registering everything is not an option any more. The full surface is 408
- * tools, which serialises to 628KB of tools/list (measured with
+ * tools, which serialises to 670KB of tools/list (measured with
  * `npm run toolslist`, not estimated) — roughly 90k tokens pushed into the
  * context of EVERY session before the user has typed anything, and past the
  * hard tool-count ceiling some clients enforce. The default set below is 143
@@ -242,7 +244,7 @@ function warnOnce(message) {
  * Turn a SCAVIO_PLATFORMS value into the canonical platform keys to register.
  *
  * Accepts a comma-separated list of platform keys, plus three keywords:
- *   all      — every platform (478 tools)
+ *   all      — every platform (493 tools)
  *   default  — expands to DEFAULT_PLATFORMS, so `default,sec,g2` is additive
  *   none     — no platform tools at all, leaving only get_usage
  *

package/dist/tools/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tools/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,GAAG,EAAE,MAAM,eAAe,CAAC;AAEpC,OAAO,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACnD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACxC,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,YAAY,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,yBAAyB,EAAE,MAAM,mBAAmB,CAAC;AAC9D,OAAO,EAAE,uBAAuB,EAAE,MAAM,kBAAkB,CAAC;AAC3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,iBAAiB,EAAE,MAAM,WAAW,CAAC;AAC9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAClD,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAC1C,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AACtD,OAAO,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AAC1D,OAAO,EAAE,sBAAsB,EAAE,MAAM,gBAAgB,CAAC;AACxD,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAC5C,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,EAAE,iBAAiB,EAAE,MAAM,YAAY,CAAC;AAI/C;;;;;;;;;;;;GAYG;AACH,MAAM,SAAS,GAA+B;IAC5C,OAAO;IACP,OAAO,EAAE,mBAAmB;IAC5B,OAAO,EAAE,oBAAoB;IAC7B,SAAS;IACT,MAAM,EAAE,mBAAmB;IAC3B,gBAAgB;IAChB,OAAO,EAAE,oBAAoB;IAC7B,MAAM,EAAE,mBAAmB;IAC3B,mBAAmB;IACnB,OAAO,EAAE,oBAAoB;IAC7B,MAAM,EAAE,mBAAmB;IAC3B,SAAS,EAAE,sBAAsB;IACjC,MAAM,EAAE,mBAAmB;IAC3B,CAAC,EAAE,cAAc;IACjB,QAAQ,EAAE,qBAAqB;IAC/B,OAAO,EAAE,oBAAoB;IAC7B,QAAQ,EAAE,qBAAqB;IAC/B,0BAA0B;IAC1B,MAAM,EAAE,mBAAmB;IAC3B,OAAO,EAAE,oBAAoB;IAC7B,IAAI,EAAE,iBAAiB;IACvB,MAAM,EAAE,mBAAmB;IAC3B,SAAS,EAAE,sBAAsB;IACjC,MAAM,EAAE,mBAAmB;IAC3B,GAAG,EAAE,gBAAgB;IACrB,MAAM,EAAE,mBAAmB;IAC3B,SAAS,EAAE,sBAAsB;IACjC,KAAK,EAAE,kBAAkB;IACzB,KAAK,EAAE,kBAAkB;IACzB,QAAQ,EAAE,qBAAqB;IAC/B,YAAY,EAAE,yBAAyB;IACvC,aAAa,EAAE,0BAA0B;IACzC,OAAO,EAAE,oBAAoB;IAC7B,IAAI,EAAE,iBAAiB;IACvB,IAAI,EAAE,iBAAiB;IACvB,WAAW,EAAE,wBAAwB;IACrC,SAAS,EAAE,sBAAsB;IACjC,GAAG,EAAE,gBAAgB;IACrB,UAAU,EAAE,uBAAuB;IACnC,aAAa,EAAE,0BAA0B;IACzC,QAAQ,EAAE,qBAAqB;IAC/B,KAAK,EAAE,kBAAkB;IACzB,KAAK,EAAE,kBAAkB;IACzB,KAAK,EAAE,kBAAkB;IACzB,OAAO,EAAE,oBAAoB;IAC7B,SAAS,EAAE,sBAAsB;IACjC,aAAa,EAAE,0BAA0B;IACzC,OAAO,EAAE,oBAAoB;IAC7B,SAAS,EAAE,sBAAsB;IACjC,MAAM,EAAE,mBAAmB;IAC3B,KAAK,EAAE,kBAAkB;IACzB,IAAI,EAAE,iBAAiB;IACvB,KAAK,EAAE,kBAAkB;IACzB,QAAQ,EAAE,qBAAqB;IAC/B,KAAK,EAAE,kBAAkB;IACzB,UAAU,EAAE,uBAAuB;IACnC,QAAQ,EAAE,qBAAqB;IAC/B,SAAS,EAAE,sBAAsB;IACjC,OAAO,EAAE,oBAAoB;IAC7B,GAAG,EAAE,gBAAgB;IACrB,YAAY,EAAE,yBAAyB;IACvC,aAAa,EAAE,uBAAuB;IACtC,mBAAmB;IACnB,OAAO,EAAE,oBAAoB;IAC7B,MAAM,EAAE,mBAAmB;IAC3B,WAAW,EAAE,wBAAwB;IACrC,IAAI,EAAE,iBAAiB;IACvB,cAAc;IACd,MAAM,EAAE,mBAAmB;IAC3B,MAAM,EAAE,mBAAmB;IAC3B,OAAO,EAAE,oBAAoB;IAC7B,SAAS,EAAE,sBAAsB;IACjC,yBAAyB;IACzB,MAAM,EAAE,mBAAmB;IAC3B,SAAS,EAAE,sBAAsB;IACjC,aAAa;IACb,QAAQ,EAAE,qBAAqB;IAC/B,UAAU,EAAE,uBAAuB;IACnC,mBAAmB;IACnB,EAAE,EAAE,eAAe;IACnB,QAAQ,EAAE,qBAAqB;IAC/B,mBAAmB;IACnB,UAAU,EAAE,uBAAuB;IACnC,eAAe;IACf,SAAS,EAAE,sBAAsB;IACjC,OAAO,EAAE,oBAAoB;IAC7B,gCAAgC;IAChC,GAAG,EAAE,gBAAgB;IACrB,cAAc,EAAE,2BAA2B;CAC5C,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAG,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;AAEpD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,SAAS;IACT,SAAS;IACT,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,QAAQ;IACR,aAAa;IACb,WAAW;IACX,GAAG;IACH,UAAU;CACX,CAAC;AAEF,kEAAkE;AAClE,MAAM,OAAO,GAA2B;IACtC,OAAO,EAAE,GAAG;IACZ,aAAa,EAAE,SAAS;IACxB,WAAW,EAAE,SAAS;IACtB,qBAAqB,EAAE,WAAW;CACnC,CAAC;AAEF,SAAS,SAAS,CAAC,KAAa;IAC9B,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;AAC9D,CAAC;AAED,MAAM,uBAAuB,GAAG,IAAI,GAAG,EAAkB,CAAC;AAC1D,KAAK,MAAM,GAAG,IAAI,aAAa;IAAE,uBAAuB,CAAC,GAAG,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAClF,KAAK,MAAM,CAAC,KAAK,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC;IAAE,uBAAuB,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,GAAG,CAAC,CAAC;AAEvG,MAAM,MAAM,GAAG,IAAI,GAAG,EAAU,CAAC;AACjC,SAAS,QAAQ,CAAC,OAAe;IAC/B,IAAI,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC;QAAE,OAAO;IAChC,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACpB,+CAA+C;IAC/C,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;AACzB,CAAC;AAED;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,gBAAgB,CAAC,GAA8B;IAC7D,IAAI,GAAG,KAAK,SAAS,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,CAAC,IAAI,EAAE,KAAK,EAAE;QAAE,OAAO,CAAC,GAAG,iBAAiB,CAAC,CAAC;IAE1F,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,IAAI,YAAY,GAAG,KAAK,CAAC;IAEzB,KAAK,MAAM,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,SAAS,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,GAAG,KAAK,EAAE;YAAE,SAAS;QACzB,IAAI,GAAG,KAAK,KAAK,IAAI,GAAG,KAAK,GAAG;YAAE,OAAO,CAAC,GAAG,aAAa,CAAC,CAAC;QAC5D,IAAI,GAAG,KAAK,MAAM,EAAE,CAAC;YACnB,YAAY,GAAG,IAAI,CAAC;YACpB,SAAS;QACX,CAAC;QACD,IAAI,GAAG,KAAK,SAAS,EAAE,CAAC;YACtB,KAAK,MAAM,CAAC,IAAI,iBAAiB;gBAAE,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;YACnD,SAAS;QACX,CAAC;QACD,MAAM,SAAS,GAAG,uBAAuB,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnD,IAAI,SAAS;YAAE,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;;YAClC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;IAClC,CAAC;IAED,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,QAAQ,CACN,kDAAkD,OAAO,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,KAAK,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI;YACpH,oBAAoB,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,CAC7D,CAAC;IACJ,CAAC;IAED,IAAI,QAAQ,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;QACxB,IAAI,YAAY;YAAE,OAAO,EAAE,CAAC;QAC5B,QAAQ,CAAC,6FAA6F,iBAAiB,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvI,OAAO,CAAC,GAAG,iBAAiB,CAAC,CAAC;IAChC,CAAC;IAED,OAAO,aAAa,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,sEAAsE;AACtE,MAAM,WAAW,GAA2B;IAC1C,MAAM,EAAE,QAAQ;IAChB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,QAAQ;IACf,IAAI,EAAE,OAAO;IACb,IAAI,EAAE,MAAM;IACZ,GAAG,EAAE,KAAK;IACV,QAAQ,EAAE,UAAU;IACpB,KAAK,EAAE,OAAO;IACd,GAAG,EAAE,KAAK;IACV,EAAE,EAAE,IAAI;IACR,EAAE,EAAE,IAAI;IACR,GAAG,EAAE,KAAK;IACV,OAAO,EAAE,SAAS;CACnB,CAAC;AAEF,0DAA0D;AAC1D,MAAM,UAAU,SAAS,CAAC,IAAY;IACpC,OAAO,IAAI;SACR,KAAK,CAAC,GAAG,CAAC;SACV,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;SACpE,IAAI,CAAC,GAAG,CAAC,CAAC;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,qBAAqB,GAAG;IAC5B,YAAY,EAAE,IAAI;IAClB,eAAe,EAAE,KAAK;IACtB,aAAa,EAAE,IAAI;CACX,CAAC;AAEX;;;;GAIG;AACH,MAAM,oBAAoB,GAAoG;IAC5H,aAAa,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE;IACrF,aAAa,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,KAAK,EAAE,cAAc,EAAE,KAAK,EAAE;IACrF,YAAY,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;IAClF,YAAY,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE;CACnF,CAAC;AAEF;;;GAGG;AACH,SAAS,UAAU,CAAC,MAAiB;IACnC,OAAO,IAAI,KAAK,CAAC,MAAM,EAAE;QACvB,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ;YACxB,IAAI,IAAI,KAAK,MAAM;gBAAE,OAAO,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC;YAChE,OAAO,CAAC,IAAY,EAAE,GAAG,IAAe,EAAE,EAAE;gBAC1C,MAAM,UAAU,GAAkC,OAAO,CAAC,KAAK,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC,CAAC,CAAC;gBACtG,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;gBAC9B,UAAU,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,KAAK,EAAE,GAAG,qBAAqB,EAAE,GAAG,oBAAoB,CAAC,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;gBAC9G,OAAO,UAAU,CAAC;YACpB,CAAC,CAAC;QACJ,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,MAAiB,EACjB,SAA6B,EAC7B,eAAmC,GAAG,CAAC,gBAAgB;IAEvD,MAAM,SAAS,GAAG,gBAAgB,CAAC,YAAY,CAAC,CAAC;IACjD,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;IACrC,KAAK,MAAM,GAAG,IAAI,SAAS;QAAE,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IAClE,iBAAiB,CAAC,SAAS,EAAE,SAAS,CAAC,CAAC;IACxC,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/tools/kroger.js

@@ -1,6 +1,28 @@
 import { z } from "zod";
 import { handleApiError } from "../lib/tool-error.js";
 import { trimResponse } from "../lib/trim-response.js";
+// Shapes mirror backend/src/routes/kroger.ts (kroger.com plus the QFC and Fred
+// Meyer banners). Cross-field rules the backend enforces and zod here does not:
+// product takes product_url or upc; stores takes exactly one of zip, query or
+// store_id; category takes url or taxonomy_id, not both; coupons takes
+// store_id or zip, not both; a banner that contradicts a URL host or a
+// store_id prefix is a 400. No zod `.default()`: the MCP SDK would post a
+// defaulted field on every call.
+const BANNERS = ["kroger", "qfc", "fred_meyer"];
+const BANNER_TEXT = "kroger (kroger.com, default), qfc (QFC, qfc.com: Washington and Oregon) or fred_meyer (Fred Meyer, fredmeyer.com: the Pacific Northwest and Alaska, grocery plus general merchandise, apparel and home)";
+const CHARGE = "Failed upstream calls are not charged (they are retried automatically); a not-found is charged.";
+const CENTS = "Prices are integer cents (price 399 = $3.99).";
+const SITE_STORE = "Prices, promotions, stock and aisle are those of the store returned in store (location_id, name, banner, division, store_number, address): a store the site chooses, which can change between calls and cannot be picked here. For one specific store use get_kroger_prices with a store_id from find_kroger_stores.";
+const ITEM = "upc (for get_kroger_product and get_kroger_prices), name, brand, url, image, price, list_price, promo_price with promo_ends_at, price_display, unit_price_display, nfor / nfor_price (multi-buy), size, in_stock (null when the store has no stock record), stock_level, SNAP eligibility, dietary info, category and rating (average, count, star distribution; no review text)";
+const GRID = `banner, store, total (all matches, the site counts up to 1000), count and products with ${ITEM}. Only the first page (up to 24 products) is available and there is no sort: page above 1 is a 400, not charged.`;
+const banner = () => z.enum(BANNERS).optional()
+    .describe(`The store banner: ${BANNER_TEXT}. Defaults to kroger. Prices differ by banner and by store.`);
+const storeBanner = () => z.enum(BANNERS).optional()
+    .describe(`The store banner: ${BANNER_TEXT}. Optional with store_id: QFC ids start with 705, Fred Meyer ids with 701, anything else is kroger.`);
+const storeId = () => z.string().regex(/^\d{8}$/)
+    .describe("A store's 8-digit location_id: stores[].location_id of find_kroger_stores, e.g. '70500847'.");
+const firstPage = () => z.number().int().min(1).max(100).optional()
+    .describe("Results page. Only page 1 (up to 24 products) is available; page above 1 is refused with a 400 before any charge. Narrow the query or use get_kroger_category instead.");
 export function registerKrogerTools(server, getClient) {
     const post = (path) => async (params) => {
         try {
@@ -11,19 +33,70 @@ export function registerKrogerTools(server, getClient) {
             return handleApiError(err);
         }
     };
-    server.tool("search_kroger", `Search Kroger grocery products by keyword. Kroger operates Kroger, Ralphs, Fred Meyer, Harris Teeter, King Soopers, Fry's and other banners. Returns price (cents), promo price, n-for deals, unit price, size, UPC, stock, SNAP eligibility, dietary info, rating and category. 2 credits/call.`, {
+    server.tool("search_kroger", `Search Kroger, QFC or Fred Meyer products by keyword (banner). Returns ${GRID} ${SITE_STORE} ${CENTS} ${CHARGE} 2 credits.`, {
         query: z.string().min(1).max(200)
             .describe("Search keywords, e.g. 'organic milk'."),
-        page: z.number().int().min(1).max(100).optional()
-            .describe("Page, 1-based."),
+        banner: banner(),
+        page: firstPage(),
     }, post("search"));
-    server.tool("get_kroger_product", `Full Kroger product detail by URL or UPC: nutrition facts (allergens, ingredients, nutrients with daily values), description, images, rating distribution, store aisle location, stock level, dietary flags (organic, non-GMO, gluten-free), SNAP eligibility, dimensions and country of origin. Pass product_url (from search_kroger) or upc. 2 credits.`, {
+    server.tool("get_kroger_product", `One Kroger, QFC or Fred Meyer product by product_url or upc: the search fields plus description, nutrition facts, ingredients, allergens, images, country of origin, dimensions, weight, dietary flags, the aisle at the store (store_location) and breadcrumbs. ${SITE_STORE} ${CENTS} An unknown upc is a charged 404. ${CHARGE} 2 credits.`, {
         product_url: z.string().min(1).max(500).optional()
-            .describe("Full or relative product URL from kroger.com, e.g. '/p/kroger-2-reduced-fat-milk-gallon/0001111041700'. Preferred."),
+            .describe("Full or relative product URL on kroger.com, qfc.com or fredmeyer.com (products[].url of search_kroger), e.g. '/p/simple-truth-organic-lactose-free-2-reduced-fat-milk-half-gallon/0001111050438'. An absolute URL sets the banner; a banner that contradicts its host is a 400."),
         upc: z.string().min(1).max(20).optional()
-            .describe("Kroger product UPC (from search_kroger or product URLs: /p/{slug}/{upc})."),
+            .describe("The product's UPC (products[].upc of search_kroger, or the digits at the end of a product URL: /p/{slug}/{upc}), e.g. '0001111050438'."),
         slug: z.string().min(1).max(300).optional()
-            .describe("Product slug for readable URL. Optional with upc."),
+            .describe("Product slug (the readable part of the product URL). Optional with upc."),
+        banner: banner(),
     }, post("product"));
+    server.tool("get_kroger_prices", `Price, promotion, stock and aisle for 1 to 25 UPCs at one Kroger, QFC or Fred Meyer store you choose (store_id from find_kroger_stores). The same item is priced differently by banner and by store. Per UPC: upc, name, brand, size, url, image, price, promo_price, promo_ends_at, on_sale, price_display, unit_price_display, in_stock (null when the store has no stock record), stock_level, quantity (the number the site reports as available; an estimate, not a shelf count), aisle (description, number, side, bay, shelf), fulfillment (pickup, delivery, in_store, ship) and priced_at (the store that priced it). UPCs the site does not know are listed in not_found. Also store (location_id, name, banner, address) and count. ${CENTS} An unknown store_id is a charged 404. Can take up to about a minute. ${CHARGE} 3 credits.`, {
+        store_id: storeId(),
+        upcs: z.array(z.string().regex(/^\d{13}$/)).min(1).max(25)
+            .describe("1 to 25 13-digit UPCs as the site writes them (products[].upc of search_kroger or get_kroger_category), e.g. ['0001111050438', '0081006334306']."),
+        banner: storeBanner(),
+    }, post("prices"));
+    server.tool("find_kroger_stores", `Kroger, QFC or Fred Meyer stores near a ZIP or a city / address (nearest first), or one store by store_id. Send exactly one of zip, query or store_id. Each store: location_id (use it as store_id on get_kroger_prices, get_kroger_coupons and get_kroger_suggestions), banner, type (store or fuel_center), name, store_number, address (line1, city, state, zip), coordinates (lat, lng), phone, timezone, hours, open_24_hours, departments (name, phone, hours), has_pharmacy, has_fuel_center, pickup, delivery and distance_miles. Fuel center locations only, no fuel prices. Partner fuel stations are never returned; other Kroger banners only with include_other_banners. An unknown store_id is a charged 404. ${CHARGE} 1 credit.`, {
+        zip: z.string().regex(/^\d{5}$/).optional()
+            .describe("A 5-digit US ZIP code, e.g. '98101'."),
+        query: z.string().min(2).max(100).optional()
+            .describe("A city or address, as typed in the site's store finder, e.g. 'Portland, OR'."),
+        store_id: storeId().optional(),
+        banner: storeBanner(),
+        limit: z.number().int().min(1).max(50).optional()
+            .describe("Stores to return, 1-50. Defaults to 10."),
+        include_other_banners: z.boolean().optional()
+            .describe("Also return nearby stores of other Kroger banners (for example Fred Meyer stores near a QFC search). Defaults to false."),
+    }, post("stores"));
+    server.tool("get_kroger_category", `A Kroger, QFC or Fred Meyer category listing by /pl/ URL or taxonomy_id (send one, not both): category (id, name, url) and ${GRID} ${SITE_STORE} ${CENTS} ${CHARGE} 1 credit.`, {
+        url: z.string().min(1).max(400).optional()
+            .describe("A category listing URL (/pl/<name>/<id>) on kroger.com, qfc.com or fredmeyer.com, e.g. 'https://www.fredmeyer.com/pl/headphones-earbuds-headsets/2900300001'. The URL's host sets the banner."),
+        taxonomy_id: z.string().regex(/^\d{3,14}$/).optional()
+            .describe("The digits at the end of a /pl/ URL, e.g. '08190'. Category ids are shared across banners."),
+        slug: z.string().min(1).max(120).optional()
+            .describe("The name part of a /pl/ URL, e.g. 'Import-Beer'. Optional with taxonomy_id; without it category.name is null."),
+        banner: banner(),
+        page: firstPage(),
+    }, post("category"));
+    server.tool("get_kroger_deals", `This week's weekly digital deals of Kroger, QFC or Fred Meyer: deals_week (id, ends_at: the promotion end most deal items share) and ${GRID} Items on a store promotion carry promo_price and promo_ends_at; items whose deal is a digital coupon show the shelf price (the coupon and its deal price are in get_kroger_coupons, tag Weekly Digital Deals). ${SITE_STORE} ${CENTS} The printed weekly ad circular is not available. ${CHARGE} 1 credit.`, {
+        banner: banner(),
+        page: firstPage(),
+    }, post("deals"));
+    server.tool("get_kroger_coupons", `The digital coupons offered at one Kroger, QFC or Fred Meyer store (store_id, or the banner's store nearest a zip; send one, not both), 24 per page, optionally one department (category) or a text match (query). Each coupon: id, brand, title, description, details (the terms), savings (type amount_off / percent_off / price / free_item / other, amount in cents, percent), type, min_quantity, categories, tags (Weekly Digital Deals, Delivery Only...), valid_for (pickup, delivery, in_store), max_redemptions, starts_at, clip_by, expires_at (YYYY-MM-DD) and image. Also store, page, page_size, count, total_at_store (before any filter), has_more and the categories to filter on. Listing only: coupons are not clipped and no account is used. ${CHARGE} 1 credit.`, {
+        store_id: storeId().optional(),
+        zip: z.string().regex(/^\d{5}$/).optional()
+            .describe("A 5-digit ZIP: the banner's nearest store is used. Alternative to store_id."),
+        banner: storeBanner(),
+        page: z.number().int().min(1).max(50).optional()
+            .describe("Page of coupons, 24 per page, 1-based. Defaults to 1. Follow has_more."),
+        category: z.string().min(2).max(60).optional()
+            .describe("Only coupons in one department: a name from the response's categories list, e.g. 'Dairy'."),
+        query: z.string().min(2).max(100).optional()
+            .describe("Only coupons whose brand or text matches, e.g. 'coffee'."),
+    }, post("coupons"));
+    server.tool("get_kroger_suggestions", `Kroger, QFC or Fred Meyer search box suggestions for a partial query: suggestions (text, type), count and the store they were asked for. Without store_id the banner's store nearest a representative ZIP is used (Kroger 45202 Cincinnati, QFC 98101 Seattle, Fred Meyer 97201 Portland). ${CHARGE} 1 credit.`, {
+        query: z.string().min(2).max(100)
+            .describe("What a shopper has typed so far (2+ characters), e.g. 'almond mi'."),
+        banner: storeBanner(),
+        store_id: storeId().optional(),
+    }, post("suggestions"));
 }
 //# sourceMappingURL=kroger.js.map

package/dist/tools/kroger.js.map

@@ -1 +1 @@
-{"version":3,"file":"kroger.js","sourceRoot":"","sources":["../../src/tools/kroger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,EAAE,YAAY,EAAE,MAAM,yBAAyB,CAAC;AAEvD,MAAM,UAAU,mBAAmB,CAAC,MAAiB,EAAE,SAA6B;IAClF,MAAM,IAAI,GAAG,CAAC,IAAY,EAAE,EAAE,CAAC,KAAK,EAAE,MAA+B,EAAE,EAAE;QACvE,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,SAAS,EAAE,CAAC,IAAI,CAAC,kBAAkB,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;YACtE,OAAO,YAAY,CAAC,IAAI,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO,cAAc,CAAC,GAAG,CAAC,CAAC;QAC7B,CAAC;IACH,CAAC,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,eAAe,EACf,kSAAkS,EAClS;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;aAC9B,QAAQ,CAAC,uCAAuC,CAAC;QACpD,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;aAC9C,QAAQ,CAAC,gBAAgB,CAAC;KAC9B,EACD,IAAI,CAAC,QAAQ,CAAC,CACf,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,2VAA2V,EAC3V;QACE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;aAC/C,QAAQ,CAAC,oHAAoH,CAAC;QACjI,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;aACtC,QAAQ,CAAC,2EAA2E,CAAC;QACxF,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;aACxC,QAAQ,CAAC,mDAAmD,CAAC;KACjE,EACD,IAAI,CAAC,SAAS,CAAC,CAChB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"kroger.js","sourceRoot":"","sources":["../../src/tools/kroger.ts"],"names":[],"mappings":"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"}

package/dist/tools/olx.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { ScavioClient } from "../lib/client.js";
+export declare function registerOlxTools(server: McpServer, getClient: () => ScavioClient): void;

package/dist/tools/olx.js

@@ -0,0 +1,132 @@
+import { z } from "zod";
+import { handleApiError } from "../lib/tool-error.js";
+import { trimResponse } from "../lib/trim-response.js";
+// Shapes mirror backend/src/routes/olx.ts (OLX Europe: olx.pl, olx.ro, olx.pt,
+// olx.bg, olx.ua, olx.kz, olx.uz). Cross-field rules the backend enforces and
+// zod here does not: search takes query, category_id or both; offer and
+// similar take offer_id or url; page x page_size may not exceed 1000;
+// language is kz / uz only (kk on kz, uz on uz, ru on both); olx_delivery is
+// refused on kz and uz. No zod `.default()`: the MCP SDK would post a
+// defaulted field on every call.
+const COUNTRIES = ["pl", "ro", "pt", "bg", "ua", "kz", "uz"];
+const COUNTRIES_NO_KZ_UZ = ["pl", "ro", "pt", "bg", "ua"];
+const SORTS = ["relevance", "newest", "price_low_to_high", "price_high_to_low"];
+const DISTANCES = [0, 2, 5, 10, 15, 30, 50, 75, 100];
+const MARKETS = "pl (olx.pl, PLN, Polish, default), ro (olx.ro, RON, Romanian), pt (olx.pt, EUR, Portuguese), bg (olx.bg, EUR, Bulgarian), ua (olx.ua, UAH, Ukrainian), kz (olx.kz, KZT, Russian or Kazakh) or uz (olx.uz, UZS, Russian or Uzbek)";
+const MARKETS_NO_KZ_UZ = "pl (olx.pl, PLN, Polish, default), ro (olx.ro, RON, Romanian), pt (olx.pt, EUR, Portuguese), bg (olx.bg, EUR, Bulgarian) or ua (olx.ua, UAH, Ukrainian); not kz or uz";
+const SCOPE = "OLX Europe only (olx.pl, olx.ro, olx.pt, olx.bg, olx.ua, olx.kz, olx.uz); OLX Brasil, olx.in and other OLX-branded sites are not covered.";
+const LANGUAGE = "Titles, parameters and labels come back in the site's language as the site writes them (Polish on pl; Russian by default on kz and uz).";
+const PRIVACY = "Most OLX sellers are private individuals: a seller name is returned only for business sellers (business_name); private sellers come as an id only. No phone numbers, emails, last-seen times, profile photos or map positions are ever returned, and phone numbers and emails written into titles and descriptions are replaced with [phone removed] / [email removed].";
+const PRICE = "price has value, currency, negotiable, type (price, free, exchange or budget), label as shown and previous_value when the seller lowered it; when the site converts a price (olx.uz y.e. to UZS, EUR to RON on ro, USD / EUR to UAH on ua) value is the converted figure and original_value with original_currency keep what the seller entered";
+const ITEM = `id, url, title, description_snippet, ${PRICE}, salary (jobs: from, to, period, currency, gross), condition, params (key, name, value, normalized_value), category_id, location (city, district, region with their ids), created_at, refreshed_at, valid_to, status, is_promoted with promoted_position (the slot on the page), is_highlighted, is_business, olx_delivery and photos, seller (id; business_name for business sellers only)`;
+const GRID = `Items with ${ITEM}. Also total (the site's count; null on kz and uz once a search reaches 1000 ads), total_capped (true when there are more ads than the 1000 OLX lets anyone page through), total_pages, page, page_size, has_next_page, count, promoted_count, sort, applied_filters, country, language and currency`;
+const CHARGE = "1 credit. Failed upstream calls are not charged (they are retried automatically); a not-found is charged.";
+const country = () => z.enum(COUNTRIES).optional()
+    .describe(`The OLX site: ${MARKETS}. Defaults to pl. Titles and labels come in the site's language, prices in its currency.`);
+const countryNoKzUz = () => z.enum(COUNTRIES_NO_KZ_UZ).optional()
+    .describe(`The OLX site: ${MARKETS_NO_KZ_UZ}. Defaults to pl.`);
+const language = () => z.enum(["ru", "kk", "uz"]).optional()
+    .describe("kz and uz only: kk (Kazakh) on kz or uz (Uzbek) on uz; both sites default to ru (Russian). Refused on the other sites, which answer in their own language.");
+const numericId = (description) => z.union([z.string().regex(/^\d{1,9}$/), z.number().int().min(1)]).optional()
+    .describe(description);
+const userId = () => z.union([z.string().regex(/^\d{1,12}$/), z.number().int().min(1)])
+    .describe("An OLX seller id: items[].seller.id of a search or seller.id of an offer, e.g. '2547532895'.");
+const offerTarget = {
+    offer_id: z.union([z.string().regex(/^\d{1,12}$/), z.number().int().min(1)]).optional()
+        .describe("An OLX ad id: items[].id of a search, e.g. '1107557408'. Alternative to url."),
+    url: z.string().min(1).max(800).optional()
+        .describe("An OLX ad link on any of the seven sites. Alternative to offer_id."),
+};
+const gridFields = {
+    page: z.number().int().min(1).max(1000).optional()
+        .describe("Results page, 1-based. OLX serves the first 1000 results of a search only, so page x page_size may not exceed 1000."),
+    page_size: z.number().int().min(1).max(50).optional()
+        .describe("Ads per page, up to 50 (default 40). Promoted ads come on top of these (40 asks return about 52 items)."),
+    sort: z.enum(SORTS).optional()
+        .describe("relevance (default), newest (most recently posted or refreshed first: sellers can refresh an ad to the top), price_low_to_high or price_high_to_low. Promoted ads are not sorted."),
+    min_price: z.number().min(0).optional()
+        .describe("Lowest price, in the site's currency."),
+    max_price: z.number().min(0).optional()
+        .describe("Highest price, in the site's currency."),
+    condition: z.enum(["new", "used", "refurbished", "damaged"]).optional()
+        .describe("new, used, refurbished or damaged (in categories that have a condition)."),
+    seller_type: z.enum(["private", "business"]).optional()
+        .describe("private (individuals) or business."),
+    olx_delivery: z.boolean().optional()
+        .describe("Only ads that can be bought with OLX delivery. Not on kz or uz."),
+    with_photos: z.boolean().optional()
+        .describe("Only ads with photos."),
+    region_id: numericId("Only ads in this region: region_id of search_olx_locations or of an item's location."),
+    city_id: numericId("Only ads in this city: city_id of search_olx_locations or of an item's location, e.g. '17871'."),
+    district_id: numericId("Only ads in this district of a city: district_id of search_olx_locations."),
+    distance_km: z.union([z.literal(0), z.literal(2), z.literal(5), z.literal(10), z.literal(15), z.literal(30), z.literal(50), z.literal(75), z.literal(100)]).optional()
+        .describe(`With city_id: include ads within this many km of the city (${DISTANCES.join(", ")}).`),
+    filters: z.record(z.string(), z.union([z.number(), z.string().min(1).max(80), z.array(z.union([z.string().min(1).max(80), z.number()])).max(20)])).optional()
+        .describe("The category's own filters, as listed by get_olx_filters (send_as keys): a range filter as filter_float_<name>:from / :to with a number (e.g. {\"filter_float_year:from\": 2018, \"filter_float_milage:to\": 100000}), a choice filter as filter_enum_<name> with one value or a list (e.g. {\"filter_enum_rooms\": [\"two\"]}). Up to 20 keys; other keys are refused."),
+    include_promoted: z.boolean().optional()
+        .describe("Keep the promoted ads the site places on each page (default true; each is flagged is_promoted with its slot)."),
+};
+export function registerOlxTools(server, getClient) {
+    const post = (path) => async (params) => {
+        try {
+            const data = await getClient().post(`/api/v1/olx/${path}`, params);
+            return trimResponse(data);
+        }
+        catch (err) {
+            return handleApiError(err);
+        }
+    };
+    server.tool("search_olx", `Search OLX classifieds (used goods, cars, real estate, jobs, services) by keyword and / or category. ${SCOPE} Sort by newest or price; filter by price range, condition, private or business seller, OLX delivery, photos, region / city / district with a radius, and the category's own filters (rooms, area, year, mileage ... discovered with get_olx_filters). Up to 1000 results per query (OLX's own cap). Promoted ads are interleaved and flagged (is_promoted, promoted_position). A query with no exact match returns the closest ads, never an empty list. ${GRID}. ${LANGUAGE} ${PRIVACY} Markets: ${MARKETS}. ${CHARGE}`, {
+        query: z.string().min(1).max(200).optional()
+            .describe("Search keywords, in any language, e.g. 'iphone'. query, category_id or both."),
+        category_id: numericId("Search inside one category: categories[].id of get_olx_categories or an item's category_id, e.g. '84' = cars on olx.pl."),
+        country: country(),
+        language: language(),
+        ...gridFields,
+    }, post("search"));
+    server.tool("get_olx_offer", `One OLX ad by id or link: title, the full description as plain text, ${PRICE}, salary for jobs, condition, every parameter (a car's VIN is never returned), category with breadcrumb, all photos, location (city, district, region with ids), created_at, refreshed_at, valid_to, status, is_active, is_promoted, olx_delivery, is_job and the seller (id, is_business, business_name for business sellers, member_since). An ad that does not exist and an ad that has ended answer the same 404 ("not found or no longer active"). No view counts, phone numbers or messaging. ${SCOPE} ${LANGUAGE} ${PRIVACY} Markets: ${MARKETS}. ${CHARGE}`, {
+        ...offerTarget,
+        country: country(),
+        language: language(),
+    }, post("offer"));
+    server.tool("get_olx_seller", `One OLX seller by id: is_business (from the seller's own ads), business_name (the registered business name, business sellers only; null otherwise), member_since, active_ads (number of live ads; null on kz and uz from 1000 ads up) and ads_url (the seller's page on OLX). OLX shows no seller ratings or reviews, so none are returned. ${SCOPE} ${PRIVACY} Markets: ${MARKETS}. ${CHARGE}`, {
+        user_id: userId(),
+        country: country(),
+    }, post("seller"));
+    server.tool("get_olx_seller_ads", `One OLX seller's live ads, with the search_olx sorts and filters and an optional query. ${GRID}. ${LANGUAGE} ${PRIVACY} Markets: ${MARKETS}. ${CHARGE}`, {
+        user_id: userId(),
+        query: z.string().min(1).max(200).optional()
+            .describe("Search within the seller's ads."),
+        category_id: numericId("Only the seller's ads in this category."),
+        country: country(),
+        language: language(),
+        ...gridFields,
+    }, post("seller-ads"));
+    server.tool("get_olx_filters", `The filters one OLX category offers, ready to send as search_olx filters: each with key, label, type, kind (range or choice), unit, send_as (the filters keys to use), suggested range steps, and for choice filters every value with its label and the number of matching ads. Also the category's ad counts per region (or per city inside region_id) and per category. Markets: ${MARKETS_NO_KZ_UZ}. ${CHARGE}`, {
+        category_id: z.union([z.string().regex(/^\d{1,9}$/), z.number().int().min(1)])
+            .describe("The category (categories[].id of get_olx_categories), e.g. '14' = flats for sale on olx.pl, '84' = cars."),
+        query: z.string().min(1).max(200).optional()
+            .describe("Count values for this keyword inside the category."),
+        region_id: numericId("Count values in this region only (locations then lists its cities)."),
+        country: countryNoKzUz(),
+    }, post("filters"));
+    server.tool("get_olx_categories", `The OLX category tree of one site: id, name, parent_id, level, path, url, type and count (active ads), with children. Without parent_id: the top-level categories and their direct children (children_count tells which go deeper); with parent_id: that category's whole subtree. Category names come in the site's language. Markets: ${MARKETS}. ${CHARGE}`, {
+        parent_id: numericId("Return this category's whole subtree, e.g. '5'. Without it: the top-level categories with their direct children."),
+        country: country(),
+    }, post("categories"));
+    server.tool("search_olx_locations", `Place autocomplete for OLX location filters: cities and districts matching a name, with city_id, district_id and region_id to send to search_olx, plus the municipality, county and region names. Markets: ${MARKETS}. ${CHARGE}`, {
+        query: z.string().min(2).max(100)
+            .describe("At least 2 letters of a city or district name, e.g. 'Warszawa'."),
+        country: country(),
+    }, post("locations"));
+    server.tool("get_olx_suggestions", `The suggestions the OLX search box shows for what a user typed: popular searches, each with the category it is most searched in (category_id, name and its parent categories). Markets: ${MARKETS}. ${CHARGE}`, {
+        query: z.string().min(1).max(100)
+            .describe("What the user has typed so far, e.g. 'rower'."),
+        country: country(),
+    }, post("suggestions"));
+    server.tool("get_olx_similar", `The ads OLX recommends next to one ad (about 30), in the search_olx item shape: ${ITEM}. Also offer_id, count, country, language and currency. ${PRIVACY} Markets: ${MARKETS_NO_KZ_UZ}. ${CHARGE}`, {
+        ...offerTarget,
+        country: countryNoKzUz(),
+    }, post("similar"));
+}
+//# sourceMappingURL=olx.js.map

package/dist/tools/olx.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"olx.js","sourceRoot":"","sources":["../../src/tools/olx.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@scavio/mcp-server",
-  "version": "0.50.0",
+  "version": "0.52.0",
   "mcpName": "io.github.scavio-ai/scavio-mcp",
-  "description": "MCP server connecting AI agents to Scavio: web search, page extraction, and structured e-commerce, social, travel, jobs, real-estate, app-store, ad-library and company-filing data. 478 tools across 72 platforms plus Extract, Company Enrich, site map, crawl and batch extraction, one API key.",
+  "description": "MCP server connecting AI agents to Scavio: web search, page extraction, and structured e-commerce, social, travel, jobs, real-estate, app-store, ad-library and company-filing data. 493 tools across 73 platforms plus Extract, Company Enrich, site map, crawl and batch extraction, one API key.",
   "type": "module",
   "license": "MIT",
   "author": "Scavio",
@@ -88,6 +88,15 @@
     "allegro-api",
     "allegro-price-monitoring",
     "polish-marketplace",
+    "olx",
+    "olx-api",
+    "olx-listings",
+    "classifieds",
+    "kroger",
+    "kroger-api",
+    "qfc",
+    "fred-meyer",
+    "grocery-prices",
     "mercadolibre",
     "mercado-libre",
     "tiktok",