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 from Claude and other AI assistants.
curl -fsSL https://cookapps.net/api/skills/install?skills=••••••• | nodeAn MCP server that lets AI assistants shop at
Continente.pt: 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.

The assistant shows milk, banana and Greek yoghurt options with photos and prices; the user switches two choices and confirms
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.
Search, prices and product details need no Continente account. With Node.js 22 or newer, add
the server to your MCP client with no credentials at all. In Claude Code:
claude mcp add continente -- npx -y continentept-mcp
Other clients use the JSON under Manual setup, step 2. Then ask:
Compare three laundry detergents by price per wash, without changing the cart.
Favorites, orders, coupons and the cart need your account; add it when you want them. The
Claude Desktop extension works this way too: leave the email and password empty when you
install it, and add them later in the extension's settings.
availability and sale rules for weighted and bulk products.
options side by side and you pick, in clients that support MCP Apps.
delivery shown. Every change is confirmed by reading the cart back, and one that cannot be
confirmed is never retried.
Continente coupons.
booking, so those always happen on the website, by you.
sent only to Continente.pt.
connects, and offers a [basket-planner](docs/tools.md#instructions-and-prompt) prompt and
skill with the full shopping workflow.
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).
When you install the extension, Claude Desktop warns that it will have access to everything on
your computer. That warning appears for every extension installed from a file: an extension
runs as an ordinary program with your user's permissions, and Claude cannot check what each one
does. Here is what this one does:
~/.continentept-mcp (the website session,your favorites list and the date of the last update check), a credentials file if you set
one up, and the Chromium it downloads, which lives in Playwright's cache folder. It does not
read your documents, photos or other files.
out. The first time it needs a browser it downloads Chromium from Playwright's servers.
scripts, as they would in your own browser. Payment, order submission and delivery-slot
booking are blocked.
extension, Claude Desktop keeps them in its secure settings storage.
You don't have to take this on trust: the code is all here, and every npm release is
published by GitHub Actions with provenance,
so you can check it was built from this repository. The extension file is built by the same
workflow. Configuration
lists every stored file.
from the latest release.
first and add them later in the extension's settings. Claude Desktop keeps the password in
its secure settings storage.
If opening the file does nothing, install it from inside Claude Desktop: go to **Settings >
Desktop app and select Manage next to Extensions (Settings > Extensions** in the
older layout), click Advanced settings, then Install Extension… and pick the file.
These are the steps in
Claude's guide to local MCP servers.
To update, download the new continente-mcp.mcpb and open it; your email and password are
kept. The assistant tells you when a new release is out
(how updates work). To use 1Password instead of storing the
password in Claude Desktop, use the manual setup below.
1. Save your credentials in a private file, ~/.continentept-mcp/credentials.env (see
configuration for other options). Skip this step if you only want
search and product details.
Create the file first, then type your password in an editor, so it never passes through your
shell history. On macOS and Linux:
mkdir -p ~/.continentept-mcp && chmod 700 ~/.continentept-mcp
touch ~/.continentept-mcp/credentials.env && chmod 600 ~/.continentept-mcp/credentials.env
${EDITOR:-nano} ~/.continentept-mcp/credentials.envOn Windows, in PowerShell (Notepad offers to create the file):
New-Item -ItemType Directory -Force "$env:USERPROFILE\.continentept-mcp" | Out-Null
icacls "$env:USERPROFILE\.continentept-mcp" /inheritance:r /grant:r "${env:USERNAME}:(OI)(CI)F"
notepad "$env:USERPROFILE\.continentept-mcp\credentials.env"Put these two lines in it and save:
CONTINENTE_EMAIL=you@example.com CONTINENTE_PASSWORD=your-password
Using 1Password? Skip the file and pass secret references through op run instead; see
Optionally check that login works:
npx -y continentept-mcp login
2. Add the server to your MCP client.
Claude Code:
claude mcp add continente -- npx -y continentept-mcp
Claude Desktop, Cursor and other clients (claude_desktop_config.json, mcp.json, ...):
{
"mcpServers": {
"continente": {
"command": "npx",
"args": ["-y", "continentept-mcp"]
}
}
}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).
3. 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."*
The server is also listed in the MCP Registry as
io.github.andredelgado/continente-mcp.
The repository has a Dockerfile, but no image is published yet, so you build it yourself.
Configuration has the commands, the /data
volume and how to sign in on a machine without a screen.
| 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_coupons | Your Cartão Continente coupons, and which are selected in the cart |
set_cart_coupons | Choose which coupons the cart uses, confirmed by reading the cart back |
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, uncertain cart
changes and limits.
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
broad queries or long histories are reported as incomplete rather than read in full.
sign-in window the server opens (details). The
server never answers that check.
Fair-code workflow automation platform with native AI capabilities. Combine visual building with custom code, self-host or cloud, 400+ integrations.
🕷️ The BEST Web Scraping framework that handles everything from a single request to a full-scale crawl! Don't be shy, join here: https://discord.gg/EMgGbDceNQ and follow here for daily tips and tricks: https://x.com/Scrapling_dev
Get instant access to complete setup guides, repository source code, and integration assets.