picnic-mcp 0.0.0-stage → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 MRVDH
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,64 @@
-# Temporary Holding Version
+# picnic-mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+An [MCP](https://modelcontextprotocol.io) server for the online supermarket [Picnic](https://picnic.app). It lets a model search Picnic's products and change your shopping cart. It can't place an order.
+
+Unofficial: not made or supported by Picnic. Built on [picnic-api](https://github.com/MRVDH/picnic-api).
+
+## Tools
+
+| Tool               | What it does                                                                                                                          |
+| ------------------ | ------------------------------------------------------------------------------------------------------------------------------------- |
+| `search_products`  | Searches products. Returns a `bestMatch` when one product fits (usually one you bought before), or 2 or 3 `choices` to ask you about. |
+| `add_to_cart`      | Adds a product by its id. Returns the quantity in the cart and the cart total, and replacements when the product can't be delivered.  |
+| `remove_from_cart` | Removes a product by its id.                                                                                                          |
+| `get_cart`         | Shows the cart: products, quantities, prices, total and delivery window, and replacements for products that can't be delivered.       |
+
+Output is compact JSON with only what a model needs. It contains products, prices and your cart, but not your name, address or other account details. Keep in mind that whatever the tools return is sent to the model your MCP client uses.
+
+## Setup
+
+Requires Node.js 20 or later.
+
+### 1. Get an auth key
+
+```bash
+npx picnic-mcp login
+```
+
+It asks for your country, email and password, and the code Picnic texts you when your account uses two-factor authentication. It prints an auth key and stores nothing. Keep the key secret: it gives access to your Picnic account.
+
+### 2. Add the server to your MCP client
+
+Most clients take a configuration like this:
+
+```json
+{
+  "mcpServers": {
+    "picnic": {
+      "command": "npx",
+      "args": ["-y", "picnic-mcp"],
+      "env": {
+        "PICNIC_AUTH_KEY": "<your auth key>",
+        "PICNIC_COUNTRY_CODE": "NL"
+      }
+    }
+  }
+}
+```
+
+`PICNIC_COUNTRY_CODE` is `NL`, `DE` or `FR` (default `NL`). The server runs over stdio.
+
+When the key expires, the tools say so; run `npx picnic-mcp login` again.
+
+## Use it in your own code
+
+`createServer` returns the MCP server without reading environment variables or files, so you can run it in your own process and connect it to any MCP transport:
+
+```ts
+import { createServer } from "picnic-mcp";
+
+const server = createServer({ authKey: "<auth key>", countryCode: "NL" });
+await server.connect(transport);
+```
+
+Pass `client` instead of `authKey` to use a picnic-api client you already have, and `onError` to handle errors from Picnic yourself (by default they're logged to stderr).

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,89 @@
+#!/usr/bin/env node
+import { serveStdio } from "@modelcontextprotocol/server/stdio";
+import { createInterface } from "node:readline/promises";
+import { Writable } from "node:stream";
+import PicnicClient from "picnic-api";
+import { createServer } from "./server.js";
+import { COUNTRY_CODES } from "./types.js";
+const USAGE = `Usage:
+  picnic-mcp          Serve the MCP server over stdio. Reads PICNIC_AUTH_KEY and
+                      PICNIC_COUNTRY_CODE (NL, DE or FR; default NL).
+  picnic-mcp login    Sign in to Picnic and print an auth key for PICNIC_AUTH_KEY.`;
+function parseCountryCode(value) {
+    const code = (value ?? "NL").trim().toUpperCase();
+    if (!COUNTRY_CODES.includes(code)) {
+        throw new Error(`Unknown country code "${value}". Use one of ${COUNTRY_CODES.join(", ")}.`);
+    }
+    return code;
+}
+async function serve() {
+    const authKey = process.env.PICNIC_AUTH_KEY?.trim();
+    if (!authKey) {
+        console.error("PICNIC_AUTH_KEY is not set. Get an auth key with `npx picnic-mcp login`.\n\n" + USAGE);
+        process.exit(1);
+    }
+    const countryCode = parseCountryCode(process.env.PICNIC_COUNTRY_CODE);
+    serveStdio(() => createServer({ authKey, countryCode }));
+}
+/** Asks for the login details on the terminal and prints the auth key. Stores nothing. */
+async function login() {
+    // Output goes to stderr, so stdout carries only the auth key.
+    let muted = false;
+    const output = new Writable({
+        write(chunk, _encoding, callback) {
+            if (!muted)
+                process.stderr.write(chunk);
+            callback();
+        },
+    });
+    const terminal = createInterface({ input: process.stdin, output, terminal: true });
+    const ask = (question) => terminal.question(question);
+    const askHidden = async (question) => {
+        process.stderr.write(question);
+        muted = true;
+        const answer = await terminal.question("");
+        muted = false;
+        process.stderr.write("\n");
+        return answer;
+    };
+    try {
+        const countryCode = parseCountryCode((await ask("Country (NL, DE or FR) [NL]: ")) || "NL");
+        const email = (await ask("Email: ")).trim();
+        const password = await askHidden("Password: ");
+        const client = new PicnicClient({ countryCode });
+        const result = await client.auth.login(email, password);
+        let authKey = result.authKey;
+        if (result.secondFactorAuthenticationRequired) {
+            await client.auth.generate2FACode("SMS");
+            const code = (await ask("Code from the text message Picnic sent you: ")).trim();
+            authKey = (await client.auth.verify2FACode(code)).authKey;
+        }
+        process.stderr.write("\nSigned in. Set this as PICNIC_AUTH_KEY:\n");
+        process.stdout.write(`${authKey}\n`);
+    }
+    finally {
+        terminal.close();
+    }
+}
+async function main() {
+    const command = process.argv[2];
+    if (command === undefined)
+        return serve();
+    if (command === "login")
+        return login();
+    console.error(command === "--help" || command === "-h" ? USAGE : `Unknown command "${command}".\n\n${USAGE}`);
+    process.exit(command === "--help" || command === "-h" ? 0 : 1);
+}
+main().catch((error) => {
+    if (PicnicClient.isPicnicApiError(error) && error.code === "AUTH_INVALID_CRED") {
+        console.error("The email or password is wrong.");
+    }
+    else if (PicnicClient.isPicnicApiError(error) && error.code === "OTP_NOT_VALID") {
+        console.error("The code is wrong or expired. Run `picnic-mcp login` again.");
+    }
+    else {
+        console.error(error instanceof Error ? error.message : error);
+    }
+    process.exit(1);
+});
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

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

package/dist/errors.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Turns an error from picnic-api into a short message for the model. Response bodies stay out:
+ * they can be long HTML pages or contain account data.
+ */
+export declare function describeError(error: unknown): string;

package/dist/errors.js

@@ -0,0 +1,25 @@
+import PicnicClient from "picnic-api";
+/**
+ * Turns an error from picnic-api into a short message for the model. Response bodies stay out:
+ * they can be long HTML pages or contain account data.
+ */
+export function describeError(error) {
+    if (PicnicClient.isPicnicApiError(error)) {
+        // Throttling comes from the edge in front of Picnic's API as a 403 with an HTML page.
+        if (/<html[\s>]/i.test(error.body)) {
+            return "Picnic is rate limiting this client. Try again in a few minutes.";
+        }
+        if (error.status === 401 || error.status === 403) {
+            return "The Picnic auth key is invalid or expired. Get a new one with `npx picnic-mcp login` and update PICNIC_AUTH_KEY.";
+        }
+        return `Picnic answered with HTTP ${error.status}${error.code ? ` (${error.code})` : ""}.`;
+    }
+    if (PicnicClient.isUnexpectedPageFormatError(error)) {
+        return "Picnic changed the format of a page this server reads. Update picnic-mcp, or report it if this is the latest version.";
+    }
+    if (error instanceof Error && error.name === "TimeoutError") {
+        return "Picnic did not answer in time. Try again.";
+    }
+    return "Could not reach Picnic. Try again later.";
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,YAAY,MAAM,YAAY,CAAC;AAEtC;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,IAAI,YAAY,CAAC,gBAAgB,CAAC,KAAK,CAAC,EAAE,CAAC;QACzC,sFAAsF;QACtF,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;YACnC,OAAO,kEAAkE,CAAC;QAC5E,CAAC;QACD,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,IAAI,KAAK,CAAC,MAAM,KAAK,GAAG,EAAE,CAAC;YACjD,OAAO,kHAAkH,CAAC;QAC5H,CAAC;QACD,OAAO,6BAA6B,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,EAAE,GAAG,CAAC;IAC7F,CAAC;IACD,IAAI,YAAY,CAAC,2BAA2B,CAAC,KAAK,CAAC,EAAE,CAAC;QACpD,OAAO,uHAAuH,CAAC;IACjI,CAAC;IACD,IAAI,KAAK,YAAY,KAAK,IAAI,KAAK,CAAC,IAAI,KAAK,cAAc,EAAE,CAAC;QAC5D,OAAO,2CAA2C,CAAC;IACrD,CAAC;IACD,OAAO,0CAA0C,CAAC;AACpD,CAAC"}

package/dist/format/cart.d.ts

@@ -0,0 +1,47 @@
+import type { Cart, CartLineItem, CountryCode } from "../types.js";
+/** A cart line as a tool shows it to a model. Optional fields are left out when empty. */
+export type CartLineOutput = {
+    productId: string;
+    name: string;
+    size?: string;
+    quantity: number;
+    /** The price of the line, after discounts. */
+    price: string;
+    labels?: string[];
+    /** Why the product can't be delivered, when it can't. */
+    unavailable?: string;
+    /** Products Picnic offers instead, when the product can't be delivered. */
+    replacements?: ReplacementOutput[];
+};
+/** A product Picnic offers instead of one that can't be delivered. */
+export type ReplacementOutput = {
+    productId: string;
+    name: string;
+    size?: string;
+    price: string;
+};
+/** The totals of the cart. */
+export type CartSummaryOutput = {
+    itemCount: number;
+    /** The amount to pay, including deposits and fees. */
+    total: string;
+    savings?: string;
+    deliveryWindow?: string;
+    /** The minimum order value of the selected delivery slot. */
+    minimumOrder?: string;
+};
+export type CartOutput = CartSummaryOutput & {
+    items: CartLineOutput[];
+};
+/**
+ * Builds the model-facing cart from an allow-list of fields. The cart id, its timestamp, images
+ * and other fields a model doesn't need stay out, as do fields picnic-api adds later.
+ */
+export declare function formatCart(cart: Cart, countryCode: CountryCode): CartOutput;
+export declare function formatCartLine(item: CartLineItem, countryCode: CountryCode): CartLineOutput;
+/**
+ * Says why a cart line can't be delivered and what Picnic offers instead, or nothing when the line
+ * can be delivered.
+ */
+export declare function formatUnavailability(item: CartLineItem, countryCode: CountryCode): Pick<CartLineOutput, "unavailable" | "replacements">;
+export declare function formatCartSummary(cart: Cart, countryCode: CountryCode): CartSummaryOutput;

package/dist/format/cart.js

@@ -0,0 +1,57 @@
+import { formatPrice, formatWindow } from "./prices.js";
+/** At most this many replacements per cart line. */
+const MAX_REPLACEMENTS = 3;
+/**
+ * Builds the model-facing cart from an allow-list of fields. The cart id, its timestamp, images
+ * and other fields a model doesn't need stay out, as do fields picnic-api adds later.
+ */
+export function formatCart(cart, countryCode) {
+    return {
+        items: cart.items.map((item) => formatCartLine(item, countryCode)),
+        ...formatCartSummary(cart, countryCode),
+    };
+}
+export function formatCartLine(item, countryCode) {
+    const labels = item.labels.map((label) => label.text).filter(Boolean);
+    return {
+        productId: item.productId,
+        name: item.name,
+        ...(item.unitQuantity && { size: item.unitQuantity }),
+        quantity: item.quantity,
+        price: formatPrice(item.displayPrice, countryCode),
+        ...(labels.length > 0 && { labels }),
+        ...formatUnavailability(item, countryCode),
+    };
+}
+/**
+ * Says why a cart line can't be delivered and what Picnic offers instead, or nothing when the line
+ * can be delivered.
+ */
+export function formatUnavailability(item, countryCode) {
+    if (!item.isUnavailable)
+        return {};
+    const replacements = item.replacements.slice(0, MAX_REPLACEMENTS).map((replacement) => ({
+        productId: replacement.id,
+        name: replacement.name,
+        ...(replacement.unitQuantity && { size: replacement.unitQuantity }),
+        price: formatPrice(replacement.displayPrice, countryCode),
+    }));
+    return {
+        unavailable: item.unavailableReason ?? "not available",
+        ...(replacements.length > 0 && { replacements }),
+    };
+}
+export function formatCartSummary(cart, countryCode) {
+    const savings = cart.promotionSavings + cart.membershipSavings;
+    const window = formatWindow(cart.selectedSlot?.windowStart ?? null, cart.selectedSlot?.windowEnd ?? null);
+    return {
+        itemCount: cart.totalCount,
+        total: formatPrice(cart.totalPrice, countryCode),
+        ...(savings > 0 && { savings: formatPrice(savings, countryCode) }),
+        ...(window && { deliveryWindow: window }),
+        ...(cart.minimumOrderValue !== null && {
+            minimumOrder: formatPrice(cart.minimumOrderValue, countryCode),
+        }),
+    };
+}
+//# sourceMappingURL=cart.js.map

package/dist/format/cart.js.map

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

package/dist/format/prices.d.ts

@@ -0,0 +1,5 @@
+import type { CountryCode } from "../types.js";
+/** Formats an amount in cents as the country shows prices, e.g. "€ 2,49" for NL. */
+export declare function formatPrice(cents: number, countryCode: CountryCode): string;
+/** Formats a delivery window as e.g. "Thu 23 Oct, 18:00-19:00", or null without a start and end. */
+export declare function formatWindow(start: string | null, end: string | null): string | null;

package/dist/format/prices.js

@@ -0,0 +1,27 @@
+const LOCALES = { NL: "nl-NL", DE: "de-DE", FR: "fr-FR" };
+/** Picnic serves every supported country from the Central European time zone. */
+const TIME_ZONE = "Europe/Amsterdam";
+/** Formats an amount in cents as the country shows prices, e.g. "€ 2,49" for NL. */
+export function formatPrice(cents, countryCode) {
+    return new Intl.NumberFormat(LOCALES[countryCode], { style: "currency", currency: "EUR" })
+        .format(cents / 100)
+        .replace(/\s/g, " "); // Intl uses non-breaking spaces
+}
+/** Formats a delivery window as e.g. "Thu 23 Oct, 18:00-19:00", or null without a start and end. */
+export function formatWindow(start, end) {
+    if (!start || !end)
+        return null;
+    const day = new Intl.DateTimeFormat("en-GB", {
+        timeZone: TIME_ZONE,
+        weekday: "short",
+        day: "numeric",
+        month: "short",
+    }).format(new Date(start));
+    const time = new Intl.DateTimeFormat("en-GB", {
+        timeZone: TIME_ZONE,
+        hour: "2-digit",
+        minute: "2-digit",
+    });
+    return `${day}, ${time.format(new Date(start))}-${time.format(new Date(end))}`;
+}
+//# sourceMappingURL=prices.js.map

package/dist/format/prices.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prices.js","sourceRoot":"","sources":["../../src/format/prices.ts"],"names":[],"mappings":"AAEA,MAAM,OAAO,GAAgC,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,OAAO,EAAE,CAAC;AAEvF,iFAAiF;AACjF,MAAM,SAAS,GAAG,kBAAkB,CAAC;AAErC,oFAAoF;AACpF,MAAM,UAAU,WAAW,CAAC,KAAa,EAAE,WAAwB;IACjE,OAAO,IAAI,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,WAAW,CAAC,EAAE,EAAE,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;SACvF,MAAM,CAAC,KAAK,GAAG,GAAG,CAAC;SACnB,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,CAAC,gCAAgC;AAC1D,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,YAAY,CAAC,KAAoB,EAAE,GAAkB;IACnE,IAAI,CAAC,KAAK,IAAI,CAAC,GAAG;QAAE,OAAO,IAAI,CAAC;IAChC,MAAM,GAAG,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAC3C,QAAQ,EAAE,SAAS;QACnB,OAAO,EAAE,OAAO;QAChB,GAAG,EAAE,SAAS;QACd,KAAK,EAAE,OAAO;KACf,CAAC,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3B,MAAM,IAAI,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAC5C,QAAQ,EAAE,SAAS;QACnB,IAAI,EAAE,SAAS;QACf,MAAM,EAAE,SAAS;KAClB,CAAC,CAAC;IACH,OAAO,GAAG,GAAG,KAAK,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;AACjF,CAAC"}

package/dist/format/products.d.ts

@@ -0,0 +1,27 @@
+import type { CountryCode, ProductTile } from "../types.js";
+/** A product as a tool shows it to a model. Optional fields are left out when empty. */
+export type ProductOutput = {
+    id: string;
+    name: string;
+    brand?: string;
+    size?: string;
+    price: string;
+    /** The price before a discount. */
+    wasPrice?: string;
+    unitPrice?: string;
+    /** Promotion and other labels, e.g. "1+1 gratis". */
+    labels?: string[];
+    /** Set when the user bought the product before. */
+    boughtBefore?: true;
+    unavailable?: true;
+};
+/** A product from the search results, with whether the user bought it before. */
+export type Candidate = {
+    tile: ProductTile;
+    boughtBefore: boolean;
+};
+/**
+ * Builds the model-facing product from an allow-list of fields, so fields picnic-api adds later
+ * don't end up in tool output.
+ */
+export declare function formatProduct(candidate: Candidate, countryCode: CountryCode): ProductOutput;

package/dist/format/products.js

@@ -0,0 +1,25 @@
+import { formatPrice } from "./prices.js";
+/**
+ * Builds the model-facing product from an allow-list of fields, so fields picnic-api adds later
+ * don't end up in tool output.
+ */
+export function formatProduct(candidate, countryCode) {
+    const { tile } = candidate;
+    const labels = tile.labels.map((label) => label.text).filter((text) => !!text);
+    return {
+        id: tile.id,
+        name: tile.namePrefix ? `${tile.namePrefix} ${tile.name}` : tile.name,
+        ...(tile.brand && { brand: tile.brand }),
+        ...(tile.unitQuantity && { size: tile.unitQuantity }),
+        price: formatPrice(tile.displayPrice, countryCode),
+        ...(tile.originalPrice !== null &&
+            tile.originalPrice > tile.displayPrice && {
+            wasPrice: formatPrice(tile.originalPrice, countryCode),
+        }),
+        ...(tile.unitPrice && { unitPrice: tile.unitPrice }),
+        ...(labels.length > 0 && { labels }),
+        ...(candidate.boughtBefore && { boughtBefore: true }),
+        ...(tile.isUnavailable && { unavailable: true }),
+    };
+}
+//# sourceMappingURL=products.js.map

package/dist/format/products.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"products.js","sourceRoot":"","sources":["../../src/format/products.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAyB1C;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,SAAoB,EAAE,WAAwB;IAC1E,MAAM,EAAE,IAAI,EAAE,GAAG,SAAS,CAAC;IAC3B,MAAM,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;IAC/F,OAAO;QACL,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI;QACrE,GAAG,CAAC,IAAI,CAAC,KAAK,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC;QACxC,GAAG,CAAC,IAAI,CAAC,YAAY,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC;QACrD,KAAK,EAAE,WAAW,CAAC,IAAI,CAAC,YAAY,EAAE,WAAW,CAAC;QAClD,GAAG,CAAC,IAAI,CAAC,aAAa,KAAK,IAAI;YAC7B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,YAAY,IAAI;YACxC,QAAQ,EAAE,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,WAAW,CAAC;SACvD,CAAC;QACJ,GAAG,CAAC,IAAI,CAAC,SAAS,IAAI,EAAE,SAAS,EAAE,IAAI,CAAC,SAAS,EAAE,CAAC;QACpD,GAAG,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QACpC,GAAG,CAAC,SAAS,CAAC,YAAY,IAAI,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;QACrD,GAAG,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,CAAC;KACjD,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export { createServer, type CreateServerOptions } from "./server.js";
+export type { CountryCode } from "./types.js";
+export type { ProductOutput } from "./format/products.js";
+export type { CartOutput, CartLineOutput, CartSummaryOutput } from "./format/cart.js";

package/dist/index.js

@@ -0,0 +1,2 @@
+export { createServer } from "./server.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAA4B,MAAM,aAAa,CAAC"}

package/dist/match.d.ts

@@ -0,0 +1,33 @@
+import type { Candidate } from "./format/products.js";
+import type { SearchResults } from "./types.js";
+export type Match = 
+/** One product fits: add it. */
+{
+    type: "best";
+    best: Candidate;
+    others: Candidate[];
+}
+/** Several fit, or none was bought before: ask the user. */
+ | {
+    type: "choose";
+    choices: Candidate[];
+    others: Candidate[];
+}
+/** Nothing that can be ordered. */
+ | {
+    type: "none";
+    others: Candidate[];
+};
+/**
+ * Lists the products of the search results in display order, once each, marking the ones in the
+ * bought-before section. The search has no per-product order count: a tile's `numberOfOrders` is
+ * the same on every tile.
+ */
+export declare function listCandidates(results: SearchResults): Candidate[];
+/**
+ * Picks what to add from the search results:
+ * - one available product bought before: that product;
+ * - several bought before: those to choose from, in Picnic's order;
+ * - none bought before: the first results to choose from, or the only one if there is one.
+ */
+export declare function matchProducts(candidates: Candidate[]): Match;

package/dist/match.js

@@ -0,0 +1,44 @@
+/** The section type of "Opnieuw bestellen": the products the user bought before. */
+const BOUGHT_BEFORE_SECTION = "RFY";
+/** At most this many products are offered to choose between. */
+const MAX_CHOICES = 3;
+/**
+ * Lists the products of the search results in display order, once each, marking the ones in the
+ * bought-before section. The search has no per-product order count: a tile's `numberOfOrders` is
+ * the same on every tile.
+ */
+export function listCandidates(results) {
+    const candidates = new Map();
+    for (const section of results.products?.sections ?? []) {
+        const boughtBefore = section.type === BOUGHT_BEFORE_SECTION;
+        for (const tile of section.products) {
+            const existing = candidates.get(tile.id);
+            if (existing)
+                existing.boughtBefore ||= boughtBefore;
+            else
+                candidates.set(tile.id, { tile, boughtBefore });
+        }
+    }
+    return [...candidates.values()];
+}
+/**
+ * Picks what to add from the search results:
+ * - one available product bought before: that product;
+ * - several bought before: those to choose from, in Picnic's order;
+ * - none bought before: the first results to choose from, or the only one if there is one.
+ */
+export function matchProducts(candidates) {
+    const available = candidates.filter((candidate) => !candidate.tile.isUnavailable);
+    const bought = available.filter((candidate) => candidate.boughtBefore);
+    const pool = bought.length > 0 ? bought : available;
+    const without = (picked) => candidates.filter((candidate) => !picked.includes(candidate));
+    if (pool.length === 1) {
+        return { type: "best", best: pool[0], others: without(pool) };
+    }
+    if (pool.length > 1) {
+        const choices = pool.slice(0, MAX_CHOICES);
+        return { type: "choose", choices, others: without(choices) };
+    }
+    return { type: "none", others: candidates };
+}
+//# sourceMappingURL=match.js.map

package/dist/match.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"match.js","sourceRoot":"","sources":["../src/match.ts"],"names":[],"mappings":"AAGA,oFAAoF;AACpF,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAEpC,gEAAgE;AAChE,MAAM,WAAW,GAAG,CAAC,CAAC;AAUtB;;;;GAIG;AACH,MAAM,UAAU,cAAc,CAAC,OAAsB;IACnD,MAAM,UAAU,GAAG,IAAI,GAAG,EAAqB,CAAC;IAChD,KAAK,MAAM,OAAO,IAAI,OAAO,CAAC,QAAQ,EAAE,QAAQ,IAAI,EAAE,EAAE,CAAC;QACvD,MAAM,YAAY,GAAG,OAAO,CAAC,IAAI,KAAK,qBAAqB,CAAC;QAC5D,KAAK,MAAM,IAAI,IAAI,OAAO,CAAC,QAAQ,EAAE,CAAC;YACpC,MAAM,QAAQ,GAAG,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;YACzC,IAAI,QAAQ;gBAAE,QAAQ,CAAC,YAAY,KAAK,YAAY,CAAC;;gBAChD,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,YAAY,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,UAAU,CAAC,MAAM,EAAE,CAAC,CAAC;AAClC,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,UAAuB;IACnD,MAAM,SAAS,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAClF,MAAM,MAAM,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,YAAY,CAAC,CAAC;IACvE,MAAM,IAAI,GAAG,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC;IACpD,MAAM,OAAO,GAAG,CAAC,MAAmB,EAAE,EAAE,CACtC,UAAU,CAAC,MAAM,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC;IAEhE,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,EAAE,CAAC;IAChE,CAAC;IACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,CAAC;QAC3C,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/D,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;AAC9C,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,23 @@
+import { McpServer } from "@modelcontextprotocol/server";
+import PicnicClient from "picnic-api";
+import type { CountryCode } from "./types.js";
+export type CreateServerOptions = ({
+    /** The Picnic auth key of the account, from `picnic-mcp login`. */
+    authKey: string;
+    /** The country of the account. Default: "NL". */
+    countryCode?: CountryCode;
+} | {
+    /** A picnic-api client that is already signed in. */
+    client: PicnicClient;
+    /** The country of the client's account. Default: "NL". */
+    countryCode?: CountryCode;
+}) & {
+    /** Called with errors from Picnic before the tool returns a short message. Default: log to stderr. */
+    onError?: (error: unknown) => void;
+};
+/**
+ * Creates an MCP server with tools to search Picnic's products and change the cart. It reads no
+ * environment variables or files, so it can run in-process: connect it to a transport with
+ * `server.connect(transport)`.
+ */
+export declare function createServer(options: CreateServerOptions): McpServer;

package/dist/server.js

@@ -0,0 +1,34 @@
+import { McpServer } from "@modelcontextprotocol/server";
+import { createRequire } from "node:module";
+import PicnicClient from "picnic-api";
+import { registerCartTools } from "./tools/cart.js";
+import { SEARCH_LANGUAGES } from "./tools/context.js";
+import { registerSearchProducts } from "./tools/search-products.js";
+const { version } = createRequire(import.meta.url)("../package.json");
+/**
+ * Creates an MCP server with tools to search Picnic's products and change the cart. It reads no
+ * environment variables or files, so it can run in-process: connect it to a transport with
+ * `server.connect(transport)`.
+ */
+export function createServer(options) {
+    const countryCode = options.countryCode ?? "NL";
+    const context = {
+        client: "client" in options
+            ? options.client
+            : new PicnicClient({ authKey: options.authKey, countryCode }),
+        countryCode,
+        onError: options.onError ?? ((error) => console.error("[picnic-mcp]", error)),
+    };
+    const server = new McpServer({ name: "picnic-mcp", version }, {
+        capabilities: { tools: {} },
+        instructions: "Tools for the user's account at the online supermarket Picnic. " +
+            "To add a product: search_products (query in " +
+            SEARCH_LANGUAGES[countryCode] +
+            "), then add_to_cart with the product id. If the search returns choices, ask the user first. " +
+            "These tools can change the cart but cannot place an order.",
+    });
+    registerSearchProducts(server, context);
+    registerCartTools(server, context);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,8BAA8B,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,YAAY,MAAM,YAAY,CAAC;AAEtC,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,gBAAgB,EAAoB,MAAM,oBAAoB,CAAC;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AAGpE,MAAM,EAAE,OAAO,EAAE,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,iBAAiB,CAAwB,CAAC;AAoB7F;;;;GAIG;AACH,MAAM,UAAU,YAAY,CAAC,OAA4B;IACvD,MAAM,WAAW,GAAG,OAAO,CAAC,WAAW,IAAI,IAAI,CAAC;IAChD,MAAM,OAAO,GAAgB;QAC3B,MAAM,EACJ,QAAQ,IAAI,OAAO;YACjB,CAAC,CAAC,OAAO,CAAC,MAAM;YAChB,CAAC,CAAC,IAAI,YAAY,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;QACjE,WAAW;QACX,OAAO,EAAE,OAAO,CAAC,OAAO,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;KAC9E,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B,EAAE,IAAI,EAAE,YAAY,EAAE,OAAO,EAAE,EAC/B;QACE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;QAC3B,YAAY,EACV,iEAAiE;YACjE,8CAA8C;YAC9C,gBAAgB,CAAC,WAAW,CAAC;YAC7B,8FAA8F;YAC9F,4DAA4D;KAC/D,CACF,CAAC;IACF,sBAAsB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACxC,iBAAiB,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACnC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/tools/cart.d.ts

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

package/dist/tools/cart.js

@@ -0,0 +1,67 @@
+import * as z from "zod";
+import { formatCart, formatCartSummary, formatUnavailability } from "../format/cart.js";
+import { errorResult, jsonResult, runTool } from "./result.js";
+const productId = z
+    .string()
+    .trim()
+    .regex(/^s\d+$/, "Use a product id from search_products or get_cart, e.g. s1004201.")
+    .describe("The product id from search_products or get_cart, e.g. s1004201.");
+const quantity = (what) => z.number().int().min(1).max(50).default(1).describe(`How many to ${what}. Default 1.`);
+export function registerCartTools(server, context) {
+    const { client, countryCode, onError } = context;
+    server.registerTool("get_cart", {
+        title: "Get cart",
+        description: "Show the user's Picnic shopping cart: the products with their quantity and price, the total, and the delivery window. " +
+            "A product that can't be delivered in that window has `unavailable` with the reason, and `replacements` Picnic offers instead.",
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, () => runTool(async () => jsonResult(formatCart(await client.cart.getCart(), countryCode)), onError));
+    server.registerTool("add_to_cart", {
+        title: "Add to cart",
+        description: "Add a product to the user's Picnic shopping cart. Get the product id from search_products first. " +
+            "Returns the product with the quantity now in the cart, and the cart total. " +
+            "If the product can't be delivered in the selected delivery window, it says so and lists `replacements`: tell the user and offer them. " +
+            "This does not place an order.",
+        inputSchema: z.object({ productId, quantity: quantity("add") }),
+        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
+    }, ({ productId, quantity }) => runTool(async () => {
+        const cart = await client.cart.addProductToCart(productId, quantity);
+        const lines = linesOf(cart, productId);
+        if (lines.length === 0) {
+            return errorResult(`Picnic did not add ${productId}. Check the product id with search_products.`);
+        }
+        const unavailableLine = lines.find((line) => line.isUnavailable);
+        return jsonResult({
+            ...(unavailableLine && {
+                next: "The product is in the cart, but it can't be delivered in the selected delivery window. Tell the user, and offer the replacements if there are any.",
+            }),
+            added: {
+                productId,
+                name: lines[0].name,
+                quantityInCart: quantityOf(lines),
+                ...(unavailableLine && formatUnavailability(unavailableLine, countryCode)),
+            },
+            cart: formatCartSummary(cart, countryCode),
+        });
+    }, onError));
+    server.registerTool("remove_from_cart", {
+        title: "Remove from cart",
+        description: "Remove a product from the user's Picnic shopping cart. Get the product id from get_cart. " +
+            "Returns the quantity left in the cart and the cart total.",
+        inputSchema: z.object({ productId, quantity: quantity("remove") }),
+        annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
+    }, ({ productId, quantity }) => runTool(async () => {
+        const cart = await client.cart.removeProductFromCart(productId, quantity);
+        return jsonResult({
+            removed: { productId, quantityInCart: quantityOf(linesOf(cart, productId)) },
+            cart: formatCartSummary(cart, countryCode),
+        });
+    }, onError));
+}
+/** The lines of a product: more than one when it was also added for a recipe. */
+function linesOf(cart, productId) {
+    return cart.items.filter((item) => item.productId === productId);
+}
+function quantityOf(lines) {
+    return lines.reduce((sum, line) => sum + line.quantity, 0);
+}
+//# sourceMappingURL=cart.js.map

package/dist/tools/cart.js.map

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

package/dist/tools/context.d.ts

@@ -0,0 +1,10 @@
+import type PicnicClient from "picnic-api";
+import type { CountryCode } from "../types.js";
+/** What the tools share: the Picnic client and the account's country. */
+export type ToolContext = {
+    client: PicnicClient;
+    countryCode: CountryCode;
+    onError: (error: unknown) => void;
+};
+/** The language Picnic's search expects in each country. */
+export declare const SEARCH_LANGUAGES: Record<CountryCode, string>;

package/dist/tools/context.js

@@ -0,0 +1,7 @@
+/** The language Picnic's search expects in each country. */
+export const SEARCH_LANGUAGES = {
+    NL: "Dutch",
+    DE: "German",
+    FR: "French",
+};
+//# sourceMappingURL=context.js.map

package/dist/tools/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../../src/tools/context.ts"],"names":[],"mappings":"AAWA,4DAA4D;AAC5D,MAAM,CAAC,MAAM,gBAAgB,GAAgC;IAC3D,EAAE,EAAE,OAAO;IACX,EAAE,EAAE,QAAQ;IACZ,EAAE,EAAE,QAAQ;CACb,CAAC"}

package/dist/tools/result.d.ts

@@ -0,0 +1,6 @@
+import type { CallToolResult } from "@modelcontextprotocol/server";
+/** Returns data as compact JSON text: models read the text, and indentation only costs tokens. */
+export declare function jsonResult(data: unknown): CallToolResult;
+export declare function errorResult(message: string): CallToolResult;
+/** Runs a tool handler and turns a thrown error into a short tool error. */
+export declare function runTool(run: () => Promise<CallToolResult>, onError: (error: unknown) => void): Promise<CallToolResult>;

package/dist/tools/result.js

@@ -0,0 +1,19 @@
+import { describeError } from "../errors.js";
+/** Returns data as compact JSON text: models read the text, and indentation only costs tokens. */
+export function jsonResult(data) {
+    return { content: [{ type: "text", text: JSON.stringify(data) }] };
+}
+export function errorResult(message) {
+    return { content: [{ type: "text", text: message }], isError: true };
+}
+/** Runs a tool handler and turns a thrown error into a short tool error. */
+export async function runTool(run, onError) {
+    try {
+        return await run();
+    }
+    catch (error) {
+        onError(error);
+        return errorResult(describeError(error));
+    }
+}
+//# sourceMappingURL=result.js.map

package/dist/tools/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../src/tools/result.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE7C,kGAAkG;AAClG,MAAM,UAAU,UAAU,CAAC,IAAa;IACtC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,WAAW,CAAC,OAAe;IACzC,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;AACvE,CAAC;AAED,4EAA4E;AAC5E,MAAM,CAAC,KAAK,UAAU,OAAO,CAC3B,GAAkC,EAClC,OAAiC;IAEjC,IAAI,CAAC;QACH,OAAO,MAAM,GAAG,EAAE,CAAC;IACrB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,CAAC;QACf,OAAO,WAAW,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/tools/search-products.d.ts

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

package/dist/tools/search-products.js

@@ -0,0 +1,52 @@
+import * as z from "zod";
+import { formatProduct } from "../format/products.js";
+import { listCandidates, matchProducts } from "../match.js";
+import { SEARCH_LANGUAGES } 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;
+export function registerSearchProducts(server, context) {
+    const language = SEARCH_LANGUAGES[context.countryCode];
+    server.registerTool("search_products", {
+        title: "Search products",
+        description: "Search the Picnic supermarket for a product and get its id for add_to_cart. " +
+            `Write the query in ${language}, as a short product name. ` +
+            "The result has `bestMatch` when one product fits, usually one the user bought before: add that one. " +
+            "It has `choices` when there is no clear match: ask the user which one they want before adding anything. `boughtBefore` marks products the user ordered before.",
+        inputSchema: z.object({
+            query: z.string().trim().min(1).describe(`The product to search for, in ${language}.`),
+        }),
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, ({ query }) => runTool(async () => {
+        const results = await context.client.catalog.getSearchResults(query);
+        const match = matchProducts(listCandidates(results));
+        const format = (candidates) => candidates.map((candidate) => formatProduct(candidate, context.countryCode));
+        const corrected = results.correctedQuery && results.correctedQuery !== query
+            ? { searchedFor: results.correctedQuery }
+            : {};
+        if (match.type === "best") {
+            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)),
+            });
+        }
+        if (match.type === "choose") {
+            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)),
+            });
+        }
+        return jsonResult({
+            ...corrected,
+            next: match.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)),
+        });
+    }, context.onError));
+}
+//# sourceMappingURL=search-products.js.map

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

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

package/dist/types.d.ts

@@ -0,0 +1,7 @@
+import PicnicClient from "picnic-api";
+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 Cart = PicnicClient.Types.cart.Cart;
+export type CartLineItem = PicnicClient.Types.cart.CartLineItem;

package/dist/types.js

@@ -0,0 +1,2 @@
+export const COUNTRY_CODES = ["NL", "DE", "FR"];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAIA,MAAM,CAAC,MAAM,aAAa,GAA2B,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,61 @@
 {
   "name": "picnic-mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "MCP server for the online supermarket Picnic: search products and manage the cart",
+  "keywords": [
+    "picnic",
+    "mcp",
+    "model-context-protocol",
+    "supermarket",
+    "groceries"
+  ],
+  "homepage": "https://github.com/MRVDH/picnic-mcp",
+  "bugs": {
+    "url": "https://github.com/MRVDH/picnic-mcp/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/MRVDH/picnic-mcp.git"
+  },
+  "license": "MIT",
+  "author": "Maarten van den Hoven <info@maartenvandenhoven.com> (https://maartenvandenhoven.com)",
+  "type": "module",
+  "engines": {
+    "node": ">=20"
+  },
+  "files": [
+    "dist/**"
+  ],
+  "bin": {
+    "picnic-mcp": "dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "scripts": {
+    "prebuild": "node -e \"require('fs').rmSync('dist', { recursive: true, force: true })\"",
+    "build": "tsc -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest run",
+    "format": "prettier --write .",
+    "format:check": "prettier --check ."
+  },
+  "dependencies": {
+    "@modelcontextprotocol/server": "^2.3.1",
+    "picnic-api": "^5.0.0",
+    "zod": "^4.6.7"
+  },
+  "devDependencies": {
+    "@modelcontextprotocol/client": "^2.3.1",
+    "@trivago/prettier-plugin-sort-imports": "^6.0.2",
+    "@types/node": "^26.6.5",
+    "prettier": "^3.9.10",
+    "typescript": "^7.0.2",
+    "vitest": "^5.0.5"
+  }
+}