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

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

AutoBrowser MCP

autobrowser-ai

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K

🚀 Model Context Protocol (MCP) Curriculum for Beginners

microsoft

This open-source curriculum introduces the fundamentals of Model Context Protocol (MCP) through real-world, cross-language examples in .NET, Java, TypeScript, JavaScript, Rust and Python. Designed for developers, it focuses on practical techniques for building modular, scalable,

16.7K