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/ |
Capabilities
Features and capabilities supported by this server
| 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 | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/qso-graph/ionis-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server