io.github.qso-graph/ionis-mcp

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).

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 propagation signatures with filters. Searches across WSPR, RBN, Contest, DXpedition, and PSKR signature tables. All signature tables share the same 13-column schema. Args: source: "wspr", "rbn", "contest", "dxpedition", "pskr", or "all" band: ADIF band ID (102=160m, 103=80m, 104=60m, 105=40m, 106=30m, 107=20m, 108=17m, 109=15m, 110=12m, 111=10m) tx_grid: TX grid square (4-char like "DN13" or 2-char field like "DN") rx_grid: RX grid square (4-char or 2-char) hour: UTC hour (0-23) month: Month (1-12) min_spots: Minimum spot count filter (default: 5) limit: Max rows returned (default: 100, max: 1000) Returns: Matching signatures with all columns plus source label.

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. Args: tx_grid: Transmitter 4-char Maidenhead grid (e.g., "DN13") rx_grid: Receiver 4-char Maidenhead grid (e.g., "JO51") band: ADIF band ID (102-111) Returns: 24-row hourly profile with SNR, spots, reliability, solar geometry.

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. Args: tx_grid: Transmitter 4-char Maidenhead grid rx_grid: Receiver 4-char Maidenhead grid source: Dataset source or "all"

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). Args: band: ADIF band ID (102-111) tx_grid: Optional TX grid to filter (omit for global) rx_grid: Optional RX grid to filter (omit for global) source: Dataset source (default: "wspr")

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. Args: grid: Maidenhead grid (4-char like "DN13" or 6-char like "DN13la") hour: UTC hour (0-23) for solar elevation calculation month: Month (1-12) for solar elevation (used if day_of_year not given) day_of_year: Day of year (1-366) for precise solar elevation

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. Args: tx_grid: Transmitter 4-char grid rx_grid: Receiver 4-char grid band: ADIF band ID (102-111) hour: Specific UTC hour (omit for all hours)

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). Args: band: ADIF band ID (102-111) hour: UTC hour (0-23) month: Month (1-12) for solar geometry (default: all months aggregated) source: Dataset source (default: "pskr" for most recent data) min_spots: Minimum spot count filter (default: 10)

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. Args: start_date: Start date (YYYY-MM-DD) end_date: End date (YYYY-MM-DD) resolution: "daily" (default) or "3hour" for Kp resolution

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. Args: band: ADIF band ID (102-111) source: Dataset source or "all"

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?" Args: qth_grid: Your 4-char Maidenhead grid (e.g., "DN13") for solar elevation context. Optional but recommended.