ikea-mcp 1.2.1 → 1.3.0

package/README.md

@@ -12,8 +12,8 @@ Read-only MCP server for IKEA product search and in-store stock lookup.
 | `get_product_details` | Get details for a single product by item number |
 | `check_store_stock` | Check cash-and-carry stock at one store |
 | `check_multi_item_stock` | Check stock for multiple items at one store |
-| `compare_store_stock` | Compare stock across multiple stores |
-| `find_best_store_for_item` | Rank stores by in-stock quantity |
+| `compare_store_stock` | Compare stock across explicit stores or a country catalog |
+| `find_best_store_for_item` | Rank stores by in-stock quantity (optionally filter by country) |
 
 ## MVP limitations
 - Uses unofficial public IKEA APIs — no SLA, may break without notice
@@ -123,14 +123,24 @@ On error (e.g. item not carried):
 
 ### `compare_store_stock`
 
-Compare stock for one item across multiple stores.
+Compare stock for one item across multiple stores. Provide explicit `storeIds`, or use `countryCode` to expand to all catalog stores for that country. At least one of `storeIds` or `countryCode` is required.
 
 **Input**
 | param | type | default | required |
 |---|---|---|---|
 | `itemNo` | string | — | yes |
-| `storeIds` | string[] (min 2) | — | yes |
-| `countryCode` | string | `"us"` | no |
+| `storeIds` | string[] (min 2) | — | one of `storeIds`/`countryCode` |
+| `countryCode` | `"US"` \| `"CA"` | — | one of `storeIds`/`countryCode` |
+
+`storeIds` takes precedence — if both are provided, `countryCode` only sets the IKEA API locale.
+
+**Examples**
+```json
+{ "itemNo": "20522046", "storeIds": ["399", "026", "921"] }
+```
+```json
+{ "itemNo": "20522046", "countryCode": "CA" }
+```
 
 **Output** — array of the same shape as `check_store_stock` (one entry per store).
 
@@ -176,6 +186,9 @@ Find stores with the highest in-stock quantity for an item. Queries stores in pa
 | `itemNo` | string | — | yes |
 | `storeIds` | string[] | all known stores | no |
 | `maxResults` | number | `3` (max 10) | no |
+| `countryCode` | `"US"` \| `"CA"` | — | no |
+
+`storeIds` takes precedence. If only `countryCode` is given, searches all catalog stores for that country. If neither is given, searches all ~65 known stores.
 
 **Output** — array of matching stores, up to `maxResults`:
 ```json
@@ -365,6 +378,6 @@ An invalid or unsupported `storeId` returns a 405 error in the `errors` array.
 
 - Uses unofficial public IKEA APIs — no SLA, no auth required, may break without notice.
 - Read-only: no cart, no order, no account operations.
-- `compare_store_stock` fires all store requests in parallel — large `storeIds` arrays may hit rate limits.
+- `compare_store_stock` fires all store requests in parallel — large `storeIds` arrays or a full `countryCode` expansion may hit rate limits.
 - Click-and-collect and home-delivery availability are not exposed (cash-and-carry only).
 - `size` in `search_products` is capped by IKEA's API (observed max ~24 per page; `total` reflects the full catalogue count).

package/dist/data/stores.js

@@ -83,3 +83,11 @@ export const STORE_LABELS = {
 export function storeLabel(storeId) {
     return STORE_LABELS[storeId];
 }
+// Canada labels have a province code before the country: "(City, BC, CA)"
+// US state abbreviations like California "(City, CA)" must not match.
+const CA_LABEL_RE = /,\s+[A-Z]{2},\s+CA\)$/;
+export function storeIdsByCountry(countryCode) {
+    return Object.entries(STORE_LABELS)
+        .filter(([, label]) => countryCode === "CA" ? CA_LABEL_RE.test(label) : !CA_LABEL_RE.test(label))
+        .map(([id]) => id);
+}

package/dist/schemas/index.js

@@ -12,13 +12,14 @@ export const CheckStoreStockInput = z.object({
 });
 export const CompareStoreStockInput = z.object({
     itemNo: z.string().min(1),
-    storeIds: z.array(z.string().min(1)).min(2).max(10),
-    countryCode: z.string().length(2).default("us"),
-});
+    storeIds: z.array(z.string().min(1)).min(2).max(10).optional(),
+    countryCode: z.enum(["US", "CA"]).optional(),
+}).refine((d) => d.storeIds !== undefined || d.countryCode !== undefined, { message: "provide storeIds or countryCode" });
 export const FindBestStoreInput = z.object({
     itemNo: z.string().min(1),
     storeIds: z.array(z.string().min(1)).optional(),
     maxResults: z.number().int().min(1).max(10).default(3),
+    countryCode: z.enum(["US", "CA"]).optional(),
 });
 export const GetProductDetailsInput = z.object({
     itemNo: z.string().min(1),

package/dist/tools/compare_store_stock.js

@@ -1,21 +1,24 @@
 import { CompareStoreStockInput } from "../schemas/index.js";
 import { getStoreStock, projectStock } from "../services/ikea.js";
-import { storeLabel } from "../data/stores.js";
+import { storeLabel, storeIdsByCountry } from "../data/stores.js";
 export const compareStoreStockTool = {
     name: "compare_store_stock",
-    description: "Compare stock availability for an item across multiple IKEA stores.",
+    description: "Compare stock availability for an item across multiple IKEA stores. Provide explicit storeIds, or use countryCode ('US' or 'CA') to compare all catalog stores for that country.",
     inputSchema: {
         type: "object",
         properties: {
             itemNo: { type: "string" },
             storeIds: { type: "array", items: { type: "string" }, minItems: 2 },
-            countryCode: { type: "string", default: "us" },
+            countryCode: { type: "string", enum: ["US", "CA"] },
         },
-        required: ["itemNo", "storeIds"],
+        required: ["itemNo"],
     },
     async handler(rawInput) {
         const input = CompareStoreStockInput.parse(rawInput);
-        const results = await Promise.all(input.storeIds.map((storeId) => getStoreStock(input.itemNo, storeId, input.countryCode).then((data) => {
+        const targetIds = input.storeIds
+            ?? storeIdsByCountry(input.countryCode);
+        const apiCountry = input.countryCode?.toLowerCase() ?? "us";
+        const results = await Promise.all(targetIds.map((storeId) => getStoreStock(input.itemNo, storeId, apiCountry).then((data) => {
             const label = storeLabel(storeId);
             return {
                 storeId,

package/dist/tools/find_best_store_for_item.js

@@ -1,21 +1,23 @@
 import { FindBestStoreInput } from "../schemas/index.js";
 import { getStoreStock, projectStock } from "../services/ikea.js";
-import { STORE_LABELS, storeLabel } from "../data/stores.js";
+import { STORE_LABELS, storeLabel, storeIdsByCountry } from "../data/stores.js";
 export const findBestStoreForItemTool = {
     name: "find_best_store_for_item",
-    description: "Find stores with the highest in-stock quantity for an item. Returns up to maxResults stores sorted by quantity descending.",
+    description: "Find stores with the highest in-stock quantity for an item. Returns up to maxResults stores sorted by quantity descending. Optionally filter by countryCode ('US' or 'CA'). Explicit storeIds take precedence over countryCode.",
     inputSchema: {
         type: "object",
         properties: {
             itemNo: { type: "string" },
             storeIds: { type: "array", items: { type: "string" } },
             maxResults: { type: "number", default: 3 },
+            countryCode: { type: "string", enum: ["US", "CA"] },
         },
         required: ["itemNo"],
     },
     async handler(rawInput) {
         const input = FindBestStoreInput.parse(rawInput);
-        const targetIds = input.storeIds ?? Object.keys(STORE_LABELS);
+        const targetIds = input.storeIds
+            ?? (input.countryCode ? storeIdsByCountry(input.countryCode) : Object.keys(STORE_LABELS));
         const results = await Promise.all(targetIds.map(async (storeId) => {
             const data = await getStoreStock(input.itemNo, storeId, "us");
             const stock = projectStock(data);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ikea-mcp",
-  "version": "1.2.1",
+  "version": "1.3.0",
   "description": "Read-only MCP server for IKEA product search and in-store stock lookup. Supports stdio and Streamable HTTP transports.",
   "license": "MIT",
   "type": "module",