Continente MCP

Continente MCP

An 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.

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, promotions, availability and sale rules for weighted and bulk products.
• Choose with photos. When there is more than one good match, the assistant shows the options side by side and you pick, in clients that support MCP Apps.
• Labels: ingredients, allergens and nutrition as the label declares them.
• Safe cart changes. Preview a list before applying it, with the minimum order and delivery shown. Every change is confirmed by reading the cart back, and one that cannot be confirmed is never retried.
• Your account: favorites, order history, the products you buy most, and your Cartão Continente coupons.
• No checkout. The browser the server drives blocks payment, order submission and slot booking, so those always happen on the website, by you.
• 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 and skill with the full shopping workflow.

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).

Install in Claude Desktop (one click)

1. Download continente-mcp.mcpb from the latest release.
2. Open it. Claude Desktop shows an install dialog; click Install.
3. Enter your Continente email and password when asked. Claude Desktop keeps the password in its secure settings storage.

That's it. 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.

Manual setup (any MCP client)

1. Save your credentials in ~/.continentept-mcp/credentials.env (see configuration for other options):

mkdir -p ~/.continentept-mcp && chmod 700 ~/.continentept-mcp

printf 'CONTINENTE_EMAIL=you@example.com\nCONTINENTE_PASSWORD=your-password\n' > ~/.continentept-mcp/credentials.env chmod 600 ~/.continentept-mcp/credentials.env

Using 1Password? Skip the file and pass secret references through op run instead; see Using 1Password.

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).

The server is also listed in the MCP Registry as io.github.andredelgado/continente-mcp.

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

See the tool reference for inputs, outputs, error codes, uncertain cart changes and limits.

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.
• When Continente asks you to confirm you are not a robot, you tick the box yourself in a sign-in window the server opens (details). The server never answers that check.
• There are no checkout, payment, delivery-slot or favorites-editing tools.

Documentation

• Tool reference
• Stability: what counts as a breaking change from 1.0
• Configuration
• Troubleshooting
• Contributing
• Security policy
• Changelog

License

MIT