MCP 服务器

marktplaats-mcp

Enables AI agents to search and monitor Dutch and Belgian classifieds (Marktplaats and 2dehands) for listings, seller profiles, and categories.

README

English | <a href="https://github.com/jasp-nerd/marktplaats-mcp/blob/main/README.nl.md">Nederlands</a> | <a href="https://github.com/jasp-nerd/marktplaats-mcp/blob/main/README.fr.md">Français</a>

marktplaats-mcp

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:

claude mcp add marktplaats -- uvx marktplaats-mcp

Then ask: "Search Marktplaats for an OLED TV under €400 near 3011 AB."

📦 Install in your favorite client

Every config runs the same stdio server via uvx marktplaats-mcp.

<details> <summary>Claude Desktop</summary>

Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then fully restart Claude Desktop:

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

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

<details> <summary>OpenAI Codex CLI</summary>

Add to ~/.codex/config.toml:

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

Or: codex mcp add marktplaats -- uvx marktplaats-mcp </details>

<details> <summary>opencode</summary>

Add to opencode.json:

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

</details>

<details> <summary>Cursor</summary>

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

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

</details>

<details> <summary>VS Code / GitHub Copilot</summary>

Add to .vscode/mcp.json (note the servers key and explicit type):

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

</details>

<details> <summary>Windsurf</summary>

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

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

</details>

<details> <summary>Gemini CLI</summary>

Add to ~/.gemini/settings.json:

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

</details>

<details> <summary>JetBrains IDEs (AI Assistant / Junie)</summary>

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

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

</details>

🧰 Tools

Tool	What it does
`search_listings`	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.