data.overheid.nl MCP — the Netherlands national open-data portal (CKAN API)
Four tools with complete schemas and descriptions. Naming follows verb_noun pattern (search_, dataset_, list_). Descriptions are clear and contextual (avg 180 chars), explaining WHAT each tool does and WHEN to use it. All parameters have type definitions and descriptions. However, output schemas are not documented, LLMs cannot predict response structure for planning. Error handling is minimal (generic HTTP errors). No parameter validation guidance (e.g., 'rows must be 1-1000'). Missing tool annotations (readOnlyHint, idempotentHint). No pagination guidance despite search_datasets supporting offset/limit.
Full dataset record by id or slug (CKAN package_show), including its resources. Each resource has a download "url" and "format" (CSV/JSON/etc.) — the portal is metadata-only, so fetch those URLs to get the actual data.
List thematic groups/categories on data.overheid.nl (CKAN group_list). Note: this portal currently exposes no groups (returns an empty list) — prefer fq facets on search_datasets to narrow by theme.
List publishing organizations (ministries/agencies/provinces) on data.overheid.nl (CKAN organization_list). Use an org "name" in search_datasets fq, e.g. "organization:<name>".
Search the data.overheid.nl catalogue of Dutch government open data (CKAN package_search). Returns matching datasets with titles/descriptions (mostly Dutch). Query may be Dutch or English; Dutch matches more.
Output schemas not documented. LLMs cannot predict response structure (fields, types, nested objects) for downstream planning or field extraction.
No tool annotations (readOnlyHint, idempotentHint). All four tools are read-only and idempotent, but LLMs cannot infer this without explicit hints.
Pagination guidance missing. search_datasets accepts rows/start but description does not explain pagination strategy or result limits.
Error handling is generic. ckanGet() throws raw HTTP errors without recovery guidance. LLMs cannot determine if errors are retryable or user-fixable.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 68 | 2026-07-28+ | v2 |
Parameter constraints not enforced in descriptions. 'rows' accepts 1-1000 but description does not state this range; LLMs may pass invalid values.