PrijsProfeet MCP
One line: This MCP server gives a model read-only access to PrijsProfeet's normalized Dutch supermarket offer API — searching offers, browsing deals and products, and checking API health — plus one unexpected write tool (pp_request_free_key) that the README says is disabled on every plan.
Search offers (
pp_search): across 10 chains (Albert Heijn, Jumbo, Lidl, Aldi, PLUS, Dirk, Ekoplaza, Poiesz, SPAR, DekaMarkt, Hoogvliet, Vomar), filtering by query, retailer, unified category, price range, savings %, dietary tags, house-brand vs A-brand, promotion type and promotion status.Resolve categories (
pp_get_categories,pp_get_filter_stats): map a user's word to a valid category slug, and see facet counts per retailer/status/category before committing to a filter.List and enumerate products: by retailer, promotional folder, promo group, or validity window (
pp_list_products), pluspp_get_products_by_retailer,pp_get_products_by_folder,pp_get_promotional_products.Inspect a single product (
pp_get_product): full detail — EAN, folder, promo group, dietary labels.Deal browsing and aggregates:
pp_get_top_deals,pp_get_brand_deals,pp_get_deals_by_type,pp_get_new_deals,pp_get_popular_deals,pp_get_deals_summary.Forecasting:
pp_get_price_forecast— backtested per-product forecast, wherenullmeans "no forecast available", not an error.Search by name (
pp_search_products_by_name): older path-based variant, superseded bypp_search.Operational/meta:
pp_health_check(API liveness),pp_get_sla_summary(monthly availability),pp_get_partner_usage(rate-limit usage and account info for the configured key; needs a valid key).Notable anomaly: the schema exposes
pp_request_free_key, the signup endpoint that emails a key link to an address. The README saysPOST /api/v1/partner/signupis withheld on every plan and namesNEVER_EXPOSED_ENDPOINTSas the only place it appears — so this surface does not match the documented behaviour and has a real-world side effect (it emails a stranger).Not available here: all 6 Pro-gated tools (EAN/product matching, cross-retailer price comparison, EAN stats, regular shelf prices, price history) are absent — consistent with the default
freeplan.Character of the tools: per annotations, all are read-only, idempotent and open-world; none writes to the local filesystem. The only write-shaped tool is the free-key request above.
Key caveat for use: a price only means something alongside
promotion_status(active/upcoming/shelf/historical), so never quote the lowest price across all rows. Also, this is promotional offers, not a full assortment.
Provides tools for querying live supermarket offers, products, and categories for Albert Heijn through the PrijsProfeet API.
Provides tools for querying live supermarket offers, products, and categories for Lidl through the PrijsProfeet API.
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., "@PrijsProfeet MCP compare milk prices at Albert Heijn and Jumbo"
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.
prijsprofeet-mcp
Unofficial MCP server for the PrijsProfeet API
Warning: This is an unofficial project and is not developed, endorsed, or supported by PrijsProfeet.
For official information, see the PrijsProfeet API and API voorwaarden.
A Dockerized MCP server for the PrijsProfeet API: live offers from 10+ Dutch supermarket chains (Albert Heijn, Jumbo, Lidl, Aldi, PLUS, Dirk, Ekoplaza, Poiesz, SPAR, DekaMarkt, Hoogvliet, Vomar and more) as one normalised JSON API.
The 25 tools are generated from the OpenAPI document at https://www.prijsprofeet.nl/openapi.json (a copy is
bundled in the image, because the live one sits behind Cloudflare and is not reachable from a server). Argument
schemas come from the spec; the tool names and descriptions are curated, because a good description is what stops
a model from quoting a price nobody is charging.
Quick start
docker build -t prijsprofeet-mcp .
docker run -i --rm -e PRIJSPROFEET_API_KEY prijsprofeet-mcpThat speaks MCP over stdio, so it wants to be run by an MCP client rather than by hand.
Related MCP server: dutch-supermarkets-mcp
Wiring it into a client
The key is read from the PRIJSPROFEET_API_KEY environment variable and sent as the X-API-Key header.
stdio — the client launches the container
This is the default, and the right choice for a local Docker tool: no port, no auth surface, no network listener.
docker run -i --rm -e PRIJSPROFEET_API_KEY prijsprofeet-mcp:latestopencode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"prijsprofeet": {
"type": "local",
"command": ["docker", "run", "-i", "--rm", "-e", "PRIJSPROFEET_API_KEY", "prijsprofeet-mcp:latest"],
"environment": { "PRIJSPROFEET_API_KEY": "{env:PRIJSPROFEET_API_KEY}" },
"enabled": true
}
}
}opencode prefixes tool names with the server name, so the tools arrive as prijsprofeet_pp_search,
prijsprofeet_pp_get_categories, and so on. Prompt with use the prijsprofeet tools to pull them in.
Claude Desktop / any stdio client
claude_desktop_config.json only accepts command-shaped servers, so the container is the entry point — Desktop
launches it and talks to it over pipes:
OS | Path |
macOS |
|
Windows |
|
Linux |
|
Settings → Developer → Edit Config opens it. Build the image once first, then point the entry at it:
docker build -t prijsprofeet-mcp:latest .{
"mcpServers": {
"prijsprofeet": {
"command": "docker",
"args": [
"run", "-i", "--rm",
"--env-file", "/absolute/path/to/.env",
"prijsprofeet-mcp:latest"
]
}
}
}Desktop apps launched from a dock do not inherit your shell environment, so --env-file is the reliable way to
get PRIJSPROFEET_API_KEY in; -e PRIJSPROFEET_API_KEY only works if the variable is already exported in the
process that started the app. Use an absolute path — the app's working directory is not your shell's.
Then fully quit and relaunch. Closing the window leaves the previous container running; the config is read once at process start, so edits made while the app is open do nothing.
With stdio there is no port and therefore no MCP_AUTH_TOKEN — the client owns the container's lifetime and talks
to it over pipes. The token only exists in the HTTP transport.
Never paste a
urlintoclaude_desktop_config.json. Desktop's config schema is stdio-only: an entry withurl,type, orheadersfails validation, and recent builds respond by rewriting the file with the wholemcpServersblock removed — taking your working entries with it, silently (#37286). Theurl+headers+"type": "http"shape belongs to Claude Code's~/.claude.json, which is a different client with a different parser. For a remote endpoint, use the mcp-remote bridge below.
HTTP — the client connects to a URL
Set PRIJSPROFEET_TRANSPORT=http and the same container serves Streamable HTTP instead:
docker run -d --rm -p 127.0.0.1:3000:3000 \
-e PRIJSPROFEET_TRANSPORT=http \
-e MCP_AUTH_TOKEN="$(openssl rand -base64 32)" \
-e PRIJSPROFEET_API_KEY \
prijsprofeet-mcp:latestEndpoint | Auth |
|
|
| none, so a platform health check can poll it |
In opencode that is a remote server rather than a local one:
{
"mcp": {
"prijsprofeet": {
"type": "remote",
"url": "http://localhost:3000/mcp",
"headers": { "Authorization": "Bearer YOUR_TOKEN" },
"enabled": true
}
}
}Or with compose, which keeps it bound to loopback:
cp .env.example .env # then fill in the key
docker compose --profile http up -d prijsprofeet-mcp-httpClaude Desktop
Desktop has no schema for a remote endpoint, so a command entry is the only way in — mcp-remote is a stdio
bridge that speaks Streamable HTTP on the other side, and it carries the Authorization header that Desktop's own
remote path cannot:
{
"mcpServers": {
"prijsprofeet": {
"command": "npx",
"args": [
"-y", "mcp-remote",
"https://prijsprofeet-mcp.onrender.com/mcp",
"--transport", "http-only",
"--header", "Authorization: Bearer YOUR_MCP_AUTH_TOKEN"
]
}
}
}--transport http-only is not optional decoration: mcp-remote otherwise negotiates the SSE half of Streamable
HTTP first, GETs this endpoint, gets a 405 back, and stalls through a backoff before retrying as POST. With it
pinned, only the POST path is used.
Settings → Connectors → Add custom connector is not an alternative here. That flow is OAuth-only, and this server authenticates with a bearer token it has no OAuth endpoints for.
Desktop reads the config once at process start, so fully quit and relaunch after editing — closing the window is
not enough. Check Settings → Developer for a connected entry with the tool count this server publishes.
That block works unchanged against the local http://localhost:3000/mcp from the compose service above, with
Bearer $MCP_AUTH_TOKEN in the header.
A
401from this server is a dead end, not a login prompt. Clients treat an unauthenticated401from an HTTP MCP server as a request to start an OAuth flow (Claude Desktop 1.24012.0+, andmcp-remotealike). This server has no OAuth endpoints, so the flow cannot complete:mcp-remotelogsDynamic Client Registration rejected (HTTP 404)and exits, and Desktop opens a browser to a sign-in page that can never succeed. Both mean the same thing — a typo in the token, a stale token after rotation, or a wrongurl. The usual culprit is the literal stringYOUR_MCP_AUTH_TOKENstill sitting in the file. A correctly configured client never sees a401.
The token sits in plaintext in this file, so chmod 600 it and keep the file out of any repo. It is the
MCP_AUTH_TOKEN value, not PRIJSPROFEET_API_KEY — never put the partner key in a client config.
The HTTP transport is stateless — no session id, nothing held between requests — so the endpoint survives restarts
and needs no sticky sessions behind a load balancer. Requests must send Accept: application/json, text/event-stream
and Content-Type: application/json; it answers 406 and 415 respectively when you get that wrong, which is
what the MCP spec asks for.
The API key is server-side in this mode, so
MCP_AUTH_TOKENis the only thing standing between the public internet and your rate limit. It is optional in code — unset, the server still starts and logs a warning — but treat an unset token as a deployment mistake, not a local-dev convenience. See Security.
docker compose run --rm prijsprofeet-mcp is still the right command for the stdio service: a stdio server has no
port, so the client has to own the container's lifetime.
Deploying to Render
render.yaml is a Render blueprint, so the deploy is New → Blueprint → point at the repo. It builds the Dockerfile
as a web service in frankfurt with the health check on /healthz.
Two things in it are deliberate. One is a trade-off, the other is easy to "fix" in a way that breaks the deploy:
plan: freeby default, which means the service sleeps. 512 MB at $0, but a Free web service spins down after 15 minutes without traffic and takes about a minute to wake. MCP clients fetchtools/liston connect with a timeout usually measured in seconds, so against a service that has been idle the client reports a timeout and gives up while the server is still booting — the server cannot distinguish that from being dead, and there is nothing to fix from the server side. Staying onfreemeans picking one of:Option
What it costs you
Raise the client timeout to ~90s
The first connect after every idle period eats the wait, or fails if the client caps out earlier
GET /healthza minute before you startA manual step per session, and it only helps if you remember it
Do nothing
Works while you are actively using it, times out on the first connect after a break
None of that is a server problem, it is the plan. If the endpoint has to be up the moment a client opens a session, switch to
plan: 0.5c-512mb(formerlystarter, $7/month): it never sleeps, the cold start disappears, and the only cost is the bill. It is one line inrender.yaml— the free one is left commented out beside it.No
PRIJSPROFEET_HTTP_PORT. Render injectsPORT; the server reads that and falls back to 3000. Pinning the port in the blueprint or the Dockerfile shadowsPORT, the container listens where nobody is looking, and Render reports the deploy as live while every request 502s.
Render prompts for PRIJSPROFEET_API_KEY on first deploy, so the partner key never enters the repo. It generates
MCP_AUTH_TOKEN for you — read it from Dashboard → Environment, then put it in your client's headers.
The service is stateless and single-instance, so deploys are not zero-downtime: a redeploy drops in-flight requests
and clients reconnect. maxShutdownDelaySeconds is left at the 30s default, which is more than the server's own 5s
drain needs.
Security
The threat model is narrow and worth stating plainly: this server has no user accounts, no database, and no writes to your filesystem. What an attacker wants is your PrijsProfeet key's rate limit, or just the data you can query with it. Ordered by what actually helps:
1. Set MCP_AUTH_TOKEN. A 256-bit random string, compared in constant time via crypto.timingSafeEqual, and
returned as a 401 with a WWW-Authenticate: Bearer challenge when missing or wrong. Every failed attempt is
logged with the client IP, so scanning shows up in the Render log stream.
Rotation is comma-separated and overlap-friendly: set MCP_AUTH_TOKEN=new,old, deploy, move your client to new,
then drop old. No window where both are down.
2. Remember what this is not. A static bearer token is a deliberate deviation from the MCP spec, which asks HTTP servers to implement OAuth 2.1. That is the right trade for a single-tenant tool with one operator, and the wrong one for a shared or multi-user deployment — if you need per-caller identity, per-caller revocation, or scoped access, put a real OAuth proxy in front of it rather than extending this.
3. Lock the plan down, not just the endpoint. PRIJSPROFEET_PLAN=free withholds the 6 Pro tools, so a leaked
token cannot reach the matching and price-history endpoints even if the key is Pro.
4. Prefer a tunnel over a public hostname if you can. Cloudflare Tunnel or Tailscale put the endpoint on a URL
nobody can scan, which removes the guessing game entirely. Render's own ipAllowList is not an option here — it
requires a Scale or Enterprise workspace.
5. Do not set a suspicious User-Agent. bot, crawler, spider and slurp in PRIJSPROFEET_USER_AGENT get
403 from PrijsProfeet on keyless requests, which looks like an outage but is not one. The server warns at startup.
If the key or token ever leaks: rotate the PrijsProfeet key in their dashboard, then rotate
MCP_AUTH_TOKEN as above. Rotating the token alone does not help if the key is what leaked, because the key is
what the attacker was spending.
The tools
19 tools are exposed by default, which is everything the API serves on a free key. The remaining 6 need the Pro plan and are withheld — see Plans below.
Tool | What it does |
| Search offers across all chains, filtered by retailer, category, status, price, savings, diet |
| The 25 category slugs with counts — call this before filtering by category |
| Facet counts for a query, to see what a filter would still return |
| Bulk list with retailer, folder, promo-group and validity-window filters |
| Full detail for one product |
| Every product in one promotional folder |
| Everything from one chain |
| Everything currently on offer |
| The older path-based product search; |
| Offer browsing and aggregates |
| Backtested price forecast; returns |
| Liveness of the API and its backing services |
| Availability per calendar month |
| Rate-limit usage and account info for the configured key |
Plans
PRIJSPROFEET_PLAN decides whether the Pro-gated tools are exposed. It defaults to free.
| Tools |
| 19 — the set above |
| 25 — adds the 6 below |
The withheld six, all of which answer 403 This endpoint requires the Pro plan on a free key:
Tool | Endpoint |
|
|
|
|
|
|
|
|
|
|
|
|
That list was verified call by call against a live free key, not read off the published docs, which only mention
/match/* and price history. Withholding is deliberate: a tool that always fails costs a round trip and invites
the model to invent a workaround, so on the free plan it is not merely unused but invisible — calling it returns
Unknown tool, and the server's instructions stop advertising the features. If you upgrade, set
PRIJSPROFEET_PLAN=pro and restart; no rebuild needed.
One endpoint is withheld on every plan, not just the free one: POST /api/v1/partner/signup, which mints a
PrijsProfeet key and mails it to an address the caller supplies. It is a write against a third party's signup flow,
reachable by anyone who can reach this server, and its net effect is to email a stranger — so it is off rather than
merely discouraged in the description. That is why the spec describes 26 endpoints and this server exposes 25 on
pro. There is no environment variable to re-enable it; NEVER_EXPOSED_ENDPOINTS in src/tools.ts is the only
place it is named. Ask at https://www.prijsprofeet.nl/api if you need a key.
Configuration
Variable | Default | Purpose |
| (unset) | Partner key, sent as |
|
| API origin |
|
|
|
|
|
|
| (unset) | Comma-separated bearer tokens for the http transport. Unset means no auth — the server starts and warns, so this is only safe on loopback. |
| (unset) | Honoured when |
|
| Interface for http mode |
|
| Port for http mode |
|
| Path for http mode |
|
| Per-request timeout |
|
| Retries on 429/5xx and network errors, with backoff honouring |
|
| Responses above this are truncated with a note instead of returned whole |
|
| Sent on every request |
|
| Fetch the OpenAPI document at startup instead of using the bundled copy |
|
| Where to refresh from |
|
| Prefix on every tool name |
|
| Diagnostics on stderr |
Things worth knowing before you trust a price
A price is not a price until you read promotion_status. Every row carries one of four values, and they mean
different things: active (on offer now), upcoming (starts next week), shelf (the regular price — no
promotion at all) and historical (the last price seen, up to 60 days old). Taking the lowest price across all
four hands you a number that no retailer is charging. The tool descriptions and the server instructions push back
on this, but it is the single easiest mistake to make with this API.
This is offers, not an assortment. Products that are not on promotion are absent, so a recipe app built on
pp_search alone will find a fraction of its ingredients, and a different fraction each week. On the free plan
there is no way around it: the only endpoint that exposes regular non-promotion prices, pp_search_shelf_prices,
is Pro-gated along with the matching tools. On Pro you get both that and cross-retailer comparison.
Not every chain publishes an EAN. Aldi, Lidl, Vomar and the folder-only chains do not (coverage per chain), so for those chains the cross-retailer match (Pro) falls back to name, brand and category. Those rows are indicative, not product identity.
Pro-gated tools are withheld, not broken. On the default free plan the six tools in
Plans are absent from tools/list entirely, so the model never spends a call discovering they 403. If
you call one by name you get Unknown tool. Set PRIJSPROFEET_PLAN=pro to get all 25.
Do not put bot, crawler, spider or slurp in the User-Agent. The API answers 403 to keyless requests
that look like a scraper, which reads like an outage but is not one. The default User-Agent is clean; the server
warns on stderr at startup if PRIJSPROFEET_USER_AGENT is set to something suspicious. Naming yourself is the
courteous thing to do and is the only way the API operator can reach you before a breaking change.
Rate limits are per IP: 120/min on search and product detail and 30/min on the bulk endpoints with no key, 150/min with a free key, 300/min on Pro, 1000/min on Business. A key is therefore always a rate-limit upgrade, never a downgrade.
Development
npm install
npm run build # tsc + copy the spec into dist/
npm start # run over stdio
npm run typecheck
npm run inspect # print the generated tool surface, no transportnpm run inspect -- --json dumps the full tool definitions, which is the quickest way to see what a model
actually receives.
Layout
File | Role |
| OpenAPI types, endpoint collection, spec loading with fallback |
| Resolves |
| The curated tool catalogue and the spec-to-tool generator |
| HTTP: auth header, retries, timeout, bounded reads, error hints |
| MCP server factory and the instructions handed to the model |
| Transport selection: stdio, or Streamable HTTP plus |
| Environment parsing |
| Bundled copy of the spec, pinned at image build time |
To add a curated description for a new endpoint, add an entry to CATALOG in src/tools.ts keyed by
"METHOD /path". Unlisted endpoints still appear, under a name derived from the path — the catalogue only
overrides.
Available Tools
20 toolspp_get_brand_dealsARead-onlyIdempotent
Every current deal for one brand, e.g. Coca-Cola or Ahold. Brand matching follows the capitalisation in the source data, so keep the brand as the user wrote it and do not normalise it.
Inputs: brand (required), limit, promotion_type.
pp_get_categoriesARead-onlyIdempotent
The unified categories with Dutch display names, product counts and group.
Call this before pp_search to turn a user's word ("zuivel", "brood") into a valid category slug. Cheap, and worth it before a search that would otherwise return nothing.
Inputs: no named parameters.
pp_get_deals_by_typeARead-onlyIdempotent
Deals for one promotion mechanic, passed as a keyword such as 1+1, 2+2 or korting. The type values used by promotion_type elsewhere are the internal names (percentage, multi_buy, one_plus_one, volume, limited, starting).
Inputs: type (required), limit.
pp_get_deals_summaryARead-onlyIdempotent
Aggregate stats: total products, retailer count, biggest discount, last update. One cheap call to check that the data is fresh before reporting anything about "this week".
Inputs: no named parameters.
pp_get_filter_statsARead-onlyIdempotent
Facet counts per retailer, promotion status and category. Pass q (and optionally category) to get the counts for one specific search — useful to show what a filter would still return, or to check whether a category exists before searching it.
Inputs: q, dietary, category, retailer, +2 more.
pp_get_new_dealsCRead-onlyIdempotent
The most recently started offers, capped at 30 rows.
Inputs: limit.
pp_get_partner_usageARead-onlyIdempotent
Current rate-limit usage and account info for the configured API key. Requires a valid partner key, so it fails with 401 when the server is running without one.
Inputs: no named parameters.
pp_get_popular_dealsBRead-onlyIdempotent
The deals users click most often, capped at 30 rows.
Inputs: limit.
pp_get_price_forecastARead-onlyIdempotent
Server-side backtested price forecast for one product ("Profeet voorspelt").
A product with no forecast is not an error: the call returns HTTP 200 with a null forecast, and the reason arrives in the X-Forecast-Reason header. Report it as "no forecast available" rather than retrying.
Inputs: product_id (required).
pp_get_productARead-onlyIdempotent
Full detail for one product, including EAN, folder, promo group and dietary labels. product_id is the product_id field from any search or list result.
Inputs: product_id (required).
pp_get_products_by_folderARead-onlyIdempotent
Every product in one promotional folder (a single actie). folder_id is the folder_id field on a product.
page_size may go up to 1000 here, but a big page is expensive in context and in rate limit — ask for what the question needs.
Inputs: folder_id (required), page, page_size.
pp_get_products_by_retailerARead-onlyIdempotent
Every product from one retailer, paginated. Takes a retailer slug (albert_heijn, jumbo, aldi, lidl, ekoplaza, plus, dekamarkt, hoogvliet, vomar, dirk), not a display name.
Inputs: retailer (required), page, page_size.
pp_get_promotional_productsARead-onlyIdempotent
Everything currently on offer, newest first. Use pp_list_products with is_promotional=true instead when you also need a filter.
Inputs: page, retailer, page_size, max_valid_from, +1 more.
pp_get_sla_summaryARead-onlyIdempotent
Availability per calendar month, newest first. Answers "was the API down last Tuesday?" with a number instead of a guess.
Inputs: months.
pp_get_top_dealsARead-onlyIdempotent
Top deals grouped per brand, optionally narrowed to one or more retailers.
min_savings defaults to 10%; raise it to cut the noise. Pass retailer as an array to scope the lists to specific chains.
Inputs: limit, retailer, min_savings.
pp_health_checkARead-onlyIdempotent
Check that the PrijsProfeet API is reachable. Call this when another tool returns 5xx to tell an outage apart from a bad request.
Inputs: no named parameters.
pp_list_productsARead-onlyIdempotent
List products with filters, newest extraction first. Use pp_search when the user named a product; use this when you need to enumerate by retailer, folder, promo group or validity window.
promo_group_id returns every product in one shared action — read that field off a product to get the rest of its group.
min_valid_from / max_valid_from (YYYY-MM-DD) bound the date the promotion starts.
Inputs: page, sort_by, retailer, folder_id, +8 more.
pp_request_free_keyA
Request a free API key for an email address. A one-click link is mailed out; the key itself is never in the response. The response is deliberately identical whether or not that address already has a key, so a success here never confirms someone is a customer. Capped at 5 requests per hour per IP. This has a real-world side effect — it emails a stranger. Only call it when the user has explicitly asked for it in this conversation.
Inputs: email (required), project_name (required), site_url.
pp_searchARead-onlyIdempotent
Search supermarket offers across the 10 Dutch chains (Albert Heijn, Aldi, DekaMarkt, Dirk, Ekoplaza, Hoogvliet, Jumbo, Lidl, PLUS, Vomar).
Omit q or pass * to browse the whole catalogue.
How to read a row: promotion_status decides what the price means. active = on offer right now, upcoming = starts next week, shelf = the regular price, historical = the last price seen, up to 60 days old.
Taking the lowest price across rows can therefore return a price nobody is charging today — filter on promotion_status (or leave current_only-style filtering to the caller) before quoting a best price.
Retailer slugs: albert_heijn, jumbo, aldi, lidl, ekoplaza, plus, dekamarkt, hoogvliet, vomar, dirk.
Category slugs are not free text: call pp_get_categories first to map the user's word to a slug.
Keep page_size modest; page through rather than asking for 100 rows when a question needs 3.
Inputs: q, page, dietary, sort_by, +10 more.
pp_search_products_by_nameARead-onlyIdempotent
Search products with the term inside the URL path. This is the older sibling of pp_search: same data, fewer filters, no sorting.
Prefer pp_search for new work.
Inputs: query (required), page, retailer, page_size.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 20 tools
Each tool targets a fairly distinct slice (newest, popular, top-by-brand, by-type, by-retailer), and descriptions explicitly differentiate them. However, there are documented redundancies that create real overlap: pp_get_promotional_products vs pp_list_products with is_promotional, and pp_search vs the 'older sibling' pp_search_products_by_name.
Consistent pp_ prefix and snake_case verb_noun pattern (pp_get_*, pp_list_*, pp_search*). Minor deviation with pp_search / pp_search_products_by_name and the unprefixed-looking pp_health_check, but overall predictable.
At 20 tools this sits in the heavy range for a read-mostly price API, with several near-duplicate listing/search tools that could be consolidated. Each tool has some justification, but the surface is larger than strictly needed.
Covers the domain well: search, list, product detail, categories, folders, retailers, price forecast, deal aggregations, health, SLA and account tools. Gaps are minor (no explicit comparison or basket tools), but core supermarket-data workflows are complete.
Maintenance
Related MCP Connectors
Live Dutch supermarket prices and promotions (Albert Heijn, Jumbo, Lidl, Aldi and more) for AI.
Turn any shopping list into a ready-to-checkout grocery cart across 26 European supermarkets.
Live prices, deals & optimal multi-stop shopping routes for German grocery & drug stores.
Danish grocery catalog as MCP tools: live offers across all major chains, stores, EAN lookup, stock.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables users to compare prices, track budgets, and find promotional deals across major Dutch supermarkets and drugstores. It supports automated shopping list optimization, meal planning, and price history alerts for stores like Albert Heijn, Jumbo, and Kruidvat.21MIT
- AlicenseNot gradedqualityCmaintenanceMCP server for Dutch supermarkets and drugstores, enabling product search, price comparison, promotions, shopping lists, meal planning, price alerts, and budget tracking via natural language.MIT
- AlicenseAqualityBmaintenanceEnables shopping at Albert Heijn through an AI assistant by searching products, finding bonus deals and recipes, managing a shopping list and delivery order, and reading order history and receipts. It connects to the same API as the AH mobile app and handles login, token storage, and local stdio or remote HTTP transport.37444 npm1Apache 2.0
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants to shop groceries online by searching products, managing carts, viewing orders and delivery slots, and surfacing personalized meal and discount suggestions across multiple European grocery platforms.-