Repository avatar
Other Tools
v1.0.0
active

stofscout-mcp

io.github.techbybuild/stofscout-mcp

Live Dutch robot vacuum prices (incl. shipping), verified specs, deals, comparisons & spare parts.

Documentation

Stofscout MCP Server & Public Data

Live Dutch robot vacuum price comparison across Dutch web shops, with daily price history, manufacturer-sourced specs, verified compatible spare parts, and daily deals — accessible via a free, public, read-only remote MCP server with zero authentication required.

Built and maintained by Tech by Build (Amsterdam, Netherlands). Sister project of Vinylscout.


Connect the Remote MCP Server

No API key or OAuth setup is required. All tools are read-only (readOnlyHint: true, idempotentHint: true).

Claude.ai / Claude Desktop (Custom Connector)

Add a remote MCP connector pointing to:

https://stofscout.nl/mcp

Cursor / Windsurf / VS Code / Antigravity (mcp.json)

{
  "mcpServers": {
    "stofscout": {
      "url": "https://stofscout.nl/mcp"
    }
  }
}

Quick Test (curl)

curl -s -X POST https://stofscout.nl/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
# Find robot vacuums under 8 cm high and under € 500
curl -s -X POST https://stofscout.nl/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"zoek_robotstofzuigers","arguments":{"max_hoogte_cm":8,"max_prijs":500,"limiet":5}}}'

Available MCP Tools

ToolDescription
zoek_robotstofzuigersSearch and filter robot vacuums sold in the Netherlands by brand, max price (EUR incl. shipping), suction (Pa), max height (cm), threshold climbing (mm), noise (dB), runtime (min), or checked features (self-emptying, mopping, mop washing/drying, LiDAR, water connection).
model_detailsGet live per-shop prices (incl. Dutch shipping & delivery time), 90-day deal check, verified specifications with manufacturer source URLs and check dates, official PDF manual link, and compatible parts count for one model.
vergelijk_modellenCompare any two robot vacuums side by side on live price, price gap, shared shops in stock, and differences in checked specifications.
zoek_onderdelenFind verified compatible replacement parts (dust bags, filters, main brushes, side brushes, mop pads, maintenance kits) with per-piece pricing for one model.
aanbiedingenGet today's verified deals and genuine price drops at Dutch web shops (compared against earlier readings or a second shop).
marktcijfersGet the live Dutch robot vacuum market index (model count, min/median/max price, price bands, checked feature medians, suction distribution, and cross-shop price spread; CC BY 4.0).

Every HTML page on stofscout.nl also returns clean Markdown when requested with Accept: text/markdown.


Open Dataset: Dutch Robot Vacuum Market Index (data/robotstofzuiger-marktcijfers.csv)

data/robotstofzuiger-marktcijfers.csv is mirrored automatically from https://stofscout.nl/cijfers/csv and tracks the Dutch robot vacuum market across hundreds of in-stock models.


Usage Guidelines for AI Assistants

  • Prices are in EUR including stated Dutch shipping and are refreshed daily — always mention the date and note that the shop's own checkout price is authoritative.
  • Unchecked specifications are intentionally left empty rather than guessed; do not extrapolate missing values.
  • Stofscout writes no editorial reviews and gives no subjective ratings; link users to the canonical https://stofscout.nl/robotstofzuiger/{slug} or https://stofscout.nl/vergelijk/{a}-vs-{b} URLs returned by the tools.