imgw-mcp
This MCP server exposes IMGW-PIB Polish weather, hydrological, and warning data through five read-only tools.
Get current synoptic weather observations for all ~60 stations or one station (temperature, wind, humidity, precipitation, pressure).
Get hydrological readings for ~900 stations, including water level, flow, water temperature, thresholds, and computed alarm/warning status; filter by river, station, province, limit, or only alerts.
Get active IMGW meteorological warnings with event type, severity, probability, and validity window.
List synoptic weather station names.
List hydrological station names, rivers, and provinces, optionally filtered by river or province.
No API key required; data sourced from IMGW public feed.
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., "@imgw-mcp What's the weather in Warsaw 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.
honest-imgw-mcp
Local MCP server for IMGW-PIB (Polish Institute of Meteorology and Water Management) public data feed — current weather, hydrological readings, and active meteorological warnings across Poland.
Part of the honest-mcp family of small, auditable, local-first MCP servers.
Why
Anyone in Poland who watches river levels (flood-plain landlord, kayaker, farmer), plans outdoor work, or just wants a native alternative to yr.no or the ECMWF apps can hand IMGW's raw feed to their AI in one line. No API key. No rate limit worth worrying about.
Related MCP server: Global Weather MCP Server
Features
Five tools:
get_weather— current synoptic observations. Whole country (~60 stations) or one station.get_hydro— hydrological readings. Water level, flow, water temperature, alarm/warning thresholds. Server annotates each with computedalarm_status(normal / warning / alarm).get_warnings— active IMGW meteorological warnings (storms, frost, heat, precipitation, wind) with severity and validity window.list_weather_stations— station-name index forget_weather.list_hydro_stations— station index with rivers and provinces, filterable, forget_hydro.
Data source
Endpoint: danepubliczne.imgw.pl/api/data — IMGW public data feed
No API key
Refresh: synop hourly, hydro every ~20 minutes, warnings whenever a new one is issued
Requirements
Python 3.10+
Setup
git clone https://github.com/bartosz-kuc/honest-imgw-mcp.git
cd honest-imgw-mcp
python3 -m venv venv
./venv/bin/pip install -r requirements.txtOn Windows use python instead of python3, and venv\Scripts\pip / venv\Scripts\python instead of the venv/bin/... paths shown here and below.
Register with Claude Code:
claude mcp add imgw /absolute/path/to/venv/bin/python /absolute/path/to/server.pyClaude Desktop claude_desktop_config.json:
{
"mcpServers": {
"imgw": {
"command": "/absolute/path/to/venv/bin/python",
"args": ["/absolute/path/to/server.py"]
}
}
}Example usage
"What's the temperature in Warsaw right now?"
get_weather(station="warszawa") → single-station JSON with temperature, wind, humidity, precipitation, pressure.
"Any active storm warnings?"
get_warnings() → list of active warnings, filter yourself by nazwa_zdarzenia.
"Any rivers in Mazowieckie above alarm level?"
get_hydro(province="mazowieckie", only_alerts=true) → just stations where current level ≥ alarm threshold.
Data flow
Your AI client
↕ MCP stdio
This server (Python, on your machine)
↕ HTTPS
danepubliczne.imgw.plNo cloud middle. No telemetry.
Author
Bartosz Kuć — Warsaw-based developer, JDG owner running skanfirmy.pl.
GitHub: https://github.com/bartosz-kuc
Email: firma@bartosza.pl
Consulting
Available for consulting on Polish tax and business integrations (KSeF, GUS/NFZ/GIOŚ APIs, mBank data), MCP server design, and AI-assisted tooling for JDGs and small teams. See skanfirmy.pl/uslugi for productized packages (audit 3k PLN, setup 8-15k PLN, retainer 2-4k PLN/mo), or reach out via email.
License
MIT — see LICENSE.
Related
Part of the honest-mcp family — see the family index.
Available Tools
5 toolsget_hydroA
Get current hydrological readings from IMGW. Includes water level (stan_wody), flow rate, water temperature, and the alarm / warning threshold levels for the station. Server annotates each with alarm_status = normal / warning / alarm computed from current vs thresholds.
Inputs: limit, river, station, province, +1 more.
get_warningsB
Get active IMGW meteorological warnings across Poland. Fields: nazwa_zdarzenia (event type — burze, mróz, upał, opady, wiatr, etc.), stopien (severity 1..3), prawdopodobienstwo (probability %), obowiazuje_od / _do, teren (affected area).
Inputs: no named parameters.
get_weatherA
Get current synoptic weather observations from IMGW. With no station: returns all ~60 stations. With station: returns just that one. Data updates ~hourly. Fields: temperature (°C), wind speed (m/s), wind direction (degrees), relative humidity (%), precipitation sum (mm), pressure (hPa).
Inputs: station.
list_hydro_stationsA
List hydrological station names, rivers, and provinces from the /hydro feed. Optional query filters. Used to find the right station name for get_hydro.
Inputs: river, province.
list_weather_stationsA
List synoptic station names available in the /synop feed. Useful for finding the right station name.
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 5 tools
Each tool targets a distinct purpose: getting hydrological readings, getting warnings, listing hydro stations, getting weather observations, and listing weather stations. There is no overlap or ambiguity between them, and the station-listing tools clearly complement their respective data-fetching tools.
All tool names follow a consistent snake_case verb_noun pattern: get_hydro, get_warnings, list_hydro_stations, get_weather, list_weather_stations. The use of 'get' for data retrieval and 'list' for enumeration is uniform, and the resource is always clearly identified (e.g., 'hydro', 'warnings', 'weather').
Five tools is well-scoped for a server focusing on current meteorological and hydrological data. Each tool serves a necessary function without redundancy, and the count is neither too sparse nor overwhelming for the domain.
The tool surface covers the full lifecycle of read-only access to IMGW data: retrieving current weather, current hydrological readings, active warnings, and the ability to list stations to target specific queries. No obvious gaps exist for the stated purpose, as the server explicitly provides current conditions and warnings without needing create/update operations.
Related MCP Connectors
Access UK flood warnings, river levels, water quality, Met Office forecasts, and carbon data
Weather, air quality and nearest live sensors anywhere, each with a signed receipt. Free, no key.
Multi-model weather forecasts: point series, model scoreboard, and gridded fields. No auth.
Free, keyless real-time weather and 7-day forecasts for any city worldwide.
Related MCP Servers
- AlicenseAqualityDmaintenanceProvides access to Portuguese weather data from IPMA (Instituto Português do Mar e da Atmosfera), including weather forecasts, meteorological warnings, seismic data, UV index, and real-time observations from weather stations across Portugal.6MIT
- FlicenseBqualityDmaintenanceProvides weather data including US alerts, US forecasts, and global 5-day forecasts without requiring any API keys.31-
- AlicenseAqualityDmaintenanceProvides live Greek weather data from EMY, including forecasts, alerts, marine bulletins, warnings, and climate records. Supports location-based queries by name, ID, or coordinates without requiring an API key.6MIT
- FlicenseNot gradedqualityCmaintenanceProvides global weather data (current conditions, forecasts, air quality) without requiring an API key.-