Skip to main content
Glama

tweakers-mcp

MCP server for Tweakers Pricewatch: let Claude search products, read full specifications, filter a category on specs, and find the cheapest shops (new items by default, refurbished/open-box only when you ask for it).

Built on tweakers-pricewatch (unofficial, reverse-engineered endpoints).

"Find the best deal fridge with energy label A and under 30 dB, then the best price per litre."

How to install

Needs uv (brew install uv).

Claude Code

claude mcp add tweakers -- uvx --from git+https://github.com/rleroi/tweakers-mcp tweakers-mcp

Claude Desktop: add this to ~/Library/Application Support/Claude/claude_desktop_config.json (Windows: %APPDATA%\Claude\claude_desktop_config.json) and restart Claude Desktop. Desktop does not use your shell PATH, so use the absolute path from which uvx:

{
  "mcpServers": {
    "tweakers": {
      "command": "/absolute/path/to/uvx",
      "args": ["--from", "git+https://github.com/rleroi/tweakers-mcp", "tweakers-mcp"]
    }
  }
}

The first start takes a few seconds while uv builds the package.

Related MCP server: galaxus-mcp

Tools

Tool

What

find_cheapest(query)

Search, pick best hit with offers, return info + specs + cheapest offers

search_products(query)

Autocomplete search (~8 hits max)

get_product(product_id)

Product info + cheapest offers

get_cheapest_offers(product_id)

Offers sorted by total price (incl. shipping), with clickout URL

get_specs(product_id)

Spec table as {group: {label: value}}

get_category_filters(slug, query)

Spec filters of a category (select options, range bounds)

browse_category(slug, filters, details)

Category listing, filtered server-side on specs; details=N adds specs + offers for the first N

list_categories()

Category slugs

Refurbished / open-box / outlet offers are excluded by default (refurbished_hidden shows how many); pass include_refurbished=true only when explicitly asked for. The package ignores the offer condition, so offers are parsed here.

Filter first, then fetch details: browse_category('koelkasten', filters={'Energieklasse (2021)': ['A'], 'Geluidssterkte (max.)': {'max': 29}}, details=25) is ~20s instead of scanning hundreds of products.

Specs are parsed here from the product page (the package has none). Requests are throttled (0.5s) and specs are cached per process.

Development

git clone https://github.com/rleroi/tweakers-mcp && cd tweakers-mcp
uv sync
uv run tweakers-mcp        # stdio server

Caveats

  • Unofficial: relies on reverse-engineered Tweakers endpoints and HTML, which can change or be blocked at any time. Check Tweakers' terms before heavy use.

  • Search is the autocomplete endpoint (~8 hits). Use browse_category with filters for more.

  • Some products lack specs on Tweakers (e.g. no dB value), so a spec filter silently skips them.

  • Not affiliated with Tweakers. MIT licensed.

Available Tools

8 tools
browse_categoryA

Browse a Pricewatch category (e.g. 'videokaarten', 'koelkasten'), optionally filtered server-side by specs, so only matching products are returned. sort: 'prijs' | 'popularity' | 'score'; sort_dir: 'asc' | 'desc'. filters: {filter name: value}, names/options from get_category_filters, e.g. {"Energieklasse (2021)": ["A"], "Geluidssterkte (max.)": {"max": 29}} select filters take an option label or list of labels; range filters take {"min": x, "max": y} (inclusive bounds). details: for the first N items also return full specs and cheapest offers (one extra request each; keep small). Refurbished/open-box/outlet offers are left out of those offers (counted in refurbished_hidden) unless include_refurbished is true; only set that when the user explicitly asks for refurbished/outlet items. Use list_categories to find slugs.

Inputs: slug (required), page, sort, details, +4 more. Returns: object

find_cheapestA

Search for a product and return the best match with its specs and cheapest offers in one call. Takes the first of the top 3 hits that has usable shop offers (falls back to the first hit). Other search hits are returned as alternatives. Refurbished/open-box/outlet offers are left out (counted in refurbished_hidden) unless include_refurbished is true; only set that when the user explicitly asks for refurbished/outlet items.

Inputs: query (required), offer_limit, include_refurbished. Returns: object

get_category_filtersA

Spec filters available in a category (e.g. 'koelkasten'): name, kind ('select' with options, or 'range' with min/max values). query narrows by filter name. Use the names in browse_category's filters.

Inputs: slug (required), query. Returns: result

get_cheapest_offersA

Cheapest current shop offers for a product, sorted by total price (product + shipping). Includes shop name, product_price, shipping_cost, condition and url. Refurbished/open-box/outlet offers are left out (counted in refurbished_hidden) unless include_refurbished is true; only set that when the user explicitly asks for refurbished/outlet items.

Inputs: product_id (required), limit, include_refurbished. Returns: object

get_productA

Product info (brand, name, mpn, gtin, price range) plus the cheapest shop offers. price per offer is the total incl. shipping; url is the Tweakers clickout link to the shop. Refurbished/open-box/outlet offers are left out (counted in refurbished_hidden) unless include_refurbished is true; only set that when the user explicitly asks for refurbished/outlet items.

Inputs: product_id (required), offer_limit, include_refurbished. Returns: object

get_specsC

Full specification table of a product as {group: {label: value}}.

Inputs: product_id (required). Returns: object

list_categoriesB

Category slugs mapped to names; filter is a case-insensitive substring match.

Inputs: filter. Returns: object

search_productsA

Search Tweakers Pricewatch by name or SKU. Returns at most ~8 matches (product_id, name, url, price when known). Use product_id with the other tools.

Inputs: query (required). Returns: result

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 8 tools

    Disambiguation3/5

    get_product, get_cheapest_offers, and find_cheapest all return shop offers for a product, creating overlap; get_product already includes offers that get_cheapest_offers returns alone. Descriptions do differentiate intent (info vs offers vs convenience bundle), but an agent must reason carefully to pick the right one.

    Naming Consistency4/5

    All names are snake_case verb_noun (search_products, get_product, browse_category, list_categories), which is predictable. The verb set varies (search/get/find/browse/list), causing minor deviation from a single canonical verb pattern.

    Tool Count5/5

    Eight tools is well-scoped for a price-comparison server: search, product detail, offers, specs, category browsing, filters, and categories. Each tool earns its place in the workflow.

    Completeness4/5

    Covers the core Pricewatch lifecycle: discover categories, filter, search, fetch specs and offers. Minor gaps exist (no price-history or direct product-comparison tool), but agents can work around these with the current surface.

    Maintenance

    ActivitySlowing
    ResponsivenessNo recent community issues

    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