{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_we3rhf3n77p5","handle":"basketwatch-mcp","url":"https://wellknown.network/agents/basketwatch-mcp","links":{"self":"https://wellknown.network/agents/basketwatch-mcp/record.json","html":"https://wellknown.network/agents/basketwatch-mcp","markdown":"https://wellknown.network/agents/basketwatch-mcp/record.md","api":"https://wellknown.network/api/v1/agents/basketwatch-mcp","status":"https://wellknown.network/api/v1/agents/basketwatch-mcp/status","claim":"https://wellknown.network/agents/basketwatch-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/basketwatch-mcp/claim.json","badge":"https://wellknown.network/agents/basketwatch-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:basketwatch-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"basketwatch-mcp","summary":"Model Context Protocol server for BasketWatch — Irish grocery data for AI agents","description":"# BasketWatch MCP Server\n\nA [Model Context Protocol](https://modelcontextprotocol.io/) server that\nexposes the **BasketWatch Irish grocery data** API as tools your AI agent\ncan call directly. Works with **Claude Desktop**, **Continue.dev**,\n**Cursor**, and any other MCP-compatible client.\n\n> ~47,000 Irish supermarket SKUs across Aldi, Tesco, SuperValu and Dunnes\n> Stores. Refreshed every Friday at 02:00 UTC. Now queryable by Claude.\n\n## What your agent can do\n\nOnce installed, your agent has 8 grocery-aware tools:\n\n| Tool | What it does |\n|---|---|\n| `status` | Cross-retailer health snapshot — SKU counts, last-scrape dates, run status |\n| `search_products` | Find products by name in one or all stores |\n| `compare_price_across_stores` | One-call comparison across all 4 supermarkets |\n| `get_promotions` | List products currently on offer at a given store |\n| `recent_price_changes` | Week-over-week price movements |\n| `newly_added_products` | New listings in a configurable lookback window |\n| `removed_products` | Delistings / range cuts |\n| `list_products` | Paginated catalogue dump for walking the full assortment |\n\nExample questions your agent can answer:\n\n- *\"Where can I buy Heinz Baked Beans cheapest this week?\"*\n- *\"Build me a €40 weekly grocery list across the 4 supermarkets.\"*\n- *\"Which products got cheaper at Tesco this week?\"*\n- *\"What promotions are running on chocolate at Dunnes right now?\"*\n- *\"Track the price of Brennans bread for the next 12 weeks.\"*\n\n## Install\n\n```bash\npip install basketwatch-mcp\n```\n\nOr from source:\n\n```bash\ngit clone https://github.com/basketwatch/basketwatch-mcp.git\ncd basketwatch-mcp\npip install -e .\n```\n\n## Configuration\n\n| Variable | Default | Purpose |\n|---|---|---|\n| `BASKETWATCH_API_BASE` | (required) | Origin of the BasketWatch API (e.g. `https://basketwatch.fly.dev`) |\n| `BASKETWATCH_API_KEY` | (none) | API key for higher-tier usage. Free-tier limits apply without one |\n| `BASKETWATCH_MCP_DAILY_LIMIT` | `100` | Free-tier cap …","publisher":null,"homepage":"https://github.com/basketwatch/basketwatch-mcp","repository":"https://github.com/basketwatch/basketwatch-mcp","version":"0.1.0","license":"MIT","protocols":["mcp"],"tags":["agent","aldi","claude","dunnes","grocery","ireland","mcp","prices","supermarket","supervalu","tesco"],"pricing":null,"endpoints":[{"url":"pypi:basketwatch-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"commerce.ecommerce","name":"E-commerce Operations","confidence":0.791,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"}],"categories":["commerce","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"basketwatch-mcp","registry":"pypi","observedAt":"2026-09-09T10:29:38.152Z","publishedAt":"2026-05-23T22:29:05.618640Z","latestVersion":"0.1.0"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"basketwatch-mcp","url":"https://pypi.org/project/basketwatch-mcp/","firstSeenAt":"2026-09-09T10:26:41.360Z","fetchedAt":"2026-09-09T10:26:41.360Z","normalizedAt":"2026-09-09T10:26:41.360Z"}]},"firstSeenAt":"2026-09-09T10:26:41.360Z","updatedAt":"2026-09-09T10:29:38.152Z"}