UK Supermarkets
Compare grocery prices and product details across nine UK supermarkets and stores
- Pricing
- Open source
- Platforms
- CLI, Linux, macOS
- Runs
- Locally
- Version
- 1.0.3
- Listing updated
- today
Similar MCP servers
About UK Supermarkets
UK Supermarkets is an open-source MCP server for e-commerce. It runs locally on your machine and is started by your AI client.
This server fans a product search out to nine UK stores at once and aggregates the results: Tesco, Sainsbury's, Ocado, Morrisons, Asda, Waitrose and three Shopify-based shops. Each store is a pluggable datasource behind a common interface, using a JSON API, server-rendered HTML or headless Chrome depending on the retailer.
Detail varies by store. Most return price, unit price, promotions, ingredients and nutrition; dietary info appears only for Asda, and the Shopify stores give name, price, description and weight. Tesco, Asda and Waitrose need Chrome, Chromium or Edge for rendering. On Linux the README warns against snap-packaged Chromium because it can hang.
No configuration is required, as every store works without login. Optional login adds personalised results, and for Tesco order history and basket management, using a visible browser window you complete manually.
Install
Run in a terminal
claude mcp add supermarkets-uk-mcp -- npx -y https://github.com/jbeshir/mcp-servers/releases/download/supermarkets-uk-v1.0.3/supermarkets-uk-mcp.mcpbAdd to claude_desktop_config.json
{
"mcpServers": {
"supermarkets-uk-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/jbeshir/mcp-servers/releases/download/supermarkets-uk-v1.0.3/supermarkets-uk-mcp.mcpb"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"supermarkets-uk-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/jbeshir/mcp-servers/releases/download/supermarkets-uk-v1.0.3/supermarkets-uk-mcp.mcpb"
]
}
}
}Add to .vscode/mcp.json
{
"servers": {
"supermarkets-uk-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"https://github.com/jbeshir/mcp-servers/releases/download/supermarkets-uk-v1.0.3/supermarkets-uk-mcp.mcpb"
]
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"supermarkets-uk-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/jbeshir/mcp-servers/releases/download/supermarkets-uk-v1.0.3/supermarkets-uk-mcp.mcpb"
]
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"supermarkets-uk-mcp": {
"command": "npx",
"args": [
"-y",
"https://github.com/jbeshir/mcp-servers/releases/download/supermarkets-uk-v1.0.3/supermarkets-uk-mcp.mcpb"
]
}
}
}Using several servers? Build one config file with the MCP config generator.
Tools this server provides (9)
Taken from the project documentation; the running server may differ.
- list_supermarkets
- Lists supported supermarkets with IDs and status.
- search_products
- Searches products across supermarkets.
- compare_prices
- Compares a product's price across stores.
- get_product_details
- Returns price, description, ingredients and nutrition.
- browse_categories
- Browses a store's categories.
- get_order_history
- Returns past Tesco orders.
- get_basket
- Returns the Tesco basket.
- add_to_basket
- Adds or updates a Tesco basket item.
- remove_from_basket
- Removes a Tesco basket item.
What it does
- Cross-store search
- Searches several supermarkets concurrently.
- Price comparison
- Compares one product across all stores.
- Product details
- Returns price, description, ingredients and nutrition.
- Category browsing
- Browses a store's product categories.
- Tesco basket
- Reads and changes the basket after login.
- Order history
- Lists past Tesco orders after login.
- Per-host rate limits
- Throttles requests to each retailer.
Good for
- Find the cheapest supplier of a grocery item
- Check ingredients or nutrition before buying
- Compare promotions across stores
- Add items to a Tesco basket from chat
- Review past Tesco orders
Pricing
Open source
Free; run locally
UK Supermarkets FAQ
Do I need to log in?
No. All supermarkets work without login; login only adds personalised results, order history and baskets.
Which stores are covered?
Tesco, Sainsbury's, Ocado, Morrisons, Asda, Waitrose, HiYoU, Tuk Tuk Mart and Morueats.
Is a browser required?
For Tesco, Asda and Waitrose, and for any login. Other stores work without one.
Which basket features exist?
Order history and basket management are Tesco only and need login.
Is UK Supermarkets free?
Yes. UK Supermarkets is open source, so you can use and self-host it for free.
How do I add UK Supermarkets to Claude Code?
Run this command in your terminal: claude mcp add supermarkets-uk-mcp -- npx -y https://github.com/jbeshir/mcp-servers/releases/download/supermarkets-uk-v1.0.3/supermarkets-uk-mcp.mcpb
What are the best alternatives to UK Supermarkets?
The closest alternatives to UK Supermarkets are ChatGPT for Amazon, O'So MCP Server for PrestaShop, Ebid, Menus Recommender and Foodish.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.
