What can you do with this server?

Provide live NOAA space weather and HF propagation data through MCP tools. * Get current SFI, Kp, and NOAA R/S/G scales with an HF band outlook. * Retrieve the 27-day SFI and Kp forecast for planning DX, contests, and activations. * View active space weather alerts and warnings. * Read real-time DSCOVR L1 solar wind Bz, speed, and density. * Check GOES X-ray flux and solar flare classification. * Assess HF band-by-band propagation from 160m to 6m. * Get service and upstream spec versions for fleet alignment. * Use public NOAA SWPC endpoints without authentication, with optional mock mode for offline testing.

Which integrations are available for this server?

Enables real-time space weather and HF propagation assessments, including solar conditions, forecasts, alerts, and band outlooks, via the GitHub Copilot extension in VS Code.

How do I use solar-mcp?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@solar-mcp What are the current solar conditions?" 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.

solar-mcp

by qso-graph

Overview Schema Source Related Servers Discussions Admin

Python

Remote

solar-mcp

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.

Part of the qso-graph project. No authentication required—all data from NOAA SWPC public endpoints.

Install

uvx solar-mcp            # run it; nothing to install

Related MCP server: io.github.qso-graph/ionis-mcp

Tools

Tool	Description
`solar_conditions`	Current SFI, Kp, and NOAA R/S/G space weather scales
`solar_forecast`	27-day SFI and Kp forecast from NOAA
`solar_alerts`	Active space weather alerts and warnings
`solar_wind`	Real-time DSCOVR L1 solar wind (Bz, speed, density)
`solar_xray`	GOES X-ray flux and solar flare classification
`solar_band_outlook`	HF band-by-band propagation assessment (160m-6m), each band rated on the scale in BAND-OUTLOOK.md
`get_version_info`	Service version + upstream spec version (fleet identity attestation)

Quick Start

No credentials needed—just install and configure your MCP client.

Configure your MCP client

Claude Desktop

Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

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

Claude Code

Add to .claude/settings.json:

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

ChatGPT Desktop

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

Cursor

Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

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

VS Code / GitHub Copilot

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "solar": {
      "command": "uvx",
      "args": ["solar-mcp"]
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):

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

Ask questions

"What are the current solar conditions?"

"Is the solar wind causing any geomagnetic disturbance?"

"What's the 27-day solar forecast look like?"

"Are any bands open right now on HF?"

"Are there any active space weather alerts?"

"What class solar flare is happening?"

Data Sources

Every value comes from a public NOAA Space Weather Prediction Center endpoint at services.swpc.noaa.gov:

Data	Endpoint	Used by
10.7 cm solar flux (SFI)	`/products/summary/10cm-flux.json`	`solar_conditions`, `solar_band_outlook`
Planetary K-index	`/products/noaa-planetary-k-index.json`	`solar_conditions`, `solar_band_outlook`
NOAA R/S/G scales	`/products/noaa-scales.json`	`solar_conditions`
Space weather alerts	`/products/alerts.json`	`solar_alerts`
27-day outlook	`/text/27-day-outlook.txt`	`solar_forecast`
Solar wind (real-time, 1 minute)	`/json/rtsw/rtsw_wind_1m.json`, `/json/rtsw/rtsw_mag_1m.json`	`solar_wind`
GOES X-ray flux	`/json/goes/primary/xrays-6-hour.json`	`solar_xray`

Testing Without Network

SOLAR_MCP_MOCK=1 solar-mcp

MCP Inspector

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

Development

git clone https://github.com/qso-graph/solar-mcp.git
cd solar-mcp
uv sync --group dev
uv run pytest

License

GPL-3.0-or-later

Available Tools

7 tools

get_version_infoGet Version InfoA

Read-onlyIdempotent

Get solar-mcp service version and upstream spec version.

Returns the running PyPI version of solar-mcp and the NOAA SWPC endpoint set revision currently in use. Use this to confirm fleet alignment across MCP deployments — agents can compare service_version and spec_version across servers to detect drift without going outside the MCP protocol.