picnic-mcp 0.2.0 → 0.4.0

package/dist/tools/search-products.js

@@ -1,7 +1,7 @@
 import * as z from "zod";
 import { formatProduct } from "../format/products.js";
 import { listCandidates, matchProducts } from "../match.js";
-import { SEARCH_LANGUAGES } from "./context.js";
+import { SEARCH_LANGUAGES, imageUrls } from "./context.js";
 import { jsonResult, runTool } from "./result.js";
 /** At most this many products in the output, to keep it short. */
 const MAX_PRODUCTS = 8;
@@ -24,29 +24,33 @@ export function registerSearchProducts(server, context) {
         const corrected = results.correctedQuery && results.correctedQuery !== query
             ? { searchedFor: results.correctedQuery }
             : {};
+        const images = (shown) => imageUrls(context, shown.map(({ tile }) => ({ productId: tile.id, imageId: tile.imageId })));
         if (match.type === "best") {
+            const others = match.others.slice(0, MAX_PRODUCTS - 1);
             return jsonResult({
                 ...corrected,
                 next: "Add bestMatch with add_to_cart, unless the user asked for something else.",
                 bestMatch: formatProduct(match.best, context.countryCode),
-                otherResults: format(match.others.slice(0, MAX_PRODUCTS - 1)),
-            });
+                otherResults: format(others),
+            }, images([match.best, ...others]));
         }
         if (match.type === "choose") {
+            const others = match.others.slice(0, MAX_PRODUCTS - match.choices.length);
             return jsonResult({
                 ...corrected,
                 next: "No clear match. Ask the user which of the choices they want, then add it with add_to_cart.",
                 choices: format(match.choices),
-                otherResults: format(match.others.slice(0, MAX_PRODUCTS - match.choices.length)),
-            });
+                otherResults: format(others),
+            }, images([...match.choices, ...others]));
         }
+        const others = match.others.slice(0, MAX_PRODUCTS);
         return jsonResult({
             ...corrected,
-            next: match.others.length > 0
+            next: others.length > 0
                 ? "None of the results can be ordered right now. Tell the user, or try another search term."
                 : "Nothing found. Try another search term, or tell the user.",
-            otherResults: format(match.others.slice(0, MAX_PRODUCTS)),
-        });
+            otherResults: format(others),
+        }, images(others));
     }, context.onError));
 }
 //# sourceMappingURL=search-products.js.map

package/dist/tools/search-products.js.map

@@ -1 +1 @@
-{"version":3,"file":"search-products.js","sourceRoot":"","sources":["../../src/tools/search-products.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAEtD,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAoB,MAAM,cAAc,CAAC;AAClE,OAAO,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAElD,kEAAkE;AAClE,MAAM,YAAY,GAAG,CAAC,CAAC;AAEvB,MAAM,UAAU,sBAAsB,CAAC,MAAiB,EAAE,OAAoB;IAC5E,MAAM,QAAQ,GAAG,gBAAgB,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC;IACvD,MAAM,CAAC,YAAY,CACjB,iBAAiB,EACjB;QACE,KAAK,EAAE,iBAAiB;QACxB,WAAW,EACT,8EAA8E;YAC9E,sBAAsB,QAAQ,6BAA6B;YAC3D,sGAAsG;YACtG,gKAAgK;QAClK,WAAW,EAAE,CAAC,CAAC,MAAM,CAAC;YACpB,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,iCAAiC,QAAQ,GAAG,CAAC;SACvF,CAAC;QACF,WAAW,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE;KACzD,EACD,CAAC,EAAE,KAAK,EAAE,EAAE,EAAE,CACZ,OAAO,CAAC,KAAK,IAAI,EAAE;QACjB,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,KAAK,CAAC,CAAC;QACrE,MAAM,KAAK,GAAG,aAAa,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CAAC;QACrD,MAAM,MAAM,GAAG,CAAC,UAAuB,EAAE,EAAE,CACzC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,aAAa,CAAC,SAAS,EAAE,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC;QAC/E,MAAM,SAAS,GACb,OAAO,CAAC,cAAc,IAAI,OAAO,CAAC,cAAc,KAAK,KAAK;YACxD,CAAC,CAAC,EAAE,WAAW,EAAE,OAAO,CAAC,cAAc,EAAE;YACzC,CAAC,CAAC,EAAE,CAAC;QAET,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC1B,OAAO,UAAU,CAAC;gBAChB,GAAG,SAAS;gBACZ,IAAI,EAAE,2EAA2E;gBACjF,SAAS,EAAE,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,WAAW,CAAC;gBACzD,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,GAAG,CAAC,CAAC,CAAC;aAC9D,CAAC,CAAC;QACL,CAAC;QACD,IAAI,KAAK,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;YAC5B,OAAO,UAAU,CAAC;gBAChB,GAAG,SAAS;gBACZ,IAAI,EAAE,4FAA4F;gBAClG,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC;gBAC9B,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;aACjF,CAAC,CAAC;QACL,CAAC;QACD,OAAO,UAAU,CAAC;YAChB,GAAG,SAAS;YACZ,IAAI,EACF,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;gBACrB,CAAC,CAAC,0FAA0F;gBAC5F,CAAC,CAAC,2DAA2D;YACjE,YAAY,EAAE,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,YAAY,CAAC,CAAC;SAC1D,CAAC,CAAC;IACL,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CACtB,CAAC;AACJ,CAAC"}
+{"version":3,"file":"search-products.js","sourceRoot":"","sources":["../../src/tools/search-products.ts"],"names":[],"mappings":"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"}

package/dist/tools/slots.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/server";
+import type { ToolContext } from "./context.js";
+export declare function registerSlotTools(server: McpServer, context: ToolContext): void;

package/dist/tools/slots.js

@@ -0,0 +1,61 @@
+import * as z from "zod";
+import { formatCartSummary } from "../format/cart.js";
+import { formatWindow } from "../format/prices.js";
+import { slotDays } from "../format/slots.js";
+import { errorResult, jsonResult, runTool } from "./result.js";
+/** Without a date, the slots of this many days are listed. */
+const DAYS_WITHOUT_DATE = 2;
+export function registerSlotTools(server, context) {
+    const { client, countryCode, onError } = context;
+    server.registerTool("get_delivery_slots", {
+        title: "Get delivery slots",
+        description: "List the delivery slots the user can choose for the cart. Without a date it lists the first 2 days and the dates of the other days. " +
+            "Pass a date from that list to see its slots. Use select_delivery_slot once the user picked a slot.",
+        inputSchema: z.object({
+            date: z
+                .string()
+                .regex(/^\d{4}-\d{2}-\d{2}$/, "Use a date like 2026-10-23.")
+                .optional()
+                .describe("The day to list, as YYYY-MM-DD. Leave out for the first days."),
+        }),
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, ({ date }) => runTool(async () => {
+        const slots = await client.cart.getDeliverySlots();
+        const days = slotDays(slots, countryCode);
+        const shown = date
+            ? days.filter((day) => day.date === date)
+            : days.slice(0, DAYS_WITHOUT_DATE);
+        const otherDays = days
+            .filter((day) => !shown.includes(day))
+            .map((day) => `${day.date} (${day.day})`);
+        const selected = formatWindow(slots.selectedSlot?.windowStart ?? null, slots.selectedSlot?.windowEnd ?? null);
+        return jsonResult({
+            ...(date &&
+                shown.length === 0 && { next: `No slots on ${date}. Pick one of otherDays.` }),
+            ...(selected && { selectedWindow: selected }),
+            days: shown,
+            ...(otherDays.length > 0 && { otherDays }),
+        });
+    }, onError));
+    server.registerTool("select_delivery_slot", {
+        title: "Select delivery slot",
+        description: "Choose when the cart is delivered. Only use a slotId from get_delivery_slots, after the user picked the slot. " +
+            "Returns the selected delivery window and the cart total. This does not place an order.",
+        inputSchema: z.object({
+            slotId: z.string().trim().min(1).describe("The slotId from get_delivery_slots."),
+        }),
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: true,
+        },
+    }, ({ slotId }) => runTool(async () => {
+        const cart = await client.cart.setDeliverySlot(slotId);
+        if (cart.selectedSlot?.slotId !== slotId) {
+            return errorResult(`Picnic did not select slot ${slotId}. Check the slotId with get_delivery_slots.`);
+        }
+        return jsonResult({ selected: true, cart: formatCartSummary(cart, countryCode) });
+    }, onError));
+}
+//# sourceMappingURL=slots.js.map

package/dist/tools/slots.js.map

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

package/dist/types.d.ts

@@ -3,5 +3,13 @@ export type CountryCode = "NL" | "DE" | "FR";
 export declare const COUNTRY_CODES: readonly CountryCode[];
 export type SearchResults = PicnicClient.Types.catalog.SearchResults;
 export type ProductTile = PicnicClient.Types.catalog.ProductTile;
+export type SearchRecipe = PicnicClient.Types.catalog.SearchRecipe;
+export type Product = PicnicClient.Types.catalog.Product;
 export type Cart = PicnicClient.Types.cart.Cart;
 export type CartLineItem = PicnicClient.Types.cart.CartLineItem;
+export type DeliverySlots = PicnicClient.Types.cart.DeliverySlots;
+export type DeliverySlot = PicnicClient.Types.cart.DeliverySlot;
+export type DeliverySummary = PicnicClient.Types.delivery.DeliverySummary;
+export type Delivery = PicnicClient.Types.delivery.Delivery;
+export type DeliveryPosition = PicnicClient.Types.delivery.DeliveryPosition;
+export type Recipe = PicnicClient.Types.recipe.Recipe;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "picnic-mcp",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "MCP server for the online supermarket Picnic: search products and manage the cart",
   "keywords": [
     "picnic",
@@ -47,7 +47,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/server": "^2.3.1",
-    "picnic-api": "^5.0.0",
+    "picnic-api": "^5.2.0",
     "zod": "^4.6.7"
   },
   "devDependencies": {