marktplaats-mcp: the Marktplaats & 2dehands MCP server

marktplaats-mcp is an MCP server for Marktplaats.nl (Netherlands) and 2dehands.be (Belgium), the Dutch and Belgian second-hand classifieds (tweedehands, petites annonces d'occasion). Search listings, filter on category attributes, vet sellers, compare prices and watch for new ads from Claude, ChatGPT, Cursor, Codex, Gemini or any other MCP client. With your own login it also reads and sends messages, places bids and manages your favorites and ads. No API key.

🚀 Get started

No install: paste a URL. The hosted, read-only server runs at https://marktplaats-mcp.jaspnerd.dev/mcp. Add it as a custom connector in claude.ai (Settings → Connectors, works on the Free plan and mobile), ChatGPT, Mistral Le Chat, Perplexity or the Gemini app.

Claude Code: one command.

claude mcp add --scope user marktplaats -- uvx marktplaats-mcp

Any other client. Install uv (brew install uv, or winget install --id=astral-sh.uv -e on Windows), then add the standard MCP config:

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

One click:

Step-by-step instructions for 40 clients (Cursor, VS Code, Codex, Gemini CLI, Cline, Windsurf, JetBrains, Zed, opencode, Goose, ...), with the config path per OS and a link to each client's official guide: docs/clients.md.

Then ask: "Find a racefiets under €500 within 25 km of 1011 AB, frame 57-61 cm, and tell me if the sellers look legit."

Related MCP server: Begagnad MCP

👤 Use your own account (messages, favorites, bids, your ads)

Marktplaats has no public API and its login uses SMS two-factor authentication, so this server never asks for your password. It copies the session from a browser you are already logged into:

uvx --from 'marktplaats-mcp[login]' marktplaats-mcp login

The session is stored in ~/.config/marktplaats-mcp/session.json, readable by your user only. Restart your MCP client and the account tools appear.

marktplaats-mcp login --site 2dehands  # also import your 2dehands.be session
marktplaats-mcp login --read-only      # never send, bid or change favorites
marktplaats-mcp login --window         # open a browser window and log in there instead
marktplaats-mcp login --paste          # paste a Cookie header from DevTools instead
marktplaats-mcp status                 # is the stored session still valid?
marktplaats-mcp logout                 # delete it

• macOS: the system blocks command-line tools from reading browser data and does not ask. Once, open System Settings → Privacy & Security → Full Disk Access, add the terminal app you use (Terminal, iTerm, Warp, or VS Code), then quit and reopen it. Then run the login command again.

• Windows: Chrome and Edge lock their cookie file while they run; the tool copies it first, so this normally just works. If it doesn't, close the browser and run the login again, or use --paste.

• Linux: Chromium browsers store the cookie key in your keyring (GNOME Keyring or KWallet), which must be unlocked; Firefox needs nothing. Snap or Flatpak browsers keep their profile elsewhere, so use --paste there.

• Everywhere: marktplaats-mcp login --paste never needs permissions. In your browser on marktplaats.nl press F12 → Network, click any request, copy the Cookie request header and paste it.

Or set MARKTPLAATS_COOKIE / TWEEDEHANDS_COOKIE (the request Cookie header) in your client's config. Sessions last weeks; when one expires the tools tell you to log in again.

Sending, contacting a seller and bidding return a preview first and only act when called again with confirm=true. Bids are binding on Marktplaats; the tool refuses bids below the minimum. Automated ad placement is forbidden by Marktplaats' terms and deliberately not implemented. See Safety model.

🧰 Tools

Read-only tools carry the matching MCP annotations, so clients skip confirmation prompts for them and ask for the write tools. Every tool returns structured output with a real schema. Two prompts, bargain_hunt and vet_listing, encode the common workflows.

What you can say, and what happens

🔒 Safety model

• No credentials by default. Searching, details, seller checks, filters, price statistics and monitoring need no account.

• Your session stays yours. The local server reads the cookie from your browser or a file only you can read, sends it only to marktplaats.nl / 2dehands.be, and never logs it. The hosted endpoint refuses to start with account credentials configured.

• Writes are explicit. Sending and bidding preview first and require confirm=true; bids below the minimum are refused; login --read-only or MARKTPLAATS_READ_ONLY=1 disables writes entirely; every confirmed write is logged locally.

• Untrusted content is labelled. Listing text and messages are written by other users; the server tells the model to treat them as data, never as instructions.

• Polite to the marketplace. Requests are spaced (MARKTPLAATS_MIN_INTERVAL_MS, default 200), retried with backoff and Retry-After, and search pages are cached for a minute. The hosted endpoint is rate-limited per client and globally.

• No affiliate links, no tracking. Listing URLs are returned exactly as the marketplaces publish them.

❓ FAQ

Is there an MCP server for Marktplaats?

Yes, this one. Free, open source (MIT), no API key. Paste the hosted URL into claude.ai or run uvx marktplaats-mcp.

Does it work with 2dehands.be and Belgium?

Yes. Every tool takes site="2dehands", and language="nl" or "fr" narrows Belgian results to one language.

Do I need a Marktplaats account or API key?

No. Only the account tools need your own login, and they use your existing browser session rather than a password.

Can AI read and send my Marktplaats messages, or place bids?

Yes, with the local server after marktplaats-mcp login. Sending and bidding show a preview and only act after you confirm.

Where are my login credentials stored?

In ~/.config/marktplaats-mcp/session.json on your machine, readable by your user only, or in the environment variables you set yourself. They are only ever sent to marktplaats.nl / 2dehands.be. marktplaats-mcp logout removes them.

Can I use it without installing anything?

Yes: the hosted endpoint https://marktplaats-mcp.jaspnerd.dev/mcp works in claude.ai, including the Free plan and mobile apps. It offers the read-only tools.

Does it work with ChatGPT, Cursor, Gemini, VS Code and Cline?

Yes. See docs/clients.md for step-by-step instructions per client. Any client that runs stdio servers can use uvx marktplaats-mcp; clients that support remote servers can use the hosted URL.

Is this official or affiliated with Marktplaats?

No. It is an independent open source project with no ties to Marktplaats, 2dehands or Adevinta. It uses the same public JSON endpoints the websites use; that API is undocumented and may change, which is why a live canary runs every day.

Why do I sometimes see fewer results than the limit, or total_count looks high?

Paid promotions (DAGTOPPER, TOPADVERTENTIE) are filtered out by default; pass include_sponsored=true to see them. total_count is the marketplace's raw count before that filtering.

Which Python versions are supported?

3.10 and up. CI tests 3.11 through 3.13 on Linux, macOS and Windows.

📚 Docs

• Install in your client: step-by-step for 40 clients

• Configuration: environment variables for the local and hosted server

• How this compares to the other Marktplaats MCP servers

• Changelog

🗺️ Roadmap

• Cross-site search (NL and BE in one call)

• Saved-search creation from the agent

• Claude Desktop extension bundle (MCPB)

🤝 Contributing

PRs welcome. See CONTRIBUTING.md for the dev setup: uv sync --all-groups, then uv run pytest. uv run python scripts/e2e_smoke.py runs the live canary.

This project reuses proven ideas from marktplaats-py, marktplaats-monitor, marktplaats-2dehands-mcp and PonClick/marktplaats-mcp. Details in THIRD_PARTY_NOTICES.md.

If this saved you a trip to Marktplaats, a star helps other people find it.

📄 License

MIT © 2026 jasp-nerd

mcp-name: io.github.jasp-nerd/marktplaats-mcp