Hamqth Mcp

by qso-graph

386 downloads
Not rated
GitHub Website

About

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

Details

Author
qso-graph
Downloads
386
Categories
Other

- 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:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name Hamqth Mcp
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

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.

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"
    }
}

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

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.