Prototype · Preview: every server in the official registry, synced every 30 minutes. Sign in with Google to write reviews.Prototype · updated every 30 min
PopNx MCPMCP servers for people who use AI · explained in plain words

UK Supermarkets

by jbeshirversion 1.0.3i★ 1 (Stars for the whole repo)iRuns on your computerRepository ↗
Registry nameio.github.jbeshir/supermarkets-uk-mcp

How to install

What it does

Search and compare grocery prices across UK supermarkets with product details.

  • Connects Runs on your computer
  • Account or key No key needed
  • Category Search & AI memory

Use together with

Skills that teach the AI this kind of work; they work alongside this one

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

by google-research★ 35,6381 skills

Skill · How-to guide

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

by BigBodyCobain★ 11,6051 skills

Skill · How-to guide

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

by gosom★ 8,2361 skills

Skill · How-to guide

Why it ranks here

Lists are ordered by a usage score (out of 100) built from these parts

Popularity0/80GitHub stars or weekly downloads: the larger counts 60, the smaller 20
Freshness12/12Full marks for a release or code change within 30 days
Still answering0/8The cloud endpoint answered at the last check
Usage score12/100

Quality: Passed 3/3 basic checks (shown, not used for ordering) · Momentum: No data yet (Used only on the Trending tab)

Install

Pick the AI app you use, then copy the settings.

Passed 3/3 checks · Runs on your computer

First: which AI do you use?

Pick your app and the steps appear below.

Works with Claude, with some setup first

No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

  1. Download the maker’s installer

    Download the maker’s .mcpb file

    The .mcpb file comes straight from the maker; we do not change it

  2. Double-click the file, then click Install in the Claude desktop app

  3. Try it

    Use UK Supermarkets and tell me what you can do for me, then show me one thing

    ✓ If Claude says it is using UK Supermarkets or shows a UK Supermarkets tool in the answer, you are connected

Menu names checked against Anthropic’s help page on Nov 11, 2026 · your screen may differ slightly by app version

ChatGPT cannot connect UK Supermarkets yet

UK Supermarkets runs on your computer, but ChatGPT can only connect servers that run on the web

What you can do instead

A · Use an app that can connect UK Supermarkets

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

B · Others in Search & AI memory that work with ChatGPT

Picked from the most used in the same category, only ones that connect by address with no key

Claude Code cannot connect UK Supermarkets yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect UK Supermarkets

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Cursor cannot connect UK Supermarkets yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect UK Supermarkets

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

VS Code cannot connect UK Supermarkets yet

The maker only provides an installer for the Claude desktop app

What you can do instead

A · Use an app that can connect UK Supermarkets

  • No key, nothing to install · Only the Claude desktop app (Windows or Mac), not the web or phone

Other apps that use MCP, such as Windsurf, Zed or Gemini CLI, each add servers differently. See how in the app list.

See every app that uses MCP →

JSON settings are under “For developers” below

Stuck? Ask people who use UK Supermarkets💬 Discussion →

At a glance

GitHub starsi
1 (Stars for the whole repo)
This repo holds several MCP listings; its stars count once in rankings
Downloads per weeki
Not on npm/PyPI
Connection
Runs on your computer
Latest versioni
1.0.3
Published to registryi
Oct 27, 2026
Code last changedi
Oct 27, 2026
Maker
jbeshir
Packages
mcpb: …/supermarkets-uk-mcp.mcpb
Registry status
Active

Which apps can use it

Based on how this server connects and on each app’s own docs, checked Nov 10, 2026.

Run on your computer in

ClaudeGooseLM StudioMsty StudioCherry StudioVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

All apps, with pros and cons →

Related guides

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 19, 2026

  • ✓ Pass

    Maker matches the repo

    The registry name was verified with the GitHub account jbeshir, which owns the repo

  • ✓ Pass

    Still maintained

    Code last changed 23 days ago

  • ✓ Pass

    Has a licence

    Uses MIT

  • – Not applicable

    Endpoint responds

    This one runs on your computer; there is no internet endpoint

  • – Not applicable

    Sign-in with OAuth

    Runs on your computer and uses local settings instead

  • … Not checked yet

    No hidden instructions in tool descriptions

    Runs on your computer; we can only read tool lists from internet endpoints

Published vulnerabilities (OSV.dev)

Not checked: only npm and PyPI packages with a version can be checked

What we check → · JSON

Makers: ask for a re-check or report wrong info
For makers: add a badge to your README

If you made this, paste this code into your README. The badge links back to this page.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/jbeshir-supermarkets-uk-mcp.svg)](https://mcp.popnx.com/en/servers/jbeshir-supermarkets-uk-mcp)

Discussion

Ask, share a tip or report that it does not work. Sorted by what people marked helpful.

No posts yet. Be the first to ask or share.

Posts here are written by users, not the PopNx team.

Sign in to post

User reviews

No reviews yet

Sign in to write a review

Compared with others in Search & AI memoryi

  • More stars than 0% of the other 6416 servers in this category
  • Published to the registry more recently than 62% of the other 6416 servers in this category
  • Basic checks equal to or better than 99% of the other 6416 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is UK Supermarkets safe?

It passed 3 of 3 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

The registry does not list a required key, though some servers ask you to sign in on first use.

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed 23 days ago, and the latest version (1.0.3) reached the registry 23 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need MCPB on your computer.

What can I use instead?

In the same category: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Similar alternatives

Same category, other makers, commands already checked. Official ones first, then by stars.

Reading a card:↓ Downloads per weeki★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

by every-appWidely used★ 28.2KUpdated 5 days ago

Runs in the cloud✓ everyapp.com

Exa

Connect AI agents to Exa for web search, content fetching, and multi-step research.

by exa-labsWidely used★ 5.2KUpdated 2 months ago

Runs in the cloud✓ service owner · exa.aiTried by the PopNx team

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

by MicrosoftDocsWidely used★ 2KUpdated 12 months ago

Runs in the cloud✓ service owner · microsoft.comTried by the PopNx team

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

by proxysoulGrowing★ 1.6KUpdated 2 months ago

Runs in the cloud✓ empryo.com
Compared with similar ones
This one
UK Supermarkets
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Runs whereInstalls on your computerRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to installRuns in the cloud, nothing to install
Needs a keyNoNoNoNoNoNo
Add with + in ClaudeNoYesYesYesNoNo
Basic checks3/35/52/44/44/44/4
LicenseMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
PriceNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registryNo cost listed in the registry

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

supermarkets-uk-mcp

An MCP server for searching and comparing grocery prices across 9 UK supermarkets. It provides product search, price comparison, category browsing, and (for Tesco) order history and basket management. Each supermarket is implemented as a pluggable datasource behind a common interface, with the server fanning out concurrent requests across stores and aggregating the results.

Getting Started

Requirements
  • Go 1.27.3+ (to build from source)
  • Chrome, Chromium, or Microsoft Edge — required for Tesco, Asda, and Waitrose (headless browser rendering), and for login to any supermarket. Sainsbury's, Ocado, Morrisons, and the Shopify stores work without a browser.

On Linux, avoid snap-packaged Chromium (Ubuntu's default chromium package). It is known to hang indefinitely — both on graceful CDP tab-close and on OS-level process reaping after a forced kill — when launched as a descendant of certain parent processes (observed running under Claude Desktop's Electron process tree). The hang was 100% reproducible under that setup and never reproduced with the same code against a non-snap Chrome/Chromium build. Install Google Chrome or a non-snap Chromium build instead, and point CHROME_EXEC_PATH at it if it isn't picked up automatically.

Installation

Pre-built binaries are available from Releases.

Install from source:

go install github.com/jbeshir/mcp-servers/supermarkets-uk/cmd/supermarkets-uk-mcp@latest

Or build from the repo root:

make build

A Dockerfile is also provided, based on chromedp/headless-shell so that browser-based stores work out of the box:

docker build -t supermarkets-uk-mcp ./supermarkets-uk
Configuration

No environment variables are required to get started — all supermarkets work without login.

VariableRequiredDescription
CHROME_EXEC_PATHNoPath to the Chrome/Chromium binary to launch. Leave unset to use automatic detection. See the note above about snap-packaged Chromium on Linux.

See Login below for the additional variables that enable interactive login.

Claude Desktop
{

"mcpServers": { "supermarkets-uk": { "command": "/path/to/supermarkets-uk-mcp" } } }

Claude Code
claude mcp add supermarkets-uk /path/to/supermarkets-uk-mcp

Tools

ToolDescription
list_supermarketsList all supported supermarkets with IDs and status
search_productsSearch for products across one or more supermarkets
compare_pricesCompare prices for a product across all supermarkets
get_product_detailsGet detailed product info (price, description, ingredients, nutrition)
browse_categoriesBrowse product categories for a supermarket
get_order_historyGet past order history (Tesco only, requires login)
get_basketGet current shopping basket contents (Tesco only, requires login)
add_to_basketAdd a product to the basket or update its quantity (Tesco only, requires login)
remove_from_basketRemove a product from the basket (Tesco only, requires login)

Supported Supermarkets

SupermarketIDData SourceBrowser Required
TescotescoHTML (headless browser)Yes
Sainsbury'ssainsburysJSON APINo
OcadoocadoServer-rendered HTML (OSP)No
MorrisonsmorrisonsServer-rendered HTML (OSP)No
AsdaasdaAlgolia API (search) + HTML (details)Yes
WaitrosewaitroseHTML (headless browser)Yes
HiYoUhiyouShopify predictive search APINo
Tuk Tuk MarttuktukmartShopify predictive search APINo
MorueatsmorueatsShopify predictive search APINo

Product Information Coverage

Not all supermarkets provide the same level of detail:

FieldTescoSainsbury'sOcadoMorrisonsAsdaWaitroseShopify stores
Name / Price / URLYesYesYesYesYesYesYes
Price per unitYesYesYesYesYesYes--
PromotionsYesYesYesYesYesYes--
DescriptionYesYesYesYesYesYesYes
IngredientsYesYesYesYesYesYes--
NutritionYesYesYesYesYesYes--
Dietary info--------Yes----
Weight------YesYesYesYes

Login

Login is optional and enables personalised results (e.g. local stock, delivery availability), order history, and basket management. It requires running the server locally with a browser available.

To enable login, set _LOGIN=true for each supermarket you want to log in to. On first use, a visible browser window opens for you to complete login manually. Session cookies are cached to disk and reused across restarts. If cookies expire, the server clears them and triggers a fresh login automatically.

Login requires Chrome, Chromium, or Edge for all supermarkets, including those that do not otherwise need a browser. Supermarket sessions tend to expire frequently, so expect to be prompted to log in again regularly.

VariableDescription
TESCO_LOGINEnable Tesco login
SAINSBURYS_LOGINEnable Sainsbury's login
OCADO_LOGINEnable Ocado login
MORRISONS_LOGINEnable Morrisons login
ASDA_LOGINEnable Asda login
WAITROSE_LOGINEnable Waitrose login
SUPERMARKET_COOKIE_DIROverride cookie storage directory (default: OS config dir)

Example with login enabled:

{

"mcpServers": { "supermarkets-uk": { "command": "/path/to/supermarkets-uk-mcp", "env": { "TESCO_LOGIN": "true", "WAITROSE_LOGIN": "true", "SUPERMARKET_COOKIE_DIR": "/home/you/.supermarket-cookies" } } } }

Key Concepts

  • Datasource — A pluggable adapter for a single supermarket. Each datasource implements a common ProductSource interface (search, product details, category browsing) using whatever transport the supermarket requires: JSON API, server-rendered HTML scraping, or headless Chrome rendering.
  • AuthProductSource — An extension of ProductSource that supports session cookie injection and validation. Six of the nine supermarkets implement this interface, allowing logged-in features like personalised results. The three Shopify-based stores are plain ProductSource implementations with no auth support.
  • Client orchestrator — The client.Client type wires together all nine datasources. It manages concurrent fan-out for searches, lazy authentication with session expiry detection, and per-host rate limiting.
  • Auth resolver — A per-supermarket wrapper that handles lazy login. On first use of a login-enabled supermarket, it opens a visible browser window for the user to complete login manually. Session cookies are persisted to disk and reused. If a request returns ErrSessionExpired, the resolver clears the cookies and triggers a fresh login.
  • Shared browser — A single headless Chrome instance (via chromedp) shared across all browser-based datasources. Each request opens a new tab within the shared browser context so that cookies persist between navigations.
  • OSP (Ocado Smart Platform) — Ocado and Morrisons share a common server-rendered HTML structure. A single osp package implements both, parameterised by store-specific config.

Architecture

graph TD

MCP["MCP Client (Claude Desktop, etc.)"] SRV["MCP Server 9 tools"] ORCH["Client Orchestrator concurrent fan-out + auth"]

MCP -->|"stdio JSON-RPC"| SRV SRV --> ORCH

subgraph "Datasource Adapters" direction LR BROWSER["Browser-based Tesco, Asda, Waitrose"] HTML["HTML scraping Ocado, Morrisons"] API["JSON API Sainsburys"] SHOPIFY["Shopify API HiYoU, TukTukMart, Morueats"] end

ORCH --> BROWSER ORCH --> HTML ORCH --> API ORCH --> SHOPIFY

CHROME["Headless Chrome"] BROWSER --> CHROME

External Dependencies

graph LR

SM["supermarkets-uk-mcp"]

SM -->|"Headless Chrome"| TESCO["tesco.com"] SM -->|"Headless Chrome"| ASDA_BR["asda.com"] SM -->|"Headless Chrome"| WAITROSE["waitrose.com"] SM -->|"HTTP + HTML parsing"| OCADO["ocado.com"] SM -->|"HTTP + HTML parsing"| MORR["groceries.morrisons.com"] SM -->|"JSON API"| SAINS["sainsburys.co.uk"] SM -->|"Shopify predictive search API"| SHOPIFY["hiyou.co / tuktukmart.co.uk / morueats.co.uk"]

Data Flow

A search_products call with multiple supermarkets triggers concurrent requests across all targeted stores. Individual store failures are captured per-result rather than failing the entire request.

sequenceDiagram

participant Client as MCP Client participant Server as MCP Server participant Orch as Orchestrator participant Auth as Auth Resolver participant DS as Datasource Adapters participant Ext as Supermarket Sites

Client->>Server: search_products(query, stores) Server->>Orch: SearchAll(query, stores)

par One goroutine per store Orch->>Auth: ensureAuth(tesco) Note over Auth: Lazy login on first use Auth-->>Orch: ready Orch->>DS: Tesco.SearchProducts DS->>Ext: Headless Chrome Ext-->>DS: Rendered HTML and Orch->>DS: Sainsburys.SearchProducts DS->>Ext: JSON API Ext-->>DS: JSON response and Orch->>DS: Ocado.SearchProducts DS->>Ext: HTTP GET Ext-->>DS: Server-rendered HTML end

DS-->>Orch: Parsed products (per store) Orch-->>Server: Combined results Server-->>Client: Formatted tool response

When a logged-in request fails with ErrSessionExpired, the auth resolver clears the cached cookies, opens a browser window for re-login, and retries the request transparently.