The European Grocery Price
& Inventory API.
Real-time prices, catalogue, and stock data across European retailers, plus a directory of 13,600+ physical store locations - accessible via REST API and Model Context Protocol.
- countries·- products·updated -
$ curl -H "X-API-Key: $MEALCP_API_KEY" \
"api.mealcp.com/v1/search?q=milk&country=GB&page_size=1"HTTP/1.1 200 OK
{
"query": "milk",
"found": 862,
"page": 1,
"page_size": 1,
"hits": [
{
"id": "rp_01jds8v2kqn4hbtz0a6yc5emxw3gro",
"name": "Tesco British Semi Skimmed Milk 2 Litres",
"retailer_slug": "tesco-uk",
"latest_price": 1.85,
"latest_unit_price": 0.93,
"currency": "GBP"
}
]
}
$ Beta closed
Beta signups are closed and new keys are on pause until launch. The launch date will be announced on Discord first.
Join Discord for the launch dateExisting beta keys keep working - support, quickstart help, and the changelog live there too.
Where we have data, right now
Live coverage of the MealCP food & grocery catalogue across European markets. Brighter countries have more products indexed; the rest are on the roadmap.
European Supermarket and Grocery Catalogue Coverage
MealCP indexes grocery retail pricing, product catalogues, and inventory data across European countries including the United Kingdom, Austria, Belgium, Finland, Greece, Hungary, and the Netherlands. Live data coverage refreshes daily from major supermarket chains and is accessible via the /v1/coverage REST API endpoint. A physical store directory covering 13,600+ supermarket locations across 11 retailers is available via the /v1/stores endpoint, with retailer, country, city, and nearest-store search.
Retailers coming soon
The grocery shops we're planning to index next, grouped by country. Countries go live as integrations land - this list evolves as we add sources.
Frequently asked questions
Everything you need to know about the API, data sources, update frequency, and AI integrations.
What data does MealCP provide?
MealCP provides real-time supermarket product names, brands, package sizes (quantity and unit), current prices, unit-normalized prices (e.g. EUR/kg, HUF/l), 3-level category paths, dietary and allergen tags, historical price observation timestamps, and a physical store directory with addresses, coordinates, and nearest-store search.
How frequently are grocery prices updated?
Product catalogues and prices are refreshed daily from automated nightly retailer update runs across all supported supermarket chains.
How does the Model Context Protocol (MCP) server work?
The standalone mealcp-mcp package runs locally as a subprocess via uvx mealcp-mcp. It exposes tools like search_products and get_price_history to AI clients such as Claude Desktop, Cursor, and opencode over stdio.
Which European countries and supermarket chains are supported?
Prices are indexed across Austria (BILLA), Belgium (Colruyt), Finland (S-Kaupat), Great Britain (ASDA, Morrisons, Sainsbury’s, Tesco, Waitrose), Greece (AB), Hungary (Auchan, Lidl, Tesco), and the Netherlands (Jumbo, PLUS), with continuous rollouts. Store locations additionally cover France (Carrefour). Check the live coverage map above or the /v1/coverage endpoint.
Can I find physical supermarket locations?
Yes. GET /v1/stores returns the physical store directory: 13,600+ locations across 11 retailers in Austria, Belgium, Finland, France, Great Britain, and the Netherlands. Filter by retailer, country, or city, or use the near-me search (?near=lat,lon&radius_km=5) to get the nearest stores with distance in kilometres. Store lookups are free and cost no credits.
How much does the API cost? Is there a free tier?
The coverage, category, and tag endpoints are public - you can explore them without signup or a key. Search, price, and store endpoints require an API key. The beta is closed to new signups and keys are no longer issued, but existing beta keys keep working - and the launch date, along with launch-day key access, will be announced on Discord first.
When does MealCP launch?
The public launch date hasn't been announced yet, and it will be posted first in our Discord alongside launch-day key access. Join the Discord to get the date the moment it drops.