Model Context Protocol server for BasketWatch — Irish grocery data for AI agents
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"basketwatch-mcp","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# BasketWatch MCP Server A [Model Context Protocol](https://modelcontextprotocol.io/) server that exposes the **BasketWatch Irish grocery data** API as tools your AI agent can call directly. Works with **Claude Desktop**, **Continue.dev**, **Cursor**, and any other MCP-compatible client. > ~47,000 Irish supermarket SKUs across Aldi, Tesco, SuperValu and Dunnes > Stores. Refreshed every Friday at 02:00 UTC. Now queryable by Claude. ## What your agent can do Once installed, your agent has 8 grocery-aware tools: | Tool | What it does | |---|---| | `status` | Cross-retailer health snapshot — SKU counts, last-scrape dates, run status | | `search_products` | Find products by name in one or all stores | | `compare_price_across_stores` | One-call comparison across all 4 supermarkets | | `get_promotions` | List products currently on offer at a given store | | `recent_price_changes` | Week-over-week price movements | | `newly_added_products` | New listings in a configurable lookback window | | `removed_products` | Delistings / range cuts | | `list_products` | Paginated catalogue dump for walking the full assortment | Example questions your agent can answer: - *"Where can I buy Heinz Baked Beans cheapest this week?"* - *"Build me a €40 weekly grocery list across the 4 supermarkets."* - *"Which products got cheaper at Tesco this week?"* - *"What promotions are running on chocolate at Dunnes right now?"* - *"Track the price of Brennans bread for the next 12 weeks."* ## Install ```bash pip install basketwatch-mcp ``` Or from source: ```bash git clone https://github.com/basketwatch/basketwatch-mcp.git cd basketwatch-mcp pip install -e . ``` ## Configuration | Variable | Default | Purpose | |---|---|---| | `BASKETWATCH_API_BASE` | (required) | Origin of the BasketWatch API (e.g. `https://basketwatch.fly.dev`) | | `BASKETWATCH_API_KEY` | (none) | API key for higher-tier usage. Free-tier limits apply without one | | `BASKETWATCH_MCP_DAILY_LIMIT` | `100` | Free-tier cap …
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.