ikea-mcp 1.4.0 → 1.5.0

package/dist/schemas/index.js

@@ -69,3 +69,10 @@ export const CheckMultiItemStockInput = z.object({
     storeId: z.string().min(1),
     itemNos: z.array(ItemNo).min(1).max(20),
 });
+export const CheckCartAvailabilityInput = z.object({
+    storeId: z.string().min(1),
+    items: z.array(z.object({
+        itemNo: ItemNo,
+        quantity: z.number().int().min(1).max(99).default(1),
+    })).min(1).max(20),
+});

package/dist/server.js

@@ -7,7 +7,8 @@ import { findBestStoreForItemTool } from "./tools/find_best_store_for_item.js";
 import { getProductDetailsTool } from "./tools/get_product_details.js";
 import { checkMultiItemStockTool } from "./tools/check_multi_item_stock.js";
 import { listStoresTool } from "./tools/list_stores.js";
-const tools = [listStoresTool, searchProductsTool, checkStoreStockTool, compareStoreStockTool, findBestStoreForItemTool, getProductDetailsTool, checkMultiItemStockTool];
+import { checkCartAvailabilityTool } from "./tools/check_cart_availability.js";
+const tools = [listStoresTool, searchProductsTool, checkStoreStockTool, compareStoreStockTool, findBestStoreForItemTool, getProductDetailsTool, checkMultiItemStockTool, checkCartAvailabilityTool];
 export function createServer() {
     const server = new Server({ name: "ikea-mcp", version: "1.0.0" }, { capabilities: { tools: {} } });
     server.setRequestHandler(ListToolsRequestSchema, async () => ({

package/dist/tools/check_cart_availability.js

@@ -0,0 +1,93 @@
+import { CheckCartAvailabilityInput } from "../schemas/index.js";
+import { getMultiItemStock } from "../services/ikea.js";
+import { storeLabel } from "../data/stores.js";
+export const checkCartAvailabilityTool = {
+    name: "check_cart_availability",
+    description: "Check whether all items in a shopping list are available in sufficient quantity at a single IKEA store.",
+    inputSchema: {
+        type: "object",
+        properties: {
+            storeId: { type: "string" },
+            items: {
+                type: "array",
+                items: {
+                    type: "object",
+                    properties: {
+                        itemNo: { type: "string" },
+                        quantity: { type: "number", default: 1 },
+                    },
+                    required: ["itemNo"],
+                },
+                minItems: 1,
+                maxItems: 20,
+            },
+        },
+        required: ["storeId", "items"],
+    },
+    async handler(rawInput) {
+        const input = CheckCartAvailabilityInput.parse(rawInput);
+        const itemNos = input.items.map((i) => i.itemNo);
+        const result = await getMultiItemStock(itemNos, input.storeId);
+        const byItemNo = new Map();
+        for (const a of result.availabilities ?? []) {
+            byItemNo.set(a.itemKey.itemNo, a);
+        }
+        const errorByItemNo = new Map();
+        for (const e of result.errors ?? []) {
+            if (e.details?.itemNo) {
+                errorByItemNo.set(e.details.itemNo, {
+                    ...e,
+                    meaning: e.code === 404 ? "item not stocked at this store" : "unknown",
+                });
+            }
+        }
+        const storeError = result.errors?.find((e) => e.code === 405);
+        const items = input.items.map((item) => {
+            if (storeError) {
+                return {
+                    itemNo: item.itemNo,
+                    quantity: item.quantity,
+                    inStock: null,
+                    sufficient: false,
+                    eligibleForStockNotification: null,
+                    errors: [{ code: storeError.code, message: storeError.message, meaning: "store ID does not exist" }],
+                };
+            }
+            const a = byItemNo.get(item.itemNo);
+            if (a) {
+                const inStock = a.buyingOption.cashCarry.availability.quantity;
+                return {
+                    itemNo: item.itemNo,
+                    quantity: item.quantity,
+                    inStock,
+                    sufficient: inStock >= item.quantity,
+                    eligibleForStockNotification: a.buyingOption.cashCarry.eligibleForStockNotification ?? null,
+                    errors: [],
+                };
+            }
+            const err = errorByItemNo.get(item.itemNo);
+            return {
+                itemNo: item.itemNo,
+                quantity: item.quantity,
+                inStock: null,
+                sufficient: false,
+                eligibleForStockNotification: null,
+                errors: err
+                    ? [err]
+                    : [{ code: 404, message: "Not found", meaning: "item not stocked at this store" }],
+            };
+        });
+        const allSufficient = items.every((i) => i.sufficient);
+        return {
+            content: [{
+                    type: "text",
+                    text: JSON.stringify({
+                        storeId: input.storeId,
+                        storeLabel: storeLabel(input.storeId) ?? input.storeId,
+                        allSufficient,
+                        items,
+                    }, null, 2),
+                }],
+        };
+    },
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ikea-mcp",
-  "version": "1.4.0",
+  "version": "1.5.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",