Search Marktplaats & 2dehands (NL/BE classifieds), vet sellers, compare prices, use your account.
marktplaats-mcp is an MCP server that enables an MCP client (e.g., Claude, Cursor, Codex, opencode) to search listings on Marktplaats and 2dehands. It supports searching listings, sellers, and categories, and includes new-listing monitoring. The project is associated with the Model Context Protocol.
🛠️ Key Features
Search Marktplaats listings
Search 2dehands listings
Retrieve sellers and categories
Monitor for new listings
🚀 Use Cases
Find items across Marktplaats and 2dehands from an AI agent
Search by category and review seller information
Set up workflows that track newly posted listings
⚡ Developer Benefits
Works as an MCP server for multiple MCP clients
Exposes Marktplaats and 2dehands search, including sellers and categories
Provides new-listing monitoring for automated follow-up
⚠️ Limitations
The provided material describes search and monitoring, but does not specify authentication, rate limits, or response formats.
Search second-hand listings on Marktplaats or 2dehands with filters for
category, category-specific attributes, price range, condition, delivery,
recency and distance from a postal code. Paid promotions are filtered out
unless include_sponsored is set.
Parameters21
query
string
optional
Free-text search, e.g. 'racefiets' or 'iphone 15'. May be empty if a category is given.
site
string
optional
Which marketplace: marktplaats (Netherlands) or 2dehands (Belgium).
category
any
optional
Top-level category name (Dutch, e.g. 'Fietsen en Brommers') or numeric id. See list_categories.
subcategory
any
optional
Subcategory name (e.g. 'Fietsen | Racefietsen' or 'Fietsen | Heren | Herenfietsen') or numeric id. See list_categories with a parent.
attributes
any
optional
Category-specific filters as {filter: value}, using the labels from list_category_filters, e.g. {'Merk': 'Gazelle', 'Framehoogte': '57 tot 61 cm'} or {'Bouwjaar': '2018-2022', 'Kilometerstand': '-100000', 'Brandstof': 'Benzine'}. A list means any of those values. Ranges are 'min-max', 'min-' or '-max'.
postcode
any
optional
Dutch/Belgian postal code to search around, e.g. '1011 AB' or '2000'. Required for distance filtering and for distance_km in results.
distance_km
any
optional
Max distance from postcode in kilometers (needs postcode).
price_from
any
optional
Minimum price in euros.
price_to
any
optional
Maximum price in euros.
condition
any
optional
Filter by item condition.
delivery
any
optional
'shipping' for ads that can be shipped, 'pickup' for collection.
language
any
optional
2dehands only: 'nl' for Dutch-language ads, 'fr' for French, 'all' (default).
exclude
any
optional
Drop listings whose title or description contains any of these words, e.g. ['hoesje', 'defect', 'gezocht'].
offered_since_days
any
optional
Only listings placed within the last N days.
sort_by
string
optional
'relevance' (default), 'date' (newest first with desc), 'price' or 'location'.
sort_order
string
optional
'asc' or 'desc'.
limit
integer
optional
Results per page (1-100).
offset
integer
optional
Pagination: pass 'next_offset' from the previous result.
compact
boolean
optional
True (default) returns a token-efficient shortlist; False adds description, seller, images and attributes per listing.
include_unpriced
boolean
optional
Keep ads without an asking price (free, 'Bieden' without amount) when sorting by price or filtering on price. Default False: those ads would otherwise sort as €0 and flood the cheapest pages.
include_sponsored
boolean
optional
Include paid promotions (DAGTOPPER/TOPADVERTENTIE) and the sponsored top block.
Raw schema
{
"type": "object",
"properties": {
"query": {
"default": "",
"description": "Free-text search, e.g. 'racefiets' or 'iphone 15'. May be empty if a category is given.",
"type": "string"
},
"site": {
"default": "marktplaats",
"description": "Which marketplace: marktplaats (Netherlands) or 2dehands (Belgium).",
"enum": [
"marktplaats",
"2dehands"
],
"type": "string"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Top-level category name (Dutch, e.g. 'Fietsen en Brommers') or numeric id. See list_categories."
},
"subcategory": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Subcategory name (e.g. 'Fietsen | Racefietsen' or 'Fietsen | Heren | Herenfietsen') or numeric id. See list_categories with a parent."
},
"attributes": {
"anyOf": [
{
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
}
]
},
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Category-specific filters as {filter: value}, using the labels from list_category_filters, e.g. {'Merk': 'Gazelle', 'Framehoogte': '57 tot 61 cm'} or {'Bouwjaar': '2018-2022', 'Kilometerstand': '-100000', 'Brandstof': 'Benzine'}. A list means any of those values. Ranges are 'min-max', 'min-' or '-max'."
},
"postcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Dutch/Belgian postal code to search around, e.g. '1011 AB' or '2000'. Required for distance filtering and for distance_km in results."
},
"distance_km": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Max distance from postcode in kilometers (needs postcode)."
},
"price_from": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum price in euros."
},
"price_to": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum price in euros."
},
"condition": {
"anyOf": [
{
"enum": [
"new",
"as_good_as_new",
"used",
"refurbished",
"not_working"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by item condition."
},
"delivery": {
"anyOf": [
{
"enum": [
"pickup",
"shipping"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'shipping' for ads that can be shipped, 'pickup' for collection."
},
"language": {
"anyOf": [
{
"enum": [
"nl",
"fr",
"all"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "2dehands only: 'nl' for Dutch-language ads, 'fr' for French, 'all' (default)."
},
"exclude": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Drop listings whose title or description contains any of these words, e.g. ['hoesje', 'defect', 'gezocht']."
},
"offered_since_days": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Only listings placed within the last N days."
},
"sort_by": {
"default": "relevance",
"description": "'relevance' (default), 'date' (newest first with desc), 'price' or 'location'.",
"enum": [
"relevance",
"date",
"price",
"location"
],
"type": "string"
},
"sort_order": {
"default": "desc",
"description": "'asc' or 'desc'.",
"enum": [
"asc",
"desc"
],
"type": "string"
},
"limit": {
"default": 10,
"description": "Results per page (1-100).",
"maximum": 100,
"minimum": 1,
"type": "integer"
},
"offset": {
"default": 0,
"description": "Pagination: pass 'next_offset' from the previous result.",
"minimum": 0,
"type": "integer"
},
"compact": {
"default": true,
"description": "True (default) returns a token-efficient shortlist; False adds description, seller, images and attributes per listing.",
"type": "boolean"
},
"include_unpriced": {
"default": false,
"description": "Keep ads without an asking price (free, 'Bieden' without amount) when sorting by price or filtering on price. Default False: those ads would otherwise sort as €0 and flood the cheapest pages.",
"type": "boolean"
},
"include_sponsored": {
"default": false,
"description": "Include paid promotions (DAGTOPPER/TOPADVERTENTIE) and the sponsored top block.",
"type": "boolean"
}
},
"additionalProperties": false
}
get_listing_details
Fetch the full advertisement: complete description, attributes, status
(active/closed), exact listing time, view and favorite counts, bidding state,
shipping, images, and seller signals such as response rate and account age.
Parameters3
listing_id
string
required
Listing id from search results (e.g. 'm2400641485') or a pasted marktplaats.nl / 2dehands.be listing URL.
site
string
optional
Which marketplace: marktplaats (Netherlands) or 2dehands (Belgium).
Look up a seller's trust signals: verified bank account / identity /
phone number, business verification, payment method, review score and count.
Null means the marketplace does not report that signal. Use
list_seller_listings to see everything the seller currently offers.
Parameters2
seller_id
integer
required
Numeric seller id from a listing's seller field.
site
string
optional
Which marketplace: marktplaats (Netherlands) or 2dehands (Belgium).
Browse the category tree (shared by marktplaats.nl and 2dehands.be) to find
names/ids for search_listings' category and subcategory filters.
Parameters1
parent
any
optional
Omit for all top-level categories; pass a top-level category name or id for its subcategories.
Raw schema
{
"type": "object",
"properties": {
"parent": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Omit for all top-level categories; pass a top-level category name or id for its subcategories."
}
},
"additionalProperties": false
}
list_category_filters
Discover the filters available for a category or search (brand, frame
height, mileage, fuel, RAM, ...), with their valid values and how many ads
match each. Pass the labels to search_listings' 'attributes' parameter.
Parameters5
category
any
optional
Top-level category name (Dutch, e.g. 'Fietsen en Brommers') or numeric id. See list_categories.
subcategory
any
optional
Subcategory name (e.g. 'Fietsen | Racefietsen' or 'Fietsen | Heren | Herenfietsen') or numeric id. See list_categories with a parent.
site
string
optional
Which marketplace: marktplaats (Netherlands) or 2dehands (Belgium).
query
string
optional
Optional search text; needed when no category is given.
max_options
integer
optional
Max values per filter, most common first (1-200).
Raw schema
{
"type": "object",
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Top-level category name (Dutch, e.g. 'Fietsen en Brommers') or numeric id. See list_categories."
},
"subcategory": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Subcategory name (e.g. 'Fietsen | Racefietsen' or 'Fietsen | Heren | Herenfietsen') or numeric id. See list_categories with a parent."
},
"site": {
"default": "marktplaats",
"description": "Which marketplace: marktplaats (Netherlands) or 2dehands (Belgium).",
"enum": [
"marktplaats",
"2dehands"
],
"type": "string"
},
"query": {
"default": "",
"description": "Optional search text; needed when no category is given.",
"type": "string"
},
"max_options": {
"default": 25,
"description": "Max values per filter, most common first (1-200).",
"maximum": 200,
"minimum": 1,
"type": "integer"
}
},
"additionalProperties": false
}
check_new_listings
Poll for listings placed after a given moment (newest first, paid promotions
filtered out). Stateless: store the returned 'cursor' and pass it as 'since'
on the next call. When the result is truncated the cursor only advances to
the oldest ad returned, so nothing is ever skipped.
Parameters15
query
string
optional
Free-text search, e.g. 'racefiets' or 'iphone 15'. May be empty if a category is given.
site
string
optional
Which marketplace: marktplaats (Netherlands) or 2dehands (Belgium).
since
any
optional
ISO 8601 timestamp (e.g. '2026-07-15T09:00:00Z'); only listings placed after this moment are returned. Defaults to 24 hours ago. Pass the 'cursor' from the previous call to poll incrementally.
category
any
optional
Top-level category name (Dutch, e.g. 'Fietsen en Brommers') or numeric id. See list_categories.
subcategory
any
optional
Subcategory name (e.g. 'Fietsen | Racefietsen' or 'Fietsen | Heren | Herenfietsen') or numeric id. See list_categories with a parent.
attributes
any
optional
Category-specific filters as {filter: value}, using the labels from list_category_filters, e.g. {'Merk': 'Gazelle', 'Framehoogte': '57 tot 61 cm'} or {'Bouwjaar': '2018-2022', 'Kilometerstand': '-100000', 'Brandstof': 'Benzine'}. A list means any of those values. Ranges are 'min-max', 'min-' or '-max'.
postcode
any
optional
Dutch/Belgian postal code to search around, e.g. '1011 AB' or '2000'. Required for distance filtering and for distance_km in results.
distance_km
any
optional
Max distance from postcode in kilometers (needs postcode).
price_from
any
optional
Minimum price in euros.
price_to
any
optional
Maximum price in euros.
condition
any
optional
Filter by item condition.
delivery
any
optional
'shipping' for ads that can be shipped, 'pickup' for collection.
language
any
optional
2dehands only: 'nl' for Dutch-language ads, 'fr' for French, 'all' (default).
exclude
any
optional
Drop listings whose title or description contains any of these words, e.g. ['hoesje', 'defect', 'gezocht'].
limit
integer
optional
Max new listings to return (1-100).
Raw schema
{
"type": "object",
"properties": {
"query": {
"default": "",
"description": "Free-text search, e.g. 'racefiets' or 'iphone 15'. May be empty if a category is given.",
"type": "string"
},
"site": {
"default": "marktplaats",
"description": "Which marketplace: marktplaats (Netherlands) or 2dehands (Belgium).",
"enum": [
"marktplaats",
"2dehands"
],
"type": "string"
},
"since": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "ISO 8601 timestamp (e.g. '2026-07-15T09:00:00Z'); only listings placed after this moment are returned. Defaults to 24 hours ago. Pass the 'cursor' from the previous call to poll incrementally."
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Top-level category name (Dutch, e.g. 'Fietsen en Brommers') or numeric id. See list_categories."
},
"subcategory": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Subcategory name (e.g. 'Fietsen | Racefietsen' or 'Fietsen | Heren | Herenfietsen') or numeric id. See list_categories with a parent."
},
"attributes": {
"anyOf": [
{
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
}
]
},
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Category-specific filters as {filter: value}, using the labels from list_category_filters, e.g. {'Merk': 'Gazelle', 'Framehoogte': '57 tot 61 cm'} or {'Bouwjaar': '2018-2022', 'Kilometerstand': '-100000', 'Brandstof': 'Benzine'}. A list means any of those values. Ranges are 'min-max', 'min-' or '-max'."
},
"postcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Dutch/Belgian postal code to search around, e.g. '1011 AB' or '2000'. Required for distance filtering and for distance_km in results."
},
"distance_km": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Max distance from postcode in kilometers (needs postcode)."
},
"price_from": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum price in euros."
},
"price_to": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum price in euros."
},
"condition": {
"anyOf": [
{
"enum": [
"new",
"as_good_as_new",
"used",
"refurbished",
"not_working"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by item condition."
},
"delivery": {
"anyOf": [
{
"enum": [
"pickup",
"shipping"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'shipping' for ads that can be shipped, 'pickup' for collection."
},
"language": {
"anyOf": [
{
"enum": [
"nl",
"fr",
"all"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "2dehands only: 'nl' for Dutch-language ads, 'fr' for French, 'all' (default)."
},
"exclude": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Drop listings whose title or description contains any of these words, e.g. ['hoesje', 'defect', 'gezocht']."
},
"limit": {
"default": 30,
"description": "Max new listings to return (1-100).",
"maximum": 100,
"minimum": 1,
"type": "integer"
}
},
"additionalProperties": false
}
analyze_prices
Price statistics (min, quartiles, median, max, mean) over the most relevant
asking prices for a search, plus the cheapest matches. Free, bidding-only and
reserved ads are excluded and outliers beyond 1.5x the interquartile range are
trimmed. Most reliable with a subcategory plus attributes (e.g. subcategory
'Mobiele telefoons | Apple iPhone', attributes {'Model': 'iPhone 15',
'Opslagcapaciteit': '128 GB'}) instead of free text, which drags in accessories.
Parameters14
query
string
required
Free-text search, e.g. 'racefiets' or 'iphone 15'. May be empty if a category is given.
site
string
optional
Which marketplace: marktplaats (Netherlands) or 2dehands (Belgium).
category
any
optional
Top-level category name (Dutch, e.g. 'Fietsen en Brommers') or numeric id. See list_categories.
subcategory
any
optional
Subcategory name (e.g. 'Fietsen | Racefietsen' or 'Fietsen | Heren | Herenfietsen') or numeric id. See list_categories with a parent.
attributes
any
optional
Category-specific filters as {filter: value}, using the labels from list_category_filters, e.g. {'Merk': 'Gazelle', 'Framehoogte': '57 tot 61 cm'} or {'Bouwjaar': '2018-2022', 'Kilometerstand': '-100000', 'Brandstof': 'Benzine'}. A list means any of those values. Ranges are 'min-max', 'min-' or '-max'.
postcode
any
optional
Dutch/Belgian postal code to search around, e.g. '1011 AB' or '2000'. Required for distance filtering and for distance_km in results.
distance_km
any
optional
Max distance from postcode in kilometers (needs postcode).
price_from
any
optional
Minimum price in euros.
price_to
any
optional
Maximum price in euros.
condition
any
optional
Filter by item condition.
delivery
any
optional
'shipping' for ads that can be shipped, 'pickup' for collection.
language
any
optional
2dehands only: 'nl' for Dutch-language ads, 'fr' for French, 'all' (default).
exclude
any
optional
Drop listings whose title or description contains any of these words, e.g. ['hoesje', 'defect', 'gezocht'].
sample_size
integer
optional
Listings to sample, most relevant first (10-100).
Raw schema
{
"type": "object",
"properties": {
"query": {
"description": "Free-text search, e.g. 'racefiets' or 'iphone 15'. May be empty if a category is given.",
"type": "string"
},
"site": {
"default": "marktplaats",
"description": "Which marketplace: marktplaats (Netherlands) or 2dehands (Belgium).",
"enum": [
"marktplaats",
"2dehands"
],
"type": "string"
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Top-level category name (Dutch, e.g. 'Fietsen en Brommers') or numeric id. See list_categories."
},
"subcategory": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Subcategory name (e.g. 'Fietsen | Racefietsen' or 'Fietsen | Heren | Herenfietsen') or numeric id. See list_categories with a parent."
},
"attributes": {
"anyOf": [
{
"additionalProperties": {
"anyOf": [
{
"type": "string"
},
{
"items": {
"type": "string"
},
"type": "array"
}
]
},
"type": "object"
},
{
"type": "null"
}
],
"default": null,
"description": "Category-specific filters as {filter: value}, using the labels from list_category_filters, e.g. {'Merk': 'Gazelle', 'Framehoogte': '57 tot 61 cm'} or {'Bouwjaar': '2018-2022', 'Kilometerstand': '-100000', 'Brandstof': 'Benzine'}. A list means any of those values. Ranges are 'min-max', 'min-' or '-max'."
},
"postcode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Dutch/Belgian postal code to search around, e.g. '1011 AB' or '2000'. Required for distance filtering and for distance_km in results."
},
"distance_km": {
"anyOf": [
{
"exclusiveMinimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Max distance from postcode in kilometers (needs postcode)."
},
"price_from": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Minimum price in euros."
},
"price_to": {
"anyOf": [
{
"minimum": 0,
"type": "number"
},
{
"type": "null"
}
],
"default": null,
"description": "Maximum price in euros."
},
"condition": {
"anyOf": [
{
"enum": [
"new",
"as_good_as_new",
"used",
"refurbished",
"not_working"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "Filter by item condition."
},
"delivery": {
"anyOf": [
{
"enum": [
"pickup",
"shipping"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "'shipping' for ads that can be shipped, 'pickup' for collection."
},
"language": {
"anyOf": [
{
"enum": [
"nl",
"fr",
"all"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null,
"description": "2dehands only: 'nl' for Dutch-language ads, 'fr' for French, 'all' (default)."
},
"exclude": {
"anyOf": [
{
"items": {
"type": "string"
},
"type": "array"
},
{
"type": "null"
}
],
"default": null,
"description": "Drop listings whose title or description contains any of these words, e.g. ['hoesje', 'defect', 'gezocht']."
},
"sample_size": {
"default": 60,
"description": "Listings to sample, most relevant first (10-100).",
"maximum": 100,
"minimum": 10,
"type": "integer"
}
},
"required": [
"query"
],
"additionalProperties": false
}
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.
bash
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:
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."
marktplaats-mcp trailer: an AI agent searches for a racefiets and vets the seller, rendered as a retro CRT terminal session
👤 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:
The session is stored in ~/.config/marktplaats-mcp/session.json, readable by your user only. Restart your MCP client and the account tools appear.
bash
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
If login says it could not read your browser's cookies
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
Tool
What it does
Account
Writes
search_listings
Search with query, category, subcategory, category-specific attributes, price range, condition, delivery (pickup/shipping), distance from a postcode, recency, negative keywords, sorting and pagination
get_listing_details
Full ad: description, attributes, status (active/closed), exact listing time, view and favorite counts, bidding state and minimum bid, shipping, images, seller response rate and account age. Accepts pasted URLs
get_seller_profile
Trust signals: verified bank account, identity, phone, business verification, payment method, review score and count, lowest bid the seller accepts
list_seller_listings
Everything one seller has on offer: spot dealers posing as private sellers and duplicate ads
list_categories
The category tree (names and ids) used for filtering, also available as an MCP resource
list_category_filters
Discover the filters for a category (brand, frame height, mileage, fuel, RAM, ...) with their valid values and counts
check_new_listings
Newest-first monitoring with a stateless cursor: returns only ads placed after since, never skips one
analyze_prices
Median, quartiles, min, max and mean asking prices for a search, plus the cheapest matches
Your ads (views, favorites, highest bid, expiry), favorites, bids and saved searches
✅
send_message, contact_seller
Reply in a thread, or ask a seller a question or make a non-binding offer. Preview first, confirm=true to send
✅
✅
place_bid
Bid on a listing. Preview first, refuses bids below the minimum, marked destructive
✅
✅
set_favorite, extend_my_listing
Save/unsave a listing; renew one of your expiring ads
✅
✅
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
You say
The agent calls
"Is €450 a fair price for an iPhone 15 128 GB in good condition?"
analyze_prices → median, quartiles and the three cheapest ads
"Find a used Golf, 2018-2022, under 100,000 km, petrol, from a private seller"
"Tell me when new bakfiets ads appear near Antwerp"
check_new_listings(site="2dehands", postcode="2000", distance_km=25) with the returned cursor on every poll
"Ask the seller whether it's still available and offer €120"
contact_seller(..., offer_euros=120) preview → you confirm → sent
"Reply to Piet that I can pick it up Saturday"
list_conversations → send_message preview → you confirm → sent
🔒 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.
