Weather Alerts & Forecast

What Weather Alerts & Forecast does

Weather Alerts & Forecast MCP server connects an MCP client to the public National Weather Service API at api.weather.gov. It covers two focused tasks: checking active alerts for a US state and retrieving a short-range point forecast for a geographic position.

The server is intended for US weather queries supported by NWS data. It does not provide a general global weather service, historical observations, or a long-range forecast interface based on the documented tools.

How it works

The server exposes MCP tools that accept structured inputs from a connected client. get_alerts takes state, a two-letter US state code, and returns active NWS alerts for that state. get_forecast takes numeric latitude and longitude values and returns the next five forecast periods for those coordinates.

Requests are backed by public NOAA/NWS endpoints. Because the server uses live public data, results depend on the availability and response behavior of that API. Clients can launch the process locally and issue tool calls through the MCP connection.

Setup and configuration

Install the package and its dependencies with:

pip install .

Start the stdio server with:

python -m weather.weather

Configure the MCP client to launch the package entry point or the module path above. No credentials are described for access to the public NWS API.

Tools and capabilities

• get_alerts: accepts a two-letter state string and fetches active NWS alerts for that state.
• get_forecast: accepts numeric latitude and longitude values and fetches a short-term forecast covering the next five periods.

Weather Alerts & Forecast MCP server can support agent workflows such as checking whether a state has active warnings before presenting travel information, or adding a point forecast to a location-focused response. The documented interface is deliberately limited to these two read operations.

Limitations and notes

The data source is the public US National Weather Service API, so coverage and output are tied to that service. The alert tool requires a US two-letter state code, while the forecast tool requires coordinates. The forecast result is limited to five upcoming periods rather than an arbitrary forecast horizon.

The README advises respecting NWS API usage guidelines and rate limits. It also identifies the project license as MIT, while noting that the license metadata should be kept consistent if packaging or publishing the project elsewhere. No guarantees about alert delivery, update frequency, international locations, historical data, or severe-weather notification subscriptions are documented.