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

Related MCP server: MatMCP

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:

1. Find products — my_usual_products (frequently ordered) and/or search_products.

2. Pick a slot — list_delivery_slots, choose a slotId.

3. 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 makes add_to_cart / add_many_to_cart fail with 404 "Le panier est introuvable".

4. Add products — add_to_cart / add_many_to_cart (by slug).

5. 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 build

The 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 start

Register 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

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 from quotation.count, unit price from itemPrice, cart total from price.quotation.preauthorization (includes shipping + prep fee).

• clear_cart only empties. There is no endpoint to fully delete a cart — DELETE /api/cart clears the contents but the cart shell and its delivery slot persist for the period. So the GET /api/cart → 404 ("no cart") state cannot be reproduced once a cart exists; set_delivery_slot then 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.

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.