About shelfatlas-catalog
shelfatlas-catalog is an MCP server for querying Danish grocery products, offers, chains, and stores. It provides live price comparisons and product lookup by name or EAN, with approved community stock signals where available.
Key features
- 01Product search by name and EAN
- 02Live offer search and price comparison
- 03Nearest-store geographic search
- 04Retail chain and store listings
- 05Approved community stock signals
Use cases
- 01Find the lowest current price for a product
- 02Look up an item using its EAN-13 barcode
- 03Find nearby grocery stores
- 04Check offer prices and validity periods
MCP support
Exposes grocery catalog tools to MCP clients over Streamable HTTP or a local stdio server. Tool calls require an API key.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://api.shelfatlas.com/api/v1/mcpclaude mcp add --transport http slambertdk-shelfatlas-catalog https://api.shelfatlas.com/api/v1/mcp{"mcpServers":{"slambertdk-shelfatlas-catalog":{"type":"http","url":"https://api.shelfatlas.com/api/v1/mcp"}}}Open in Cursor{"servers":{"slambertdk-shelfatlas-catalog":{"type":"http","url":"https://api.shelfatlas.com/api/v1/mcp"}}}Open in VS Code{"mcpServers":{"slambertdk-shelfatlas-catalog":{"type":"http","url":"https://api.shelfatlas.com/api/v1/mcp"}}}{"mcpServers":{"slambertdk-shelfatlas-catalog":{"serverUrl":"https://api.shelfatlas.com/api/v1/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://api.shelfatlas.com/api/v1/mcpAuth requiredTools
Details
From the project READMEShelfAtlas MCP server
Danish grocery catalog and shelf data as MCP tools. Ask "where is Pepsi Max
cheapest right now?" and get live, structured answers: current offers across
every major Danish chain, nearest-store geo search, product name and EAN
lookup, and a purpose-built find_cheapest_offers tool. Community shelf-stock
signals are included where approved, with confirmation counts.
- Endpoint:
https://api.shelfatlas.com/api/v1/mcp(Streamable HTTP) - Auth:
Authorization: Bearer sa_live_<your-key>— create a free key at https://app.shelfatlas.com - Docs: https://shelfatlas.com/docs (tools, quotas, error codes)
Tools
| Tool | What it answers |
|---|---|
search_products | Resolve a product name to id + EAN before calling other tools |
get_product_by_ean | Look up a product by EAN-13 barcode |
find_cheapest_offers | "Where is this product cheapest right now?" — live offers, cheapest first, chain resolved |
search_catalog_offers | Catalog offers with price and validity window (live-only by default; chain/EAN/product filters) |
get_stores | Paginated store list, or nearest-first geo search |
list_chains | All retail chains (id, slug, name) |
Claude Desktop
Claude Desktop reaches remote servers through mcp-remote:
{
"mcpServers": {
"shelfatlas": {
"command": "npx",
"args": ["-y", "mcp-remote", "https://api.shelfatlas.com/api/v1/mcp"],
"env": {
"MCP_REMOTE_HEADER_AUTHORIZATION": "Bearer sa_live_<your-key>"
}
}
}
}
Clients with native Streamable HTTP support connect directly to the endpoint
with the Authorization header.
Run locally (stdio)
For clients that only speak stdio, this repository is also a small local server that serves the hosted tools over stdio (Node.js 20+):
git clone https://github.com/SlambertDK/shelfatlas-mcp && cd shelfatlas-mcp
npm ci
SHELFATLAS_API_KEY=sa_live_<your-key> node index.js
Or with Docker: docker build -t shelfatlas-mcp . and
docker run -i --rm -e SHELFATLAS_API_KEY=sa_live_<your-key> shelfatlas-mcp.
Listing the tools works without a key; calling them needs SHELFATLAS_API_KEY.
server.json is the manifest for the official MCP registry.
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.