io.github.qso-graphPublished by GitHub account qso-graphv0.7.1Updated Nov 3, 2026
HamQTH.com MCP server. Free callsign lookup, DX spots, RBN data, SAVP verification.
Local MCP server for HamQTH.com that lets an assistant look up amateur radio callsigns, resolve DXCC entities, and read live DX spots and RBN decodes.
Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.
Follow the launch instructions in the repository.
MCP server for HamQTH.com — callsign lookup, DX cluster spots, Reverse Beacon Network, DXCC resolution, and more through any MCP-compatible AI assistant.
Part of the qso-graph project. Authenticated tools use qso-graph-auth for persona and credential management.
Sign up at hamqth.com — it's free, no subscription required.
hamqth-mcp uses qso-graph-auth personas for credential management:
All three steps are needed: without provider enable, the server reports that the persona has no hamqth ref.
hamqth-mcp works with any MCP-compatible client. Add the server config and restart — tools appear automatically.
Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):
Add to .claude/settings.json:
Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):
Add to .vscode/mcp.json in your workspace:
Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):
"Look up the callsign OK2CQR"
"What DXCC entity is VP8PJ?"
"Show me the biography for OK2CQR"
"What's the recent activity for KI7MT?"
"Show me DX spots for 3Y0K"
"What RBN decodes are there for 3Y0K on CW?"
"Show me 20m DX spots"
"Verify my QSO with OK2CQR on 20m on March 5"
The DXCC tool (hamqth_dxcc) works without any credentials — it uses a public endpoint.
For testing all tools without a HamQTH account:
Then open the MCP Inspector at http://localhost:8005.
GPL-3.0-or-later
Source: README.md at commit 86323b7
Get Version Info
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.
Takes no parameters.
Hamqth Lookup
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.
personarequiredcallsignrequiredHamqth Dxcc
Resolve a DXCC entity from a callsign or ADIF entity code. Public endpoint — no authentication required.
queryrequiredHamqth Bio
Fetch an operator's biography from HamQTH.
personarequiredcallsignrequiredHamqth Activity
Get recent DX cluster, RBN, and logbook activity for a callsign.
personarequiredcallsignrequiredHamqth Dx Spots
Live DX cluster spots from HamQTH (public, no auth required). Spots update every ~15 seconds. Max 200 spots per request.
bandcalllimitHamqth Rbn
Reverse Beacon Network spots from HamQTH (public, no auth required).
agebandcallcontmodefromcontHamqth Verify Qso
Verify a QSO via HamQTH SAVP protocol (public, no auth required). Checks if a QSO exists in HamQTH's database for both parties.
bandrequireddaterequiredmycallrequiredhiscallrequired90% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.
uvx hamqth-mcp # run it; nothing to install# Install qso-graph-auth if you haven'tuv tool install qso-graph-auth
# A persona (your callsign and the dates it covers), then HamQTH for itqso-graph-auth persona add --name ki7mt --callsign KI7MT --start 2020-01-01qso-graph-auth provider enable ki7mt hamqthqso-graph-auth creds set ki7mt hamqth # asks for your username, then your password (hidden){ "mcpServers": { "hamqth": { "command": "uvx", "args": ["hamqth-mcp"] } }}{ "mcpServers": { "hamqth": { "command": "uvx", "args": ["hamqth-mcp"] } }}{ "mcpServers": { "hamqth": { "command": "uvx", "args": ["hamqth-mcp"] } }}{ "mcpServers": { "hamqth": { "command": "uvx", "args": ["hamqth-mcp"] } }}{ "servers": { "hamqth": { "command": "uvx", "args": ["hamqth-mcp"] } }}{ "mcpServers": { "hamqth": { "command": "uvx", "args": ["hamqth-mcp"] } }}HAMQTH_MCP_MOCK=1 hamqth-mcphamqth-mcp --transport streamable-http --port 8005git clone https://github.com/qso-graph/hamqth-mcp.gitcd hamqth-mcpuv sync --group devuv run pytest