Skip to main content
Glama
tweakers-aanbod-mcp

tweakers-aanbod-mcp

by frankwiersma

tweakers-aanbod-mcp

MCP server for Tweakers Vraag & Aanbod, the Dutch second-hand marketplace for electronics. It lets Claude (or any MCP client) search listings in a category, filter on price, condition, seller type and distance, and open a single advertisement.

"Find laptops between €300 and €550 within 30 km of Utrecht, nearest first, and open the best one."

For new products and shop prices, see rleroi/tweakers-mcp (Pricewatch). This server covers the second-hand side.

Install

Needs uv (brew install uv).

Claude Code

claude mcp add tweakers-aanbod -- uvx --from git+https://github.com/frankwiersma/tweakers-aanbod-mcp tweakers-aanbod-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-aanbod": {
      "command": "/absolute/path/to/uvx",
      "args": ["--from", "git+https://github.com/frankwiersma/tweakers-aanbod-mcp", "tweakers-aanbod-mcp"]
    }
  }
}

Related MCP server: marktplaats-mcp

Tools

Tool

What it does

list_categories(contains)

The ~220 Vraag & Aanbod categories with their slugs (laptops, videokaarten, ...)

search_listings(category, ...)

One page (~40 listings) of a category: title, price, date, seller rating, city, distance, status (Gereserveerd)

get_listing(listing_id)

The full advertisement: description, condition, warranty, age, delivery, payment, photos, seller, status

search_listings filters on Tweakers' side, so a narrow search costs one request:

Argument

Example

Notes

keyword

"thinkpad t14"

min_price, max_price

300, 550

Euros

near, max_distance_km

"Utrecht", 30

Place name or full Dutch postcode (3521DT). Each listing then carries distance_km.

conditions

["new", "good"]

new, good, visibly_used, defective

seller_type

"business"

private or business

min_seller_rating

4

1 to 5 stars

sort

"price_low"

newest, oldest, price_low, price_high, nearest, best_rated

page

2

include_wanted

true

Also return "gevraagd" posts

How it works

It reads the same public pages a browser does: the category listing at /<category>/aanbod/ (with the query parameters of its filter form) and the advertisement at /aanbod/<id>/. It stays out of the paths that robots.txt disallows (/aanbod/zoeken, /ajax, ...), which is why every search needs a category.

Requests go out one at a time, at least two seconds apart. Tweakers rate limits busy IPs; when that happens the tool returns a clear error and you can retry after a minute. Nothing is cached to disk or stored.

Caveats

  • Unofficial and not affiliated with Tweakers. It parses HTML, which can change at any time.

  • Listings include seller nicknames and locations as Tweakers shows them. Tweakers' terms do not allow collecting other members' personal data systematically, so use this for your own searches, not for building datasets.

  • Tweakers ignores a place name it cannot resolve. The tool detects that and returns an error instead of unfiltered results.

  • An old listing id still opens; check posted_at.

Development

git clone https://github.com/frankwiersma/tweakers-aanbod-mcp && cd tweakers-aanbod-mcp
uv sync
uv run pytest                # offline, against fixtures in tests/fixtures
uv run tweakers-aanbod-mcp   # stdio server

MIT licensed.

Available Tools

3 tools
get_listingA
Read-only

Open one advertisement: full description, condition, warranty, age, delivery and payment options, photos, and the seller's location, rating and history. Old ids still resolve, so check posted_at.

Inputs: listing_id (required). Returns: The full advertisement.

list_categoriesA
Read-only

List Vraag & Aanbod categories (about 220, e.g. laptops, videokaarten, cameras).

Inputs: contains. Returns: result

search_listingsA
Read-only

Search one Vraag & Aanbod category. Filtering happens on Tweakers' side, so narrow filters cost no extra requests. Returns about 40 listings per page with price, seller rating and city.

Inputs: category (required), near, page, sort, +8 more. Returns: One page of search results.

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

    Disambiguation5/5

    The three tools form a clear funnel: browse categories, search within a category, then open a specific listing. Each has a distinct resource and action, with no overlapping purposes. An agent can easily select the right tool.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun snake_case pattern: list_categories, search_listings, get_listing. There are no mixed conventions or vague verbs.

    Tool Count5/5

    Three tools are exactly enough for a read-only marketplace browsing server: one for category discovery, one for search, and one for detail retrieval. No tool feels redundant or missing within that narrow scope.

    Completeness4/5

    The core browse-search-detail workflow is fully covered, including categories, listings, and rich detail such as seller history. Minor gaps exist, such as no explicit cross-category search or pagination control, but agents can work around them via the documented search behavior.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      MCP server for interacting with Bazos.cz, Bazos.sk, Bazos.at, and Bazos.pl. Supports searching ads, retrieving ad details, and fetching user ratings.
      3
      101 npm
      4
      AGPL 3.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables AI agents to search and monitor Dutch and Belgian classifieds (Marktplaats and 2dehands) for listings, seller profiles, and categories.
      8
      75 PyPI
      5
      MIT