Knmi MCP server

@pipeworx/knmi

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.

Part of Pipeworx — an MCP gateway connecting AI agents to 1679+ live data sources.

Tools

each contains, how often it updates, and (checked live) its newest file.

• knmi_datasets(search?, verify?, limit?) — the datasets worth calling, what

files in a dataset, newest first by default.

• knmidatasetfiles(dataset, version, maxkeys?, orderby?, sorting?, begin?, page_token?) —

for one file.

• knmifileurl(dataset, version, filename) — a temporary signed download URL

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:

dedicated 200 req/s.

• A 429 is that shared bucket, not an outage. A registered key gets a

section of and update ANON_KEY. The tools refuse with wording that says so.

• A 401/403 means the published key has rotated — read the "Anonymous key"

Register free at . A Pipeworx-held key would be PLATFORMKNMIKEY; 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 opendata@knmi.nl. KNMI's fair-use policy treats aggressive polling as abuse; use their Notification Service for new-file push instead of tight loops.

Data sources

signed download URL.

• GET /open-data/v1/datasets/{dataset}/versions/{version}/files — file listing.
• GET /open-data/v1/datasets/{dataset}/versions/{version}/files/{filename}/url —

• Docs:

Things worth knowing:

carries a curated registry instead and verifies each entry live, so a retired dataset reports as retired rather than vanishing.

• There is no /datasets listing endpoint — it answers 404. knmi_datasets

cannot probe the route table without a key.

• Auth is checked before routing, so an unknown path also answers 401. You

10-minute-in-situ-meteorological-observations/1.0 replaced it. A stale newest-file timestamp is the only signal, hence verify.

• Dataset names are opaque and versioned as strings ("1.0", "2", "5").
• Actuele10mindataKNMIstations/2 still answers but stopped receiving files;

runs are 1–3 GB each.

• Files are scientific binaries (NetCDF, HDF5, GRIB in tar), not JSON. HARMONIE

• 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.

Quick Start

Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):

{
  "mcpServers": {
    "knmi": {
      "url": "https://gateway.pipeworx.io/knmi/mcp"
    }
  }
}

What this endpoint actually serves

tools/list at https://gateway.pipeworx.io/knmi/mcp returns the tools in the table above plus the shared Pipeworx meta-tools — askpipeworx, discovertools, search_within, remember/recall and the rest of the gateway-wide set. So the tool count you see is larger than this table: a single-pack endpoint currently lists roughly 30 shared tools alongside the pack's own. The connection's initialize response states its exact scope, and is the authoritative answer for a given day.

Shortened. The full README is on GitHub.