Marktplaats & 2dehands

marktplaats-mcpis 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.

- 🔍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 asiteparameter
- 📄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 andRetry-Afterhandling
- 🔓No account, no API key

The only prerequisite isuv(brew install uvorcurl -LsSf https://astral.sh/uv/install.sh | sh).

claude mcp add marktplaats -- uvx marktplaats-mcp

You can skip the terminal entirely. A hosted copy of this server runs athttps://marktplaats-mcp.jaspnerd.dev/mcp, ready to plug intoclaude.aiin your browser or the Claude mobile app. Custom connectors work on every Claude plan, including Free.
- Openclaude.aiand go toSettings → Connectors.
- ClickAdd custom connector.
- Pastehttps://marktplaats-mcp.jaspnerd.dev/mcpas the URL and clickAdd. No account or key needed.
- Ask Claude:"Search Marktplaats for an OLED TV under €400 near 3011 AB."

{ "mcpServers": { "marktplaats": { "command": "uvx", "args": ["marktplaats-mcp"] } } }

If Claude Desktop can't finduvx, use the absolute path (which uvx, e.g./Users/you/.local/bin/uvx).

[mcp_servers.marktplaats] command = "uvx" args = ["marktplaats-mcp"]

Or:codex mcp add marktplaats -- uvx marktplaats-mcp

{ "$schema": "https://opencode.ai/config.json", "mcp": { "marktplaats": { "type": "local", "command": ["uvx", "marktplaats-mcp"], "enabled": true } } }

Add to~/.cursor/mcp.json(global) or.cursor/mcp.json(project):

{ "mcpServers": { "marktplaats": { "command": "uvx", "args": ["marktplaats-mcp"] } } }

Add to.vscode/mcp.json(note theserverskey and explicittype):

{ "servers": { "marktplaats": { "type": "stdio", "command": "uvx", "args": ["marktplaats-mcp"] } } }

Add to~/.codeium/windsurf/mcp_config.json:

{ "mcpServers": { "marktplaats": { "command": "uvx", "args": ["marktplaats-mcp"] } } }

{ "mcpServers": { "marktplaats": { "command": "uvx", "args": ["marktplaats-mcp"] } } }

Settings → Tools → AI Assistant → Model Context Protocol (MCP) → Add:

{ "mcpServers": { "marktplaats": { "command": "uvx", "args": ["marktplaats-mcp"] } } }

All five tools are read-only and carry the matching MCP annotations, so clients skip the confirmation 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."

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. Passinclude_sponsored=trueif you want them.

Which Python versions are supported?3.10 and up. CI tests 3.11 through 3.13 on Linux, macOS and Windows.

- 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

PRs welcome. SeeCONTRIBUTING.mdfor the dev setup:uv sync --all-groups, thenuv run pytest.

This project reuses proven ideas frommarktplaats-py,marktplaats-monitor,marktplaats-2dehands-mcpandPonClick/marktplaats-mcp. Details inTHIRD_PARTY_NOTICES.md.

Eagle MCP Server is a local Model Context Protocol bridge that lets AI assistants (e.g. Cursor, Claude) access your Eagle media library so you can tag, categorize, search, and batch-organize assets with natural language.