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., "@dutch-supermarkets-mcp Optimize my shopping list across Dutch supermarkets"
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.
TypeScript MCP server for Dutch supermarket and drugstore prices, promotions, shopping lists, meal planning, price alerts, routes, and budgets.
Tool | Purpose |
| Search supermarket and drugstore products |
| Compare the cheapest matching product per store |
| Split a list across the cheapest stores |
| List stores and product counts |
| List drugstores and active promotion counts |
| Search current promotions by store/category |
| Search recipes by text, category, diet, or duration |
| Generate a meal plan and priced shopping list |
| Show recent price ranges |
| Create a price or promotion alert |
| Check active alerts against current data |
| Save a shopping list |
| Re-price a saved list |
| List saved shopping lists |
| Recommend buying now or waiting |
| Find nearby stored locations |
| Group cheapest products into store stops |
| Set the current weekly budget |
| Price a list against a budget |
| Find promotion savings |
Tool names, input fields, descriptions, and responses are English. Dutch terms are retained only in synchronized source values and matching keywords required by Dutch retailer data sources.
Related MCP server: Swissgroceries MCP
cp .env.example .env
# Replace DB_PASSWORD and HTTP_AUTH_TOKEN with random values.
docker compose up -d --buildThe stack contains:
db: PostgreSQL 16 with docker/init.sql
mcp-server: authenticated Streamable HTTP at http://localhost:8000/mcp
scheduler: initial sync followed by 12-hour product/promotion/recipe syncs
The MCP and scheduler initialize the PostgreSQL schema themselves from the schema bundled in the image. A deployment consuming the published image does not need to clone this repository or mount docker/init.sql.
Every push to main publishes two image tags through .github/workflows/publish-container.yml:
ghcr.io/thijserven/dutch-supermarkets-mcp:latest
ghcr.io/thijserven/dutch-supermarkets-mcp:<full-commit-sha>services:
dutch-supermarkets-db:
image: postgres:16-alpine
restart: unless-stopped
environment:
POSTGRES_DB: dutch_supermarkets
POSTGRES_USER: postgres
POSTGRES_PASSWORD: ${DUTCH_SUPERMARKETS_DB_PASSWORD}
volumes:
- dutch-supermarkets-data:/var/lib/postgresql/data
healthcheck:
test: ['CMD-SHELL', 'pg_isready -U postgres -d dutch_supermarkets']
interval: 5s
timeout: 5s
retries: 10
dutch-supermarkets-mcp:
image: ghcr.io/thijserven/dutch-supermarkets-mcp:<full-commit-sha>
restart: unless-stopped
depends_on:
dutch-supermarkets-db:
condition: service_healthy
environment: &dutch-supermarkets-env
DB_HOST: dutch-supermarkets-db
DB_PORT: 5432
DB_NAME: dutch_supermarkets
DB_USER: postgres
DB_PASSWORD: ${DUTCH_SUPERMARKETS_DB_PASSWORD}
ENABLE_HTTP_SERVER: 'true'
HTTP_HOST: '0.0.0.0'
HTTP_PORT: 8000
HTTP_AUTH_TOKEN: ${DUTCH_SUPERMARKETS_MCP_AUTH_TOKEN}
dutch-supermarkets-scheduler:
image: ghcr.io/thijserven/dutch-supermarkets-mcp:<full-commit-sha>
restart: unless-stopped
depends_on:
dutch-supermarkets-mcp:
condition: service_healthy
environment:
<<: *dutch-supermarkets-env
SYNC_INTERVAL_MS: 43200000
command: ['bin/scheduler.js']
healthcheck:
disable: true
volumes:
dutch-supermarkets-data:Check health:
curl http://localhost:8000/healthConnect an MCP client using either header:
Authorization: Bearer <HTTP_AUTH_TOKEN>
x-mcp-token: <HTTP_AUTH_TOKEN>Example Hermes MCP configuration:
mcp_servers:
dutch_supermarkets:
url: http://mcp-server:8000/mcp
headers:
Authorization: Bearer ${HTTP_AUTH_TOKEN}Requirements: Node.js 20+ and a reachable PostgreSQL database initialized with docker/init.sql.
npm ci
npm run build
DB_HOST=127.0.0.1 DB_PORT=5432 DB_PASSWORD=... node bin/mcp-server.jsENABLE_HTTP_SERVER defaults to false, so the CLI uses stdio. An MCP client configuration can invoke it directly:
{
"mcpServers": {
"dutch-supermarkets": {
"command": "node",
"args": ["/absolute/path/to/dutch-supermarkets-mcp/bin/mcp-server.js"],
"env": {
"DB_HOST": "127.0.0.1",
"DB_PORT": "5432",
"DB_NAME": "dutch_supermarkets",
"DB_USER": "postgres",
"DB_PASSWORD": "..."
}
}
}
}Variable | Default | Description |
|
| PostgreSQL host |
|
| PostgreSQL port |
|
| Database name |
|
| Database user |
| empty | Database password |
|
| Use Streamable HTTP instead of stdio |
|
| HTTP bind host |
|
| HTTP bind port |
| unset | Optional HTTP bearer/custom-header token |
|
| Custom token header |
For exposed or shared HTTP deployments, always set HTTP_AUTH_TOKEN and place the server behind TLS. The Docker Compose stack requires the token.
npm run sync -- prices
npm run sync -- promotions
npm run sync -- recipes
npm run sync -- allSources:
Product prices: checkjebon.nl/data/supermarkets.json
Promotions: public Folderz category pages
Recipes: bundled Dutch recipes plus TheMealDB
These are third-party sources and can change or rate-limit requests. The sync commands fail visibly on source/database errors; existing database data remains available to the MCP server.
npm test
npm run lint
npm run typecheck
npm run buildThe test suite covers tool parity, Zod validation, parameterized SQL behavior, transport authentication, MCP protocol calls, geographic calculations, and promotion parsing.
MIT
This server cannot be deployed
Live Dutch supermarket prices and promotions (Albert Heijn, Jumbo, Lidl, Aldi and more) for AI.
Unlock the power of food transparency with our Open Food Facts MCP server. Easily look up any food
Danish grocery catalog as MCP tools: live offers across all major chains, stores, EAN lookup, stock.
Live prices, deals & optimal multi-stop shopping routes for German grocery & drug stores.
