# SanAlert

> SanAlert is a free MCP server for maps and travel. Unofficial air-threat level for a place in Poland, computed locally from public data. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, macOS, Windows, Linux
- **Website:** https://sanalert.pl/en/
- **Repository:** https://github.com/plrojek/sanalert-mcp
- **MCP Registry name:** io.github.plrojek/sanalert-mcp
- **Categories:** maps and travel, news and media
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add sanalert-mcp -- uvx sanalert-mcp
```

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

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

## 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

- [Tutu eSIM](https://ai-powered.com/mcp/tutu-esim): Tutu eSIM is a paid MCP server for maps and travel.
- [Shanghai Streets Travel Guide](https://ai-powered.com/mcp/shanghai-streets-travel-guide): Shanghai Streets Travel Guide is a free MCP server for maps and travel.
- [Fifty Asks](https://ai-powered.com/mcp/fifty-asks): Fifty Asks is a free MCP server for maps and travel.
- [OpenNash Podcasts](https://ai-powered.com/mcp/opennash-podcasts): OpenNash Podcasts is a free MCP server for news and media.
- [Gangway AIS](https://ai-powered.com/mcp/gangway-ais): Gangway AIS is a freemium MCP server for freight and logistics.
- [Tickets: tours and event tickets in South America](https://ai-powered.com/mcp/tickets-tours-and-event-tickets-in-south-america): Tickets: tours and event tickets in South America is a free MCP server for maps and travel.
- [Nexus Politics](https://ai-powered.com/mcp/nexus-politics): Nexus Politics is a free MCP server for legal and government.
- [Goyondo](https://ai-powered.com/mcp/goyondo-2): Goyondo is a freemium MCP server for maps and travel.

---
Source: https://ai-powered.com/mcp/sanalert
