Noaa Spaceweather MCP Server

What noaa-spaceweather-mcp-server does

NOAA SWPC data becomes available to MCP-compatible agents through six focused tools. The server covers the NOAA R, S, and G storm scales; planetary Kp observations and forecasts; OVATION aurora predictions; solar-wind plasma and magnetic-field measurements; solar flares and related activity; and active SWPC alerts, watches, and warnings.

The conditions tool combines a current snapshot with yesterday's assessed levels, today's levels, and a three-day forecast. It can also include SWPC's forecast discussion, divided into solar activity, energetic particles, solar wind, and geospace topics.

How it works

The server retrieves data from NOAA SWPC feeds and products, then returns structured MCP tool results. Kp data includes recent three-hour observations, G-scale equivalents, aurora-latitude guidance, and the full three-day forward forecast. Solar-wind results identify the active L1 spacecraft and expose speed, proton density, temperature, and GSM magnetic-field components, including Bz behavior over the requested window.

Aurora lookups use optional WGS84 latitude and longitude. With both coordinates, the result adds the nearest one-degree grid probability, geomagnetic latitude, required Kp and G level, solar elevation, darkness state, and the strongest poleward reading within 1,000 km. The model forecasts roughly 30–90 minutes ahead and updates about every five minutes.

Setup and configuration

The package can be run as an MCP server over STDIO or Streamable HTTP. It is published as @cyanheads/noaa-spaceweather-mcp-server, and the project also provides a public endpoint at https://noaa-spaceweather.caseyjhand.com/mcp. Installation links are available for Claude Desktop, Cursor, and VS Code. A container package is also published for Docker-based deployment.

Tool inputs control time windows and response size. Kp observations accept a one-to-seven-day window. Solar-wind queries accept one to 168 hours and can return reduced, full, or summary output. Solar-activity queries accept a one-to-168-hour flare window and can include or omit active-region details. Alert queries support active-only filtering and a one-to-720-hour age bound.

Tools and capabilities

• noaa_spaceweather_get_conditions returns storm scales, current Kp context, a plain-language status, and an optional forecast discussion.
• noaa_spaceweather_get_kp_index returns observed Kp readings, G-scale labels, aurora guidance, and a three-day forecast.
• noaa_spaceweather_get_aurora_forecast returns global OVATION metadata or a coordinate-based visibility assessment.
• noaa_spaceweather_get_solar_wind returns plasma and magnetic-field series plus window-wide Bz, speed, density, and Bt summaries.
• noaa_spaceweather_get_solar_activity reports flare events, GOES X-ray flux, F10.7 radio flux, flare probabilities, active regions, and radiation-storm level.
• noaa_spaceweather_get_alerts returns structured active or historical SWPC products with severity, validity, cancellation state, and full message text.

Limitations and notes

The aurora verdict accounts for daylight: a favorable model probability is not considered visible when the location is in daylight. Coordinates must be supplied together; providing only latitude or only longitude fails validation.

Solar-wind feeds cover roughly the latest 24 hours at approximately one-minute cadence, even though the query window can be larger. Reduced output caps each series at 200 records, while full output may contain about 1,400 records per series over 24 hours. Alert filtering distinguishes an empty result caused by quiet conditions from one caused by filtering.

Forecast R and S values represent probabilities, and a null forecast level means that no level was predicted rather than level zero. Similarly, an alert scale value of zero means that no scale was stated.