Hamqth Mcp

Name: Hamqth Mcp
Author: qso-graph

@qso-graph

Repository Homepage

About Hamqth Mcp

MCP server for HamQTH.com — callsign lookup (free QRZ alternative)

#amateur-radio #hamqth #callsign #lookup

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "hamqth": {
      "command": "hamqth-mcp"
    }
  }
}

Tools

Yes

Overview

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.

Comments

More Other MCP servers

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

88.2K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K