fr-grocery-mcp
An MCP server that gives an agent domain-level access to a French online grocery service (Super U / coursesu.com, per this schema's store enum), driving your own logged-in Chrome session — browsing, cart management and cart comparison, but never placing the order.
List retailers —
list_stores(check=false)returns plugged-in retailers, their capabilities (product details, store locator, minimum order, booked slot) and optionally live session status plus active store.Search the catalogue —
search_products(store, query, limit=20)returns products with id, label, price, unit price (€/kg, €/l, €/piece), availability, typed promotions (immediate, multibuy, loyalty) and best net offer.Read product pages —
get_product(store, product_id)gives ingredients (allergens capitalised,nullfor raw products), declared allergens and origin.Read the cart —
get_cart(store)returns lines (product, quantity, line total, unit price) and total.Check order conditions —
get_order_conditions(store?)returns selected store, booked slot, cart slot, dated next slots and minimum order amounts, for one or all retailers.Modify the cart —
add_to_cart(adds),set_quantity(sets, 0 removes),remove_from_cart; each reads the cart back and returnsconfirmed.Manage stores —
find_stores(store, query)lists nearby stores by postcode/town,set_store(store, store_id)selects and remembers the active one.Compare carts —
compare_carts(mode="drive")shows each retailer's total, lines, minimum/missing amount and next slots, sorted cheapest first.Errors & safety — typed errors (
ValidationError,NotSupportedError,SessionExpiredError,SiteBlockedError,TransientError), 50-unit cap per product, one spaced request at a time, no anti-bot bypass, no slot booking or payment.
Integrates with E.Leclerc Drive online grocery shopping through the user's logged-in browser session: search products with prices, unit prices and promotions, read product pages (ingredients, allergens, origin), view and modify the cart (add, set quantity, remove), read order conditions and dated delivery slots, find and select a drive store, and compare carts across retailers to pick the cheapest.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@fr-grocery-mcp find ingredients for bolognese for 4, fill both carts, compare totals"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
fr-grocery-mcp
An MCP server that gives an agent domain-level access to the online grocery services ("drive") of French retailers: E.Leclerc Drive and Super U (coursesu.com) today, others through a new adapter. Search products, read their composition, manage the cart, read slots and minimum order amounts, compare carts. Nothing else.
The reasoning (recipes, ingredients, quantities for N people, product choice, price/promotion trade-offs) belongs to the agent. For example:
Order what I need to cook spaghetti bolognese and a four-cheese pizza for 4, at the cheapest of Leclerc and Super U.
The agent builds the list, searches each ingredient at each retailer, fills the carts, then compares them. The order is never placed: slot booking and payment are left to the user, on the site.
This project is not affiliated with, endorsed by or supported by E.Leclerc, Système U or any retailer. It drivesyour own logged-in browser session, at a human pace, for personal use. Retailer sites change without notice and their terms of use apply: use it at your own risk.
Tools
Every retailer tool takes store (leclerc, superu: an enum generated from the configuration).
Tool | Effect | Annotations |
| plugged-in retailers and capabilities; with | read-only |
| products: | read-only |
| product page: | read-only |
| lines ( | read-only |
| store, booked slot, slot attached to the cart, dated next slots (ISO | read-only |
| adds to the quantity already present | |
| sets the quantity (0 = removal) | idempotent |
| removes the product | destructive, idempotent |
| stores around a postcode or town (if the retailer supports it) | read-only |
| selects and remembers the active store | idempotent |
| each retailer's cart: total, lines, minimum and missing amount, next slots; sorted from cheapest to most expensive | read-only |
Every change reads the cart back and returns confirmed: true if the site holds the targeted quantity.
Results are typed (outputSchema + structuredContent) and the server sends instructions describing the flow to
the agent. A cap of 50 units per product guards against unit mistakes.
Errors (isError, error field): ValidationError (fix the call), NotSupportedError (the retailer does not
support it), SessionExpiredError (log in again in Chrome), SiteBlockedError (anti-bot: stop),
TransientError (retried automatically, then reported).
Product labels, promotion texts and search terms stay in French, as on the sites.
Capabilities per retailer
Capability | E.Leclerc Drive | Super U |
Search, cart, promotions | yes (immediate, multibuy, Ticket) | yes (immediate, multibuy, Carte U) |
Product page | ingredients, allergens, origin | ingredients, origin |
Store selection from the agent |
| no: on the site |
Minimum order | not exposed when logged out | yes |
Slots | next slot, cart date | next slots, booked slot |
Related MCP server: Rohlik MCP Server
Requirements
Node ≥ 26 (runs TypeScript natively: no build step). With mise:
mise install --lockedinstalls the version recorded inmise.lock.A Chrome started with
--remote-debugging-port=9222and logged in to the sites (mise run chromestarts a dedicated profile in~/.fr-grocery-mcp/chrome). One tab per site is found, or opened, by its domain.
Requests go through the browser session, one at a time and spaced out: the server replays what the site does on a click (see docs/retailers/). No protection is bypassed: an anti-bot block stops the server, it is never retried.
Configuration
FR_GROCERY_CONFIG points to a JSON file. Without a file, only Super U is plugged in.
{
"chrome": { "port": 9222, "timeoutMs": 30000 },
"stores": [
{
"retailer": "leclerc",
"store": {
"storeId": "123456",
"retrievalPointId": "123456",
"host": "fd7-courses.leclercdrive.fr",
"name": "My Leclerc Drive"
}
},
{ "retailer": "superu", "minIntervalMs": 300 }
]
}The order of the retailers is the order of preference. minIntervalMs sets the spacing between requests (default:
1000 ms for Leclerc, 300 ms for Super U). Your Leclerc store's values can be found with find_stores /
set_store: the store picked with set_store is remembered in $FR_GROCERY_STATE_DIR/leclerc-store.json
(default ~/.fr-grocery-mcp) and takes precedence over the configuration. FR_GROCERY_CHROME_PORT overrides the port of
the file. The Super U store is chosen on coursesu.com.
Usage
The server is distributed as the fr-grocery-mcp npm package and runs locally over stdio. Claude Code (.mcp.json):
{
"mcpServers": {
"fr-grocery-mcp": {
"command": "npx",
"args": ["-y", "fr-grocery-mcp@latest"],
"env": { "FR_GROCERY_CONFIG": "/path/to/fr-grocery-mcp.json" }
}
}
}Pin an exact version (for example fr-grocery-mcp@0.2.0) instead of @latest for a reproducible setup. The same
package is described in the official MCP Registry by
io.github.maxime-desmarchelier/fr-grocery-mcp. Each release is published on npm, GitHub Releases and the MCP
Registry; see docs/releasing.md.
From a source checkout, use "command": "node" and
"args": ["/path/to/fr-grocery-mcp/src/main.ts"] instead. Manual inspection: npm run inspect (MCP Inspector).
Development
npm ci
npm run check # typecheck + lint + tests with coverage thresholds
mise run lint # the git hook's ruleset on the whole repository (what CI runs)
npm test # unit, adapter contract, integration (no access to the sites)
npm run doctor # real sites, read-only: session, search, product page, cart per retailer
npm run test:live # real sites: changes then removes an item that is not in the cart
LIVE_STORES=leclerc npm run test:live
npm run fixtures -- leclerc # captures a retailer's reference pages again
npm run format # BiomeArchitecture and technical choices: docs/architecture.md. Adding a retailer: docs/adding-a-retailer.md. Releases: docs/releasing.md.
Contributing
Issues and pull requests are welcome: see CONTRIBUTING.md for the setup, the code rules and what
npm run check must show before a pull request. main is protected and CI must be green.
Security
Please report vulnerabilities privately through the repository's Security tab, never in a public issue: see SECURITY.md.
License
MIT. The E.Leclerc Drive adapter builds on knowledge from mcp-leclerc-drive (MIT): see NOTICE.
Available Tools
11 toolsadd_to_cartAdd to cartA
Adds units of a product on top of those already present, then reads the cart back to confirm.
Inputs: store (required), product_id (required), quantity. Returns: line, store, confirmed, product_id, +2 more
compare_cartsCompare cartsARead-only
Reads each retailer's cart: total, lines, minimum order and missing amount, next slots. Sorted from cheapest to most expensive.
Inputs: mode. Returns: mode, stores, cheapest
find_storesFind a storeBRead-only
The retailer's stores around a postcode or town, nearest first (if the retailer supports it, see list_stores).
Inputs: query (required), store (required). Returns: query, store, locations
get_cartRead the cartARead-only
Reads the retailer's actual cart: lines (id, label, quantity, line total, unit price) and total.
Inputs: store (required). Returns: lines, store, total_eur
get_order_conditionsOrder conditionsARead-only
Reads, for one retailer or all of them (store omitted), the selected store, the booked slot, the next pickup and delivery slots (structured dates) and the minimum order. Books nothing.
Inputs: store. Returns: stores
get_productProduct detailsARead-only
Reads a product page: ingredient list (allergens in capitals, possible traces), allergen statement if the site provides it, and origin. Ingredients are null for a raw product (fruit, fresh meat).
Inputs: store (required), product_id (required). Returns: id, name, store, origin, +2 more
list_storesAvailable retailersARead-only
Lists the plugged-in retailers and their capabilities (product page, store selection, minimum order, booked slot). With check: true, also checks that each session responds and shows the active store.
Inputs: check. Returns: stores
remove_from_cartRemove from cartADestructiveIdempotent
Removes a product from the cart entirely, then reads the cart back.
Inputs: store (required), product_id (required). Returns: line, store, confirmed, product_id, +2 more
search_productsSearch productsARead-only
Searches the retailer's catalogue. For each product: id, label (brand and size included), price, price per kg/l/piece, availability, typed promotions (immediate, multibuy, loyalty) and best net offer.
Inputs: query (required), store (required), limit. Returns: query, store, total, products
set_quantitySet a quantityAIdempotent
Sets a product's quantity in the cart (replaces the current one; 0 removes the product), then reads the cart back.
Inputs: store (required), quantity (required), product_id (required). Returns: line, store, confirmed, product_id, +2 more
set_storeSelect the storeAIdempotent
Selects the retailer's active store among the find_stores results and remembers it. The site session must be on this store: on "session expired", open it on the site.
Inputs: store (required), store_id (required). Returns: store, selected
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 11 tools
Most tools have clearly distinct purposes (cart mutation vs. reading vs. product lookup), but list_stores (retailers) and find_stores (physical locations) are easy to conflate by name alone, and store/slot/minimum-order data is duplicated across list_stores, get_order_conditions, and compare_carts. The descriptions do resolve these overlaps, so misselection is unlikely but possible.
Every tool is snake_case, verb-first, and noun-scoped (list_stores, search_products, get_cart, add_to_cart, set_quantity, remove_from_cart, compare_carts). Verb choices vary appropriately with the action rather than being forced into one pattern.
11 tools sit in the ideal range and each maps to a real step in a grocery workflow: discover retailer, pick store, search/browse products, manage cart lines, read conditions, compare baskets. No tool looks redundant or filler.
The surface covers discovery, product inspection, full cart CRUD (add/set/remove/read), conditions, and cross-retailer comparison, which is coherent for a browsing/assembly server. The notable gap is order placement/checkout and any slot booking, plus no session/login tool despite the 'session expired' note — manageable but a dead end if an agent is expected to complete a purchase.
Maintenance
Related MCP Connectors
Turn any shopping list into a ready-to-checkout grocery cart across 26 European supermarkets.
Search live store shelves, verify delivery windows, and run instant AI agent checkouts.
Search direct grocery storefronts and create product-link pickup handoffs.
Product search for AI shopping agents: prices and buy links from big retailers. No key needed.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to search the catalog, manage a cart and usual orders, find delivery slots, and handle favorites, shopping lists, past orders, and item remarks through the store's API, with login and payment left to the user on the website.MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to search grocery products, manage shopping carts, and access account, order, delivery, and discount information across multiple European online grocery platforms.MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to search grocery products, manage shopping carts, retrieve account, order, delivery, and premium information, and get personalized meal suggestions and discounted items across multiple European grocery delivery platforms.MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to search grocery products, manage shopping carts, view orders and delivery information, and get personalized meal and deal suggestions across multiple European grocery delivery services.MIT