uba-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@uba-mcp what's the air quality in Berlin right now?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| Measuring stations, filterable by city, state, type, area or name |
| One station: address, coordinates, type, data window, recent pollutants |
| Latest hourly values + LQI at a station (code, id or city name) |
| Hourly values over a date range (max 31 days) + min/max/mean & daily means |
| All 12 pollutants: code, symbol, unit, name |
| The 17 measuring networks (16 Länder + UBA) |
| 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/ -qtests/test_domain.py— offline, parses real captured API fixturestests/test_live.py— 7 cautious live requests against the UBA API
License
MIT
Built by Mohammad Abbasi — Almanibama · mabbasi.ir
Available Tools
7 toolsuba_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
Scored across 7 tools
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.
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.
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.
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
Access UK air quality data, monitoring sites, and hourly pollutant measurements across regions
Real-world data for agents: air quality, geocoding, quakes, holidays, web search
Read-only AI environmental data, meters, search, methodology, sources. No authentication required.
Find air-quality stations and read pollutant observations from government monitors via OpenAQ v3.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides access to EPA's Air Quality System API with 31 tools for querying air quality data, monitoring sites, and pollution measurements across the United States through natural language.31MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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 npmMIT
- AlicenseAqualityAmaintenanceConnects AI assistants to Swiss environmental data from BAFU, including air quality, hydrology, natural hazards, and open datasets, with no API keys required.2153 PyPI1MIT
- AlicenseNot gradedqualityBmaintenanceEnables 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