Search Marktplaats and 2dehands: listings, sellers, categories and new-listing monitoring.
A Model Context Protocol (MCP) server that enables searching Marktplaats and 2dehands for listings, sellers, and categories, with new-listing monitoring. It leverages model context to facilitate targeted queries and monitoring tasks across classified ads platforms. The server is described by its name, description, topics, and related tooling in the repository metadata.
🛠️ Key Features
Searches across Marktplaats and 2dehands for listings, sellers, and categories
New-listing monitoring and alerting support
Model context protocol integration for structured prompts
Python-based implementation with MCP compatibility
Topics include classifieds, agents, and LM-assisted workflows
🚀 Use Cases
Retrieve recent listings and seller details from Dutch and Belgian marketplaces
Category and keyword-based ad discovery
Automated monitoring of new listings matching user-defined criteria
⚡ Developer Benefits
Clear MCP server structure for easy integration
Grounded in Model Context Protocol best practices
Rich metadata in topics for discoverability and SEO
⚠️ Limitations
Data freshness depends on external marketplace APIs
Language and locale constraints may affect results for non-Dutch/Belgian markets
marktplaats-mcp is an MCP server that lets Claude, Cursor, Codex, opencode and every other MCP client search Marktplaats and 2dehands, the Dutch and Belgian second-hand classifieds. Find bargains, vet sellers, browse categories and monitor new listings in plain language.
✨ Features
🔍 Powerful search: free text, categories, price range, condition, distance from a postal code, recency, sorting
🇳🇱🇧🇪 Two marketplaces, one server: marktplaats.nl (Netherlands) and 2dehands.be (Belgium) via a site parameter
📄 Full listing details: complete description, all photos, view and favorite counts, listing age
🛡️ Seller vetting: verified bank account, identity and phone, review score
🔔 New-listing monitoring: poll for ads placed after a timestamp with a stateless cursor
🧠 Built for LLMs: compact token-efficient output, paid promotions filtered out, structured results, pagination hints
🔁 Resilient: retries with exponential backoff, jitter and Retry-After handling
🔓 No account, no API key
🚀 Quickstart
The only prerequisite is uv (brew install uv or curl -LsSf https://astral.sh/uv/install.sh | sh).
Claude Code, one command:
bash
claude mcp add marktplaats -- uvx marktplaats-mcp
Then ask: "Search Marktplaats for an OLED TV under €400 near 3011 AB."
marktplaats-mcp trailer: an AI agent searches for a racefiets and vets the seller, rendered as a retro CRT terminal session
🌐 Use on claude.ai (no install)
You can skip the terminal entirely. A hosted copy of this server runs at https://marktplaats-mcp.jaspnerd.dev/mcp, ready to plug into claude.ai in your browser or the Claude mobile app. Custom connectors work on every Claude plan, including Free.
Paste https://marktplaats-mcp.jaspnerd.dev/mcp as the URL and click Add. No account or key needed.
Ask Claude: "Search Marktplaats for an OLED TV under €400 near 3011 AB."
The hosted endpoint runs the same code as the PyPI package, rate-limited per client. If you'd rather have requests come from your own machine, install it locally below.
📦 Install in your favorite client
Every config runs the same stdio server via uvx marktplaats-mcp.
Claude Desktop
Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then fully restart Claude Desktop:
Search with query, category, price range, condition, distance, recency, sorting and pagination
get_listing_details
Full ad: complete description, all images, view and favorite counts, listing age
get_seller_profile
Trust signals: verified bank, identity and phone, review score and count
list_categories
Browse the category tree (names + ids) used for filtering
check_new_listings
Newest-first monitoring with a stateless cursor: returns only ads placed after since
All five tools are read-only and carry the matching MCP annotations, so clients skip the confirmation prompts.
Example prompts
"Find a second-hand iPhone 15 under €600 in as-good-as-new condition, sorted by price."
"Search 2dehands for a bakfiets within 20 km of postcode 2000 Antwerpen."
"Is seller 12345 trustworthy? Check their profile."
"Check for new 'vintage lamp' listings since my last check and summarize the interesting ones."
❓ FAQ
Does this need a Marktplaats account or API key?
No. It uses the same public JSON endpoints the website itself uses.
Is this an official Marktplaats product?
No. This is an independent open source project with no ties to Marktplaats or Adevinta. The underlying API is undocumented and may change. The server backs off politely on rate limits; keep your own usage reasonable.
Why do I sometimes see fewer results than the limit?
Paid promotions (DAGTOPPER/TOPADVERTENTIE) are filtered out by default. Pass include_sponsored=true if you want them.
Which Python versions are supported?
3.10 and up. CI tests 3.11 through 3.13 on Linux, macOS and Windows.
🗺️ Roadmap
Persistent saved searches with price-drop detection
Notifications (Discord/Telegram/ntfy via Apprise)
Authenticated tools (your messages, favorites and bids)
Docker image + Docker MCP Catalog
🤝 Contributing
PRs welcome. See CONTRIBUTING.md for the dev setup: uv sync --all-groups, then uv run pytest.
