Command-line tool and TypeScript library

mudab

A tiny, dependency-light TypeScript client + CLI for the MUDAB (Meeresumweltdatenbank — the German marine environment database) REST API: marine-monitoring data from the coastal Bundesländer and research institutions, hosted by the Bundesanstalt für Gewässerkunde (BfG) and surfaced by the Umweltbundesamt (UBA). A bund.dev API.

Version 0.0.5 npm GitHub API reference

Install

Needs Node.js 20 or newer. Installs the mudab command:

npm i -g @maschinenlesbar.org/mudab-cli

Access

No account, no API key, no configuration — install and query.

Quick start

mudab stations --count 5                      # measurement stations
mudab project-stations                        # monitoring projects (region, institute)
mudab parameters --compartment wasser         # water parameters
mudab measurements --from 0 --count 200       # station measurements (page it — huge)
mudab plc-stations                            # HELCOM PLC river-load stations
mudab plc-measurements --all                  # river pollutant loads
mudab compartments                            # compartment code table (offline)

Commands

All commands, arguments and options →

Claude Code skills

The mudab plugin teaches Claude to use mudab. Install it from the maschinenlesbar.org marketplace:

/plugin marketplace add maschinenlesbar-org/plugins
/plugin install mudab@maschinenlesbar

TypeScript library

@maschinenlesbar.org/mudab-cli is also a typed API client you can import in your own code, with no runtime HTTP dependencies.

The tool, not the data

The data comes from the provider behind the API, under its own terms — see DATA_LICENSE.md. The code is dual-licensed AGPL-3.0-or-later or commercial — see LICENSING.md.