An MCP server that lets AI assistants shop at
: search products, check prices and sale rules,
read your favorites and past orders, and fill your cart. Checkout and payment always stay
on the website.
Unofficial MCP server for Continente.pt: search products and promotions, compare prices per kg or litre, choose with photos, read favorites and orders, and fill your cart.
Unofficial. This project is not affiliated with, endorsed by or supported by
Continente or MC Sonae. It automates the public website with a headless browser, may break
when the site changes, and should be used in line with the website's terms. You are
responsible for anything placed in your cart.
Features
Catalogue search and product details, with exact prices, unit prices, availability and
sale rules for weighted and bulk products.
Safe cart changes. Every change is confirmed by reading the cart back. If a change
cannot be confirmed, the result says so and tells the assistant to check the cart instead
of retrying.
Your account: favorites, order history and a ranking of the products you buy most.
Runs locally over stdio. Your credentials and session are stored on your computer and
sent only to Continente.pt.
Built-in guidance. The server tells the assistant the cart rules as soon as it
connects, and offers a basket-planner prompt with the full shopping workflow. Nothing
extra to install; the same guide also ships as a skill.
Requirements
A Continente.pt account for account features (search and product details work without one)
Claude Desktop on macOS or Windows for the one-click install, or Node.js 22 or newer for
any other MCP client
The server drives the website with Chromium, which it downloads automatically the first time
it needs it (about 150 MB, once).
Open it. Claude Desktop shows an install dialog; click Install.
Enter your Continente email and password when asked. Claude Desktop keeps the password
in its secure settings storage.
That's it. The server is also listed
in the MCP Registry as
io.github.andredelgado/continente-mcp, so clients that browse the registry can find it. To use 1Password instead
of storing the password in Claude Desktop, use the manual setup below.
Updates
The server checks npm once a day for a newer release. When there is one, it tells the
assistant, so Claude can mention it, and get_session_status shows it.
Extension: download the new continente-mcp.mcpb and open it. Claude Desktop updates the
extension in place and keeps your email and password.
npx setups: using continentept-mcp@latest picks up new versions when the client restarts.
Release emails: on GitHub, choose
Watch → Custom → Releases.
Manual setup (any MCP client)
1. Save your credentials in ~/.continentept-mcp/credentials.env (see
configuration for other options):
To keep the credentials file elsewhere, add
"env": { "CONTINENTE_CREDENTIALS_FILE": "/absolute/path/to/credentials.env" }.
Chromium downloads itself on first use. To fetch it ahead of time, run
npx -y continentept-mcp install-browser (on Linux, add --with-deps for the system
libraries it needs).
Then ask your assistant something like "Add semi-skimmed milk and a dozen eggs to my
Continente cart" or "What do I usually buy? Build me a list for this week."
Tools
Tool
What it does
search_products
Search the catalogue in relevance order, with favorites marked and a cursor for more
get_product
Price, pack size, availability and sale rules for one product
get_product_labels
Ingredients, allergens and nutrition as the label declares them
choose_products
Let the user pick between products, with photos where the client supports it
list_favorites
Your saved favorites (refresh: true fetches the latest)
get_cart
Cart lines, quantities, bags and totals
preview_cart_changes
What a list of changes would do and cost, without changing the cart
add_cart_item
Add an amount on top of what is in the cart
set_cart_item_quantity
Make the cart hold exactly a quantity; zero removes
remove_cart_item
Remove a line from the cart
clear_cart
Empty the whole cart in one confirmed step
list_orders
Recent orders with their product lines
get_order
One order's product lines
list_frequently_bought_products
Products ranked by how often you order them
get_session_status
Local login, cookie and cache state (no network)
See the tool reference for inputs, outputs, error codes and limits.
About uncertain cart changes
A cart change can fail after the request has reached the website, for example on a timeout.
In that case the result has mutation.outcome: "unknown" and asks the client to call
get_cart before doing anything else. The server never retries such a change on its own,
and clients should not either: repeating an add_cart_item could add the item twice.
Guidance for the assistant
When a client connects, the server sends short instructions with these cart rules, so the
assistant follows them without any setup. For planning a shopping list, pick the
basket-planner prompt from your client's prompt or attachment menu, optionally with a
request such as "weekly basket for two".
The same guide is available as a skill in
skills/basket-planner. Clients that support skills, such
as Claude Desktop (Settings → Capabilities → Skills) or Claude Code (~/.claude/skills/),
then apply it automatically whenever you ask about groceries.
Command line
continentept-mcp Start the MCP server on stdio
continentept-mcp login Sign in and save the session (--show-browser to watch)
continentept-mcp install-browser Download Chromium now instead of on first use (extra arguments go to Playwright)
continentept-mcp --version
Limitations
One account per server process.
Searches read at most five result pages and order listings at most ten pages, so very
broad queries or long histories are reported as incomplete rather than read in full.
Login handles the standard email and password flow. When Continente asks you to confirm you
are not a robot, the server opens a sign-in window for you to tick the box; where no window
can be shown, run continentept-mcp login --show-browser and do it there. The server never
answers that check itself.
There are no checkout, payment, delivery-slot or favorites-editing tools.
Unofficial MCP server for Continente.pt: search products and promotions, compare prices per kg or litre, choose with photos, read favorites and orders, and fill your cart.
Aún no hay lista de herramientas. Los servidores remotos la reciben tras la primera comprobación de estado.
Preguntas frecuentes
Preguntas
¿Cómo instalo Continentept?
Copia en esta página la configuración stdio para Cursor, Claude Desktop, Claude Code o VS Code. Usa la instalación del publicador, no un proxy de PlugMCP.
¿Continentept necesita una clave de API?
Este registro no indica ninguna variable de entorno obligatoria.
¿Qué transporte usa Continentept?
Continentept se ejecuta localmente por stdio.
¿Cuándo se comprobó Continentept por última vez?
Última comprobación: 2026-11-15. Unofficial MCP server for Continente.pt: search products and promotions, compare prices per kg or litre, choose with photos, read favorites and orders, and fill your cart.
