@pipeworx/knmi

Connect: https://gateway.pipeworx.io/knmi/mcp · Install: one-click buttons

No MCP client? Skip the connection: POST https://gateway.pipeworx.io/v1/tools/search_packs {"query":"..."} to find a tool below, GET /v1/tools/<name> for its schema, POST the same URL with arguments for the data — see For AI agents.

Tools: 3

Dutch national weather service open data — station observations, national radar precipitation, HARMONIE-AROME forecast runs and the gridded daily climate series — from the KNMI Data Platform Open Data API.

Tools

• knmi_datasets(search?, verify?, limit?) — the datasets worth calling, what each contains, how often it updates, and (checked live) its newest file.
• knmi_dataset_files(dataset, version, max_keys?, order_by?, sorting?, begin?, page_token?) — files in a dataset, newest first by default.
• knmi_file_url(dataset, version, filename) — a temporary signed download URL for one file.

Auth

Keyless in practice, keyed by design. Every endpoint needs an Authorization header, but KNMI publishes a shared anonymous key on its docs page and this pack ships it as the default, so callers need nothing. BYO override via _apiKey for a registered key.

The anonymous key is shared worldwide (50 requests/minute, 3000/hour) and KNMI rotates it on an expiry date printed on the docs page:

• A 429 is that shared bucket, not an outage. A registered key gets a dedicated 200 req/s.
• A 401/403 means the published key has rotated — read the “Anonymous key” section of https://developer.dataplatform.knmi.nl/open-data-api and update ANON_KEY. The tools refuse with wording that says so.

Register free at https://developer.dataplatform.knmi.nl/. A Pipeworx-held key would be PLATFORM_KNMI_KEY; declare platformKeyEnv in the pack manifest in the same change that lands the value, never before.

Whole-dataset downloads need a separate bulk key by email to [email protected]. KNMI’s fair-use policy treats aggressive polling as abuse; use their Notification Service for new-file push instead of tight loops.

Data sources

• GET /open-data/v1/datasets/{dataset}/versions/{version}/files — file listing.
• GET /open-data/v1/datasets/{dataset}/versions/{version}/files/{filename}/url — signed download URL.
• Docs: https://developer.dataplatform.knmi.nl/open-data-api

Things worth knowing:

• There is no /datasets listing endpoint — it answers 404. knmi_datasets carries a curated registry instead and verifies each entry live, so a retired dataset reports as retired rather than vanishing.
• Auth is checked before routing, so an unknown path also answers 401. You cannot probe the route table without a key.
• Dataset names are opaque and versioned as strings ("1.0", "2", "5").
• Actuele10mindataKNMIstations/2 still answers but stopped receiving files; 10-minute-in-situ-meteorological-observations/1.0 replaced it. A stale newest-file timestamp is the only signal, hence verify.
• Files are scientific binaries (NetCDF, HDF5, GRIB in tar), not JSON. HARMONIE runs are 1–3 GB each.
• Responses may carry an X-KNMI-Deprecation header ahead of a dataset retiring.

Verified

2026-09-17 — 11 datasets verified live; radar composite listing and a signed download URL both returned real payloads on the published anonymous key.

Tools

• knmi_datasets — The KNMI Data Platform datasets worth calling, with what each one contains, how often it updates and its file format — and, checked live, the timestamp of its newest file. AUTHORITATIVE starting point
• knmi_dataset_files — List the files in one KNMI Data Platform dataset, newest first by default. Returns filename, size in bytes, creation and last-modified timestamps, plus a page token. This is how you find the most rece
• knmi_file_url — Mint a temporary download URL for one file in a KNMI Data Platform dataset. Returns the signed URL, the content type, the byte size and when the file was last modified. The URL is short-lived and must