BasketWatch
Server Details
Irish grocery prices at Aldi, Tesco, SuperValu, Dunnes and Lidl: compare, baskets, offers, history
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- BasketWatch
TDQS
Scored across 17 tools
Most tools have a clearly distinct scope, and the descriptions explicitly separate the easily-confused pairs (compare_prices vs compare_price_across_stores, find_products vs search_products, recent_price_changes vs price_movements vs get_price_history). The four product-finding/price-comparison tools still sit close together, so an agent must read descriptions carefully to avoid misselection.
Names are uniformly snake_case and mostly follow a verb_noun or noun_phrase pattern (search_products, get_price_history, compare_prices, price_basket_over_time). A few deviate into bare noun/adjective phrases (best_deals, status, price_movements), but the overall convention is readable and predictable.
17 tools is slightly above the comfortable middle band but each maps to a distinct analytical task (deals, comparison, history, promotions, basket, delistings, credits, freshness). No tool appears redundant enough to be filler.
The surface covers the full lifecycle: discovery, price comparison, history, promotions, basket costing over time, barcode lookup, new/removed products, and account/freshness meta-tools. Minor gaps exist (no saved watchlists, price alerts, or store/category enumeration), but agents can work around these with existing searches.
Available Tools
17 toolsbest_dealsBest real deals todayARead-onlyIdempotentInspect
Today's real deals at Aldi, Tesco, SuperValu, Dunnes Stores and Lidl: offers at the lowest price on record for that product at that shop, or the first offer it has ever had. Each is measured against the product's own price history, not the shop's was price, so a recurring or long-running price does not count as a deal.
The biggest saving comes first, against the usual price or the price it typically sold at, whichever is less, so a product that is usually on offer does not lead. By that saving, the shops take turns among deals that save alike, so one shop does not fill the top of the list, and no deal comes ahead of one that saves more than twice as much. Every promotion on sale is judged, so this covers them all, and offset reaches every deal. Covers food, drinks, alcohol, household, baby and pet products unless another aisle is named. Tobacco, infant formula and medicines are never included.
Returns {"as_of", "note", "total", "deals"}. total counts every deal for this search, across all pages, and next_offset is the next page's offset, missing on the last page. Each deal has name, store, pack, you_pay, regular_price, saving_eur, saving_pct, card_needed, buy_quantity, offer_ends, url and category, and the record behind it: kind, lowest_since, low_before, low_before_date, offer_start, run_start, days_on_offer, started_today, cut_today, yesterday_price, back_after_days, typical_price, offer_share and abv. started_today is true only for an offer that began on the collection day; an offer running for weeks whose price fell that day has cut_today instead, and offer_start says since when it has been on offer. One credit per deal returned.
Inputs: limit, query, store, offset, +1 more. Returns: hint, note, as_of, deals, +4 more
check_creditsYour credit balanceARead-onlyIdempotentInspect
How many BasketWatch credits the signed-in account has left, and when they expire. Free to call. One credit is one record returned.
Inputs: no named parameters. Returns: plan, credits, metered, expiring, +3 more
compare_price_across_storesEach shop's own matches for a product nameARead-onlyIdempotentInspect
Raw per-store search results for a product name at all five supermarkets: every matching line at each store, including other pack sizes, without matching the same product across stores, so its rows are not like for like.
stores is keyed by store, each shop's closest matches first; total_by_store is how many each has in all; as_of is the day the prices are from. Each product returned costs one credit, up to limit_per_store at each of the five stores.
Inputs: query (required), limit_per_store. Returns: hint, as_of, query, errors, +3 more
compare_pricesWhere is a product cheapestARead-onlyIdempotentInspect
Find where a product is cheapest right now. Matches the same product at Aldi, Tesco, SuperValu, Dunnes Stores and Lidl and returns each store's current price side by side, with unit prices, offers and member prices (Tesco Clubcard, SuperValu Real Rewards, Lidl Plus). It answers for one product a call. To list the products matched at several stores, leave out query and set min_stores, e.g. min_stores=5 for every product matched at all five. Free: no BasketWatch account needed.
total is how many matched products the search found in all. cheapest_match is the cheapest product of the kind asked for, by shelf price; matches lists the closest matches first, not the cheapest, so the first of them is not the cheapest. In each match, prices is keyed by store; cheapest_store goes by shelf price and cheapest_store_with_card by the loyalty-card price where a shop has one. unit_price is in the shop's own measure (unit_basis); price_per_kg or price_per_litre is the same figure per kilo or per litre. A store missing from "prices" did not have that product in its online range today and may still sell it in store: say "not found online", not that the store lacks it. offer_ends is the last day an offer applies (Irish time): say when an offer ends, as online orders are priced for the delivery or collection day.
Inputs: limit, query, min_stores. Returns: hint, as_of, query, total, +3 more
find_productsFind products by ingredients, nutrition, quality mark, offers or priceARead-onlyIdempotentInspect
Find products that meet ingredient, nutrition, alcohol or offer conditions, optionally sorted. For questions like "biscuits without palm oil", "nut-free snacks at Tesco", "vegan chocolate", "cereal with the least sugar", "high protein yoghurt", "bread with the fewest ingredients", "alcohol-free beer", "low salt soup" or "cheapest olive oil at Aldi". Fibre and saturated fat are not recorded. quality_mark finds products by mark (Bord Bia, organic, free range), with or without a query.
A search is for one kind of product: every word of query has to be in a product's name, so several kinds in one query ("lentils chickpeas beans") match nothing. A search on price or offers alone returns short rows: name, pack, shop, shelf, price, offer and unit price (unit_price in the shop's own measure, price_per_kg or price_per_litre the same figure per kilo or per litre). A search with an ingredient, nutrition, additive, origin or strength condition, or sorted on one, returns each product's label as well: nutrition, ingredients, ingredient count, allergy advice and where they came from. detail chooses either for any search.
With no store, results alternate across the stores (each store's best match, then each store's next), and matched_by_store gives each store's full count: the first row is one store's best, and the best of a kind across the stores is among each store's first rows. The counts add up: of_kind, the products that are the kind searched for, is matched + left_out_unknown + left_out_failed_filters + left_out_partly_from_origin + left_out_may_contain, and "N of M" is matched of of_kind.
A product whose ingredient list or nutrition is not on record, or whose ingredient list on record is incomplete, is left out, never assumed to pass: left_out_unknown counts them, left_out_by_reason gives the reasons, and caveats lists known gaps (Aldi's own ingredient lists are often cut short, so an Aldi product is offered as free from something only when its full list comes from the same barcode at Tesco, SuperValu or Dunnes). Claims printed in a product's NAME, such as "gluten free", "lactose free", "alcohol free" or "vegan", are matched through query; exclude_ingredients also checks the ingredients. Alcohol strength is recorded for most SuperValu, Dunnes and Tesco drinks but few at Aldi or Lidl; "alcohol free" and "0.0" in query match drinks named that way.
Answers come from the ingredient lists and nutrition the retailers publish. Where a retailer gives no list, it may come from the same barcode at another retailer or from Open Food Facts (ingredients_source); an Open Food Facts list is never used to show a product is free from something. "Free from" means none of the listed ingredients names it; not every "may contain" warning is covered. Results that show ingredients or nutrition carry a note that this is information only. Each product returned costs one credit. When a search excludes an allergen, every product carries allergy_check. Show that line with every product you mention, word for word.
Inputs: limit, query, store, detail, +18 more. Returns: hint, note, as_of, caveats, +17 more
get_price_historyPrice historyARead-onlyIdempotentInspect
A product's recorded daily prices over a date range. BasketWatch has kept every night's price at Aldi, Tesco, SuperValu and Dunnes Stores since May 2026 and at Lidl since 17 October 2026, and, with with_nutrition_and_ingredients, each day's nutrition per 100g or 100ml and ingredients list as the retailer's own data stated them, kept since 16 October 2026: for questions like "has the sugar in Frosties changed".
Takes product ids (as returned in product results; an Aldi id has no store prefix, and "aldi:" in front of one is accepted) or a query; with a query, the closest matching product at each shop is looked up first, one a shop, so a month of days fits whole, and each row names the product it is for. A range returns one row per product per day, and each row costs one credit; with from_date equal to to_date, one day's price is returned. One credit per row comes to about 31 for one product for a month and about 155 for a product at five shops, and a look-up by name adds one for each shop that has the product.
Every product gets the same days. When products x days would pass the row limit, the range is shortened to its most recent days for all of them and note says so; ids with no price in the range are listed in not_found.
Returns rows (id, name, store, scrape_date, price, unit_price, unit_basis, clubcard_price, offer_text, was_price), the days covered, not_found, note.
Inputs: limit, query, store, to_date, +3 more. Returns: note, rows, credits, to_date, +3 more
get_product_detailsNutrition, ingredients and product detailsARead-onlyIdempotentInspect
Nutrition per 100g or 100ml (energy, fat, carbohydrate, sugars, protein, salt), the ingredients list as printed (allergens included), how many ingredients it lists, country of origin, a quality mark the pack shows (Bord Bia Quality Assured), alcohol strength, pack size, description and today's price, for particular products.
Products are looked up by product id (store-prefixed, as returned in product results), by the retailer's own item numbers (skus with store, as printed on its receipts), or by name (query). ingredients_incomplete marks an ingredient list on record that is cut short, which cannot show that an ingredient is absent. A product looked up by id or item number answers even after it has left the shop's range: in_range_today false marks one, and its price is then the last one recorded (price_date), not today's. Ids with no product on record are listed in not_found. Results carry a note that nutrition and ingredients are for information only. Each product returned costs one credit.
Inputs: skus, limit, query, store, +1 more. Returns: hint, note, credits, products, +1 more
get_promotionsEverything on offer at one shopARead-onlyIdempotentInspect
List products currently on promotion at a given supermarket, the biggest saving the shop states first. Every promotion can be reached: each call returns one page, and offset moves through the whole list. These are the shop's own offers, as it states them, on the products it still lists. Aldi runs no multibuys or member prices: its list is the price cuts and offers its own site shows.
Returns offer label (e.g. "3 for €5", "SAVE €0.75"), was-price, validity window, offer_ends (the last day the offer applies, Irish time), and where applicable Tesco Clubcard prices, SuperValu Real Rewards prices, Dunnes member offers or Lidl Plus prices (scan the Lidl Plus app at the till). next_offset is the next page's offset, and is missing on the last page. Each offer returned costs one credit.
Inputs: store (required), limit, offset. Returns: hint, as_of, store, offset, +3 more
lookup_barcodeLook up products by barcodeARead-onlyIdempotentInspect
Find the products carrying one or more barcodes (GTIN, EAN or UPC) at Aldi, Tesco, SuperValu, Dunnes Stores and Lidl in one call: what a scanned or printed code is, and its price at each shop that lists it. Needs a signed-in BasketWatch account.
Returns products (each with its store, matched_barcodes: which of the codes asked for it carries, name, brand, pack_size and price), not_found and invalid. One credit per barcode found, however many retailers stock it; codes with no match cost nothing.
Inputs: codes (required), store, include_copy. Returns: credits, invalid, matched, products, +1 more
newly_added_productsNewly listed products at one shopARead-onlyIdempotentInspect
Products newly listed at a supermarket within a configurable lookback window: range additions and new launches, each with first_seen, the day it appeared. more is true when the page is full, so there may be more. Each product returned costs one credit.
Inputs: store (required), limit, days_back. Returns: hint, more, as_of, query, +8 more
price_basketPrice a shopping list or receiptARead-onlyIdempotentInspect
Price a whole shopping list, or every line of a grocery receipt (up to 100 lines in one call), at Aldi, Tesco, SuperValu, Dunnes Stores and Lidl: each item matched to the same product at every store, the cheapest store for each item, each store's basket total, and a cheaper product of the same kind (often own-label) where one exists.
Each line takes name (plain words with brand and size, e.g. "avonmore fresh milk 2l"; receipt abbreviations such as "AVNMR FRSH MLK 2L" match poorly) and optionally sku (the retailer's item number as printed on its receipts; the name is used when the number is not found), barcode, store, quantity, and paid (the line total, which gives the saving against what was paid). Irish product names say "low fat milk" for what the UK calls "semi skimmed". Bags, deposits, discounts and totals are not products.
Returns, per line, the match and matched_by (sku, barcode or name), the cheapest store and price, a cheaper alternative with its pack size and, for a receipt, price_at_store_bought; then each store's total with its items_missing, cheapest_complete_store, mix_and_match_total and not_found. A store's total covers only the lines found in its online range, so a total with items_missing is a smaller basket, not a cheaper shop. Prices are each retailer's online shelf price from the overnight collection; in-store prices can differ. Member prices (Tesco Clubcard, SuperValu Real Rewards, Lidl Plus) are reported separately. Each matched item costs one credit; items not found are free.
Inputs: items (required), store. Returns: note, as_of, items, credits, +11 more
price_basket_over_timeWhat a basket cost on an earlier dateARead-onlyIdempotentInspect
How the cost of the same basket changed between two dates, at the store it was bought from: each product's price on both dates, whether it was on promotion, the basket total on each date, and the products that moved it. BasketWatch has recorded every product's price every night since May 2026 (Lidl's since 17 October 2026). Up to 100 lines per call; each line takes name, sku (the retailer's printed item number, with the line's words in name), barcode, store and quantity.
change_pct is the change in what the basket cost (promotions included); shelf_change_pct is regular prices only, so the gap between the two is promotions starting or ending, not price rises. biggest_rises and biggest_falls list the lines that moved most; pack_changed marks a product whose pack size changed, confirmed over three days of records (a smaller pack at the same price is a hidden rise). Lines in not_compared were not found, or not sold on one of the dates.
Each product compared costs one credit.
Inputs: items (required), from_date (required), store, to_date. Returns: note, items, change, credits, +12 more
price_movementsHow a kind of product's prices movedARead-onlyIdempotentInspect
How a whole category's prices moved between two dates, in one call: the biggest regular-price rises and falls, promotions starting and ending, member price changes (Tesco Clubcard, SuperValu Real Rewards, Lidl Plus) and pack-size changes, kept apart, with a summary over every product compared (average and median shelf change, counts of rises and falls) overall and per store.
shelf_rise and shelf_fall are changes to the regular price; promotion_started and promotion_ended are changes in what was paid while the regular price stayed the same (a product at 18 euro on promotion and 23 euro after is a promotion ending, not a 27.8% price rise); loyalty_change is a member price moving; pack_change is the same product in a different pack size, confirmed over three days of records (a smaller pack at the same price is a hidden rise); was_price_change is an offer running at both dates while only its "was" price moved, kept out of the shelf figures because nobody paid it. Averages are geometric, so a half-price offer starting and ending cancel out; average_member_paid_change_pct uses member prices where they apply.
Each mover returned costs one credit; the summaries are free.
Inputs: from_date (required), group, kinds, limit, +5 more. Returns: note, movers, credits, summary, +3 more
recent_price_changesYesterday to today at one shopARead-onlyIdempotentInspect
Price movements at one supermarket between the latest nightly snapshot and the previous one: shelf price rises and falls with old price, new price and % change, and promotions starting or ending listed separately (an offer ending is not a price rise). It covers those two snapshots only. The lists' _total fields say how many changed in all. Each product returned costs one credit.
Inputs: store (required), limit. Returns: The /changes payload. Shelf moves, promotions and loyalty-card changes are deli…
removed_productsProducts one shop stopped listingARead-onlyIdempotentInspect
Products that have disappeared from a supermarket's catalogue: delistings and range cuts, each with last_seen, the last day it was listed, and last_price. A product counts as removed once it has been off the shop's site for 8 days (3 at Lidl, whose whole range is read every night), so the window runs from days_back days ago to that many days ago and never covers the last days. A product missing online may still be sold in store: it is no longer listed online, which is not the same as discontinued. more is true when the page is full, so there may be more. Each product returned costs one credit.
Inputs: store (required), limit, days_back. Returns: hint, more, as_of, query, +8 more
search_productsSearch products by nameARead-onlyIdempotentInspect
Search products by name across one or all Irish supermarkets: each shop's closest matches for the words, for a product that can be named ("kerrygold butter"). Matches on the name only: no ingredient, nutrition or offer filters, and no price sorting.
The answer has total (every match, with total_by_store when all five shops are searched) and as_of, the day the prices are from; when nothing matches, hint says which word no product has. unit_price is in the shop's own measure (unit_basis); price_per_kg or price_per_litre is the same figure per kilo or per litre. A row marked removed has left the shop's online range: its price is its last one, of the day in its scrape_date. Each product returned costs one credit.
Inputs: query (required), limit, store. Returns: hint, more, as_of, query, +8 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
UK supermarket prices across 13 stores: price items and lists, see history, save lists, set alerts.
Live prices, specials and unit prices from Coles, Woolworths, ALDI Australia and Woolworths NZ.
Live Australian grocery prices from Woolworths, Coles, Aldi and Harris Farm.
Dutch supermarket deals and regular prices (Albert Heijn, Jumbo, Lidl...): where it's cheapest.
Related MCP Servers
- AlicenseAqualityBmaintenanceMCP server for Danish grocery stores with home delivery: nemlig.com, BilkaToGo and REMA 1000. It searches offers, compares a whole basket across stores and fills the cheapest cart, but never orders or pays.142,257 PyPI152MIT
- 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
- FlicenseNot gradedqualityDmaintenanceEnables users to compare and get recommendations across multiple supermarket products, combining curated specifications with realtime price and review lookups.-
- AlicenseBqualityBmaintenanceEnables searching products, browsing weekly offers and recipes, and comparing a shopping list across nemlig.com and BilkaToGo, including fees and delivery slots. It can fill the online basket in the cheaper store, but cannot place orders or make payments.25MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.