galaxus-mcp

An unofficial Model Context Protocol server that lets AI assistants (Claude, ChatGPT, and any other MCP client) search products and read product details from Galaxus / Digitec.

⚠️ Unofficial / use at your own risk. Galaxus does not offer a public API. This server talks to the same internal GraphQL endpoints their website uses, so there's no stability guarantee: Galaxus can change the schema, rotate the persisted-query ids, or block traffic at any time. Respect their Terms of Service and robots.txt, keep request volume low, and don't use this to resell their data. Provided as-is under the MIT license with no affiliation to Digitec Galaxus AG.

Tools

Related MCP server: PriceAtlas MCP Server

How it works

Galaxus's storefront is a Next.js + Relay app backed by a HotChocolate (.NET) GraphQL server. Queries are persisted: the client sends a hash + variables, not the query text.

• Search / category → POST /graphql/o/<searchQueryHash>/useSearchDataQuery

• Product / price → POST /graphql/o/<productQueryHash>/productDetailPageQuery

Both require the headers X-Dg-Portal and X-Dg-Language. The product HTML pages are gated behind a CAPTCHA for non-browser clients, but the GraphQL endpoint is not, so this server uses GraphQL for every operation. Search uses skipRedirect so category-like terms still return a product list, supports cursor pagination, and exposes the brand / product-type facets. Every request goes through a small rate limiter, a short-lived response cache, and a timeout.

Install

npm install
npm run build

Use with Claude Code

claude mcp add galaxus -- node /absolute/path/to/galaxus_mcp/dist/index.js

Use with Claude Desktop / other MCP clients

Add to your client's MCP config (e.g. claude_desktop_config.json):

{
  "mcpServers": {
    "galaxus": {
      "command": "node",
      "args": ["/absolute/path/to/galaxus_mcp/dist/index.js"]
    }
  }
}

Configuration (env vars)

Refreshing the persisted-query ids

If search or product calls start failing (e.g. after a Galaxus deploy), the persisted-query hashes have likely rotated. To recapture them:

1. Open https://www.galaxus.ch in Chrome with DevTools → Network.

2. Search for something, then open a product page.

3. Find the requests to /graphql/o/<hash>/useSearchDataQuery and /graphql/o/<hash>/productDetailPageQuery.

4. Set GALAXUS_SEARCH_HASH / GALAXUS_PRODUCT_HASH to the new <hash> values.

Project layout

src/
  index.ts            MCP server + tool registration
  config.ts           env-driven config (site, portal, hashes, rate limits)
  types.ts            normalized models + DataProvider interface
  http.ts             HTTP client (throttle + cache + timeout)
  providers/
    graphql.ts        internal-GraphQL provider

The tools talk to a DataProvider interface rather than the GraphQL client directly, so the data source can be swapped out later if the internal API stops working.

License

MIT