spaceweather-mcp
Provides tools for accessing NASA's space weather event data via the DONKI API, including CME, geomagnetic storms, solar flares, SEP, IPS, and high-speed stream events.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@spaceweather-mcp What's the current Kp index?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| One-call snapshot: Kp, Bz/Bt, wind speed/density, G/S/R, storm flag, summary |
| Observed planetary Kp series (~1 week) |
| NOAA 3-day Kp forecast |
| L1 magnetic field + plasma ( |
| Recent SWPC alerts/watches/warnings |
| G/S/R scales for today + 3 days |
| Daily F10.7 flux, Ap, largest Kp for 27 days |
| Recent GOES X-ray flares (C/M/X class events) |
| Current proton flux + NOAA S-scale (radiation storm) |
| Today's sunspot regions + C/M/X flare probabilities |
| 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 # testsAdd 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_dsttool description and theDstReadingschema (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 toolsget_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
Scored across 15 tools
Each tool targets a distinct aspect of space weather (current conditions, forecasts, alerts, indices, solar activity, events) with clear boundaries. No significant overlap.
All tools follow a consistent 'get_' or 'list_' prefix followed by a descriptive noun phrase, making the action and resource clear.
15 tools is well-scoped for the space weather domain, covering essential data sources without being overwhelming.
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
Real-time planetary signal engine and Model Context Protocol (MCP) server for autonomous AI agents.
The official Model Context Protocol server for Ambee. It gives any MCP-compatible AI assistant — Claude, ChatGPT, Cursor, VS Code, Ollama, and more direct access to live air quality, pollen, and weather data. To get started, including information on signing up and obtaining your Ambee key, check out the Ambee documentation on https://docs.ambeedata.com
Hosted MCP server for live public-data APIs and Skills for AI agents.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Related MCP Servers
- AlicenseBqualityBmaintenanceA 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.3295 npm94ISC
- AlicenseAqualityAmaintenanceMCP 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.7128 PyPI4GPL 3.0
- AlicenseAqualityDmaintenanceProvides 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.71MIT
- AlicenseNot gradedqualityCmaintenanceEnables 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 npmMIT