Stofscout MCP Server
by techbybuild
README.md
# 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.
- **Website:** https://stofscout.nl
- **Remote MCP Server (Streamable HTTP):** `https://stofscout.nl/mcp`
- **MCP Server Card:** https://stofscout.nl/.well-known/mcp/server-card.json
- **OpenAPI 3.1 Spec:** https://stofscout.nl/openapi.json
- **LLM Guide (`llms.txt`):** https://stofscout.nl/llms.txt
- **Dutch Robot Vacuum Market Index (CSV, CC BY 4.0):** https://stofscout.nl/cijfers/csv (mirrored monthly in [`data/robotstofzuiger-marktcijfers.csv`](data/robotstofzuiger-marktcijfers.csv))
- **RSS Feed (Blog & Kennisbank):** https://stofscout.nl/rss.xml
Built and maintained by [Tech by Build](https://techbybuild.com) (Amsterdam, Netherlands). Sister project of [Vinylscout](https://github.com/techbybuild/vinylscout-mcp).
---
## 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:
```text
https://stofscout.nl/mcp
```
### Cursor / Windsurf / VS Code / Antigravity (`mcp.json`)
```json
{
"mcpServers": {
"stofscout": {
"url": "https://stofscout.nl/mcp"
}
}
}
```
### Quick Test (`curl`)
```bash
curl -s -X POST https://stofscout.nl/mcp \
-H 'Content-Type: application/json' \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
```
```bash
# 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
| Tool | Description |
| :--- | :--- |
| `zoek_robotstofzuigers` | Search 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_details` | Get 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_modellen` | Compare any two robot vacuums side by side on live price, price gap, shared shops in stock, and differences in checked specifications. |
| `zoek_onderdelen` | Find verified compatible replacement parts (dust bags, filters, main brushes, side brushes, mop pads, maintenance kits) with per-piece pricing for one model. |
| `aanbiedingen` | Get today's verified deals and genuine price drops at Dutch web shops (compared against earlier readings or a second shop). |
| `marktcijfers` | Get 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`](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.
- **Live figures & methodology:** https://stofscout.nl/cijfers
- **How prices & specs are verified:** https://stofscout.nl/hoe-we-prijzen-vergelijken
- **License for dataset:** [CC BY 4.0](https://creativecommons.org/licenses/by/4.0/) — free to use and cite with attribution to **Stofscout.nl** (`https://stofscout.nl/cijfers`).
---
## 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.
This server cannot be deployed
Maintenance
ActivityMaintained
ResponsivenessNo recent community issues