@scavio/mcp-server 0.30.2 → 0.31.1

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. 318 tools across 51 platforms plus Extract, 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. 351 tools across 58 platforms plus Extract, map, crawl and batch, one API key.
 
-**The 22 platforms added in 0.13.0 are opt-in.** Registering all 318 tools puts ~311KB of tool definitions — roughly 78k tokens — into every session before you type anything. So the default is the platform set 0.12.x already had, plus Extract: 142 tools, 112KB. 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 351 tools puts ~355KB of tool definitions — roughly 89k tokens — into every session before you type anything. So the default is the platform set 0.12.x already had, plus Extract: 142 tools, 112KB. 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,8 +207,8 @@ Add to settings (`Cmd+,`):
 
 ## Choosing which tools load
 
-Scavio exposes 318 tools. Loading all of them costs ~311KB of `tools/list` —
-roughly 78k tokens of context in every session before the user has said anything,
+Scavio exposes 351 tools. Loading all of them costs ~355KB of `tools/list` —
+roughly 89k 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
 measured, not estimated: `npm run toolslist` reproduces them.
@@ -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` — **142 tools, 112KB** |
-| `all` | every platform — **318 tools, ~311KB** |
+| `all` | every platform — **351 tools, ~355KB** |
 | `extract,sec,g2` | just those platforms — 18 tools, 21KB |
 | `default,zillow,metaads` | the default set plus two more — 148 tools, 120KB |
 | `default,chatgpt,gemini` | the default set plus ChatGPT and Gemini — 144 tools, 115KB |
@@ -233,7 +233,7 @@ tells you to call to check the server works.
 
 **Platform keys:** `extract`, `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`, `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`, `mercadolibre`, `tiktok-shop`, `booking`, `airbnb`,
 `tripadvisor`, `yelp`, `zillow`, `redfin`, `realtor`, `rightmove`, `indeed`, `glassdoor`,
 `appstore`, `googleplay`, `g2`, `capterra`, `trustpilot`, `googleads`, `metaads`, `sec`, `companieshouse`
 
@@ -739,6 +739,12 @@ not something Costco publishes, and only items Costco lists online are covered.
 the store used is echoed in `data.store`, and `product_id` alone is enough with a
 `store_id`. US only.
 
+HEB Mexico: pass `country: "mx"` to `search_heb` and `get_heb_product` for
+heb.com.mx. Prices are Mexican peso cents (`10000` = MX$100.00) for HEB Mexico's
+default store, and every row adds `stock` (units on hand), `promotions` (price
+cuts, multi-buys, free gifts, with end dates), `is_sponsored` and the EAN barcode
+in `upc`. Search pages are 20 rows with `total_pages`. `get_heb_stores` is US only.
+
 ### Spec's
 
 | Tool | Description |
@@ -886,6 +892,101 @@ cvs.com store page (e.g. `"7019"`). Search stock defaults to store 7019 (New
 York). Prices are the same at every store. `get_cvs_product` can take 10-30+
 seconds.
 
+### Whole Foods Market
+
+| Tool | Description |
+|------|-------------|
+| `search_whole_foods` | Search at one store: regular, sale and Prime member price, sale dates, on-sale and local flags, category and diet facets |
+| `get_whole_foods_category` | One category at one store, same fields as search, with 6 sorts and on-sale and diet filters |
+| `get_whole_foods_deals` | Every sale item at one store, store-wide or in one category |
+| `get_whole_foods_product` | One product by ASIN, URL or slug: ingredients, nutrition facts, diets, plus that store's in-store and online prices as separate blocks |
+| `get_whole_foods_stores` | Stores near a ZIP: store_id, address, phone, distance, in-store and pickup hours |
+| `get_whole_foods_store` | One store: status, phone, Prime eligibility, opening date, address, sales flyer URL |
+| `get_whole_foods_sales_flyer` | One store's current weekly flyer: each promotion's regular, sale and Prime price as printed, dates, ASINs covered |
+
+1 credit per call. Prices are per 5-digit `store_id` (from
+`get_whole_foods_stores`); without one, store `10145` (Austin) is used. Search
+sorts only by relevance, `price_asc` or `price_desc`. No ratings, reviews, UPCs
+or per-store unit stock.
+
+### Harbor Freight
+
+| Tool | Description |
+|------|-------------|
+| `search_harbor_freight` | Search by keyword and/or category: price, sale price and end date, public coupon price, Inside Track member price, compare-at price, rating, facets |
+| `get_harbor_freight_clearance` | Clearance items, optionally narrowed by keyword, category or brand, same fields as search |
+| `get_harbor_freight_product` | One product by item number, id or URL: every price above, UPC, specs, warranty, manuals, variants |
+| `get_harbor_freight_prices` | Current prices for up to 50 item numbers in one call |
+| `get_harbor_freight_stores` | Stores near a ZIP, "City, ST" or coordinates: store_id, address, phone, hours |
+| `get_harbor_freight_availability` | Up to 20 items at chosen or nearest stores: stock status (in_stock, limited, out_of_stock, not_carried) and aisle |
+| `get_harbor_freight_reviews` | Reviews for one item, newest first, with average rating and total count |
+
+1 credit per call. Prices are national. Store stock is a status from a daily
+snapshot (`inventory_updated_at`), not a unit count.
+
+### PetSmart
+
+| Tool | Description |
+|------|-------------|
+| `search_petsmart` | Search products: price, original and sale price, rating, how many stores stock it, pickup and Autoship eligibility; `store_id` lists only what that store has |
+| `get_petsmart_product` | One product with every size/flavor: price, sale price and end date, Autoship first-order and recurring price, ship and pickup options |
+| `get_petsmart_stores` | The 12 stores nearest a ZIP with hours and services; pass a `sku` for each store's unit count |
+| `get_petsmart_store_stock` | Units at one store for up to 20 SKUs, plus a nearby store that has it |
+| `get_petsmart_availability` | Unit counts for up to 20 store and SKU pairs in one call |
+| `get_petsmart_deals` | The Sale section by pet, sale event or keyword, with the current sale events |
+
+1 credit per call. Prices are national. The Sale section also lists points and
+Autoship promotions, so `on_sale` marks the rows whose price is actually
+reduced.
+
+### Petco
+
+| Tool | Description |
+|------|-------------|
+| `search_petco` | Search products: price, list price, Repeat Delivery (autoship) price, rating, fulfillment flags, every variation |
+| `get_petco_category` | Products in a category path, e.g. `dog/dog-food/dry-dog-food`, same fields as search |
+| `get_petco_product` | One product by part number or URL with every variant: cat_entry_id, UPC, prices, first-autoship price, ingredients, guaranteed analysis |
+| `get_petco_stores` | Up to 10 stores nearest a ZIP: store_id, store number, address, hours |
+| `get_petco_store_inventory` | Units on hand at one store for up to 10 products |
+
+1 credit per call. Prices are national. `get_petco_store_inventory` takes
+`cat_entry_id` values (from search or product), not part numbers, and a
+`store_id` from `get_petco_stores` or a ZIP. `get_petco_product` and
+`get_petco_category` can take 10-30 seconds.
+
+### iHerb
+
+| Tool | Description |
+|------|-------------|
+| `search_iherb` | Search by keyword: price, list price, discount, rating, review count, stock, badges, recent sales; brand filter |
+| `get_iherb_product` | One product: UPC, price per serving, supplement facts, expiration date, best-seller rankings, variants |
+| `get_iherb_prices` | Price, discount, stock, rating and review count for up to 50 products in one call |
+| `get_iherb_reviews` | Rating summary: average, star histogram, counts per language, top positive and top critical review |
+
+2 credits per call. US store, USD. iHerb is online only, so there are no store
+tools. `get_iherb_reviews` is a summary, not a full review list.
+
+### Chewy
+
+| Tool | Description |
+|------|-------------|
+| `search_chewy` | Search or browse a category: one-time, Autoship and first-Autoship price, MAP price, per-unit price, rating, stock |
+| `get_chewy_product` | One product by id or URL: every price above, review count and star distribution, GTIN, ingredients, every variant |
+
+10 credits per call. Some broad queries go straight to a category; `redirect`
+then names it. No store data.
+
+### Menards
+
+| Tool | Description |
+|------|-------------|
+| `get_menards_product` | One product by item id or URL: everyday and sale price, mail-in rebates (e.g. 11%), final price after rebates; `store_id` adds stock quantity and aisle |
+| `get_menards_stores` | Stores near a ZIP or a city and state: store_id, address, distance, services |
+
+1 credit per call; `get_menards_product` with `store_id` is 2 credits and can
+take 10-40 seconds. There is no search: pass the item id from a menards.com
+product URL (`p-60893666613.htm`).
+
 ### Kroger
 
 | Tool | Description |

package/dist/tools/chewy.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 registerChewyTools(server: McpServer, getClient: () => ScavioClient): void;

package/dist/tools/chewy.js

@@ -0,0 +1,36 @@
+import { z } from "zod";
+import { handleApiError } from "../lib/tool-error.js";
+import { trimResponse } from "../lib/trim-response.js";
+// Shapes mirror backend/src/routes/chewy.ts. Cross-field rules the backend
+// enforces and zod here does not: search takes query OR category_id; product
+// takes product_id OR url. Chewy has no stores. No zod `.default()`: the MCP
+// SDK would post a defaulted field on every call.
+const SORTS = ["relevance", "bestselling", "newest", "price_low", "price_high", "rating", "most_reviewed"];
+export function registerChewyTools(server, getClient) {
+    const post = (path) => async (params) => {
+        try {
+            const data = await getClient().post(`/api/v1/chewy/${path}`, params);
+            return trimResponse(data);
+        }
+        catch (err) {
+            return handleApiError(err);
+        }
+    };
+    server.tool("search_chewy", `Search Chewy products by keyword, or browse a category, 36 per page. Each result has the one-time price, offer and strike-through price, Autoship price and discount, first-Autoship price, discount and savings cap, MAP price and whether it is enforced, per-unit price, rating, rating count, in-stock flag, deal/new/exclusive/prescription flags, brand, image and product URL. Sponsored listings are removed (sponsored_removed counts them). When Chewy sends a query to a category page instead, redirect gives that category's id, name and URL and the results are that category's. sort echoes the order the results are actually in. Prices are in US dollars. Chewy has no store data. Use a result's product_id with get_chewy_product. 10 credits/call.`, {
+        query: z.string().min(1).max(200).optional()
+            .describe("Search keywords, e.g. 'kong classic dog toy'. Pass this or category_id. Some broad queries (e.g. 'dog food') go straight to a category; redirect then names it."),
+        category_id: z.string().min(1).max(200).optional()
+            .describe("Category to browse instead of a search: the number at the end of a chewy.com /b/ URL ('332' is Dog Food in /b/food-332), or that URL itself."),
+        page: z.number().int().min(1).max(100).optional()
+            .describe("Page, 1-based. 36 results per page."),
+        sort: z.enum(SORTS).optional()
+            .describe("relevance (default), bestselling, newest, price_low, price_high, rating or most_reviewed."),
+    }, post("search"));
+    server.tool("get_chewy_product", `One Chewy product by id or URL: one-time price, offer price, list and strike-through price with savings, MAP price and whether it is enforced, Autoship price and discount, first-Autoship price, discount and savings cap, per-unit price, in-stock flag, rating, rating count, review count and star distribution, brand, GTIN, description, key benefits, specifications, ingredients and feeding details where Chewy lists them, breadcrumbs, images, promotions, and every variant (size, flavor) with its own id, price, Autoship price and stock. Prices are in US dollars. An unknown product id is a 404. 10 credits.`, {
+        product_id: z.string().regex(/^\d{1,12}$/).optional()
+            .describe("Chewy product id: the number after /dp/ in the product URL, or a search result's product_id, e.g. '128666'. Pass this or url."),
+        url: z.string().url().max(500).optional()
+            .describe("A chewy.com product URL. Pass this or product_id."),
+    }, post("product"));
+}
+//# sourceMappingURL=chewy.js.map

package/dist/tools/chewy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"chewy.js","sourceRoot":"","sources":["../../src/tools/chewy.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,2EAA2E;AAC3E,6EAA6E;AAC7E,6EAA6E;AAC7E,kDAAkD;AAElD,MAAM,KAAK,GAAG,CAAC,WAAW,EAAE,aAAa,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,eAAe,CAAU,CAAC;AAEpH,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,SAA6B;IACjF,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,iBAAiB,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;YACrE,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,cAAc,EACd,0uBAA0uB,EAC1uB;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;aACzC,QAAQ,CAAC,iKAAiK,CAAC;QAC9K,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;aAC/C,QAAQ,CAAC,8IAA8I,CAAC;QAC3J,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,qCAAqC,CAAC;QAClD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;aAC3B,QAAQ,CAAC,2FAA2F,CAAC;KACzG,EACD,IAAI,CAAC,QAAQ,CAAC,CACf,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,gmBAAgmB,EAChmB;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE;aAClD,QAAQ,CAAC,+HAA+H,CAAC;QAC5I,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;aACtC,QAAQ,CAAC,mDAAmD,CAAC;KACjE,EACD,IAAI,CAAC,SAAS,CAAC,CAChB,CAAC;AACJ,CAAC"}

package/dist/tools/harborfreight.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 registerHarborFreightTools(server: McpServer, getClient: () => ScavioClient): void;

package/dist/tools/harborfreight.js

@@ -0,0 +1,93 @@
+import { z } from "zod";
+import { handleApiError } from "../lib/tool-error.js";
+import { trimResponse } from "../lib/trim-response.js";
+// Shapes mirror backend/src/routes/harborfreight.ts. Cross-field rules the
+// backend enforces and zod here does not: search takes query, category_id, or
+// both; product takes sku, id or url; stores takes query OR latitude+longitude;
+// availability takes store_ids, zip, or latitude+longitude. No zod
+// `.default()`: the MCP SDK would post a defaulted field on every call.
+const SORTS = ["best_match", "price_low", "price_high", "member_price_low", "member_price_high", "top_rated", "newest"];
+const PRICE_FIELDS = "price (what the shelf charges now), regular_price, on_sale and clearance flags, sale (sale price, end date, savings, banner code; CLR is clearance), coupon (public coupon price, code, expiry and per-customer limit), member_deal (Inside Track Club member price) and compare_at (the competitor brand, model and price Harbor Freight quotes). Prices are national and in dollars.";
+const sku = () => z.string().regex(/^\d{3,8}$/);
+const listingFields = () => ({
+    category_id: z.string().regex(/^\d{1,7}$/).optional()
+        .describe("Harbor Freight category id, e.g. '1827' (Drills, Drivers & Drill Presses). Ids are the value of the category facet in any search answer."),
+    page: z.number().int().min(1).max(100).optional()
+        .describe("Page, 1-based."),
+    page_size: z.number().int().min(1).max(48).optional()
+        .describe("Results per page, 1-48. Default 36."),
+    sort: z.enum(SORTS).optional()
+        .describe("best_match (default), price_low, price_high, member_price_low, member_price_high (Inside Track Club price), top_rated or newest."),
+    brand: z.string().min(1).max(60).optional()
+        .describe("Only this brand, as listed in the brand facet, e.g. 'BAUER', 'HERCULES', 'PITTSBURGH'. Case-insensitive."),
+});
+export function registerHarborFreightTools(server, getClient) {
+    const post = (path) => async (params) => {
+        try {
+            const data = await getClient().post(`/api/v1/harborfreight/${path}`, params);
+            return trimResponse(data);
+        }
+        catch (err) {
+            return handleApiError(err);
+        }
+    };
+    server.tool("search_harbor_freight", `Search Harbor Freight by keyword and/or category, with brand and clearance filters and 7 sorts. Each result has item number (sku), id, title, brand, URL, image, ${PRICE_FIELDS} Plus badges, rating and review count, where it sells (in store only, online only) and variant info. Also returns total_results, facets (category ids, brands, ratings, price points, attributes) and, when a keyword maps to a category page (e.g. "wrench"), redirect with that category's results. 1 credit/call.`, {
+        query: z.string().min(1).max(200).optional()
+            .describe("Search keywords, e.g. 'cordless drill'. Pass this, category_id, or both."),
+        ...listingFields(),
+        clearance: z.boolean().optional()
+            .describe("Only clearance items. Default false."),
+    }, post("search"));
+    server.tool("get_harbor_freight_clearance", `Harbor Freight clearance items, optionally narrowed by keyword, category or brand. Same fields as search_harbor_freight: each item's clearance price and end date are in sale. 1 credit/call.`, {
+        query: z.string().min(1).max(200).optional()
+            .describe("Optional keywords to narrow the clearance list, e.g. 'drill'."),
+        ...listingFields(),
+    }, post("clearance"));
+    server.tool("get_harbor_freight_product", `One Harbor Freight product by item number, id or URL: title, brand, UPC, ${PRICE_FIELDS} Plus rating, review count, badges, description, highlights, the full specification table, warranty, shipping notes, owner's manuals, images and variants. An unknown item is a 404. 1 credit.`, {
+        sku: sku().optional()
+            .describe("Harbor Freight item number (a search result's sku), e.g. '73216'. Pass sku, id or url."),
+        id: z.number().int().min(1).optional()
+            .describe("Numeric product id (a search result's id), e.g. 48725."),
+        url: z.string().max(500).optional()
+            .describe("harborfreight.com product URL."),
+    }, post("product"));
+    server.tool("get_harbor_freight_prices", `Current national prices for up to 50 Harbor Freight item numbers in one call: ${PRICE_FIELDS} Unknown item numbers are listed in not_found. 1 credit.`, {
+        skus: z.array(sku()).min(1).max(50)
+            .describe("Up to 50 Harbor Freight item numbers, e.g. ['73216', '59716', '64508']."),
+    }, post("prices"));
+    server.tool("get_harbor_freight_stores", `Harbor Freight stores near a ZIP code, "City, ST" or coordinates, nearest first: store number (store_id), name, address, phone, coordinates, distance in miles, status, opening date and hours. Use store ids with get_harbor_freight_availability. 1 credit/call.`, {
+        query: z.string().min(2).max(64).optional()
+            .describe("US ZIP code or 'City, ST', e.g. '60601' or 'Los Angeles, CA'. Pass this, or latitude and longitude."),
+        latitude: z.number().min(-90).max(90).optional()
+            .describe("Latitude, e.g. 40.7128."),
+        longitude: z.number().min(-180).max(180).optional()
+            .describe("Longitude, e.g. -74.006."),
+        radius: z.number().int().min(1).max(100).optional()
+            .describe("Search radius in miles, 1-100. Default 50."),
+        limit: z.number().int().min(1).max(50).optional()
+            .describe("Most stores to return, 1-50. Default 10."),
+    }, post("stores"));
+    server.tool("get_harbor_freight_availability", `In-store stock for up to 20 Harbor Freight items at chosen stores, or at the stores nearest a ZIP code or coordinates. Each store lists every item with stock_status (in_stock, limited, out_of_stock or not_carried), the raw stock_code (IS, LS, NS, null), the aisle, and a nearby store that has it. inventory_updated_at is the time of the daily stock snapshot. Stock is a status, not a unit count. 1 credit/call.`, {
+        skus: z.array(sku()).min(1).max(20)
+            .describe("Up to 20 Harbor Freight item numbers, e.g. ['73216', '58139']."),
+        store_ids: z.array(z.string().regex(/^\d{1,5}$/)).min(1).max(20).optional()
+            .describe("Up to 20 store numbers from get_harbor_freight_stores, e.g. ['374', '820']. Or pass zip, or latitude and longitude, for the nearest stores."),
+        zip: z.string().regex(/^\d{5}(-\d{4})?$/).optional()
+            .describe("US ZIP code, e.g. '90012': stock at the stores nearest to it."),
+        latitude: z.number().min(-90).max(90).optional()
+            .describe("Latitude: stock at the stores nearest to it."),
+        longitude: z.number().min(-180).max(180).optional()
+            .describe("Longitude: stock at the stores nearest to it."),
+        limit: z.number().int().min(1).max(100).optional()
+            .describe("Nearest stores to return with zip or coordinates, 1-100. Default 10."),
+    }, post("availability"));
+    server.tool("get_harbor_freight_reviews", `Customer reviews for one Harbor Freight item, newest first, with limit/offset paging: title, text, star rating, author, review and purchase dates, incentivized flag, helpful votes and the reviewer's answers (would recommend, what they liked). Also the item's average rating and total review count. An unknown item is a 404. 1 credit/call.`, {
+        sku: sku()
+            .describe("Harbor Freight item number, e.g. '73216'."),
+        limit: z.number().int().min(1).max(50).optional()
+            .describe("Reviews per call, 1-50. Default 10."),
+        offset: z.number().int().min(0).max(100000).optional()
+            .describe("Reviews to skip, for paging. Default 0."),
+    }, post("reviews"));
+}
+//# sourceMappingURL=harborfreight.js.map

package/dist/tools/harborfreight.js.map

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

package/dist/tools/heb.js

@@ -11,7 +11,7 @@ export function registerHebTools(server, getClient) {
             return handleApiError(err);
         }
     };
-    server.tool("search_heb", `Search HEB grocery products by keyword. Returns price (cents), list price, sale status, unit price, size, UPC, stock, EBT/SNAP eligibility, category, aisle location and product URL. Pass store_id (from get_heb_stores) for one store's prices, stock and assortment. 2 credits/call.`, {
+    server.tool("search_heb", `Search HEB grocery products by keyword. Returns price (cents), list price, sale status, unit price, size, UPC, stock, EBT/SNAP eligibility, category, aisle location and product URL. Pass store_id (from get_heb_stores) for one store's prices, stock and assortment. Pass country 'mx' for HEB Mexico (heb.com.mx): price in Mexican peso cents, units in stock, EAN barcode and promotions (Rebajado price cut, AhorraMas multi-buy, ComboLoco gift), 20 rows per page with total_pages. 2 credits/call.`, {
         query: z.string().min(1).max(200)
             .describe("Search keywords, e.g. 'organic milk'."),
         page: z.number().int().min(1).max(100).optional()
@@ -19,19 +19,23 @@ export function registerHebTools(server, getClient) {
         page_size: z.number().int().min(1).max(60).optional()
             .describe("Results per page, max 60. Default 60."),
         store_id: z.union([z.string().regex(/^\d{1,5}$/), z.number().int().positive()]).optional()
-            .describe("HEB store number from get_heb_stores (field store_number), e.g. '441'. Prices, stock, aisle location and assortment come from that store and the store used is echoed in data.store. Omit for HEB's default store."),
+            .describe("HEB store number from get_heb_stores (field store_number), e.g. '441'. Prices, stock, aisle location and assortment come from that store and the store used is echoed in data.store. US only. Omit for HEB's default store."),
+        country: z.enum(["us", "mx"]).optional()
+            .describe("'us' for heb.com (default), 'mx' for heb.com.mx (Mexico, prices in peso cents, for HEB Mexico's default store). page_size and store_id are US only."),
     }, post("search"));
-    server.tool("get_heb_product", `Full HEB product detail: nutrition facts (serving size, calories, nutrients with daily values), ingredients, description, images, similar products, coupons, EBT/SNAP eligibility, breadcrumbs, aisle location. Pass product_url (from search_heb) or slug + product_id; with store_id, product_id alone works and price, stock and aisle come from that store. 2 credits.`, {
+    server.tool("get_heb_product", `Full HEB product detail: nutrition facts (serving size, calories, nutrients with daily values), ingredients, description, images, similar products, coupons, EBT/SNAP eligibility, breadcrumbs, aisle location. Pass product_url (from search_heb) or slug + product_id; with store_id, product_id alone works and price, stock and aisle come from that store. For HEB Mexico pass country 'mx' and the url from a Mexico search: peso price, units in stock, barcode, promotions, images, ingredients and nutrition (Spanish nutrient names). 2 credits.`, {
         product_url: z.string().min(1).max(500).optional()
-            .describe("Full or relative product URL from heb.com, e.g. '/product-detail/central-market-organics-whole-milk-1-gal/931316'. Preferred."),
+            .describe("Full or relative product URL from heb.com or heb.com.mx, e.g. '/product-detail/central-market-organics-whole-milk-1-gal/931316'. Preferred."),
         product_id: z.string().min(1).max(20).optional()
             .describe("HEB product id (numeric id at the end of a product URL). Requires slug, unless store_id is set."),
         slug: z.string().min(1).max(300).optional()
             .describe("Product slug (readable part of the URL). Required with product_id, unless store_id is set."),
         store_id: z.union([z.string().regex(/^\d{1,5}$/), z.number().int().positive()]).optional()
-            .describe("HEB store number from get_heb_stores (field store_number), e.g. '441'. Price, stock and aisle location come from that store and the store used is echoed in data.store. Omit for HEB's default store."),
+            .describe("HEB store number from get_heb_stores (field store_number), e.g. '441'. Price, stock and aisle location come from that store and the store used is echoed in data.store. US only. Omit for HEB's default store."),
+        country: z.enum(["us", "mx"]).optional()
+            .describe("'us' for heb.com (default), 'mx' for heb.com.mx (Mexico)."),
     }, post("product"));
-    server.tool("get_heb_stores", `Find HEB stores near a US ZIP code or city. Returns store number, address, phone, hours, pharmacy availability, fulfillment channels (curbside, delivery, in-store), distance and store URL. 2 credits.`, {
+    server.tool("get_heb_stores", `Find HEB stores near a US ZIP code or city (US only; HEB Mexico stores are not covered). Returns store number, address, phone, hours, pharmacy availability, fulfillment channels (curbside, delivery, in-store), distance and store URL. 2 credits.`, {
         zip: z.string().regex(/^\d{5}$/).optional()
             .describe("5-digit US ZIP code, e.g. '78701'."),
         city: z.string().min(1).max(100).optional()

package/dist/tools/heb.js.map

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

package/dist/tools/iherb.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 registerIherbTools(server: McpServer, getClient: () => ScavioClient): void;

package/dist/tools/iherb.js

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { handleApiError } from "../lib/tool-error.js";
+import { trimResponse } from "../lib/trim-response.js";
+// Shapes mirror backend/src/routes/iherb.ts. Cross-field rule the backend
+// enforces and zod here does not: product and reviews take product_id OR url.
+// iHerb is online only (no stores) and always the US store in USD. No zod
+// `.default()`: the MCP SDK would post a defaulted field on every call.
+const SORTS = ["relevance", "best_selling", "rating", "price_asc", "price_desc", "newest", "percent_off", "review_count"];
+const productId = () => z.string().regex(/^\d{1,9}$/);
+const productFields = () => ({
+    product_id: productId().optional()
+        .describe("iHerb product id, the number at the end of an iherb.com/pr/ URL (a search result's product_id), e.g. '62118'. Pass this or url."),
+    url: z.string().min(1).max(500).optional()
+        .describe("An iherb.com product URL. Data is always the US store's, whatever the URL's country."),
+});
+export function registerIherbTools(server, getClient) {
+    const post = (path) => async (params) => {
+        try {
+            const data = await getClient().post(`/api/v1/iherb/${path}`, params);
+            return trimResponse(data);
+        }
+        catch (err) {
+            return handleApiError(err);
+        }
+    };
+    server.tool("search_iherb", `Search iHerb (US store, USD) by keyword, 48 products per page. Each result has product_id, part_number, name, brand, brand_code, URL, image, price, list_price, original_price and discount_percent when discounted, rating, review_count, in_stock, badges (e.g. Best seller, iHerb Brands, New), recent_sales (e.g. "30K+ sold in 30 days") and position. Also returns total_results and brand_filters (brand_code, name and match count for the top brands) for narrowing with brand_code. iHerb is online only: no stores. Use a result's product_id with get_iherb_product, get_iherb_prices or get_iherb_reviews. 2 credits/call.`, {
+        query: z.string().min(1).max(200)
+            .describe("Search keywords, e.g. 'vitamin d'."),
+        page: z.number().int().min(1).max(500).optional()
+            .describe("Page, 1-based. 48 results per page."),
+        sort: z.enum(SORTS).optional()
+            .describe("relevance, best_selling, rating, price_asc, price_desc, newest, percent_off (highest discount first) or review_count. Default iHerb's featured order."),
+        brand_code: z.string().regex(/^[A-Za-z0-9]{2,10}$/).optional()
+            .describe("Only this brand, by iHerb brand code, e.g. 'CGN' (California Gold Nutrition) or 'NOW' (NOW Foods): a result's brand_code or a brand_filters entry."),
+    }, post("search"));
+    server.tool("get_iherb_product", `One iHerb product by id or URL (US store, USD): name, brand, part number, UPC, price, list price, discount, price per serving or unit, stock status, discontinued and coming-soon flags, quantity limit, expiration date, first-available date, package quantity, weight and dimensions, rating and review count, category breadcrumbs, best-seller rankings by category, badges, variants (size, potency, flavor) with their product ids and prices, supplement facts (serving size, servings per container, nutrients with amount and % daily value), description, suggested use, ingredients, warnings and images. An unknown product id is a 404. 2 credits.`, productFields(), post("product"));
+    server.tool("get_iherb_prices", `Current price, list price, discount, in-stock flag, rating and review count for up to 50 iHerb products in one call (US store, USD). One row per requested id, in request order; unknown ids come back with found: false and are listed in not_found. The cheapest way to monitor iHerb prices and stock across many products. 2 credits.`, {
+        product_ids: z.array(productId()).min(1).max(50)
+            .describe("Up to 50 iHerb product ids, e.g. ['62118', '70316', '77548']. Duplicates are answered once."),
+    }, post("prices"));
+    server.tool("get_iherb_reviews", `The review summary for one iHerb product: average rating, total review count, star histogram (count and percent per star), review counts per language, and the full text of the top positive and top critical review with rating, title, author, country, date, verified-purchase flag, helpful votes and images. Not a full review list. 2 credits.`, productFields(), post("reviews"));
+}
+//# sourceMappingURL=iherb.js.map

package/dist/tools/iherb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"iherb.js","sourceRoot":"","sources":["../../src/tools/iherb.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,0EAA0E;AAC1E,8EAA8E;AAC9E,0EAA0E;AAC1E,wEAAwE;AAExE,MAAM,KAAK,GAAG,CAAC,WAAW,EAAE,cAAc,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE,QAAQ,EAAE,aAAa,EAAE,cAAc,CAAU,CAAC;AAEnI,MAAM,SAAS,GAAG,GAAG,EAAE,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;AAEtD,MAAM,aAAa,GAAG,GAAG,EAAE,CAAC,CAAC;IAC3B,UAAU,EAAE,SAAS,EAAE,CAAC,QAAQ,EAAE;SAC/B,QAAQ,CAAC,iIAAiI,CAAC;IAC9I,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;SACvC,QAAQ,CAAC,sFAAsF,CAAC;CACpG,CAAC,CAAC;AAEH,MAAM,UAAU,kBAAkB,CAAC,MAAiB,EAAE,SAA6B;IACjF,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,iBAAiB,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;YACrE,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,cAAc,EACd,ymBAAymB,EACzmB;QACE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC;aAC9B,QAAQ,CAAC,oCAAoC,CAAC;QACjD,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,qCAAqC,CAAC;QAClD,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,EAAE;aAC3B,QAAQ,CAAC,uJAAuJ,CAAC;QACpK,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC,QAAQ,EAAE;aAC3D,QAAQ,CAAC,oJAAoJ,CAAC;KAClK,EACD,IAAI,CAAC,QAAQ,CAAC,CACf,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,koBAAkoB,EACloB,aAAa,EAAE,EACf,IAAI,CAAC,SAAS,CAAC,CAChB,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB,2UAA2U,EAC3U;QACE,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;aAC7C,QAAQ,CAAC,6FAA6F,CAAC;KAC3G,EACD,IAAI,CAAC,QAAQ,CAAC,CACf,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,mBAAmB,EACnB,sVAAsV,EACtV,aAAa,EAAE,EACf,IAAI,CAAC,SAAS,CAAC,CAChB,CAAC;AACJ,CAAC"}

package/dist/tools/index.d.ts

@@ -4,9 +4,9 @@ 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 318
- * tools, which serialises to 311KB of tools/list (measured with
- * `npm run toolslist`, not estimated) — roughly 78k tokens pushed into the
+ * Registering everything is not an option any more. The full surface is 351
+ * tools, which serialises to 355KB of tools/list (measured with
+ * `npm run toolslist`, not estimated) — roughly 89k 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 142
  * tools, 112KB (0.20.0: TikTok, YouTube, Reddit and X gained 19 tools; 0.21.0:
@@ -27,7 +27,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 (318 tools)
+ *   all      — every platform (351 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

@@ -30,6 +30,13 @@ import { registerAldiTools } from "./aldi.js";
 import { registerMicroCenterTools } from "./microcenter.js";
 import { registerWalgreensTools } from "./walgreens.js";
 import { registerCvsTools } from "./cvs.js";
+import { registerWholeFoodsTools } from "./wholefoods.js";
+import { registerHarborFreightTools } from "./harborfreight.js";
+import { registerPetsmartTools } from "./petsmart.js";
+import { registerPetcoTools } from "./petco.js";
+import { registerIherbTools } from "./iherb.js";
+import { registerChewyTools } from "./chewy.js";
+import { registerMenardsTools } from "./menards.js";
 import { registerMercadoLibreTools } from "./mercadolibre.js";
 import { registerTiktokShopTools } from "./tiktok-shop.js";
 import { registerBookingTools } from "./booking.js";
@@ -103,6 +110,13 @@ const PLATFORMS = {
     microcenter: registerMicroCenterTools,
     walgreens: registerWalgreensTools,
     cvs: registerCvsTools,
+    wholefoods: registerWholeFoodsTools,
+    harborfreight: registerHarborFreightTools,
+    petsmart: registerPetsmartTools,
+    petco: registerPetcoTools,
+    iherb: registerIherbTools,
+    chewy: registerChewyTools,
+    menards: registerMenardsTools,
     mercadolibre: registerMercadoLibreTools,
     "tiktok-shop": registerTiktokShopTools,
     // Travel and local
@@ -137,9 +151,9 @@ 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 318
- * tools, which serialises to 311KB of tools/list (measured with
- * `npm run toolslist`, not estimated) — roughly 78k tokens pushed into the
+ * Registering everything is not an option any more. The full surface is 351
+ * tools, which serialises to 355KB of tools/list (measured with
+ * `npm run toolslist`, not estimated) — roughly 89k 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 142
  * tools, 112KB (0.20.0: TikTok, YouTube, Reddit and X gained 19 tools; 0.21.0:
@@ -195,7 +209,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 (318 tools)
+ *   all      — every platform (351 tools)
  *   default  — expands to DEFAULT_PLATFORMS, so `default,sec,g2` is additive
  *   none     — no platform tools at all, leaving only get_usage
  *
@@ -254,6 +268,8 @@ const TITLE_WORDS = {
     sams: "Sam's",
     aldi: "ALDI",
     cvs: "CVS",
+    petsmart: "PetSmart",
+    iherb: "iHerb",
     sec: "SEC",
     g2: "G2",
     ai: "AI",

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":"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"}

package/dist/tools/menards.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 registerMenardsTools(server: McpServer, getClient: () => ScavioClient): void;

package/dist/tools/menards.js

@@ -0,0 +1,35 @@
+import { z } from "zod";
+import { handleApiError } from "../lib/tool-error.js";
+import { trimResponse } from "../lib/trim-response.js";
+// Shapes mirror backend/src/routes/menards.ts. Cross-field rules the backend
+// enforces and zod here does not: product takes item_id OR url; stores takes
+// zip OR city+state. Menards has no search endpoint. No zod `.default()`: the
+// MCP SDK would post a defaulted field on every call.
+export function registerMenardsTools(server, getClient) {
+    const post = (path) => async (params) => {
+        try {
+            const data = await getClient().post(`/api/v1/menards/${path}`, params);
+            return trimResponse(data);
+        }
+        catch (err) {
+            return handleApiError(err);
+        }
+    };
+    server.tool("get_menards_product", `One Menards product by item id or URL (there is no search): name, brand, model number, SKU, description, bullets, specifications, images, videos and documents, with the full price ladder: everyday price, sale price and its end date, mail-in rebates (text such as "11% REBATE*", amount, dates), final_price after rebates and the you-save amount. Also pickup, delivery and ship-to-store flags. Pass store_id for that store's stock quantity, stock message, aisle location and not_available_at_store; without it prices are the default store's (3598) and stock fields are null. Prices are in dollars. With store_id it can take 10-40 seconds. An unknown item id or store number is a 404. 1 credit; 2 credits with store_id.`, {
+        item_id: z.string().regex(/^\d{8,16}$/).optional()
+            .describe("Menards item id: the number after p- in a menards.com product URL, e.g. '60893666613'. Not the SKU or model number. Pass this or url."),
+        url: z.string().max(2000).optional()
+            .describe("A menards.com product URL, e.g. 'https://www.menards.com/main/p-60893666613.htm'. Pass this or item_id."),
+        store_id: z.string().regex(/^\d{1,5}$/).optional()
+            .describe("Menards store number from get_menards_stores, e.g. '3181'. Adds that store's stock quantity, stock message and aisle, priced for that store. Costs 2 credits instead of 1 and typically takes 10-40 seconds."),
+    }, post("product"));
+    server.tool("get_menards_stores", `Menards stores near a US ZIP code or a city and state, nearest first: store number (store_id), name, address, coordinates, distance in miles and services (garden center, grocery, rental center, propane and more). Use a store_id with get_menards_product for that store's stock and aisle. 1 credit.`, {
+        zip: z.string().regex(/^\d{5}(-\d{4})?$/).optional()
+            .describe("US ZIP code, e.g. '55401'. Pass this, or city and state."),
+        city: z.string().min(1).max(80).optional()
+            .describe("City to search around, with state, e.g. 'Madison'."),
+        state: z.string().regex(/^[A-Za-z]{2}$/).optional()
+            .describe("2-letter US state code, with city, e.g. 'WI'."),
+    }, post("stores"));
+}
+//# sourceMappingURL=menards.js.map

package/dist/tools/menards.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"menards.js","sourceRoot":"","sources":["../../src/tools/menards.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,6EAA6E;AAC7E,6EAA6E;AAC7E,8EAA8E;AAC9E,sDAAsD;AAEtD,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,SAA6B;IACnF,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,mBAAmB,IAAI,EAAE,EAAE,MAAM,CAAC,CAAC;YACvE,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,qBAAqB,EACrB,8sBAA8sB,EAC9sB;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE;aAC/C,QAAQ,CAAC,uIAAuI,CAAC;QACpJ,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;aACjC,QAAQ,CAAC,yGAAyG,CAAC;QACtH,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;aAC/C,QAAQ,CAAC,8MAA8M,CAAC;KAC5N,EACD,IAAI,CAAC,SAAS,CAAC,CAChB,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,oBAAoB,EACpB,0SAA0S,EAC1S;QACE,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,kBAAkB,CAAC,CAAC,QAAQ,EAAE;aACjD,QAAQ,CAAC,0DAA0D,CAAC;QACvE,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,QAAQ,EAAE;aACvC,QAAQ,CAAC,oDAAoD,CAAC;QACjE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;aAChD,QAAQ,CAAC,+CAA+C,CAAC;KAC7D,EACD,IAAI,CAAC,QAAQ,CAAC,CACf,CAAC;AACJ,CAAC"}

package/dist/tools/petco.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 registerPetcoTools(server: McpServer, getClient: () => ScavioClient): void;

package/dist/tools/petco.js

@@ -0,0 +1,60 @@
+import { z } from "zod";
+import { handleApiError } from "../lib/tool-error.js";
+import { trimResponse } from "../lib/trim-response.js";
+// Shapes mirror backend/src/routes/petco.ts. Cross-field rules the backend
+// enforces and zod here does not: product takes part_number OR url;
+// store-inventory takes store_id OR zip. No zod `.default()`: the MCP SDK would
+// post a defaulted field on every call.
+const SORTS = ["relevance", "price", "rating", "top_sold", "newest", "name"];
+const LISTING_FIELDS = "Each product has price, list price and autoship (Repeat Delivery) price in dollars, rating, review count, brand, part_number, cat_entry_id (for get_petco_store_inventory), fulfillment flags (pickup in store, same-day delivery, autoship, in-store only), deal_group_ids, and every size/flavor variation with its own prices. Also returned: total_results, facets with counts and the categories the matches fall into. 48 per page. Prices are national.";
+const zip = () => z.string().regex(/^\d{5}(-\d{4})?$/);
+const listingFields = () => ({
+    page: z.number().int().min(1).max(100).optional()
+        .describe("Page, 1-based. 48 products per page."),
+    sort: z.enum(SORTS).optional()
+        .describe("relevance (default), price, rating, top_sold, newest or name."),
+    sort_order: z.enum(["asc", "desc"]).optional()
+        .describe("asc or desc. Default asc for price and name, desc for everything else."),
+});
+export function registerPetcoTools(server, getClient) {
+    const post = (path) => async (params) => {
+        try {
+            const data = await getClient().post(`/api/v1/petco/${path}`, params);
+            return trimResponse(data);
+        }
+        catch (err) {
+            return handleApiError(err);
+        }
+    };
+    server.tool("search_petco", `Search Petco products. ${LISTING_FIELDS} 1 credit/call.`, {
+        query: z.string().min(1).max(200)
+            .describe("Search keywords, e.g. 'dog food'."),
+        ...listingFields(),
+    }, post("search"));
+    server.tool("get_petco_category", `Products in a Petco category, e.g. dog/dog-food/dry-dog-food. ${LISTING_FIELDS} Can take 10-30 seconds. An unknown category is a 404. 1 credit/call.`, {
+        path: z.string().min(1).max(300)
+            .describe("A petco.com category: its path ('dog/dog-food/dry-dog-food'), /category/<path>, or the full URL. A search result's categories[].url works too."),
+        ...listingFields(),
+    }, post("category"));
+    server.tool("get_petco_product", `One Petco product by part number or URL, with every variant (size, flavor): cat_entry_id, part number, SKU, UPC, price, list price, autoship (Repeat Delivery) price, first-autoship promo price, online quantity and status, fulfillment flags, ingredients, guaranteed analysis, directions, specifications, dimensions and images. Plus brand, rating, review count and breadcrumbs. Prices are national; for per-store stock pass a variant's cat_entry_id to get_petco_store_inventory. Can take 10-30 seconds. An unknown product is a 404. 1 credit.`, {
+        part_number: z.string().regex(/^\d{4,10}$/).optional()
+            .describe("Petco part number (a search result's part_number), e.g. '3748364'. Pass this or url."),
+        url: z.string().min(1).max(500).optional()
+            .describe("Petco product page URL, /product/<name>-<part number> (a search result's url). Answers faster than part_number."),
+    }, post("product"));
+    server.tool("get_petco_stores", `Petco stores nearest a US ZIP code (up to 10): store_id (what get_petco_store_inventory takes), store number, name, address, phone, coordinates, distance in miles, in-store pickup and opening hours per weekday. 1 credit.`, {
+        zip: zip()
+            .describe("US ZIP code, e.g. '10001'."),
+        limit: z.number().int().min(1).max(10).optional()
+            .describe("Number of stores, nearest first, 1-10. Default 5."),
+    }, post("stores"));
+    server.tool("get_petco_store_inventory", `Units on hand at one Petco store for up to 10 products: qty_available, alert_level (GREEN, YELLOW, RED) and in_stock per cat_entry_id. Pass a store_id, or a zip to use the nearest store (returned as store). Takes catalog entry ids (cat_entry_id from search_petco or get_petco_product), not part numbers; one unknown id makes the whole answer a 404. 1 credit.`, {
+        cat_entry_ids: z.array(z.string().regex(/^\d{1,12}$/)).min(1).max(10)
+            .describe("Up to 10 catalog entry ids: the cat_entry_id of a search result, variation or product variant, e.g. ['6131012', '531503']. NOT the part number."),
+        store_id: z.string().regex(/^\d{1,12}$/).optional()
+            .describe("Petco store id: the store_id of get_petco_stores (not the store number), e.g. '13275'. Pass this or zip."),
+        zip: zip().optional()
+            .describe("US ZIP code, e.g. '10001': stock is read at the nearest store to it."),
+    }, post("store-inventory"));
+}
+//# sourceMappingURL=petco.js.map

package/dist/tools/petco.js.map

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

package/dist/tools/petsmart.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 registerPetsmartTools(server: McpServer, getClient: () => ScavioClient): void;

package/dist/tools/petsmart.js

@@ -0,0 +1,77 @@
+import { z } from "zod";
+import { handleApiError } from "../lib/tool-error.js";
+import { trimResponse } from "../lib/trim-response.js";
+// Shapes mirror backend/src/routes/petsmart.ts. Cross-field rule the backend
+// enforces and zod here does not: product takes exactly one of web_style_id,
+// sku or url. No zod `.default()`: the MCP SDK would post a defaulted field on
+// every call.
+const SORTS = ["relevance", "best_sellers", "price_low", "price_high", "top_rated", "new_arrivals"];
+const PETS = ["dog", "cat", "fish", "small_pet", "reptile", "bird"];
+const STORE_HELP = "Find store numbers with get_petsmart_stores.";
+const storeId = () => z.string().regex(/^\d{1,5}$/);
+const sku = () => z.string().regex(/^\d{4,9}$/);
+const listingFields = () => ({
+    page: z.number().int().min(1).max(100).optional()
+        .describe("Page, 1-based."),
+    limit: z.number().int().min(1).max(40).optional()
+        .describe("Results per page, 1-40. Default 40."),
+    store_id: storeId().optional()
+        .describe(`PetSmart store number, e.g. '1658'. Lists only products in stock at that store, each with in_stock_at_store. ${STORE_HELP}`),
+    sort: z.enum(SORTS).optional()
+        .describe("relevance (default), best_sellers, price_low, price_high, top_rated or new_arrivals."),
+});
+export function registerPetsmartTools(server, getClient) {
+    const post = (path) => async (params) => {
+        try {
+            const data = await getClient().post(`/api/v1/petsmart/${path}`, params);
+            return trimResponse(data);
+        }
+        catch (err) {
+            return handleApiError(err);
+        }
+    };
+    server.tool("search_petsmart", `Search PetSmart products, up to 40 per page. Each result has SKU, web_style_id, name, brand, UPC, price, original price, sale price, price range across sizes, rating, review count, image, size, variation summary, category, pets, promotions, stores_in_stock (how many stores stock it), pickup and Autoship eligibility, and product URL. Prices are national, in dollars. Pass store_id to list only products in stock at that store. Use web_style_id or sku with get_petsmart_product. 1 credit/call.`, {
+        query: z.string().min(1).max(200)
+            .describe("Search keywords, e.g. 'dog food'."),
+        ...listingFields(),
+    }, post("search"));
+    server.tool("get_petsmart_product", `One PetSmart product by web_style_id, SKU or URL, with every variant (size/flavor): SKU, UPC, price, original price, sale price and end date, Autoship discount with first-order and recurring price, ship-to-home stock, pickup and same-day purchase options, images and promotions. Also brand, rating, review count, categories, description and option lists. Prices are national, in dollars. For store stock use get_petsmart_store_stock. An unknown id is a 404. 1 credit.`, {
+        web_style_id: z.string().regex(/^\d{1,8}$/).optional()
+            .describe("Product id: the number at the end of a product URL (...-570.html), a search result's web_style_id, e.g. '570'. One id covers every size and flavor. Pass exactly one of web_style_id, sku or url."),
+        sku: sku().optional()
+            .describe("A SKU (one size/flavor), a search result's sku, e.g. '5154856'. Returns the whole product it belongs to."),
+        url: z.string().max(500).optional()
+            .describe("A petsmart.com product page URL."),
+    }, post("product"));
+    server.tool("get_petsmart_stores", `The 12 PetSmart stores nearest a US ZIP code: store number (store_id), name, address, phone, coordinates, distance in miles, time zone, the next 7 days of opening hours and services (grooming, PetsHotel, veterinary, adoptions...). Pass a sku and each store also carries quantity and in_stock for that SKU. An unknown ZIP returns no stores. 1 credit.`, {
+        zip: z.string().regex(/^\d{5}(-\d{4})?$/)
+            .describe("US ZIP code, e.g. '60601'."),
+        radius: z.number().int().min(1).max(100).optional()
+            .describe("Search radius in miles. Default 30."),
+        sku: sku().optional()
+            .describe("A SKU, e.g. '5154856'. Every store then also carries its unit count of that SKU."),
+    }, post("stores"));
+    server.tool("get_petsmart_store_stock", `Stock of up to 20 SKUs at one PetSmart store in one call: units available for in-store pickup at that store, units available to ship to home, and an alternate nearby store with its count when the store has none. Includes the store's name, address, phone, page URL and pickup options. An unknown store number is a 404; an unknown SKU reads 0. 1 credit.`, {
+        store_id: storeId()
+            .describe(`PetSmart store number, e.g. '1658'. ${STORE_HELP}`),
+        skus: z.array(sku()).min(1).max(20)
+            .describe("Up to 20 SKUs, e.g. every variant of a product: ['5154856', '5154855']."),
+    }, post("store-stock"));
+    server.tool("get_petsmart_availability", `Unit counts for up to 20 PetSmart store and SKU pairs in one call, mixing stores and SKUs freely. Each result has quantity and in_stock. Unknown stores or SKUs read 0. 1 credit.`, {
+        pairs: z.array(z.object({
+            store_id: storeId().describe("PetSmart store number, e.g. '1658'."),
+            sku: sku().describe("SKU, e.g. '5252900'."),
+        })).min(1).max(20)
+            .describe("Up to 20 store and SKU pairs, e.g. [{store_id: '1658', sku: '5252900'}, {store_id: '2528', sku: '5252900'}]."),
+    }, post("availability"));
+    server.tool("get_petsmart_deals", `Products in PetSmart's Sale section, up to 40 per page, in the same shape as search_petsmart, plus the current sale events with approximate product counts. Filter by pet, by one sale event, by keywords, or to products in stock at a store. The Sale section also lists points and Autoship promotions, so on_sale marks the rows whose price is actually reduced. 1 credit/call.`, {
+        pet: z.enum(PETS).optional()
+            .describe("Only deals for this pet: dog, cat, fish, small_pet, reptile or bird."),
+        event: z.string().max(200).optional()
+            .describe("Only one sale event, by its exact name from the events list of a previous deals answer, e.g. 'Sale > November > Dog Sale'. Events change with the season."),
+        query: z.string().max(200).optional()
+            .describe("Keywords to search within the sale."),
+        ...listingFields(),
+    }, post("deals"));
+}
+//# sourceMappingURL=petsmart.js.map

package/dist/tools/petsmart.js.map

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

package/dist/tools/wholefoods.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 registerWholeFoodsTools(server: McpServer, getClient: () => ScavioClient): void;

package/dist/tools/wholefoods.js

@@ -0,0 +1,89 @@
+import { z } from "zod";
+import { handleApiError } from "../lib/tool-error.js";
+import { trimResponse } from "../lib/trim-response.js";
+// Shapes mirror backend/src/routes/wholefoods.ts. Cross-field rule the backend
+// enforces and zod here does not: product takes asin, url or slug (at least
+// one). No zod `.default()`: the MCP SDK would post a defaulted field on every
+// call.
+const BROWSE_SORTS = ["featured", "popular", "price_asc", "price_desc", "brand_az", "brand_za"];
+const DIETS = ["vegan", "gluten-free", "organic", "dairy-free", "vegetarian"];
+const PRICE_NOTE = "Prices are that store's in-store (shelf) prices in dollars: regular_price, sale_price and prime_price (the Prime member price), with sale start and end dates. A multi-buy is a total: sale_price 10 with sale_quantity 2 means 2 for $10; price_unit lb means per pound.";
+const storeId = () => z.string().regex(/^\d{5}$/).optional()
+    .describe("5-digit Whole Foods store id from get_whole_foods_stores, e.g. '10160'. Prices are that store's. Default 10145 (Lamar, Austin TX).");
+const requiredStoreId = () => z.string().regex(/^\d{5}$/)
+    .describe("5-digit Whole Foods store id from get_whole_foods_stores, e.g. '10145'.");
+const diet = () => z.enum(DIETS).optional()
+    .describe("Only products with this dietary attribute: vegan, gluten-free, organic, dairy-free or vegetarian.");
+const limit = () => z.number().int().min(1).max(60).optional()
+    .describe("Products per page, 1-60. Default 60.");
+const offset = () => z.number().int().min(0).max(10000).optional()
+    .describe("Products to skip, for paging (60 = page 2 at the default limit). Default 0.");
+const browseSort = () => z.enum(BROWSE_SORTS).optional()
+    .describe("featured (default), popular, price_asc, price_desc, brand_az or brand_za.");
+const CATEGORY_HELP = "Category slug, e.g. 'dairy-eggs', 'cheese', 'produce'. Slugs are in the category facet of any search.";
+export function registerWholeFoodsTools(server, getClient) {
+    const post = (path) => async (params) => {
+        try {
+            const data = await getClient().post(`/api/v1/wholefoods/${path}`, params);
+            return trimResponse(data);
+        }
+        catch (err) {
+            return handleApiError(err);
+        }
+    };
+    server.tool("search_whole_foods", `Search Whole Foods Market products at one store, up to 60 per page. ${PRICE_NOTE} Each result has asin, slug, name, brand, image, URL, on_sale and is_local flags; the response has total_results and facets (category tree, featured and diet filters, with counts). Sorts are relevance, price_asc and price_desc only. No ratings, reviews, UPCs or per-store unit stock. Use a result's asin with get_whole_foods_product. 1 credit/call.`, {
+        query: z.string().min(1).max(200)
+            .describe("Search keywords, e.g. 'milk'."),
+        store_id: storeId(),
+        sort: z.enum(["relevance", "price_asc", "price_desc"]).optional()
+            .describe("relevance (default), price_asc or price_desc."),
+        on_sale: z.boolean().optional()
+            .describe("Only products on sale at the store. Default false."),
+        diet: diet(),
+        category: z.string().min(1).max(100).optional()
+            .describe(`Restrict to one category. ${CATEGORY_HELP}`),
+        limit: limit(),
+        offset: offset(),
+    }, post("search"));
+    server.tool("get_whole_foods_category", `Browse one Whole Foods Market category at one store, with sort and filters, up to 60 per page. ${PRICE_NOTE} The response has the category breadcrumb, total_results and facets. An unknown category slug is a 404. 1 credit/call.`, {
+        category: z.string().min(1).max(100)
+            .describe(`${CATEGORY_HELP} 'all-products' lists the whole store.`),
+        store_id: storeId(),
+        sort: browseSort(),
+        on_sale: z.boolean().optional()
+            .describe("Only products on sale at the store. Default false."),
+        diet: diet(),
+        limit: limit(),
+        offset: offset(),
+    }, post("category"));
+    server.tool("get_whole_foods_deals", `Every product on sale at one Whole Foods Market store, store-wide or in one category, up to 60 per page. ${PRICE_NOTE} 1 credit/call.`, {
+        category: z.string().min(1).max(100).optional()
+            .describe(`${CATEGORY_HELP} Default 'all-products' (every sale item at the store).`),
+        store_id: storeId(),
+        sort: browseSort(),
+        diet: diet(),
+        limit: limit(),
+        offset: offset(),
+    }, post("deals"));
+    server.tool("get_whole_foods_product", `One Whole Foods Market product by ASIN, URL or slug: name, brand, description, highlights, ingredients, nutrition facts, diets, SNAP EBT eligibility and images. With store_id, two separately labelled price blocks: in_store (the store's shelf regular, sale and Prime price; null when that store does not list the item) and online (that store's delivery/pickup price, list price, savings, Prime price, unit price and availability; null when it has no online offer). Online and in-store prices often differ. An unknown ASIN is a 404. 1 credit.`, {
+        asin: z.string().regex(/^[A-Za-z0-9]{10}$/).optional()
+            .describe("Product ASIN (a search result's asin), e.g. 'B0BCBNG8LS'. Pass this, url or slug."),
+        url: z.string().url().max(500).optional()
+            .describe("A wholefoodsmarket.com product URL."),
+        slug: z.string().min(1).max(200).optional()
+            .describe("A product slug (a search result's slug), e.g. 'a2-milk-grassfed-whole-milk-59-fz-b0bcbng8ls'."),
+        store_id: z.string().regex(/^\d{5}$/).optional()
+            .describe("5-digit Whole Foods store id, e.g. '10145'. Adds that store's in-store (shelf) prices and its online (delivery/pickup) price."),
+    }, post("product"));
+    server.tool("get_whole_foods_stores", `Whole Foods Market stores near a US ZIP code, nearest first, within 15 miles widening to 50: store_id, name, address, phone, coordinates, distance in miles, time zone, and seven days of in-store and pickup hours (UTC times). No store in range is an empty list, not an error. 1 credit.`, {
+        zip: z.string().regex(/^\d{5}(-\d{4})?$/)
+            .describe("US ZIP code, e.g. '78703'."),
+    }, post("stores"));
+    server.tool("get_whole_foods_store", `One Whole Foods Market store by id: name, status, phone, Prime eligibility, opening date, address, coordinates, time zone and its store page and sales flyer URLs. An unknown store id is a 404. 1 credit.`, {
+        store_id: requiredStoreId(),
+    }, post("store"));
+    server.tool("get_whole_foods_sales_flyer", `The current weekly sales flyer of one Whole Foods Market store: each promotion's product name, brand, headline, description, terms, regular, sale and Prime price as printed in the flyer (text such as "$3.99/lb" or "44% off"), start and end dates, image, rank and the ASINs it covers. An unknown store id is a 404. 1 credit.`, {
+        store_id: requiredStoreId(),
+    }, post("sales-flyer"));
+}
+//# sourceMappingURL=wholefoods.js.map

package/dist/tools/wholefoods.js.map

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

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@scavio/mcp-server",
-  "version": "0.30.2",
+  "version": "0.31.1",
   "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. 318 tools across 51 platforms plus Extract, 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. 351 tools across 58 platforms plus Extract, site map, crawl and batch extraction, one API key.",
   "type": "module",
   "license": "MIT",
   "author": "Scavio",
@@ -33,6 +33,13 @@
     "micro-center",
     "walgreens",
     "cvs",
+    "whole-foods",
+    "harbor-freight",
+    "petsmart",
+    "petco",
+    "iherb",
+    "chewy",
+    "menards",
     "mercadolibre",
     "mercado-libre",
     "tiktok",