Skip to main content
Glama
spaceweather-mcp
by hoon1983

spaceweather-mcp

A Model Context Protocol server for space weather and geomagnetic conditions — solar flares, the solar wind, geomagnetic storms (Kp/Dst), radiation storms, sunspot regions, aurora forecasts, and a catalogued event history — so an AI agent can answer "what's the sun/space weather doing right now, and will I see aurora?" from authoritative data.

Sibling to seismic-mcp: that one reconciles earthquakes across agencies; this one reports solar/geomagnetic conditions. They install side by side.

Status

15 tools across 4 data sources — all live and verified. Everything is U.S./NASA public domain except the Kyoto Dst index, which is non-commercial and clearly labeled (and kept segregated from the public-domain feeds).

Related MCP server: solar-mcp

Tools

NOAA SWPC (public domain)

Tool

Returns

get_conditions_now

One-call snapshot: Kp, Bz/Bt, wind speed/density, G/S/R, storm flag, summary

get_kp_index

Observed planetary Kp series (~1 week)

get_kp_forecast

NOAA 3-day Kp forecast

get_solar_wind

L1 magnetic field + plasma (window: 1-day/7-day)

get_alerts

Recent SWPC alerts/watches/warnings

get_noaa_scales

G/S/R scales for today + 3 days

get_27day_outlook

Daily F10.7 flux, Ap, largest Kp for 27 days

get_solar_flares

Recent GOES X-ray flares (C/M/X class events)

get_radiation_storm

Current proton flux + NOAA S-scale (radiation storm)

get_solar_regions

Today's sunspot regions + C/M/X flare probabilities

get_aurora_forecast

OVATION aurora probability (pass lat/lon for a local %)

NASA DONKI (public domain) — get_space_weather_events (CME / GST / FLR / SEP / IPS / HSS event catalog)

USGS Geomagnetism (public domain) — list_observatories, get_observatory (magnetometer X/Y/Z/F)

Kyoto WDC (non-commercial) — get_dst (hourly disturbance storm-time index)

Run

uv run spaceweather-mcp        # stdio MCP server
uv run pytest                  # tests

Add to claude_desktop_config.json (after publishing to PyPI):

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

Data sources, attribution & licensing

  • NOAA SWPC (services.swpc.noaa.gov) — U.S. public domain. Credit NOAA SWPC.

  • NASA DONKI via CCMC (kauai.ccmc.gsfc.nasa.gov/DONKI) — U.S. public domain (no API key needed). Credit NASA/CCMC DONKI.

  • USGS Geomagnetism (geomag.usgs.gov) — U.S. public domain. Credit the U.S. Geological Survey. (Sourced directly from USGS, not via INTERMAGNET, to keep public-domain status.)

  • Kyoto WDC for Geomagnetism — Dst index, non-commercial use only: acknowledge "WDC for Geomagnetism, Kyoto", cite the Dst DOI; real-time values are provisional. The non-commercial restriction is documented in the get_dst tool description and the DstReading schema (both surfaced to MCP clients), and this feed is kept separate from the public-domain ones.

⚠️ Only the Kyoto Dst feed is non-commercial. It is segregated, and its non-commercial terms are stated in the tool/schema docs the client sees, so a downstream commercial user is not silently bound by those terms.

Deliberately not included: INTERMAGNET and SILSO sunspot number (both CC BY-NC — would taint the otherwise commercially-usable server); JPL Horizons ephemeris (different domain). F10.7 is available via get_27day_outlook; GFZ Hp30/Hp60 high-cadence indices (CC BY 4.0) are a possible future add.

Safety

Informational only. Not for operational decisions affecting power grids, aviation, satellites, or human safety — consult official NOAA SWPC products for those. Real-time values are preliminary and routinely revised.

Available Tools

15 tools
get_27day_outlookA

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.

Inputs: no named parameters. Returns: issued, rows

get_alertsA

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.

Inputs: limit. Returns: result

get_aurora_forecastA

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.

Inputs: latitude, longitude. Returns: OVATION short-term auroral-oval forecast (NOAA SWPC).

get_conditions_nowA

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.

Inputs: no named parameters. Returns: A single-call snapshot of current space-weather conditions.

get_dstA

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.

Inputs: days. Returns: result

get_kp_forecastA

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.

Inputs: no named parameters. Returns: result

get_kp_indexA

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.

Inputs: no named parameters. Returns: result

get_noaa_scalesA

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.

Inputs: no named parameters. Returns: days

get_observatoryA

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.

Inputs: station (required), hours, elements, sampling_period, +1 more. Returns: Ground magnetometer time series for one observatory (USGS Geomagnetism).

get_radiation_stormA

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.

Inputs: no named parameters. Returns: Current solar radiation (energetic proton) environment, NOAA SWPC GOES.

get_solar_flaresA

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.

Inputs: days. Returns: result

get_solar_regionsA

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?"

Inputs: no named parameters. Returns: result

get_solar_windA

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.

Inputs: window. Returns: window, mag, plasma

get_space_weather_eventsB

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).

Inputs: event_type (required), days. Returns: result

list_observatoriesA

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.

Inputs: no named parameters. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 15 tools

    Disambiguation5/5

    Each tool targets a distinct aspect of space weather (current conditions, forecasts, alerts, indices, solar activity, events) with clear boundaries. No significant overlap.

    Naming Consistency5/5

    All tools follow a consistent 'get_' or 'list_' prefix followed by a descriptive noun phrase, making the action and resource clear.

    Tool Count5/5

    15 tools is well-scoped for the space weather domain, covering essential data sources without being overwhelming.

    Completeness5/5

    The set covers current conditions, forecasts, alerts, solar activity, geomagnetic indices, magnetometer data, and event catalogs, leaving no obvious gaps for typical space weather queries.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      B
      maintenance
      A Model Context Protocol server that provides a standardized interface for AI models to interact with NASA's vast array of data sources including APOD, Mars Rover photos, satellite imagery, and space weather data.
      32
      95 npm
      94
      ISC
    • A
      license
      A
      quality
      A
      maintenance
      MCP server for space weather and HF propagation conditions — live solar flux, Kp index, DSCOVR solar wind, X-ray flux, alerts, 27-day forecast, and band-by-band outlook through any MCP-compatible AI assistant.
      7
      128 PyPI
      4
      GPL 3.0
    • A
      license
      A
      quality
      D
      maintenance
      Provides AI assistants with access to real-time space weather data and forecasts from NOAA's Space Weather Prediction Center, enabling queries and interpretations of geomagnetic storms, solar flares, and related indices.
      7
      1
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI agents to access real-time NOAA space weather data, including alerts, solar wind, K-index, aurora forecast, and GOES X-ray flux, through natural language queries.
      309 npm
      MIT