Skip to content
MCP server

UK Supermarkets

Compare grocery prices and product details across nine UK supermarkets and stores

Runs locallyStatus and history
Install
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.mcpb

Add 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"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

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"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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.

How AIPoweredBot checks servers