# UK Supermarkets

> UK Supermarkets is an open-source MCP server for e-commerce. Compare grocery prices and product details across nine UK supermarkets and stores. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows, self-hosted
- **Repository:** https://github.com/jbeshir/mcp-servers/tree/HEAD/supermarkets-uk
- **MCP Registry name:** io.github.jbeshir/supermarkets-uk-mcp
- **Categories:** [e-commerce](https://ai-powered.com/categories/e-commerce), [food and drink](https://ai-powered.com/categories/food-and-drink)
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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"
      ]
    }
  }
}
```

## Tools

- `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.

## 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.

## Alternatives

- [ChatGPT for Amazon](https://ai-powered.com/mcp/chatgpt_for_amazon): ChatGPT for Amazon is a freemium MCP server for marketing.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [Ebid](https://ai-powered.com/mcp/ebid): Ebid is a freemium MCP server for e-commerce.
- [Menus Recommender](https://ai-powered.com/mcp/menus-recommender): Menus Recommender is an open-source MCP server for food and drink.
- [Foodish](https://ai-powered.com/mcp/foodish): Foodish is a freemium MCP server for food and drink.
- [Zovo Product Recall Check](https://ai-powered.com/mcp/zovo-product-recall-check): Zovo Product Recall Check is an MCP server for e-commerce.
- [Trackkr MCP Server — Smart Lockerless Parcel Management](https://ai-powered.com/mcp/trackkr-mcp-server-smart-lockerless-parcel-management): Trackkr MCP Server — Smart Lockerless Parcel Management is an MCP server for e-commerce.
- [Openfoodfacts](https://ai-powered.com/mcp/openfoodfacts): Openfoodfacts is a freemium MCP server for food and drink.

---
Source: https://ai-powered.com/mcp/uk-supermarkets
