English Français العربية

io.github.ContentWriterco/powietrze-mcp

Official registry Other

Air quality in Poland: live GIOŚ measurements, smog warnings, CAMS forecast and pollen

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http powietrze-mcp 'https://powietrze.compabase.com/mcp'
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "powietrze-mcp": {
            "type": "http",
            "url": "https://powietrze.compabase.com/mcp"
        }
    }
}
NPM package powietrze-mcp
Claude Code 
claude mcp add powietrze-mcp -- npx -y powietrze-mcp@0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "powietrze-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "powietrze-mcp@0.1.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. powietrze-mcp 🌫️
  2. Podłącz w 30 sekund
  3. Co potrafi
  4. Skąd dane
  5. Własny serwer
  6. Licencja
  7. English

powietrze-mcp 🌫️

Jakość powietrza, smog i pyłki w Polsce – dla Twojego asystenta AI.

Serwer MCP z bieżącymi pomiarami państwowych stacji GIOŚ, indeksem jakości powietrza, ostrzeżeniami smogowymi i prognozą CAMS (Copernicus) na 3 dni. Działa w Claude, ChatGPT, Cursorze i każdym kliencie MCP.

Prawdziwa odpowiedź publicznego serwera (22.10.2026, 22:00).

Podłącz w 30 sekund

Adres MCP: https://powietrze.compabase.com/mcp (Streamable HTTP, bez logowania).

  • Claude: Ustawienia → Connectors → Add custom connector → wklej adres.
  • ChatGPT: Settings → Connectors (tryb deweloperski) → dodaj serwer MCP.
  • Claude Code: claude mcp add --transport http powietrze https://powietrze.compabase.com/mcp
  • Lokalnie (stdio): npx -y powietrze-mcp, np. w Claude Desktop:
{ "mcpServers": { "powietrze": { "command": "npx", "args": ["-y", "powietrze-mcp"] } } }

Co potrafi

NarzędzieDo czego
air_qualityDla miejscowości, adresu albo współrzędnych: najbliższe stacje GIOŚ (do 25 km) z indeksem jakości powietrza (bardzo dobry … bardzo zły), ostatnimi pomiarami PM2.5, PM10, NO2, O3, SO2, średnią dobową pyłów i odniesieniem do norm; ostrzeżenia smogowe GIOŚ w województwie; prognoza na 3 dni z modelu Copernicus CAMS – maksymalne PM2.5/PM10, europejski indeks jakości powietrza i pyłki (brzoza, olsza, trawy, bylica, ambrozja).
air_stationsStacje pomiarowe GIOŚ w mieście, gminie, powiecie albo województwie.
data_sourcesŹródła i zastrzeżenia.

Przykładowe pytania: „Czy mogę dziś pobiegać w Krakowie?”, „Jaki jest smog w Zakopanem i czy jutro będzie lepiej?”, „Czy w weekend będzie dużo pyłków brzozy w Warszawie?”, „Jaka jest jakość powietrza przy ul. Marszałkowskiej 1 w Warszawie?”.

Skąd dane

  • Pomiary: Główny Inspektorat Ochrony Środowiska – Państwowy Monitoring Środowiska, API https://api.gios.gov.pl/pjp-api (ok. 290 stacji, wartości godzinowe; dane bieżące są niezweryfikowane). Odpowiedzi trzymamy w pamięci podręcznej (lista stacji 12 h, pomiary i indeks 15 min), żeby nie obciążać GIOŚ.
  • Prognoza i pyłki: Copernicus Atmosphere Monitoring Service (CAMS) przez Open-Meteo (CC BY 4.0) – model w siatce ok. 10 km, nie zastępuje pomiaru. Można wyłączyć: POWIETRZE_FORECAST=0.
  • Adresy: GUGiK (państwowy rejestr adresów).

Własny serwer

npx -y powietrze-mcp --http --port 3000      # MCP: http://localhost:3000/mcp
npx -y powietrze-mcp now "Kraków, Rynek Główny 1"
npx -y powietrze-mcp stations "małopolskie"

Zmienne: POWIETRZE_FORECAST=0, POWIETRZE_RATE_LIMIT, POWIETRZE_STATS=1 (anonimowe liczniki pod /stats), POWIETRZE_CONTACT, POWIETRZE_PUBLIC_URL.

Licencja

Kod: MIT. Dane: GIOŚ (Państwowy Monitoring Środowiska), Copernicus CAMS / Open-Meteo (CC BY 4.0), GUGiK – dane przetworzone. Projekt niezależny, hostowany pro publico bono przez Compabase. Zobacz też rozkład-mcp, ceny-nieruchomosci-mcp i leki-mcp.

English

powietrze-mcp gives AI assistants live air quality in Poland: the nearest official GIOŚ monitoring stations with the Polish air quality index and the latest hourly PM2.5, PM10, NO2, O3 and SO2, smog warnings for the voivodeship, and a 3-day Copernicus CAMS forecast of particulate matter and pollen (birch, alder, grass, mugwort, ragweed). Public endpoint: https://powietrze.compabase.com/mcp (no key), or run locally with npx -y powietrze-mcp.

Frequently asked questions

What is io.github.ContentWriterco/powietrze-mcp?

Air quality in Poland: live GIOŚ measurements, smog warnings, CAMS forecast and pollen

How do I install io.github.ContentWriterco/powietrze-mcp?

It runs as a remote server. In Claude Code: claude mcp add --transport http powietrze-mcp 'https://powietrze.compabase.com/mcp'. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.ContentWriterco/powietrze-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.ContentWriterco/powietrze-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.ContentWriterco/powietrze-mcp?

It is published by ContentWriterco. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.