Skip to main content
Glama

uba-mcp 🌬️

mcp-name: io.github.mohammad-abbasi-sh/uba-mcp

Unofficial read-only MCP server for UBA air quality — the Umweltbundesamt (German Federal Environment Agency) Air Data API v4: hourly measurements from ~400 German stations (PM10, PM2.5, NO2, O3, SO2, CO, benzene …) since 2016, with the official UBA air-quality index (LQI). No key, no login.

Built by Mohammad Abbasi as part of the "Germany MCP factory". Not affiliated with the Umweltbundesamt.

For AI agents

Add to your MCP client config (stdio):

{
  "mcpServers": {
    "uba": {
      "command": "uvx",
      "args": ["uba-mcp==0.1.0"]
    }
  }
}

Or run locally: python -m uba_mcp.server (needs mcp<2, httpx).

Related MCP server: mcp-opensensemap

Tools

Tool

Description

uba_list_stations

Measuring stations, filterable by city, state, type, area or name

uba_station_detail

One station: address, coordinates, type, data window, recent pollutants

uba_current_air_quality

Latest hourly values + LQI at a station (code, id or city name)

uba_measurements

Hourly values over a date range (max 31 days) + min/max/mean & daily means

uba_list_components

All 12 pollutants: code, symbol, unit, name

uba_list_networks

The 17 measuring networks (16 Länder + UBA)

uba_health

Reachability check (ok / blocked / error) — one polite request

Example output (uba_current_air_quality / Berlin Neukölln, 2026-11-11 09:00 CET):

{"station": {"code": "DEBE034", "name": "Berlin Neukölln", "city": "Berlin"},
 "hour": {"start": "2026-11-11 09:00:00", "total_index": 2, "total_label": "moderate",
  "values": [{"code": "PM2", "value": 17.0, "unit": "µg/m³", "label": "moderate"},
             {"code": "PM10", "value": 23.0, "unit": "µg/m³", "label": "good"},
             {"code": "O3", "value": 24.0, "unit": "µg/m³", "label": "very good"},
             {"code": "NO2", "value": 15.0, "unit": "µg/m³", "label": "good"}]}}

Notes:

  • Stations are found by code (DEBE010 = Berlin Wedding), numeric id, or city name (first active station in that city).

  • The index / total_index (0–4) and labels come from the API itself; they follow the UBA LQI, 2025 revision (hourly means, µg/m³):

Class

NO2

PM10

PM2.5

O3

SO2

0 very good

0–10

0–9

0–5

0–24

0–10

1 good

11–30

10–27

6–15

25–72

11–30

2 moderate

31–60

28–54

16–30

73–144

31–60

3 poor

61–100

55–90

31–50

145–240

61–100

4 very poor

>100

>90

>50

>240

>100

  • All times are CET/CEST as returned by the API. Data: UBA Air Data API v4 umweltbundesamt.de/api/air_data/v4 — no key, no login, read-only.

Development

python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
.venv/bin/pip install -e .
.venv/bin/python -m pytest tests/ -q
  • tests/test_domain.py — offline, parses real captured API fixtures

  • tests/test_live.py — 7 cautious live requests against the UBA API

License

MIT


Built by Mohammad Abbasi — Almanibama · mabbasi.ir

Available Tools

7 tools
uba_current_air_qualityA

Latest hourly air quality at a station: each pollutant's value (µg/m³) with the UBA air-quality index class (very good / good / moderate / poor / very poor) and the overall index for that hour. station: code (DEBE010), numeric id, or city name.

Inputs: station (required). Returns: result

uba_healthA

Check whether the UBA Air Data API is reachable right now.

Returns status ok (HTTP 200), blocked (HTTP 403/429 — bot wall or rate limit) or error, plus the HTTP status and the probed URL. One polite request; it does not fetch any listings.

Inputs: no named parameters. Returns: result

uba_list_componentsB

All pollutants UBA publishes air-quality data for: code, symbol, unit and name (PM10, PM2.5, NO2, O3, SO2, CO, benzene, lead ...).

Inputs: no named parameters. Returns: result

uba_list_networksB

The measuring networks behind the stations: one per Bundesland (16) plus the UBA's own network.

Inputs: no named parameters. Returns: result

uba_list_stationsA

List German air-quality measuring stations, filterable by city, state (network code like BE or name like Berlin), type (background / traffic / industry), area (urban / suburban / rural) or a name/code substring. limit: 1..100 (default 20).

Inputs: area, city, limit, query, +3 more. Returns: result

uba_measurementsA

Hourly air-quality values for a station over a date range (max 31 days), with per-pollutant min/max/mean and daily means. component: one pollutant code (PM10, PM2, NO2, O3, SO2, CO ...) to limit the series to it; empty = all pollutants the station measures. station: code (DEBE010), numeric id, or city name.

Inputs: date_to (required), station (required), date_from (required), component. Returns: result

uba_station_detailA

Full detail of one measuring station: code, name, city, address, coordinates, type, area, network, active period, data availability window, and which pollutants have recent data. station: code (DEBE010), numeric id, or city name.

Inputs: station (required). Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 7 tools

    Disambiguation4/5

    Each tool maps to a distinct resource or action: listing stations/components/networks, station detail, current snapshot, historical series, and connectivity check. The only mild overlap is uba_current_air_quality vs uba_measurements, but the descriptions make the 'latest hour' vs 'date range with aggregates' distinction clear.

    Naming Consistency4/5

    All names share the uba_ prefix, which makes the family instantly recognizable. The verb style is not strictly uniform (list_* verbs mixed with noun-only names like uba_station_detail, uba_measurements, uba_health), but the pattern remains readable and predictable by resource.

    Tool Count5/5

    Seven tools is well-scoped for a read-only wrapper around the UBA Air Data API. Every tool earns its place: discovery (stations, components, networks), retrieval (detail, current, measurements) and a diagnostic health probe.

    Completeness4/5

    The read-only surface covers discovery, detail, current values, historical measurements and API health, with no obvious dead ends for the stated purpose. Minor gaps exist—no cross-station pollutant search or way to fetch the index-class definitions themselves—but agents can work around these via the existing tools.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to query environmental sensor data from the openSenseMap citizen-science network, allowing access to air quality, weather, and other sensor measurements through natural language.
      80 npm
      MIT
    • A
      license
      A
      quality
      A
      maintenance
      Connects AI assistants to Swiss environmental data from BAFU, including air quality, hydrology, natural hazards, and open datasets, with no API keys required.
      21
      53 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to search and retrieve German open data through a remote, stateless Streamable HTTP endpoint — public procurement notices, Marktstammdatenregister energy units, and Bundesnetzagentur EV charging stations — with keyword, location, technology, and capacity filters plus aggregate statistics and data-freshness checks.
      MIT