tweakers-aanbod-mcp
The server lets you browse and search Tweakers Vraag & Aanbod second-hand listings and open individual advertisements.
List about 220 categories, optionally filtered by text in slug or name.
Search within one category by keyword, min/max price, condition, seller type, minimum seller rating, location/distance, sort order, page, and whether to include wanted posts.
Get one page of about 40 listing summaries with title, price, posted date, seller, seller rating/reviews, city, and distance when a location is used.
Open a listing by ID for full details: description, condition, warranty, age, delivery/payment, shipping costs, views, photos, Pricewatch link, posted date, and seller profile/history.
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-aanbod-mcp search laptops between €300 and €550 near Utrecht, cheapest first"
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-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-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-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 |
| The ~220 Vraag & Aanbod categories with their slugs ( |
| One page (~40 listings) of a category: title, price, date, seller rating, city, distance, status ( |
| 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 |
|
| |
|
| Euros |
|
| Place name or full Dutch postcode ( |
|
|
|
|
|
|
|
| 1 to 5 stars |
|
|
|
|
| |
|
| 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 serverMIT licensed.
Available Tools
3 toolsget_listingARead-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_categoriesARead-only
List Vraag & Aanbod categories (about 220, e.g. laptops, videokaarten, cameras).
Inputs: contains. Returns: result
search_listingsARead-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
Scored across 3 tools
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.
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.
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.
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
Search MCP servers, MCP clients and AI agents, and retrieve listing details. Free, read-only access.
Federated listings from personal humanMCP servers. Search offers, trades by humans.
Gamedeals MCP — wraps CheapShark API (game deal aggregator, no auth required)
AI-agent-first offers directory: search and publish listings via MCP.
Related MCP Servers
- AlicenseAqualityCmaintenanceMCP server for interacting with Bazos.cz, Bazos.sk, Bazos.at, and Bazos.pl. Supports searching ads, retrieving ad details, and fetching user ratings.3101 npm4AGPL 3.0
- AlicenseAqualityCmaintenanceEnables AI assistants to search and view advertisements on Marktplaats.nl with extensive filtering options.521MIT
- AlicenseAqualityBmaintenanceEnables AI agents to search and monitor Dutch and Belgian classifieds (Marktplaats and 2dehands) for listings, seller profiles, and categories.875 PyPI5MIT
- AlicenseAqualityDmaintenanceRead-only MCP server for Marktplaats.nl (Dutch classifieds) that lets agents search listings and read price, specs, condition, delivery, location, and seller details.3ISC