Ionis Mcp
About
MCP server for IONIS HF propagation analytics — 175M signatures from WSPR, RBN, Contest, DXpedition, and PSK Reporter.
Explore
- 11 specialized tools for propagation queries — no SQL required
- 175M+ aggregated signatures from 5 major telemetry networks
- Cross-dataset comparisons (WSPR vs RBN vs Contest vs PSKR)
- Solar indices and real-time DSCOVR solar wind data included
- Read-only SQLite connections with parameterized queries
- Graceful degradation when datasets are missing
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Ionis McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
pip install ionis-mcp
That's it. Both ionis-download and ionis-mcp use the same default data directory. No environment variables needed.
ionis-mcp works with any MCP-compatible client. Add the server config and restart — tools appear automatically.
If you downloaded data to a custom location, add "env": { "IONIS_DATA_DIR": "/path/to/data" } to any config below.
list_datasets
Show available datasets with row counts and file sizes
query_signatures
Flexible signature lookup — filter by source, band, grid, hour, month
band_openings
Hour-by-hour propagation profile for a path on a specific band
path_analysis
Complete path analysis across all bands, hours, months, and sources
solar_correlation
SFI effect on propagation — grouped by solar flux bracket
grid_info
Maidenhead grid decode with solar elevation computation
compare_sources
Cross-dataset comparison (WSPR vs RBN vs Contest vs PSKR)
dark_hour_analysis
Classify paths by solar geometry — both-day, cross-terminator, both-dark
solar_history
Historical solar indices for any date range
band_summary
Band overview — hour distribution, top grid pairs, distance range
current_conditions
Live propagation forecast — SFI, Kp, solar wind, band outlook, POTA/SOTA tips
get_version_info
Service version + upstream dataset version (fleet identity attestation)
| Tool | Purpose |
|------|---------|
| list_datasets | Show available datasets with row counts and file sizes |
| query_signatures | Flexible signature lookup — filter by source, band, grid, hour, month |
| band_openings | Hour-by-hour propagation profile for a path on a specific band |
| path_analysis | Complete path analysis across all bands, hours, months, and sources |
| solar_correlation | SFI effect on propagation — grouped by solar flux bracket |
| grid_info | Maidenhead grid decode with solar elevation computation |
| compare_sources | Cross-dataset comparison (WSPR vs RBN vs Contest vs PSKR) |
| dark_hour_analysis | Classify paths by solar geometry — both-day, cross-terminator, both-dark |
| solar_history | Historical solar indices for any date range |
| band_summary | Band overview — hour distribution, top grid pairs, distance range |
| current_conditions | Live propagation forecast — SFI, Kp, solar wind, band outlook, POTA/SOTA tips |
| get_version_info | Service version + upstream dataset version (fleet identity attestation) |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"ionis mcp": {
"ionis": {
"command": "ionis-mcp"
}
}
}
}McpServers
{
"ionis": {
"command": "ionis-mcp"
}
}A Model Context Protocol (MCP) server for HF radio propagation analytics, built on the IONIS dataset collection — 175M+ aggregated signatures derived from 14 billion WSPR, RBN, Contest, DXpedition, and PSK Reporter observations spanning 2005-2026.
Overview
IONIS (Ionospheric Neural Inference System) is an open-source machine learning system for predicting HF (shortwave) radio propagation. The datasets — curated from the world's largest amateur radio telemetry networks — are distributed as SQLite files on SourceForge.
ionis-mcp bridges those datasets to AI assistants via the Model Context Protocol. Install the package, download data, and Claude (Desktop or Code) can answer propagation questions using 11 specialized tools — no SQL required.
Example questions:
- "When is 20m open from Idaho to Europe?"
- "How does solar flux affect 15m propagation?"
- "Show me 10m paths at 03z where both stations are in the dark"
- "Compare WSPR and RBN observations on 20m FN31 to JO51"
- "What are the current band conditions? I'm heading out for POTA."
- "What were the solar conditions during the February 2026 geomagnetic storm?"
Datasets
| Source | Signatures | Raw Observations | SNR Type | Years |
|--------|-----------|-----------------|----------|-------|
| WSPR | 93.6M | 10.9B beacon spots | Measured (-30 to +20 dB) | 2008-2026 |
| RBN | 67.3M | 2.3B CW/RTTY spots | Measured (8-29 dB) | 2009-2026 |
| CQ Contests | 5.7M | 234M SSB/RTTY QSOs | Anchored (+10/0 dB) | 2005-2025 |
| DXpeditions | 260K | 3.9M rare-grid paths | Measured | 2009-2025 |
| PSK Reporter | 8.4M | 514M+ FT8/WSPR spots | Measured (-34 to +38 dB) | Feb 2026+ |
| Solar Indices | — | 77K daily/3-hour records | SFI, SSN, Kp, Ap | 2000-2026 |
| DSCOVR L1 | — | 23K solar wind samples | Bz, speed, density | Feb 2026+ |
All signature tables share an identical 13-column schema (tx\_grid, rx\_grid, band, hour, month, median\_snr, spot\_count, snr\_std, reliability, avg\_sfi, avg\_kp, avg\_distance, avg\_azimuth) — ready for cross-source analysis.
Quick Start
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
