> ## Documentation Index
> Fetch the complete documentation index at: https://docs.neoagent.io/llms.txt
> Use this file to discover all available pages before exploring further.

# OpenWeather API

> Check storms, weather alerts, forecasts and past weather at a client's site from OpenWeather in an agent

The common uses are a storm check, where an agent reads the weather alerts and the forecast for a client's site and acts through your RMM, and an outage check, where an agent reads the weather at a site when its server or internet went offline.

<Info>
  Automatically enabled when you configure OpenWeather permissions in your agent workflow.
</Info>

## What it does

* Turn a site's address from your PSA into coordinates with OpenWeather's geocoding
* Read the government weather alerts for the site (agency, event, start and end), the weather now, and the hourly and daily forecast
* Read the weather at the site at a past time, such as when a device went offline
* Read air quality, fire danger, lightning, road risk, solar and wind data, as your OpenWeather plan allows
* Read and change your OpenWeather account's weather stations and their measurements, saved solar locations and panels, and history-archive locations, as the permission groups allow

OpenWeather only reads weather. To shut a server down or put a device in maintenance mode when a storm comes, the agent uses your RMM tools. Neo adds your API key to each call and removes it from every answer.

## Permission groups

| Group | Covers |
| - | - |
| Weather, Forecasts & Alerts | Current weather, forecasts, weather alerts, past weather, air quality, fire danger, lightning, road risk, solar and wind data, geocoding. Read only |
| Stations & Saved Locations | Your account's weather stations and measurements, saved solar locations and panels, history-archive locations |

| Profile | What it does |
| - | - |
| Read Only | Reads both groups, changes nothing |
| Helpdesk | Reads weather. Changes to stations and saved locations ask a technician first |
| IT Admin | Reads weather and changes stations and saved locations on its own |
| Full Automation | Same as IT Admin, with no approval |

## Safety Controls

Neo does not fetch images or compressed files, which an agent cannot read: map tiles, weather icons and bulk downloads.

## Setup

See [Connecting OpenWeather to Neo](/integrations/openweather/connecting-to-neo).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.