marktplaats-mcp

Overview Schema Source Related Servers Discussions Admin

Check new listings

check_new_listings

Read-onlyIdempotent

Monitor Marktplaats and 2dehands for new classifieds after a timestamp. Filter by query, category, price, location, and more, then use the returned cursor to poll incrementally without missing ads.

Instructions

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.

Input Schema

TableJSON Schema

Name	Required	Description	Default
`site`	No	Which marketplace: marktplaats (Netherlands) or 2dehands (Belgium).	marktplaats
`limit`	No	Max new listings to return (1-100).
`query`	No	Free-text search, e.g. 'racefiets' or 'iphone 15'. May be empty if a category is given.
`since`	No	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.
`exclude`	No	Drop listings whose title or description contains any of these words, e.g. ['hoesje', 'defect', 'gezocht'].
`category`	No	Top-level category name (Dutch, e.g. 'Fietsen en Brommers') or numeric id. See list_categories.
`delivery`	No	'shipping' for ads that can be shipped, 'pickup' for collection.
`language`	No	2dehands only: 'nl' for Dutch-language ads, 'fr' for French, 'all' (default).
`postcode`	No	Dutch/Belgian postal code to search around, e.g. '1011 AB' or '2000'. Required for distance filtering and for distance_km in results.
`price_to`	No	Maximum price in euros.
`condition`	No	Filter by item condition.
`attributes`	No	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'.
`price_from`	No	Minimum price in euros.
`distance_km`	No	Max distance from postcode in kilometers (needs postcode).
`subcategory`	No	Subcategory name (e.g. 'Fietsen \| Racefietsen' or 'Fietsen \| Heren \| Herenfietsen') or numeric id. See list_categories with a parent.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`note`	No
`site`	Yes
`since`	Yes
`cursor`	Yes
`listings`	Yes
`new_count`	Yes
`truncated`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed11 schema fields changedv0.2.0Sep 26, 2026

addedInput schema / properties / attributes

Added value: +{
+  "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'."
+}

addedInput schema / properties / delivery

Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "pickup",
+        "shipping"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "'shipping' for ads that can be shipped, 'pickup' for collection."
+}

changedInput schema / properties / distance_km / description

Previous value: -"Max distance from postcode in kilometers."New value: +"Max distance from postcode in kilometers (needs postcode)."

addedInput schema / properties / exclude

Added value: +{
+  "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']."
+}

addedInput schema / properties / language

Added value: +{
+  "anyOf": [
+    {
+      "enum": [
+        "nl",
+        "fr",
+        "all"
+      ],
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "description": "2dehands only: 'nl' for Dutch-language ads, 'fr' for French, 'all' (default)."
+}

changedInput schema / properties / postcode / description

Previous value: -"Dutch/Belgian postal code to search around, e.g. '1011 AB' or '2000'. Required for distance filtering."New value: +"Dutch/Belgian postal code to search around, e.g. '1011 AB' or '2000'. Required for distance filtering and for distance_km in results."

changedInput schema / properties / subcategory / description

Previous value: -"Subcategory name (e.g. 'Fietsen | Racefietsen') or numeric id."New value: +"Subcategory name (e.g. 'Fietsen | Racefietsen' or 'Fietsen | Heren | Herenfietsen') or numeric id. See list_categories with a parent."

removedOutput schema / additionalProperties
```
Removed value: -true
```

addedOutput schema / properties

Added value: +{
+  "cursor": {
+    "title": "Cursor",
+    "type": "string"
+  },
+  "listings": {
+    "items": {
+      "properties": {
+        "attributes": {
+          "anyOf": [
+            {
+              "additionalProperties": {
+                "type": "string"
+              },
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Attributes"
+        },
+        "category_id": {
+          "anyOf": [
+            {
+              "type": "integer"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Category Id"
+        },
+        "city": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "City"
+        },
+        "description": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Description"
+        },
+        "distance_km": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Distance Km"
+        },
+        "id": {
+          "title": "Id",
+          "type": "string"
+        },
+        "image_urls": {
+          "anyOf": [
+            {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Image Urls"
+        },
+        "is_business": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Is Business"
+        },
+        "is_sponsored": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Is Sponsored"
+        },
+        "listed": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Listed"
+        },
+        "price": {
+          "title": "Price",
+          "type": "string"
+        },
+        "price_euros": {
+          "anyOf": [
+            {
+              "type": "number"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Price Euros"
+        },
+        "reserved": {
+          "anyOf": [
+            {
+              "type": "boolean"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null,
+          "title": "Reserved"
+        },
+        "seller": {
+          "anyOf": [
+            {
+              "properties": {
+                "id": {
+                  "anyOf": [
+                    {
+                      "type": "integer"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null,
+                  "title": "Id"
+                },
+                "is_verified": {
+                  "anyOf": [
+                    {
+                      "type": "boolean"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null,
+                  "title": "Is Verified"
+                },
+                "name": {
+                  "anyOf": [
+                    {
+                      "type": "string"
+                    },
+                    {
+                      "type": "null"
+                    }
+                  ],
+                  "default": null,
+                  "title": "Name"
+                }
+              },
+              "title": "Seller",
+              "type": "object"
+            },
+            {
+              "type": "null"
+            }
+          ],
+          "default": null
+        },
+        "title": {
+          "title": "Title",
+          "type": "string"
+        },
+        "url": {
+          "title": "Url",
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "title",
+        "price",
+        "url"
+      ],
+      "title": "Listing",
+      "type": "object"
+    },
+    "title": "Listings",
+    "type": "array"
+  },
+  "new_count": {
+    "title": "New Count",
+    "type": "integer"
+  },
+  "note": {
+    "anyOf": [
+      {
+        "type": "string"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "title": "Note"
+  },
+  "since": {
+    "title": "Since",
+    "type": "string"
+  },
+  "site": {
+    "title": "Site",
+    "type": "string"
+  },
+  "truncated": {
+    "anyOf": [
+      {
+        "type": "boolean"
+      },
+      {
+        "type": "null"
+      }
+    ],
+    "default": null,
+    "title": "Truncated"
+  }
+}

addedOutput schema / required

Added value: +[
+  "site",
+  "since",
+  "cursor",
+  "new_count",
+  "listings"
+]

addedOutput schema / title
```
Added value: +"NewListingsResult"
```

First observedv0.1.1Jul 15, 2026

TDQS

A4.5/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Beyond the annotations (readOnly, idempotent, non-destructive), the description discloses critical behavior: the tool is stateless, paid promotions are filtered out, and when results are truncated the cursor deliberately only advances to the oldest returned ad so no listing is skipped. This is exactly the kind of behavioral nuance an agent needs.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three tight sentences, each earning its place: the core action, the cursor state protocol, and the truncation caveat. It is front-loaded and contains no filler.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the high-quality input schema, annotations, and output schema, the description covers the non-obvious usage contract completely: stateless polling, cursor advancement semantics, and the no-skip guarantee. Nothing essential for correct invocation is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Input schema coverage is 100%, with rich per-parameter descriptions, so the baseline is 3. The description adds the cursor/since relationship, but most parameter meaning already lives in the schema; no compensation is needed.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses a specific verb ('Poll') and resource ('listings'), and pinpoints the exact behavior: listings placed after a given moment, newest first, paid promotions filtered out. This clearly distinguishes it from general-purpose siblings like search_listings or list_seller_listings, even without naming them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives clear operational context: poll incrementally by storing and passing the returned cursor as 'since'. It does not explicitly state when to prefer this over search_listings or other siblings, so it stops short of full when/when-not guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server