Read-only UK/AU supermarket price index and UK basket snapshots. CC BY 4.0. Not live prices.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Returns the licence (CC BY 4.0) and credit form, what is not served, the store setting, the published index weeks and the basket date range with its short and missing days. Use it before citing or relying on the other tools.
This tool takes no arguments.
Returns the licence (CC BY 4.0) and credit form, what is not served, the store setting, the published index weeks and the basket date range with its short and missing days. Use it before citing or relying on the other tools.
No arguments.
{
"type": "object",
"properties": {},
"additionalProperties": false
}Returns one published week of the free UK or Australian online shelf-price index (CC BY 4.0): index levels, week-on-week change and matched-product counts by retailer and product class. Use it for "how did posted grocery shelf prices move this week". Not a CPI, not prices paid, no product names. Omit vintage for the latest week; call list_index_vintages for the others.
| Argument | Type | Description |
|---|---|---|
| class | string | Only rows for this product class id, e.g. "dairy-eggs". |
| market* | string | uk or au. Example: "uk". |
| vintage | string | ISO week, e.g. "2026-W42". Omit for the latest published week. |
| retailer | string | Only rows for this retailer id, e.g. "tesco" (UK) or "aldi_au" (AU). |
| recordType | string | Only rows of this kind, e.g. "headline". Omit for all rows. |
{
"type": "object",
"required": [
"market"
],
"properties": {
"class": {
"type": "string",
"pattern": "^[a-z-]{2,40}$",
"description": "Only rows for this product class id, e.g. \"dairy-eggs\"."
},
"market": {
"enum": [
"uk",
"au"
],
"type": "string",
"description": "uk or au. Example: \"uk\"."
},
"vintage": {
"type": "string",
"pattern": "^[0-9]{4}-W[0-9]{2}$",
"description": "ISO week, e.g. \"2026-W42\". Omit for the latest published week."
},
"retailer": {
"enum": [
"tesco",
"sainsburys",
"asda",
"aldi",
"coles",
"woolworths",
"aldi_au"
],
"type": "string",
"description": "Only rows for this retailer id, e.g. \"tesco\" (UK) or \"aldi_au\" (AU)."
},
"recordType": {
"enum": [
"headline",
"retailer",
"class",
"retailer_class",
"retailer_like_for_like",
"subtotal",
"retailer_subtotal"
],
"type": "string",
"description": "Only rows of this kind, e.g. \"headline\". Omit for all rows."
}
},
"additionalProperties": false
}Returns the published weeks (vintages) of the free UK or Australian online shelf-price index, newest first, with publication time, revision and base week. Use it before get_shelf_price_index to pick a week. Not for prices.
| Argument | Type | Description |
|---|---|---|
| market* | string | uk or au. Example: "au". |
{
"type": "object",
"required": [
"market"
],
"properties": {
"market": {
"enum": [
"uk",
"au"
],
"type": "string",
"description": "uk or au. Example: \"au\"."
}
},
"additionalProperties": false
}Returns posted shelf prices from the free UK daily 212-item basket (CC BY 4.0) for up to 20 barcodes (EAN) or retailer product ids, up to one row per retailer for one day: price, was-price, loyalty price, unit price, pack size and stock. Use it for "what did this barcode cost at Tesco, Sainsbury's, Asda or Aldi on a day". Each result row lists its barcodes in `ean`. Static snapshot days, not live. Not for searching by product name; only the 212 basket products are covered.
| Argument | Type | Description |
|---|---|---|
| date | string | Day, e.g. "2026-10-08". Omit for the latest day loaded. |
| eans | array | Barcodes, 8, 12, 13 or 14 digits, e.g. ["5000157024671"]. Give eans, products or both. |
| products | array | Retailer product ids, e.g. [{"retailer": "tesco", "retailerProductId": "254656543"}]. |
| retailers | array | Only these retailers, e.g. ["tesco", "asda"]. Omit for all four. The basket holds no barcodes for Aldi: use products for Aldi. |
{
"type": "object",
"properties": {
"date": {
"type": "string",
"pattern": "^[0-9]{4}-[0-9]{2}-[0-9]{2}$",
"description": "Day, e.g. \"2026-10-08\". Omit for the latest day loaded."
},
"eans": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9]{8}$|^[0-9]{12,14}$"
},
"maxItems": 20,
"minItems": 1,
"description": "Barcodes, 8, 12, 13 or 14 digits, e.g. [\"5000157024671\"]. Give eans, products or both."
},
"products": {
"type": "array",
"items": {
"type": "object",
"required": [
"retailer",
"retailerProductId"
],
"properties": {
"retailer": {
"enum": [
"tesco",
"sainsburys",
"asda",
"aldi"
],
"type": "string"
},
"retailerProductId": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,128}$"
}
},
"additionalProperties": false
},
"maxItems": 20,
"minItems": 1,
"description": "Retailer product ids, e.g. [{\"retailer\": \"tesco\", \"retailerProductId\": \"254656543\"}]."
},
"retailers": {
"type": "array",
"items": {
"enum": [
"tesco",
"sainsburys",
"asda",
"aldi"
],
"type": "string"
},
"minItems": 1,
"description": "Only these retailers, e.g. [\"tesco\", \"asda\"]. Omit for all four. The basket holds no barcodes for Aldi: use products for Aldi.",
"uniqueItems": true
}
},
"additionalProperties": false
}