Hamqth MCP Server

@qso-graph

Repository Homepage

Basic information

About Hamqth MCP Server

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

#amateur-radio#hamqth#callsign#lookup

Hamqth MCP Server config

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

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

Hamqth MCP Server 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

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

More Other MCP servers

ICSS

chokcoco

不止于 CSS

20.7K

Soar Flight Booking MCP

Soar Flight Booking MCP is a remote MCP server available at https://mcp.soar.flights.

Hindsight

vectorize-io

Hindsight: Agent Memory That Learns

50.4K

MaxKB

1Panel-dev

🔥 MaxKB is an open-source platform for building enterprise-grade agents. 强大易用的开源企业级智能体平台。

22.0K

Screenpipe

screenpipe

YC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context