Skip to main content
Glama
picnic-mcp
by MRVDH

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PICNIC_AUTH_KEYYesYour Picnic auth key, obtained by running `npx picnic-mcp login`. Keep the key secret as it gives access to your Picnic account.
PICNIC_COUNTRY_CODENoThe Picnic country code. Valid values are NL, DE, or FR. Defaults to NL.NL

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

Tools for the user's account at the online supermarket Picnic. To add products: search_products for each (query in Dutch), then one add_to_cart with all product ids. If a search returns choices, ask the user first. To change a quantity: set_cart_quantity. To choose when the order is delivered: get_delivery_slots, then select_delivery_slot once the user picked one. For a product's ingredients, allergens or nutrition: get_product. For a cheaper version of a product: get_cheaper_alternatives. For what is on sale: get_promotions. For the products the user usually buys ("my usual groceries"): get_favorites. These tools can change the cart but cannot place an order.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
search_productsA

Search the Picnic supermarket for a product and get its id for add_to_cart. Write the query in Dutch, 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.

get_cartA

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.

add_to_cartA

Add one or more products to the user's Picnic shopping cart. Get the product ids from search_products first; put all products the user asked for in one call (at most 20). Returns each added product with the quantity now in the cart, the products that failed, and the cart total. A product that can't be delivered in the selected delivery window has unavailable and replacements: tell the user and offer them. To change how many of a product are in the cart ("make it 4"), use set_cart_quantity instead. This does not place an order.

remove_from_cartA

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.

set_cart_quantityA

Set how many of a product are in the user's Picnic shopping cart, e.g. when the user says "make it 3". 0 removes the product. Get the product id from get_cart or search_products. Returns the quantity now in the cart and the cart total.

get_delivery_slotsA

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.

select_delivery_slotA

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.

get_productA

Get the details of a Picnic product: ingredients, allergens, nutrition, storage info, promotion and price. Use it for questions such as whether a product contains gluten. Get the product id from search_products or get_cart.

get_cheaper_alternativesA

Find cheaper versions of a Picnic product: similar products that cost less per kg, litre or piece, cheapest first. Use it when the user asks for a cheaper option or wants to save on a product. Get the product id from search_products or get_cart. It only reads; to swap a product in the cart, ask the user first.

get_promotionsA

List what is on promotion at Picnic this week. Without input it lists the sections (e.g. per category) with a few products and promotions each. Pass a section title for all products and promotions in it, or a promotionId for the products of one promotion. Products have ids for add_to_cart.

get_favoritesA

List the products the user buys at Picnic, per aisle, e.g. for "what do I usually buy?" or to offer products for "my usual groceries". Without input it lists the aisles with a few products each; pass an aisleId for all of the user's products in that aisle. Products have ids for add_to_cart; add only the ones the user asks for.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.4/5.0

Scored across 11 tools

Disambiguation5/5

Each tool has a clearly distinct resource+action target: search vs. detail (search_products/get_product), cart mutation varieties (add_to_cart, remove_from_cart, set_cart_quantity), delivery flows (get_delivery_slots/select_delivery_slot), and read-only discovery tools. The descriptions even explicitly disambiguate the tricky pairs, e.g. add_to_cart vs. set_cart_quantity for changing quantities.

Naming Consistency5/5

All 11 tools use snake_case with a leading verb (get_, add_, remove_, set_, search_, select_), giving a predictable verb_noun or verb_preposition_noun pattern throughout. No mixed casing or vague standalone verbs.

Tool Count5/5

11 tools is well-scoped for a grocery shopping assistant, with each tool mapping to a needed capability (search, product info, cart management, delivery, promotions, favorites, alternatives). No redundant or filler tools.

Completeness4/5

Covers discovery, product detail, full cart create/read/update/delete, delivery slot selection, promotions, and favorites—a thorough surface. The main gap is order placement/checkout (tools repeatedly note 'this does not place an order'), so an agent can build and schedule a cart but not finalize a purchase.

Maintenance

ActivityMaintained
ResponsivenessLimited data