Skip to content
MCP server

SanAlert

Unofficial air-threat level for a place in Poland, computed locally from public data

Runs locallyStatus and history
Pricing
Free
Platforms
CLI, macOS, Windows
Runs
Locally
Version
1.1.0
Listing updated
3 days ago

About SanAlert

SanAlert is a free MCP server for maps and travel. It runs locally on your machine and is started by your AI client.

Ask the assistant what the level is in Przemyśl or Lublin and SanAlert answers with the same level its website shows: quiet, activity, approaching, near, or no data. The level is an inference for a square roughly 11 km across, built from NEPTUN's drone and missile tracking and the alarms in Ukraine, and it is not an official warning.

The server runs on your own computer over stdio. It fetches a public state document from api.sanalert.pl at most once every 5 seconds and works out the place locally, so the town name or coordinates are never sent anywhere. Answers include data age, reasons for missing data, and the RCB and RSO messages in force for the voivodeship.

It is built to say when it is blind: a missing, unreadable or stale document gives no_data, never quiet. A separate remote server at api.sanalert.pl/mcp covers the whole of Poland.

Install

Run in a terminal

claude mcp add sanalert-mcp -- uvx sanalert-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "sanalert-mcp": {
      "command": "uvx",
      "args": [
        "sanalert-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sanalert-mcp": {
      "command": "uvx",
      "args": [
        "sanalert-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "sanalert-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "sanalert-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Tools this server provides (1)

Taken from the project documentation; the running server may differ.

sanalert_level
Returns the threat level for a Polish town or coordinates, with reasons, data age and official messages.

What it does

Per-place threat level
Returns one of quiet, activity, approaching, near, no_data or out_of_range for a town or coordinates.
Local place lookup
The place stays on your computer; only the shared public state document is fetched.
No-data honesty
A stale or unreadable source yields no_data instead of a reassuring quiet.
Official messages
Includes RCB and RSO messages in force for the place's voivodeship.
Three languages
Level names and explanatory sentences come back in Polish, English or Ukrainian.
Towns resource
The sanalert://towns resource lists the towns the tool accepts, with coordinates.

Good for

  • Ask an assistant for the current level near a Polish town
  • Pull the level for exact coordinates into a script or agent
  • Check which RCB or RSO alerts apply to a voivodeship
  • Tell whether the data behind a level is fresh

Pricing

Free

No price listed; uses a public API

Prices change. Check sanalert.pl before you buy.

SanAlert FAQ

Is this an official warning system?

No. The README says it does not replace sirens, Alert RCB or instructions from the authorities.

Is my location sent to SanAlert?

The README says the place stays on your computer and no request carries it.

What does no_data mean?

The source is missing, unreadable or older than 60 seconds. It is never reported as quiet.

What do I need to install it?

The tool needs uv; Claude Code users can add it with uvx sanalert-mcp.

Is SanAlert free?

Yes. SanAlert is free to use.

How do I add SanAlert to Claude Code?

Run this command in your terminal: claude mcp add sanalert-mcp -- uvx sanalert-mcp

What are the best alternatives to SanAlert?

The closest alternatives to SanAlert are Tutu eSIM, Shanghai Streets Travel Guide, Fifty Asks, OpenNash Podcasts and Gangway AIS.

Alternatives to SanAlert

  1. Tutu eSIM

    MCP server

    Live travel eSIM plans, prices and roaming costs for 190+ countries

    • 5 tools
    • Remote
    • Paid
    • Maps and travel
  2. Curated places, walking routes and areas in Shanghai, Jiangsu and Zhejiang

    • 9 tools
    • Remote
    • Free
    • Maps and travel
  3. Fifty Asks

    MCP server

    Let an agent book a free AI-visibility check or a 15-minute call for a local business

    • 10 tools
    • Remote
    • Free
    • Maps and travel
  4. Search business and tech podcast transcripts and sourced quotes over MCP, no key needed

    • 10 tools
    • Remote
    • Free
    • News and media
  5. Gangway AIS

    MCP server

    Vessel positions, port calls and anchorage waiting times from licensed AIS data

    • 21 tools
    • Remote
    • Freemium
    • Freight and logistics