Skip to main content
Glama
geizhals-mcp
by spinnerich

geizhals-mcp

A small MCP server that lets an assistant search geizhals.de and look up shop prices for a product. I built it to stop tabbing back and forth to the browser while comparing hardware prices.

It exposes two tools:

  • search_products(query, limit=15) – full-text product search; returns the lowest price, number of offers and the product URL for each hit.

  • get_product(product) – takes a product URL or id and lists the individual shop offers (cheapest first) with the price range.

Install

git clone https://github.com/spinnerich/geizhals-mcp
cd geizhals-mcp
uv sync          # or: pip install -e .

Related MCP server: galaxus-mcp

Wiring it into a client

For Claude Code, one command does it (point it at wherever you cloned the repo):

claude mcp add geizhals -- uv --directory /path/to/geizhals-mcp run geizhals-mcp

Add --scope user to make it available in every project, or -e KEY=value to set any of the variables below. claude mcp list shows it's registered.

For Claude Desktop, add this to claude_desktop_config.json:

{
  "mcpServers": {
    "geizhals": {
      "command": "uv",
      "args": ["run", "geizhals-mcp"]
    }
  }
}

Or run it directly to test: uv run geizhals-mcp.

Configuration

A few environment variables, all optional:

Variable

Default

Purpose

GEIZHALS_DOMAIN

geizhals.de

Use geizhals.at or geizhals.eu for other regions.

GEIZHALS_MIN_DELAY

1.0

Minimum seconds between requests.

GEIZHALS_IMPERSONATE

chrome

curl_cffi browser profile used for the TLS handshake.

Caveats

Geizhals has no public API, so this reads the normal website. The site is behind Cloudflare, which is why the requests go through curl_cffi with a browser TLS fingerprint – a plain HTTP client just gets a 403. Because there's no API the parsing is tied to the current page layout and may need a nudge when they change things.

Keep the request rate sane (the default delay is there for a reason) and use this for your own price checks, not for hammering their servers.

Available Tools

2 tools
get_productA

Look up offers for a single product.

Accepts a geizhals product URL or a numeric product id and returns the individual shop offers (cheapest first) plus the price range and, when available, the recent price history.

Inputs: product (required). Returns: result

search_productsA

Search geizhals.de for products by name or keyword.

sort is one of "relevance" (default), "price_asc" or "price_desc". min_price/max_price narrow the results to a price range in euro.

Returns a list of matching products with their lowest price, number of offers and the product page URL.

Inputs: query (required), limit, sort, min_price, +1 more. Returns: result

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 2 tools

    Disambiguation5/5

    The two tools have clearly distinct purposes: one for searching products by keyword, the other for retrieving detailed offers for a specific product. No overlap or ambiguity.

    Naming Consistency5/5

    Both tools follow the verb_noun pattern (search_products, get_product), which is consistent and predictable.

    Tool Count3/5

    Only two tools for a price comparison service seems minimal. While the core workflow is covered, additional tools for categories or price history would enhance the surface.

    Completeness3/5

    Missing features like category browsing, price alerts, or multiple product comparison. However, the basic search and detail retrieval are present.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables AI assistants to search products and retrieve detailed information from Galaxus and Digitec, including prices, specifications, and price history.
      5
      4
      MIT
    • 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
      C
      maintenance
      Enables product search, price comparison, and price history analysis across 6 European marketplaces (DE, AT, GB, FR, IT, ES).
      28
      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