Skip to main content
Glama
JimFlannery

Space Weather Data MCP Server

by JimFlannery
OverviewSchemaRelated ServersScoreDiscussions
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

No arguments

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
list_directoryA

List files and subdirectories at a path on the SWPC data server.

The server is organised as a browsable file tree rooted at https://services.swpc.noaa.gov. Top-level directories include json/, text/, products/, images/, experimental/, netcdf/, and static/.

Args: path: Directory path to list, e.g. "json/", "json/goes/", "text/". Leave empty (or pass "") to list the root.

Returns: A dict with two keys: "directories": list of subdirectory names (without trailing slash) "files": list of file names

fetch_fileA

Fetch the content of a file from the SWPC data server.

JSON files are returned as parsed objects; all other files (plain text, etc.) are returned as a string.

Args: path: File path relative to the server root, e.g. "json/solar_regions.json" or "text/3-day-forecast.txt".

Returns: Parsed JSON (dict or list) for .json files, plain text string otherwise.

list_known_pathsA

Return a curated map of notable paths and files on the SWPC data server.

Use this tool first to orient yourself before calling list_directory or fetch_file. The returned map groups paths by top-level directory and highlights commonly useful files.

Returns: A dict describing the server layout and selected files of interest.

get_space_weather_scalesA

Return the NOAA space weather scales and solar flare classification system.

Call this tool to understand how to interpret space weather severity. It returns:

  • The three NOAA scales used for all space weather products: G (Geomagnetic storms, Kp-based, 1–5) S (Solar Radiation Storms, proton flux-based, 1–5) R (Radio Blackouts, X-ray flux-based, 1–5)

  • Solar flare X-ray classification (A/B/C/M/X) with flux thresholds and the mapping to R-scale radio blackout levels.

Returns: Dict with keys "noaa_scales" and "solar_flare_classes".

list_productsA

List SWPC space weather products, optionally filtered by category.

Each product entry includes its name, a description, and the data file paths on the SWPC data server where its data can be fetched.

Available categories: forecasts, reports, models, observations, summaries, alerts, experimental

Args: category: Optional category name to filter by (case-insensitive). Pass "" or omit to return all categories.

Returns: Dict mapping category names to lists of product dicts, each with keys: slug, name, description, data_paths.

describe_productA

Fetch the full description of a SWPC product from the NOAA website.

Use list_products() to find product slugs. This tool fetches the live product page from www.swpc.noaa.gov and returns its explanatory text — useful for detailed interpretation guidance, methodology, and caveats.

Args: product_slug: The product URL slug, e.g. "planetary-k-index", "goes-x-ray-flux", "wsa-enlil-solar-wind-prediction".

Returns: Plain text extracted from the product's NOAA web page.

get_data_file_infoA

Return field definitions and interpretation guidance for a known data file.

Use this tool before calling fetch_file() to understand what the data means, what each field represents, and how to interpret the values.

Args: path: The file path as used with fetch_file(), e.g. "json/planetary_k_index_1m.json" or "json/goes/primary/xrays-1-day.json".

Returns: A dict with description, fields, interpretation, and related files. If the path is not in the guide, returns a list of known paths.

Prompts

Interactive templates invoked by user choice

NameDescription
get_forecastFetch the current space weather forecast from SWPC. Retrieves and combines five authoritative forecast products: - 3-Day Space Weather Forecast (R/S/G scale outlook) - 3-Day Geomagnetic Forecast (Kp predictions) - Forecast Discussion (forecaster narrative and reasoning) - SGARF — Solar & Geophysical Activity Report and Forecast - Space Weather Advisory Outlook (weekly advisory) Returns all five products as a single formatted text block, ready for analysis and summarisation.
get_kp_indexFetch current and recent Kp (Planetary K-index) data from SWPC. Retrieves two complementary products: - NOAA Planetary K-index (JSON): recent 3-hour Kp values with observed and estimated readings, updated every 3 hours. - Daily Geomagnetic Indices (text): daily Kp, Ap, Cp, and C9 index values in tabular form for the past ~30 days. The Kp index (0–9) measures global geomagnetic disturbance. Kp ≥ 5 = geomagnetic storm (G1+). Use get_space_weather_scales() for the full G-scale storm threshold table. Returns both products as a single formatted text block.
get_dst_indexFetch the latest Dst (Disturbance Storm Time) index from SWPC/Kyoto. The Dst index measures the strength of the globally symmetric westward ring current that encircles Earth at low latitudes during geomagnetic storms. It is derived from hourly H-component magnetic variations at near-equatorial ground observatories and expressed in nanoteslas (nT). Dst is always negative or near-zero during disturbed conditions: a more negative value means a stronger storm. Interpretation thresholds: Dst ≥ -20 nT : Quiet -20 to -50 nT : Weak storm -50 to -100 nT : Moderate storm -100 to -200 nT : Intense storm < -200 nT : Super-storm (extreme) The Dst index complements Kp: Kp responds quickly (3-hour cadence) while Dst tracks the slower ring-current build-up and recovery phase (hours to days) of a storm's main phase and recovery phase. Data source: Kyoto World Data Center via SWPC (hourly, ~7 days). Returns the Dst time series as a formatted table with an interpretation guide prepended.
get_solar_windFetch real-time solar wind magnetic field and plasma data from DSCOVR at L1. DSCOVR orbits the Sun-Earth L1 Lagrange point ~1.5 million km upstream of Earth, providing 15–60 minutes of advance warning of solar wind conditions before they reach Earth. Retrieves two complementary products in parallel: - DSCOVR magnetometer (1-second): Bz, Bt, and the full IMF vector in both GSE and GSM coordinates. bz_gsm is the single most critical parameter for geomagnetic storm prediction — sustained negative (southward) values open the magnetosphere to solar wind energy. - RTSW solar wind plasma (1-minute): solar wind speed (km/s), proton density (cm⁻³), and temperature (K). bz_gsm interpretation: bz_gsm > 0 nT : Northward — quiet magnetosphere bz_gsm 0 to -5 nT : Weakly southward — minor effects possible bz_gsm < -5 nT (>1 hr) : Southward — G1+ storm possible bz_gsm < -10 nT : G2–G3 likely during sustained periods bz_gsm < -20 nT : G4–G5 possible bt (total field) : High bt with negative bz = maximum storm potential Use get_space_weather_scales() for full G-scale storm thresholds. Use get_dst_index() to track ring-current build-up during active storms.
get_goes_xrayFetch the past 6 hours of GOES X-ray flux to monitor solar flare activity. GOES satellites measure solar X-ray flux continuously in two channels: - 0.05–0.4 nm (hard X-ray) - 0.1–0.8 nm (soft X-ray) — the standard channel for flare classification Use the 'flux' field in the 0.1-0.8nm channel (electron-contamination corrected). The most recent peak in this channel determines flare class. Flare classification (soft X-ray peak flux): A : < 10⁻⁷ W/m² background; no space weather effects B : 10⁻⁷ – 10⁻⁶ W/m² minor; no significant effects C : 10⁻⁶ – 10⁻⁵ W/m² minor HF effects on sunlit side M : 10⁻⁵ – 10⁻⁴ W/m² moderate; R1 (M1) to R2 (M5) radio blackout X : ≥ 10⁻⁴ W/m² major; R3 (X1) to R5 (X20+) radio blackout Numeric suffix = multiplier within class (e.g., M5 = 5×10⁻⁵ W/m²). Long-duration events (≥30 min to decay to half-peak) often accompany CMEs. Use get_space_weather_scales() for the full R-scale blackout table. Use get_solar_wind() to check whether an associated CME has arrived.
get_proton_fluxFetch the past 24 hours of GOES integral proton flux for radiation storm monitoring. High-energy protons accelerated by solar flares and CMEs travel from the Sun to Earth in 10–30 minutes. GOES measures integral proton flux at multiple energy thresholds (≥1 to ≥500 MeV), updated every 5 minutes. NOAA S-scale thresholds (≥10 MeV flux in particles/cm²/s/sr = pfu): S1 (Minor) : ≥ 10 pfu — minor polar HF disruption S2 (Moderate): ≥ 100 pfu — elevated radiation for polar aircraft/astronauts S3 (Strong) : ≥ 1,000 pfu — radiation hazard for EVA; GPS degraded at poles S4 (Severe) : ≥ 10,000 pfu — unavoidable radiation hazard; satellite memory issues S5 (Extreme) : ≥ 100,000 pfu — satellites may be rendered inoperable Key channels to monitor: ≥10 MeV — defines the S-scale storm level ≥100 MeV — hard-spectrum events; deeper penetration, higher radiation risk ≥500 MeV — ground-level events (GLEs); extremely rare Use get_space_weather_scales() for the full S-scale effects table. Use get_goes_xray() to correlate with the originating solar flare.

Resources

Contextual data attached and managed by the client

NameDescription
get_space_weather_glossaryComprehensive space weather glossary from NOAA SWPC. Alphabetical reference of terms used in space weather forecasting, observation, and research; sourced from the NOAA Space Weather Prediction Center official glossary. Source: https://www.swpc.noaa.gov/content/space-weather-glossary
get_space_weather_impactsReference guide to space weather impacts on technology from NOAA SWPC. Covers the 5 major impact areas tracked by the Space Weather Prediction Center: Electric Power Transmission, HF Radio Communications, Satellite Communications, Satellite Drag, and GPS/GNSS Systems. Source: https://www.swpc.noaa.gov/impacts
get_space_weather_phenomenaComprehensive reference guide to space weather phenomena from NOAA SWPC. Covers all 16 major phenomena tracked by the Space Weather Prediction Center: Aurora, Coronal Holes, CMEs, Earth's Magnetosphere, F10.7 Radio Emissions, Galactic Cosmic Rays, Geomagnetic Storms, Ionosphere, Ionospheric Scintillation, Radiation Belts, Solar EUV Irradiance, Solar Flares / Radio Blackouts, Solar Radiation Storms, Solar Wind, Sunspots / Solar Cycle, and Total Electron Content. Source: https://www.swpc.noaa.gov/phenomena

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/JimFlannery/space_weather_data_mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server