Hamqth Mcp

What is Hamqth Mcp?

A Model Context Protocol server for HamQTH.com that provides callsign lookup, DX cluster spots, Reverse Beacon Network decodes, DXCC resolution, and more through any MCP-compatible AI assistant. It is part of the qso-graph project and uses qso-graph-auth for authenticated tool credential management.

How to use Hamqth Mcp?

Install with pip install hamqth-mcp, create a free HamQTH account, set up credentials using adif-mcp personas, then configure your MCP client to run the hamqth-mcp command. Tools appear automatically after restarting the client.

Key features of Hamqth Mcp

• Callsign lookup (name, grid, DXCC, coordinates, QSL preferences)
• DXCC entity resolution from callsign or ADIF code
• Operator biography retrieval
• Recent DX cluster, RBN, and logbook activity
• Live DX cluster spots and RBN decodes with filters
• QSO verification via HamQTH SAVP protocol

Use cases of Hamqth Mcp

• Look up a callsign’s operator name and grid square
• Resolve a DXCC entity from an unknown prefix
• Fetch an operator’s biography for context
• Monitor live DX spots filtered by band or callsign
• Verify a logged QSO through HamQTH’s SAVP protocol

FAQ from Hamqth Mcp

Do I need a HamQTH account to use this server?

Yes, most tools require HamQTH credentials. The hamqth_dxcc tool and mock mode (with HAMQTH_MCP_MOCK=1) work without an account.

How can I test the server without a HamQTH account?

Set the environment variable HAMQTH_MCP_MOCK=1 before running hamqth-mcp. This simulates all tools with sample data.

Which MCP clients are supported?

Claude Desktop, Claude Code, ChatGPT Desktop, Cursor, VS Code / GitHub Copilot, and Gemini CLI are explicitly documented with config examples.

How do I install Hamqth Mcp?

Install via pip: pip install hamqth-mcp. For development, clone the repository and run pip install -e ..

What license is Hamqth Mcp released under?

GPL-3.0-or-later.