# spaceweather-mcp [Health: Active]

**Category:** 🚀 Aerospace & Astrodynamics  
**Repository:** https://github.com/hoon1983/spaceweather-mcp  
**GitHub Stars:** 0  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/spaceweather-mcp

## Description
Space weather & geomagnetic conditions (NOAA SWPC, NASA DONKI, USGS, Kyoto) via MCP.

## Tools
Capabilities this server exposes over MCP:

- **get_conditions_now** — Single-call snapshot of current space weather.

Returns the latest planetary Kp, interplanetary Bz/Bt, solar wind speed and
density, the current NOAA G/S/R scale levels, whether a geomagnetic storm is
in progress (Kp >= 5), and a human-readable one-line summary. Best first call
for "what's space weather doing right now / will I see aurora" questions.
- **get_kp_index** — Observed planetary K-index time series (3-hour cadence, ~last week).

Kp ranges 0-9; Kp >= 5 indicates a geomagnetic storm (G1+). Use for trend
and history; for the single current value use `get_conditions_now`.
- **get_kp_forecast** — NOAA's 3-day planetary Kp forecast (3-hour resolution).

Each point is tagged observed/estimated/predicted. Useful for aurora-watch
planning and anticipating geomagnetic disturbance.
- **get_solar_wind** — Real-time solar wind from DSCOVR/ACE at L1: magnetic field + plasma.

Returns `mag` (Bx/By/Bz/Bt in nT, GSM) and `plasma` (density cm^-3, speed
km/s, temperature K) series for the chosen window. Sustained southward Bz
(negative) plus elevated speed is the classic geomagnetic-storm driver.
- **get_alerts** — Most recent NOAA SWPC alerts, watches, and warnings (newest first).

Plain-text bulletins for events like geomagnetic storm watches, radio
blackouts, and solar radiation storms.
- **get_noaa_scales** — NOAA G (geomagnetic), S (solar radiation), R (radio blackout) scales.

Returns today (index 0) plus the next 3 forecast days, each with a 0-5
scale level and label. The headline 'how bad is it' summary used by SWPC.
- **get_27day_outlook** — SWPC 27-day outlook: daily F10.7 cm radio flux, planetary Ap, largest Kp.

A 4-week look-ahead driven by the ~27-day solar rotation. Coarser than the
3-day Kp forecast but useful for longer-range planning.
- **list_observatories** — The USGS-operated magnetic observatories you can query with get_observatory.

Returns 3-letter IAGA codes (BOU, HON, GUA, …) with names and coordinates,
so an agent can pick a station near a region of interest.
- **get_observatory** — Ground magnetometer time series for one USGS observatory (nT).

`station` is an IAGA code from `list_observatories` (e.g. 'BOU'). Returns the
requested field components (default X,Y,Z,F) over the last `hours`, plus the
latest finite value per element. Use 60s sampling for trends, 1s for detail
(heavier). Data is U.S. public domain (credit USGS); near-real-time values
are preliminary.
- **get_dst** — Hourly Dst (disturbance storm-time) index over the last `days`, in nT.

Dst tracks the ring-current depression of a geomagnetic storm: roughly
> -30 quiet, -50..-100 moderate, < -100 intense, < -250 great storm.

NON-COMMERCIAL data from the WDC for Geomagnetism, Kyoto. Cite "WDC for
Geomagnetism, Kyoto" and the Dst DOI; real-time/quicklook values are
provisional and not licensed for commercial use. Kept separate from the
public-domain NOAA/USGS feeds for this reason.
- **get_solar_flares** — Recent GOES X-ray solar flares (events with peak class C/M/X), last `days`.

Discrete flare events with begin/peak/end times and peak class (e.g. 'M2.1').
Best for "biggest recent flare?" / current flare activity.
- **get_radiation_storm** — Current solar radiation (energetic proton) environment and NOAA S-scale.

Latest GOES integral proton flux per energy threshold (pfu) plus the S
(radiation storm) scale 0-5 derived from the >=10 MeV flux. Relevant to
satellite operations, polar flights, and astronaut radiation exposure.
- **get_solar_regions** — Today's active sunspot regions with C/M/X flare probabilities (NOAA SWPC).

Per-region location, area, spot/magnetic class, and flare/proton probabilities.
Answers "how many sunspot regions / which is most likely to flare?"
- **get_aurora_forecast** — OVATION short-term (~30-90 min) auroral-oval forecast.

Pass `latitude`/`longitude` to get the auroral activity probability (%) at
that location — the "will I see aurora tonight?" answer. Without coordinates,
returns the peak probability over the oval.
- **get_space_weather_events** — Catalogued space-weather events from NASA DONKI (newest first).

`event_type`: CME (coronal mass ejection), GST (geomagnetic storm), FLR
(solar flare), SEP (solar energetic particle), IPS (interplanetary shock),
HSS (high-speed stream). Each event carries a type-specific summary (e.g.
GST max Kp, FLR class, CME speed) and a DONKI link for full detail. This is
the structured "what space-weather events happened recently, and how are
they linked?" view that complements the real-time SWPC feeds. Public domain
(NASA/CCMC).

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `uvx` (confidence: high):

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

## Documentation

## 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:

```bash
uv run spaceweather-mcp
```

This starts a stdio MCP server.

```json
{
  "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.

_Full upstream README: https://allmcps.com/mcp/spaceweather-mcp/readme_