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": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
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. Returns: service_name, service_version (PyPI), and spec_version (dataset bundle). |
| 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_signaturesC | 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 distinct purposes (e.g., band_openings vs band_summary, path_analysis vs compare_sources), but some overlap exists between compare_sources and query_signatures as both query data; however, descriptions clearly differentiate them.
All names use snake_case, but they mix noun-first (band_openings, current_conditions) and verb-first (compare_sources, get_version_info) patterns inconsistently, which may confuse an agent expecting a uniform verb_noun format.
12 tools are well-scoped for the propagation analysis domain, covering key areas like band-specific queries, path analysis, solar conditions, and utilities without being excessive or skeletal.
The set covers core propagation analysis needs (querying, band/path analysis, solar correlation, historical data), but lacks a tool for direct band-to-band comparison or predictive modeling, which are minor gaps.