Skip to main content
Glama
galaxus-mcp

galaxus-mcp

by LeonardoRO

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

Tool

Description

search_products

Search the catalog by keyword. Returns name, brand, price (CHF), rating, availability, image, and URL, plus category facets and a nextCursor for paging. Supports sort (relevance/price_asc/price_desc/rating/newest) and minPrice / maxPrice / brand / minRating filters.

get_product

Full details for a single product by numeric id, slug, or full URL: description, GTIN, specifications, images, and price history (current position vs recent low/high).

check_price_availability

Lightweight price + stock snapshot (incl. price-history position) for one product. Handy for price tracking.

compare_products

Fetch full details for 2–8 products at once for side-by-side comparison.

list_category

Browse a category by name, sorted/filterable, with available-brand and product-type facets to help refine.

Related MCP server: galaxus-mcp

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)

Variable

Default

Notes

GALAXUS_SITE

galaxus.ch

galaxus.ch, galaxus.de, or digitec.ch

GALAXUS_PORTAL

per-site

X-Dg-Portal value (22 = galaxus.ch)

GALAXUS_LANGUAGE

per-site

en, de, fr, ...

GALAXUS_SEARCH_HASH

captured

persisted id for useSearchDataQuery

GALAXUS_PRODUCT_HASH

captured

persisted id for productDetailPageQuery

GALAXUS_MIN_INTERVAL_MS

800

min delay between requests

GALAXUS_CACHE_TTL_MS

60000

response cache TTL

GALAXUS_TIMEOUT_MS

15000

per-request timeout

GALAXUS_USER_AGENT

Chrome UA

sent with every request

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

Available Tools

5 tools
check_price_availabilityCheck price & availabilityA

Lightweight price + stock snapshot for one product (id, slug, or URL), including price-history position (whether the current price is low/high vs the recent range). Ideal for price tracking.

Inputs: idOrUrl (required).

compare_productsCompare Galaxus productsA

Fetch full details for several products at once (by id, slug, or URL) for side-by-side comparison. Returns one detail object per input.

Inputs: idsOrUrls (required).

get_productGet Galaxus product detailsA

Fetch full details for a single product by its numeric id, slug, or full product URL: description, GTIN, specifications, images, rating, availability, and price history.

Inputs: idOrUrl (required).

list_categoryBrowse a Galaxus categoryA

Browse products in a category by name (e.g. 'ssd', 'office chair'), sorted and filterable. Returns products plus facets (available brands and product types) to help refine, and a nextCursor for paging.

Inputs: category (required), sort, brand, limit, +3 more.

search_productsSearch Galaxus productsA

Search the Galaxus / Digitec catalog by keyword. Returns matching products with price (CHF), rating, availability, and URL, plus a nextCursor for pagination.

Inputs: query (required), sort, brand, limit, +4 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 5 tools

    Disambiguation4/5

    Each tool has a distinct purpose: search, browse by category, single product details, lightweight price check, and multi-product comparison. Some overlap exists between get_product, compare_products, and check_price_availability, but descriptions clearly differentiate them.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case: search_products, get_product, check_price_availability, compare_products, list_category. The naming is predictable and clear.

    Tool Count5/5

    With 5 tools, the server is well-scoped for product discovery, detail retrieval, price tracking, and comparison. The count is within the ideal range and each tool earns its place.

    Completeness4/5

    The tool surface covers the core catalog lifecycle: search, category browsing, single product details, price/availability checks, and product comparison. Minor gaps like an explicit category listing or bulk search are missing, but agents can work around these.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Enables product search and discovery on Galaxus and Digitec, with tools for searching, browsing, comparing, and looking up prices and specifications.
      7
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI to search Geizhals price-comparison data, including products, best prices, price history, ratings, categories, and deals.
      8
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search Digikala's catalogue, compare every seller's offers and prices, review ~30 days of price history, read customer reviews and Q&A, and surface current deals, all through read-only tools.
      23
      670 PyPI
      43
      PolyForm Noncommercial 1.0.0