SanAlert MCP server

SanAlert for AI assistants

<!-- mcp-name: io.github.plrojek/sanalert-mcp -->

The unofficial threat level from the air for a place in Poland, for an AI assistant that can run a local MCP server (Claude Code, Claude Desktop and others). Ask it "what is the level in Przemyśl?" and the assistant gets the answer the website would show for that place. Not an official warning system: it does not replace sirens, Alert RCB or instructions from the services.

What it does, and what it sends

public document the website and the apps read: at most once every 5 s, with If-None-Match and the User-Agent SanAlert-MCP/. Once per run it fetches the public grid (/v1/grid/1.json) to find the place's ~11 km square and its voivodeship.

• It runs on your computer and talks to the assistant over stdio.
• When the assistant asks about a place, it fetches https://api.sanalert.pl/v1/state, the same

(sanalert.pl/jak-to-dziala). The place stays on your computer: no request carries it, and a town's name is never looked up online.

• It looks the place's level up in that document with the rules SanAlert's website and apps follow

Terms (Regulamin, Умови).

• The privacy page says the same (sanalert.pl/prywatnosc, "Serwer SanAlert dla asystentów AI").

The tool

sanalert_level takes place, one of the website's towns (Przemyśl, Lublin, Rzeszów, Chełm and the rest of its list; Polish letters optional, and Warsaw and Cracow work too), or latitude and longitude, and language: pl, en or uk.

Blind is not calm. When the document is missing, cannot be read or is older than 60 s, or the grid cannot be read, the level is nodata, never quiet, and say says so. The age is never less than the time the server has held the document, so a computer clock that runs behind cannot keep an old "quiet" fresh while the API is down. A point outside Poland's grid is outof_range. A name that is not on the list is an error that names the list: give coordinates instead.

For the whole of Poland (the state summarised, official messages of the last 24 hours, night reports, the reliability record) SanAlert runs a remote MCP server, https://api.sanalert.pl/mcp. It takes no place.

Install

It needs uv.

Claude Code:

claude mcp add sanalert -- uvx sanalert-mcp
claude mcp add --transport http sanalert-poland https://api.sanalert.pl/mcp      # optional: the whole of Poland

Or both at once, as a Claude Code plugin: /plugin marketplace add plrojek/agent-skills, then /plugin install sanalert@plrojek. Straight from GitHub instead of PyPI: uvx --from git+https://github.com/plrojek/sanalert-mcp sanalert-mcp.

Claude Desktop (claudedesktopconfig.json):

{
  "mcpServers": {
    "sanalert": {
      "command": "uvx",
      "args": ["sanalert-mcp"]
    }
  }
}

Conditions of use

Shortened. The full README is on GitHub.