io.github.qso-graph/hamqth-mcp

Get hamqth-mcp service version and upstream HamQTH API version. Returns the running PyPI version of hamqth-mcp and the HamQTH.com API contract 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 (HamQTH API).

Look up a callsign on HamQTH (free, no subscription required). Returns name, grid, DXCC, coordinates, QSL preferences, and more. Field availability depends on what the operator has published. Args: persona: Persona name configured in adif-mcp. callsign: Callsign to look up (e.g., OK2CQR). Returns: Structured record with station details.

Resolve a DXCC entity from a callsign or ADIF entity code. Public endpoint — no authentication required. Args: query: Callsign (e.g., VP8PJ) or ADIF entity code (e.g., 291). Returns: DXCC entity details (name, continent, CQ/ITU zones, coordinates).

Fetch an operator's biography from HamQTH. Args: persona: Persona name configured in adif-mcp. callsign: Callsign to look up. Returns: Callsign and biography text (HTML stripped).

Get recent DX cluster, RBN, and logbook activity for a callsign. Args: persona: Persona name configured in adif-mcp. callsign: Callsign to check. Returns: List of recent activity items (spots, RBN decodes, logbook entries).

Live DX cluster spots from HamQTH (public, no auth required). Spots update every ~15 seconds. Max 200 spots per request. Args: limit: Number of spots to return (default 60, max 200). band: Optional ADIF band filter (e.g., "20M", "40M"). call: Optional callsign filter — matches spotted call or spotter (case-insensitive, e.g., "3Y0K"). Pulls max spots and filters client-side since the API does not support server-side filtering. Returns: List of DX cluster spots with call, freq, band, spotter, etc.

Reverse Beacon Network spots from HamQTH (public, no auth required). Args: band: ADIF band numbers, comma-separated (e.g., "20,40"). mode: Filter by mode (CW, RTTY, PSK31, PSK63). cont: Filter by spotted station's continent (e.g., "EU", "NA"). fromcont: Filter by receiver/skimmer continent. age: Maximum age in seconds. call: Optional callsign filter — matches spotted station (case-insensitive, e.g., "3Y0K"). Filtered client-side. Returns: List of RBN decodes with call, freq, mode, age, and listener dB values.

Verify a QSO via HamQTH SAVP protocol (public, no auth required). Checks if a QSO exists in HamQTH's database for both parties. Args: mycall: Your callsign (e.g., "KI7MT"). hiscall: Other station's callsign (e.g., "OK2CQR"). date: QSO date in YYYYMMDD format (e.g., "20260305"). band: Band (e.g., "20M", "40M"). Returns: SAVP verification result with match status.