Hamqth Mcp
About
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.
Explore
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Hamqth McpCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
pip install hamqth-mcp
pip install adif-mcp
hamqth-mcp works with any MCP-compatible client. Add the server config and restart — tools appear automatically.
hamqth_lookup
Yes
hamqth_dxcc
No
hamqth_bio
Yes
hamqth_activity
Yes
hamqth_dx_spots
No
hamqth_rbn
No
hamqth_verify_qso
No
get_version_info
No
| Tool | Auth | Description |
|------|------|-------------|
| hamqth_lookup | Yes | Callsign lookup (name, grid, DXCC, coordinates, QSL preferences) |
| hamqth_dxcc | No | Resolve DXCC entity from callsign or ADIF code |
| hamqth_bio | Yes | Fetch operator biography |
| hamqth_activity | Yes | Recent DX cluster, RBN, and logbook activity |
| hamqth_dx_spots | No | Live DX cluster spots — filter by band and/or callsign |
| hamqth_rbn | No | Reverse Beacon Network decodes — filter by band, mode, continent, callsign |
| hamqth_verify_qso | No | Verify a QSO via HamQTH SAVP protocol |
| get_version_info | No | Service version + upstream HamQTH API version (fleet identity attestation) |
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"hamqth mcp": {
"hamqth": {
"command": "hamqth-mcp"
}
}
}
}McpServers
{
"hamqth": {
"command": "hamqth-mcp"
}
}MCP server for HamQTH.com — callsign lookup, DX cluster spots, Reverse Beacon Network, DXCC resolution, and more through any MCP-compatible AI assistant.
Part of the qso-graph project. Authenticated tools use qso-graph-auth for persona and credential management.
Install
pip install hamqth-mcp
Tools
| Tool | Auth | Description |
|------|------|-------------|
| hamqth_lookup | Yes | Callsign lookup (name, grid, DXCC, coordinates, QSL preferences) |
| hamqth_dxcc | No | Resolve DXCC entity from callsign or ADIF code |
| hamqth_bio | Yes | Fetch operator biography |
| hamqth_activity | Yes | Recent DX cluster, RBN, and logbook activity |
| hamqth_dx_spots | No | Live DX cluster spots — filter by band and/or callsign |
| hamqth_rbn | No | Reverse Beacon Network decodes — filter by band, mode, continent, callsign |
| hamqth_verify_qso | No | Verify a QSO via HamQTH SAVP protocol |
| get_version_info | No | Service version + upstream HamQTH API version (fleet identity attestation) |
Quick Start
1. Create a free HamQTH account
Sign up at hamqth.com — it's free, no subscription required.
2. Set up credentials
hamqth-mcp uses adif-mcp personas for credential management:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
