mon-marche-mcp
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., "@mon-marche-mcp Search for 'lait demi-écrémé' and add 1 to cart"
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.
mon-marche-mcp
An MCP server that lets an AI assistant search the mon-marché catalog and build a grocery basket from a few instructions. It is a thin, pure-HTTP client over mon-marché's internal API (the Keplr commerce platform) and Constructor.io search — no browser automation.
It deliberately stops at the cart: there is no checkout or payment tool. You review the basket and pay yourself on the website.
Tools
Tool | Purpose | Auth |
| Search the catalog (name, slug, price, bio/anti-gaspi) | none |
| Resolve a slug to its article id + SKU | none |
| Set the quantity of one product (by slug) | sign-in |
| Build a whole basket in one call | sign-in |
| Show lines and total | sign-in |
| Remove a line by article id | sign-in |
| Empty the cart (does not delete it) | sign-in |
| List most frequently ordered products | sign-in |
| List bookable delivery slots for the saved address | sign-in |
| Attach a slot — creates the cart | sign-in |
Related MCP server: Rohlik MCP Server
Order flow
A cart can only hold products once a delivery slot is attached. Authentication is automatic from the env credentials (it uses a bearer token and a session cookie). Follow this sequence:
Find products —
my_usual_products(frequently ordered) and/orsearch_products.Pick a slot —
list_delivery_slots, choose aslotId.Create the cart —
set_delivery_slot(slotId). This creates the cart (or updates the slot on an existing one) and is required before adding products. Skipping it makesadd_to_cart/add_many_to_cartfail with404 "Le panier est introuvable".Add products —
add_to_cart/add_many_to_cart(by slug).Confirm —
view_cart.
Checkout and payment are intentionally not automated — review and pay on the website.
Setup
npm install
cp .env.example .env # fill in MM_EMAIL / MM_PASSWORD
npm run buildThe account in .env must already have a delivery zone/address configured on the website —
the cart is tied to that.
Run
npm run dev # tsx, reads .env
# or
npm run build && npm startRegister with an MCP client
{
"mcpServers": {
"mon-marche": {
"command": "node",
"args": ["/absolute/path/to/mon-marche-mcp/dist/server.js"],
"env": {
"MM_EMAIL": "you@example.com",
"MM_PASSWORD": "your-password"
}
}
}
}Configuration
Var | Required | Default |
| for cart ops | — |
| for cart ops | — |
| no |
|
| no | public key from the site bundle |
Notes & caveats
No payment. By design. The assistant fills the cart; you check out manually.
Unofficial API. mon-marché has no public API; this calls the same endpoints the website uses. It may change without notice — keep usage personal, single-account, and low-rate, and review your basket before paying. This may run against the site's terms of service; use at your own discretion.
Cart shape. The authenticated cart is normalized in
src/client.ts(normalizeCart). The upstream API uses cents; tools expose euros. Line quantity comes fromquotation.count, unit price fromitemPrice, cart total fromprice.quotation.preauthorization(includes shipping + prep fee).clear_cartonly empties. There is no endpoint to fully delete a cart —DELETE /api/cartclears the contents but the cart shell and its delivery slot persist for the period. So theGET /api/cart→ 404 ("no cart") state cannot be reproduced once a cart exists;set_delivery_slotthen just updates the slot instead of creating a new cart.
Verified API contract
Reverse-engineered from the site's JS bundle and confirmed live. Base
https://www.mon-marche.fr.
Operation | Call |
Sign in |
|
Search |
|
Resolve product |
|
Usual products |
|
Saved addresses |
|
Delivery slots |
|
Create/set delivery |
|
Add one |
|
Add many |
|
View cart |
|
Empty cart |
|
Payment |
|
License
MIT. Note: this license covers only this project's code. It grants no rights to mon-marché's API, data, or trademarks, and does not override the site's terms of service.
Available Tools
10 toolsadd_many_to_cartAdd several products at onceA
Build a basket in one call. Each item is a product slug + quantity. Slugs are resolved to article ids and added via the bulk endpoint. Returns per-item status. Requires sign-in AND an existing cart: call set_delivery_slot first, otherwise this fails with 404 'Le panier est introuvable'.
Inputs: items (required).
add_to_cartAdd or set a product in the cartA
Set the quantity of one product in the cart (adds it if absent). Accepts a product slug from search_products. Requires sign-in AND an existing cart: call set_delivery_slot first, otherwise this fails with 404 'Le panier est introuvable'.
Inputs: slug (required), quantity.
clear_cartEmpty the cartA
Remove all products from the cart.
Inputs: no named parameters.
get_productGet product detailsA
Resolve a product slug (from search_products) to its article id and SKU. The article id is what the cart uses.
Inputs: slug (required).
list_delivery_slotsList available delivery slotsA
Return bookable future delivery slots (id, start, end, order-until deadline, zone) for the account's first saved address. A slot must be set before the cart can hold products.
Inputs: no named parameters.
my_usual_productsList products I usually orderA
Return the account's most frequently ordered products (name, slug, category, price). Useful to reorder or to filter by category (e.g. fruits). Requires sign-in.
Inputs: no named parameters.
remove_from_cartRemove a product from the cartA
Remove a line by its article id (the id field from view_cart) by setting its quantity to 0.
Inputs: articleId (required).
search_productsSearch productsA
Search the mon-marché catalog by free text. Returns product name, slug (used by other tools), price in euros, and bio/anti-gaspi flags.
Inputs: query (required), limit.
set_delivery_slotSet the delivery slot (creates the cart)A
Attach a delivery slot (id from list_delivery_slots) to the cart. This creates the cart if it does not exist yet, which is required before adding products. No payment.
Inputs: slotId (required).
view_cartView the cartA
Return the current cart: lines (id, name, quantity, unit price) and total.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 10 tools
Each tool has a clear, distinct purpose: search, product lookup, cart operations (add, remove, clear, view), delivery slot management, and usual products. Even the two add-to-cart tools serve different needs (single vs bulk), well explained in descriptions.
Most tools follow verb_noun pattern (e.g., search_products, view_cart), but 'my_usual_products' breaks the imperative style, being a descriptive possessive phrase. Otherwise consistent snake_case and verb use.
10 tools cover the full cycle of a grocery ordering workflow: product search, cart management, delivery slot selection, and reordering. No redundancy, each tool earns its place.
Covers core shopping steps (search, cart, slot) but lacks checkout or payment tools, which are essential for a complete ordering flow. Without them, the set feels incomplete for real-world use.
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.
AI-agent product catalog: search, lookup & purchase routing over verified merchant data.
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
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to search grocery products, manage shopping carts, access account and order information, and find deals and delivery details across several European online grocery platforms.-
- 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, and retrieve account, order, delivery, and discount information across multiple European online grocery platforms.MIT