tweakers-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@tweakers-mcp Find the cheapest fridge with energy label A and under 30 dB"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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-mcpClaude 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 |
| Search, pick best hit with offers, return info + specs + cheapest offers |
| Autocomplete search (~8 hits max) |
| Product info + cheapest offers |
| Offers sorted by total price (incl. shipping), with clickout URL |
| Spec table as |
| Spec filters of a category (select options, range bounds) |
| Category listing, filtered server-side on specs; |
| 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 serverCaveats
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_categorywith 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 toolsbrowse_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
Scored across 8 tools
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.
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.
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.
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
Related MCP Connectors
Free, read-only price comparison for products sold in Australia. Search products, browse categories, open a product with every seller's current price (eBay Australia, Amazon, JB Hi-Fi and more), and compare two products head to head. No login or API key. Answers come from Lianex's cached catalogue, so they are fast and never place an order or change anything. Docs: https://lianex.ai/developers
Product search, store prices and price history from Norwegian web shops. Read-only, no login.
Search products, compare prices and discover deals across 6 European markets with your AI assistant.
Search and look up products across thousands of online stores, normalized into one schema.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables searching geizhals.de for products and retrieving shop prices and offers to assist with price comparison.2MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to search products and retrieve detailed information from Galaxus and Digitec, including prices, specifications, and price history.54MIT
- AlicenseAqualityCmaintenanceEnables searching for products on KuantoKusta.pt with filters and retrieving detailed product information including prices from multiple stores.223 PyPIMIT
- AlicenseAqualityDmaintenanceEnables product search and discovery on Galaxus and Digitec, with tools for searching, browsing, comparing, and looking up prices and specifications.71MIT