Skip to content

About qso-graph

Mission

qso-graph connects AI assistants to ham radio services through the Model Context Protocol. Instead of switching between browser tabs, logging platforms, and propagation tools, operators can ask questions in natural language and get answers from their actual data.

"Do I have any new LoTW confirmations?" "What's the solar forecast?" "Is 3Y0J in the Club Log?" — these should be as easy to ask as they are to think.

The Name

A QSO is a radio contact between two stations. Graph refers to the network of connections between operators, bands, modes, and propagation paths. qso-graph is the connective tissue between ham radio services and the tools operators actually use.

Author

Greg Beam, KI7MT — Extra class amateur radio operator, software engineer, and builder of the IONIS HF propagation prediction system. 49,000+ QSOs across all HF bands. Based in Idaho.

qso-graph grew out of the IONIS project's need to integrate with ham radio services for validation and analysis. The MCP servers were designed to be useful on their own — you don't need IONIS to use qso-graph.

  • IONIS — Ionospheric Neural Inference System. Physics-constrained neural network for HF propagation prediction, trained on 14 billion amateur radio observations.
  • ionis-mcp — MCP server for propagation analytics using IONIS datasets (175M+ signatures from WSPR, RBN, contests, and PSK Reporter).
  • ionis-jupyter — Jupyter notebooks for propagation research.
  • adif-mcp — Foundation library for ADIF parsing and credential management. Used by all authenticated qso-graph servers.

License

All qso-graph packages are released under the GNU General Public License v3.0.