# SanAlert

> SanAlert (sanalert.pl) is an unofficial, free public service by Applied AI sp. z o.o. (Przemyśl, Poland). It shows whether drones or missiles tracked over Ukraine are heading for a place in Poland the reader chooses, as one of four levels: Quiet, Activity, Approaching, Near. It shows the official Polish RCB and RSO alert messages separately and unchanged. It does not replace sirens, Alert RCB or instructions from the authorities.

The site and the apps are in Polish, English and Ukrainian. The data comes from open sources: NEPTUN (objects in the air over Ukraine and air-raid alarms in its districts), adsb.lol (military aircraft, ODbL 1.0), Alert RCB and RSO (official messages, shown unchanged), and the State Fire Service's shelter register (dane.gov.pl, CC BY 4.0). When there is no data, the level says so; it never says "Quiet" without data.

## Pages

- [Live map and level (Polish)](https://sanalert.pl/): the level for your place, "Teraz" (official messages in force) and the map
- [How SanAlert works](https://sanalert.pl/en/how-it-works/): where the data comes from, what the levels mean, what SanAlert does not do
- [Reliability](https://sanalert.pl/en/reliability/): how the levels compared with official RCB and RSO warnings
- [Night reports](https://sanalert.pl/en/reports/): night by night, per voivodeship
- [Privacy](https://sanalert.pl/en/privacy/): what data is processed and who sees it
- [Terms](https://sanalert.pl/en/terms/): the terms of using SanAlert, what it provides, on what conditions and how to make a complaint (in Polish: [Regulamin](https://sanalert.pl/regulamin/))
- [For your website](https://sanalert.pl/en/for-websites/): the live box other websites can embed

## API

Public and read-only at https://api.sanalert.pl: no key, no account. Every document is the same for everyone.

- [OpenAPI description](https://api.sanalert.pl/v1/openapi.json): every public endpoint, the conditions of use, and the JSON Schemas of SanAlert's API contract (under `components/schemas`)
- [Live state](https://api.sanalert.pl/v1/state): levels by grid cell and voivodeship, the objects tracked over Ukraine, its air-raid alarms, the official RCB and RSO messages, `notice` and `attribution`
- [Source cards](https://api.sanalert.pl/v1/sources): what each source is, how sure it is, what it cannot see, its licence
- [Grid](https://api.sanalert.pl/v1/grid/1.json): every cell of Poland's grid and its voivodeship
- [MCP server](https://api.sanalert.pl/mcp): for AI assistants, `POST` only (streamable HTTP, stateless, JSON): read-only tools over the same documents for the whole of Poland (the state summarised, official messages of the last 24 hours, night reports, source cards, the reliability record); no tool takes a place, and every result carries `notice`, `attribution` and these conditions
- [Local MCP server](https://github.com/plrojek/sanalert-mcp): for AI assistants that run local servers (stdio): one tool, the level for a town from the website's list or a point, worked out on the reader's computer with the same rules as the website, so no request carries the place

Conditions of use, in short (in full in the OpenAPI description): SanAlert is unofficial and does not replace sirens, RCB alerts or official instructions; a service that shows its data says so and always refers its readers to the official air-raid alarms. Pass the state's `notice` and `attribution` through unchanged. The data includes NEPTUN data: keep a visible link to https://neptun.in.ua next to it, for example with the text "Дані: Карта повітряних тривог — NEPTUN". No data is never "quiet". Poll `/v1/state` at most once every 5 seconds, with `If-None-Match`. Requests must not identify the reader: no place and no personal data in the URL or the headers.

## Other languages

- [English](https://sanalert.pl/en/)
- [Ukrainian](https://sanalert.pl/ua/)

## Contact

kontakt@appliedai.dev