Yappman Data Supermarket Price Snapshots
Read-only supermarket price snapshots (UK basket, AU index). Compilation CC BY 4.0. Not live.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"grocery-price-snapshots": {
"url": "https://yappman-grocery-mcp.blue-bar-ca29.workers.dev/mcp"
}
}
}Remote endpoints
https://yappman-grocery-mcp.blue-bar-ca29.workers.dev/mcpstreamable-httpWhat it can do
Tool inventory
Tools (4)
🟢get_shelf_price_index(market, vintage, recordType, retailer, class)
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.
Input Schema
{
"type": "object",
"properties": {
"market": {
"type": "string",
"enum": [
"uk",
"au"
],
"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."
},
"recordType": {
"type": "string",
"enum": [
"headline",
"retailer",
"class",
"retailer_class",
"retailer_like_for_like",
"subtotal",
"retailer_subtotal"
],
"description": "Only rows of this kind, e.g. \"headline\". Omit for all rows."
},
"retailer": {
"type": "string",
"enum": [
"tesco",
"sainsburys",
"asda",
"aldi",
"coles",
"woolworths",
"aldi_au"
],
"description": "Only rows for this retailer id, e.g. \"tesco\" (UK) or \"aldi_au\" (AU)."
},
"class": {
"type": "string",
"pattern": "^[a-z-]{2,40}$",
"description": "Only rows for this product class id, e.g. \"dairy-eggs\"."
}
},
"required": [
"market"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"title": {
"type": "string"
},
"vintage": {
"type": "string"
},
"publishedAt": {
"type": "string"
},
"revision": {
"type": "integer"
},
"base": {
"type": "string"
},
"notCpi": {
"type": "boolean"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"vintage": {
"type": "string"
},
"publishedAt": {
"type": "string"
},
"revision": {
"type": "integer"
},
"recordType": {
"type": "string"
},
"retailer": {
"type": [
"string",
"null"
]
},
"class": {
"type": [
"string",
"null"
]
},
"level": {
"type": [
"number",
"null"
]
},
"weekOnWeekPct": {
"type": [
"number",
"null"
]
},
"fourWeekPct": {
"type": [
"number",
"null"
]
},
"matched": {
"type": [
"integer",
"null"
]
},
"matchedShare": {
"type": [
"number",
"null"
]
},
"status": {
"type": [
"string",
"null"
]
}
}
}
},
"credit": {
"type": "string"
}
},
"required": [
"market",
"vintage",
"rows",
"credit"
]
}🟢list_index_vintages(market)
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.
Input Schema
{
"type": "object",
"properties": {
"market": {
"type": "string",
"enum": [
"uk",
"au"
],
"description": "uk or au. Example: \"au\"."
}
},
"required": [
"market"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"market": {
"type": "string"
},
"vintages": {
"type": "array",
"items": {
"type": "object"
}
}
},
"required": [
"market",
"vintages"
]
}🟢lookup_basket_prices(eans, products, date, retailers)
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". Static snapshot days, not live. Not for searching by product name, and only the 212 basket products are covered.
Input Schema
{
"type": "object",
"properties": {
"eans": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "string",
"pattern": "^[0-9]{8}$|^[0-9]{12,14}$"
},
"description": "Barcodes, 8, 12, 13 or 14 digits, e.g. [\"5000157024671\"]. Give eans, products or both."
},
"products": {
"type": "array",
"minItems": 1,
"maxItems": 20,
"items": {
"type": "object",
"properties": {
"retailer": {
"type": "string",
"enum": [
"tesco",
"sainsburys",
"asda",
"aldi"
]
},
"retailerProductId": {
"type": "string",
"pattern": "^[A-Za-z0-9._-]{1,128}$"
}
},
"required": [
"retailer",
"retailerProductId"
],
"additionalProperties": false
},
"description": "Retailer product ids, e.g. [{\"retailer\": \"tesco\", \"retailerProductId\": \"254656543\"}]."
},
"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."
},
"retailers": {
"type": "array",
"minItems": 1,
"items": {
"type": "string",
"enum": [
"tesco",
"sainsburys",
"asda",
"aldi"
]
},
"uniqueItems": true,
"description": "Only these retailers, e.g. [\"tesco\", \"asda\"]. Omit for all four. The basket holds no barcodes for Aldi: use products for Aldi."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"date": {
"type": "string"
},
"rows": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"scrapedAt": {
"type": "string"
},
"retailer": {
"type": "string"
},
"retailerProductId": {
"type": "string"
},
"ean": {
"type": "array",
"items": {
"type": "string"
}
},
"price": {
"type": [
"number",
"null"
]
},
"wasPrice": {
"type": [
"number",
"null"
]
},
"loyaltyPrice": {
"type": [
"number",
"null"
]
},
"unitPrice": {
"type": [
"object",
"null"
],
"properties": {
"value": {
"type": "number"
},
"measure": {
"type": "string"
}
}
},
"packSize": {
"type": [
"string",
"null"
]
},
"inStock": {
"type": [
"boolean",
"null"
]
}
}
}
},
"notFound": {
"type": "object",
"properties": {
"eans": {
"type": "array",
"items": {
"type": "integer"
}
},
"products": {
"type": "array",
"items": {
"type": "integer"
}
}
}
},
"credit": {
"type": "string"
}
},
"required": [
"date",
"rows",
"notFound",
"credit"
]
}🟢about_the_data
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.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Output Schema
{
"type": "object"
}Community
Evidence