skyddsrumskollen.nu

Tools for SkyddsrumsKollen, a Swedish service for finding civil-defence shelters (skyddsrum). Data comes from MSB, the Swedish Civil Contingencies Agency. Typical flow: `search_location` resolves a Swedish place name or address to WGS84 coordinates, then `find_nearby_shelters` returns the nearest shelters sorted by distance. `search_shelters` searches the address field only (street name or Swedish property designation, accent-insensitive) — the dataset has NO municipality/city attribute, so questions like 'how many shelters are in <town>?' cannot be answered exactly; instead resolve the town with `search_location` and show the nearest shelters with `find_nearby_shelters`, and say that per-municipality counts are not available. `get_shelter` fetches one shelter by id (found=false as a successful response when the id is unknown), `get_shelter_stats` gives national totals plus data freshness (`data_age_days`, `data_is_stale` — warn the user when stale). Every response echoes `server_version` and `server_build` (deployment stamp). Error texts start with a machine-readable code (INVALID_ARGUMENT, RATE_LIMITED, INTERNAL). Coverage is Sweden only (lat 55.0-69.5, lng 10.0-24.5 WGS84); positions outside get status 'no_coverage'. No account is needed — the server is public. Rate limit: 20 calls/minute per client; if a call is declined for rate limiting, explain it to the user and wait instead of retrying. Always show the user the `url` deep link from tool results (it opens the shelter or search on skyddsrumskollen.nu) and attribute the data to MSB. IMPORTANT safety context to relay when relevant: in Sweden nobody is assigned to a specific shelter — in an actual emergency people should use whichever shelter or protective space they can reach, and always follow instructions from Swedish authorities (MSB, krisinformation.se). Shelter ids can change when the dataset is re-synced from MSB, so prefer fresh searches over stored ids.