# noaa-spaceweather-mcp-server [Health: Active]

**Category:** 🌳 Environment & Nature  
**Repository:** https://github.com/cyanheads/noaa-spaceweather-mcp-server  
**GitHub Stars:** 4  
**npm Downloads (last month):** 1636  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/noaa-spaceweather-mcp-server

## Description
NOAA SWPC space weather: storm scales, Kp index, aurora forecasts, solar wind, activity, alerts.

## Tools
Capabilities this server exposes over MCP:

- **noaa_spaceweather_get_conditions** — Current space-weather snapshot: NOAA R/S/G storm scales for yesterday, today, and the 3-day forecast, latest Kp, a plain-language status summary, and optionally SWPC's forecast discussion explaining the forecast
- **noaa_spaceweather_get_kp_index** — Planetary K-index (0–9) — recent observed 3-hour values with G-scale equivalents and aurora-latitude guidance, plus 3-day forecast
- **noaa_spaceweather_get_aurora_forecast** — OVATION model aurora forecast: global probability grid, optional local lookup by coordinates with a daylight-aware go/no-go verdict and a poleward horizon reading
- **noaa_spaceweather_get_solar_wind** — Real-time solar wind from the active L1 spacecraft: speed, proton density, temperature, and the critical Bz component with the window's most southward reading — explains why current geomagnetic conditions exist
- **noaa_spaceweather_get_solar_activity** — Solar flare picture: discrete flare events with peak class and R-scale level, GOES X-ray flux, the daily F10.7 cm radio flux, 3-day flare-class probabilities, active solar regions with same-day flare counts and next-day probabilities, and solar radiation storm level
- **noaa_spaceweather_get_alerts** — Active SWPC alerts, watches, and warnings — structured records with product type, severity, issue time, validity window, and full message text

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

```json
"mcpServers": {
  "noaa-spaceweather-mcp-server": {
    "command": "npx",
    "args": ["-y","@cyanheads/noaa-spaceweather-mcp-server"]
  }
}
```

## Documentation

## What noaa-spaceweather-mcp-server does

NOAA SWPC data becomes available to MCP-compatible agents through six focused tools. The server covers the NOAA R, S, and G storm scales; planetary Kp observations and forecasts; OVATION aurora predictions; solar-wind plasma and magnetic-field measurements; solar flares and related activity; and active SWPC alerts, watches, and warnings.

The conditions tool combines a current snapshot with yesterday's assessed levels, today's levels, and a three-day forecast. It can also include SWPC's forecast discussion, divided into solar activity, energetic particles, solar wind, and geospace topics.

## How it works

The server retrieves data from NOAA SWPC feeds and products, then returns structured MCP tool results. Kp data includes recent three-hour observations, G-scale equivalents, aurora-latitude guidance, and the full three-day forward forecast. Solar-wind results identify the active L1 spacecraft and expose speed, proton density, temperature, and GSM magnetic-field components, including Bz behavior over the requested window.

Aurora lookups use optional WGS84 latitude and longitude. With both coordinates, the result adds the nearest one-degree grid probability, geomagnetic latitude, required Kp and G level, solar elevation, darkness state, and the strongest poleward reading within 1,000 km. The model forecasts roughly 30–90 minutes ahead and updates about every five minutes.

## Setup and configuration

The package can be run as an MCP server over STDIO or Streamable HTTP. It is published as `@cyanheads/noaa-spaceweather-mcp-server`, and the project also provides a public endpoint at `https://noaa-spaceweather.caseyjhand.com/mcp`. Installation links are available for Claude Desktop, Cursor, and VS Code. A container package is also published for Docker-based deployment.

Tool inputs control time windows and response size. Kp observations accept a one-to-seven-day window. Solar-wind queries accept one to 168 hours and can return reduced, full, or summary output. Solar-activity queries accept a one-to-168-hour flare window and can include or omit active-region details. Alert queries support active-only filtering and a one-to-720-hour age bound.

## Tools and capabilities

- `noaa_spaceweather_get_conditions` returns storm scales, current Kp context, a plain-language status, and an optional forecast discussion.
- `noaa_spaceweather_get_kp_index` returns observed Kp readings, G-scale labels, aurora guidance, and a three-day forecast.
- `noaa_spaceweather_get_aurora_forecast` returns global OVATION metadata or a coordinate-based visibility assessment.
- `noaa_spaceweather_get_solar_wind` returns plasma and magnetic-field series plus window-wide Bz, speed, density, and Bt summaries.
- `noaa_spaceweather_get_solar_activity` reports flare events, GOES X-ray flux, F10.7 radio flux, flare probabilities, active regions, and radiation-storm level.
- `noaa_spaceweather_get_alerts` returns structured active or historical SWPC products with severity, validity, cancellation state, and full message text.

## Limitations and notes

The aurora verdict accounts for daylight: a favorable model probability is not considered visible when the location is in daylight. Coordinates must be supplied together; providing only latitude or only longitude fails validation.

Solar-wind feeds cover roughly the latest 24 hours at approximately one-minute cadence, even though the query window can be larger. Reduced output caps each series at 200 records, while full output may contain about 1,400 records per series over 24 hours. Alert filtering distinguishes an empty result caused by quiet conditions from one caused by filtering.

Forecast R and S values represent probabilities, and a null forecast level means that no level was predicted rather than level zero. Similarly, an alert scale value of zero means that no scale was stated.

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