Skip to content

solar-mcp

Space weather integration — real-time solar conditions, forecasts, alerts, solar wind, X-ray flux, and HF band outlook.

pip install solar-mcp

GitHub · PyPI


Tools

All 6 tools are public — no credentials needed. Data comes from NOAA Space Weather Prediction Center.

Tool Description
solar_conditions Current SFI, Kp, NOAA scales, band outlook
solar_forecast 27-day SFI and Kp forecast
solar_alerts Active space weather alerts and warnings
solar_wind Real-time DSCOVR L1 solar wind data
solar_xray GOES X-ray flux and flare classification
solar_band_outlook Per-band HF propagation assessment

Tool Reference

solar_conditions

Get current solar conditions — SFI, Kp, and NOAA space weather scales. Includes an HF band outlook derived from current indices. No parameters.

Returns current SFI, Kp, NOAA R/S/G scales, and band-by-band propagation outlook.

solar_forecast

Get the NOAA 27-day solar flux and geomagnetic forecast. No parameters.

Returns day-by-day forecast with predicted SFI and Kp values for the next 27 days.

solar_alerts

Get NOAA space weather alerts and warnings from the last 24 hours. Shows solar flare alerts, geomagnetic storm warnings, radiation storm alerts, and other SWPC bulletins. No parameters.

Returns list of recent alerts with product ID, issue time, and message summary.

solar_wind

Get real-time DSCOVR L1 solar wind data. Shows interplanetary magnetic field (Bz component), solar wind speed, and proton density. Southward Bz (negative values) drives geomagnetic storms. No parameters.

Returns Bz (nT), Bt (nT), wind speed (km/s), density (p/cm^3), and geomagnetic storm assessment.

solar_xray

Get GOES X-ray flux and solar flare classification. M and X class flares can cause HF radio blackouts (NOAA R1-R5 scale). No parameters.

Returns current flare class, X-ray flux, and HF impact assessment.

solar_band_outlook

Get HF band-by-band propagation outlook based on current conditions. Derives an assessment for each band (160m through 6m) from current SFI and Kp. No parameters.

Returns per-band condition rating (Poor/Fair/Good/Excellent) with explanation, plus current SFI and Kp values.


Data Sources

All data comes from NOAA Space Weather Prediction Center public endpoints:

Endpoint Data
10cm-flux (JSON) Solar Flux Index (SFI)
planetary-k-index (JSON) Geomagnetic Kp index
noaa-scales (JSON) R/S/G space weather scales
solar-wind mag-5-minute (JSON) DSCOVR interplanetary Bz
solar-wind plasma-5-minute (JSON) Solar wind speed and density
alerts (JSON) SWPC bulletins and warnings (last 24h)
GOES xrays-6-hour (JSON) X-ray flux, flare class derived from flux
27-day-outlook (text) Predicted SFI and Kp

No Credential Setup Needed

All NOAA SWPC endpoints are public. Just install and start using it.


Mock Mode

SOLAR_MCP_MOCK=1 solar-mcp

MCP Inspector

solar-mcp --transport streamable-http --port 8008