Hamqth Mcp

@qso-graph

About Hamqth Mcp

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

#amateur-radio #hamqth #callsign #lookup

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.

Frequently asked questions

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

Basic information

More Other MCP servers

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K