io.github.qso-graph/ionis-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| IONIS_DATA_DIR | No | Path to the ionis-mcp data directory. Overrides default ~/.ionis-mcp/data/ |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": true
} |
| resources | {
"subscribe": false,
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_version_infoA | Get ionis-mcp service version and upstream dataset version. Returns the running PyPI version of ionis-mcp and the IONIS SourceForge dataset bundle revision 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. |
| list_datasetsA | Show available IONIS datasets and their statistics. Lists all datasets found in the configured data directory with row counts, file sizes, and descriptions. Use this to see what data is available for querying. |
| query_signaturesB | Query propagation signatures with filters. Searches across WSPR, RBN, Contest, DXpedition, and PSKR signature tables. All signature tables share the same 13-column schema. |
| band_openingsA | When does a specific band open between two grid squares? Shows propagation hour-by-hour (0-23z) for a grid pair on a given band. Includes spot-count-weighted SNR, reliability, SFI, and solar elevation at both endpoints. |
| path_analysisA | Complete analysis of a propagation path across all bands and hours. Provides distance/azimuth, best band/hour combinations ranked by reliability, seasonal patterns, solar geometry, and total observation counts from all available data sources. |
| solar_correlationA | How does solar flux (SFI) affect propagation on a specific band? Groups signatures by SFI bracket and shows spot counts, average SNR, and reliability for each bracket. Higher SFI generally helps HF bands above 30m (F-layer ionization) but hurts bands below 30m (D-layer absorption). |
| grid_infoA | Decode a Maidenhead grid to lat/lon and compute solar elevation. Converts a 4-char or 6-char Maidenhead grid square to geographic coordinates. If hour is provided, computes solar elevation angle with day/twilight/night classification. |
| compare_sourcesA | Cross-dataset comparison for a path/band. Shows side-by-side data from all available sources (WSPR, RBN, Contest, DXpedition, PSKR) for the same path. Useful for validating observations across independent measurement systems. |
| dark_hour_analysisA | Classify propagation paths by solar geometry — both-day, cross-terminator, or both-dark. For a given band and hour, retrieves paths and classifies each by the solar elevation at both endpoints. Useful for identifying physically anomalous paths (e.g., 10m both-dark propagation). |
| solar_historyA | Query historical solar indices (SFI, SSN, Kp, Ap) for a date range. Returns solar flux, sunspot number, and geomagnetic indices from the IONIS dataset (GFZ Potsdam and NOAA SWPC, 2000-2026). For live current conditions, use solar-mcp's solar_conditions tool instead. |
| band_summaryA | Overview of a band across all hours and available sources. Shows total signatures and spots, hour distribution, top grid pairs, SFI range observed, and distance distribution. |
| current_conditionsA | Live space weather and band conditions — like a morning propagation forecast. Fetches real-time solar flux (SFI), Kp index, solar wind data, and active alerts from NOAA SWPC. Generates an operator-friendly band outlook based on current conditions and historical propagation patterns. Perfect for: "What bands should I use today?" or "Is it worth setting up for POTA/SOTA on 10m?" |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 12 tools
Most tools have clearly distinct purposes: metadata, dataset listing, raw signature query, specific path/band analysis, solar history, and live conditions. There is some overlap among path_analysis, band_summary, band_openings, and compare_sources, but the descriptions make their different granularities and data sources reasonably clear.
All names use snake_case, which is readable, but the convention is mixed: some are verb-first (get_version_info, list_datasets, query_signatures, compare_sources) while others are noun phrases (band_openings, path_analysis, solar_history, current_conditions). This makes the naming less predictable than a consistent verb_noun pattern.
Twelve tools is well-scoped for a radio-propagation and solar-data analysis server. The set covers metadata, exploration, raw querying, path analysis, source comparison, and live conditions without an excessive number of tools.
The surface covers data discovery, querying, aggregation, solar correlation, path/grid analysis, historical and live conditions, and version alignment. Minor gaps may exist around deeper per-signature retrieval or explicit source/callsign lookup, but core propagation-analysis workflows are well supported.