Spaceweather MCP

What the spaceweather-mcp MCP server does

The spaceweather-mcp MCP server gives AI agents access to solar and geomagnetic observations, forecasts, alerts, and event catalogs. Its data covers conditions near Earth, solar activity, radiation storms, aurora probability, and ground-based magnetic measurements.

The server combines four sources. NOAA's Space Weather Prediction Center supplies most operational products, including Kp observations and forecasts, solar-wind measurements, alerts, NOAA G/S/R scales, GOES flare reports, proton flux, sunspot regions, and the 27-day outlook. NASA DONKI provides a catalog of CME, geomagnetic storm, flare, solar energetic particle, interplanetary shock, and high-speed stream events. USGS supplies observatory magnetometer readings. Kyoto WDC supplies the hourly Dst index.

How it works

MCP clients call individual tools and receive structured results from the corresponding public data services. get_conditions_now provides a consolidated snapshot with Kp, magnetic-field values, solar-wind speed and density, NOAA scales, a storm indicator, and a summary. Other tools separate the data into current readings, forecasts, alerts, event history, and location-aware aurora probability.

The aurora tool accepts latitude and longitude so an agent can request a local probability rather than only a general aurora outlook. Solar-wind queries support either a one-day or seven-day window. The observed Kp series covers approximately one week, while the NOAA forecast covers three days and the outlook extends to 27 days.

Setup and configuration

Run the server with:

uv run spaceweather-mcp

This starts a stdio MCP server.

{
  "mcpServers": {
    "spaceweather": {
      "command": "uvx",
      "args": ["spaceweather-mcp"]
    }
  }
}

No API key or environment variable is specified in the provided setup. The repository can be tested with uv run pytest.

Tools and capabilities

The NOAA-backed tools provide:

• Current conditions, Kp observations, and a three-day Kp forecast
• L1 magnetic-field and plasma data for one or seven days
• Recent alerts, watches, and warnings
• Current and upcoming G/S/R scales
• A 27-day F10.7, Ap, and maximum-Kp outlook
• Recent GOES C-, M-, and X-class flares
• Proton flux and the NOAA radiation-storm scale
• Sunspot regions and flare probabilities
• OVATION aurora probability for supplied coordinates

Additional tools list NASA space-weather events, enumerate USGS observatories, retrieve observatory X/Y/Z/F magnetic measurements, and return Kyoto's hourly Dst readings.

Limitations and notes

Results are informational and should not support operational decisions involving power grids, aviation, satellites, or human safety. Official NOAA SWPC products should be consulted for those situations. Real-time values are preliminary and may be revised.

NOAA, NASA DONKI, and USGS data are identified as public domain. Kyoto Dst data is restricted to non-commercial use, requires attribution to WDC for Geomagnetism, Kyoto, and is provisional in real time. That feed is kept separate from the public-domain sources, with its terms exposed in the tool and schema documentation.