io.github.SlambertDK/shelfatlas-catalog
Danish grocery catalog as MCP tools: live offers across all major chains, stores, EAN lookup, stock.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http shelfatlas-catalog 'https://api.shelfatlas.com/api/v1/mcp' --header 'Authorization: <Bearer sa_live_<your-key> — create a free key at https://app.shelfatlas.com>'
{
"mcpServers": {
"shelfatlas-catalog": {
"type": "http",
"url": "https://api.shelfatlas.com/api/v1/mcp",
"headers": {
"Authorization": "<Bearer sa_live_<your-key> — create a free key at https://app.shelfatlas.com>"
}
}
}
}
Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
ShelfAtlas 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.
Frequently asked questions
What is io.github.SlambertDK/shelfatlas-catalog?
Danish grocery catalog as MCP tools: live offers across all major chains, stores, EAN lookup, stock.
How do I install io.github.SlambertDK/shelfatlas-catalog?
It runs as a remote server. In Claude Code: claude mcp add --transport http shelfatlas-catalog 'https://api.shelfatlas.com/api/v1/mcp' --header 'Authorization: <Bearer sa_live_<your-key> — create a free key at https://app.shelfatlas.com>'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does io.github.SlambertDK/shelfatlas-catalog need an API key?
Yes. It expects Authorization, which you set in its configuration.
Is io.github.SlambertDK/shelfatlas-catalog open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains io.github.SlambertDK/shelfatlas-catalog?
It is published by SlambertDK. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.