hamqth-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HAMQTH_MCP_MOCK | No | Set to 1 to use mock data for testing without credentials | 1 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| logging | {} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_version_infoA | Get hamqth-mcp service version and upstream HamQTH API version. Returns the running PyPI version of hamqth-mcp and the HamQTH.com API contract in use. Use this to confirm fleet alignment across MCP deployments — agents can compare service_version and spec_version across servers to detect drift without going outside the MCP protocol. Returns: service_name, service_version (PyPI), and spec_version (HamQTH API). |
| hamqth_lookupB | Look up a callsign on HamQTH (free, no subscription required). Returns name, grid, DXCC, coordinates, QSL preferences, and more. Field availability depends on what the operator has published. |
| hamqth_dxccA | Resolve a DXCC entity from a callsign or ADIF entity code. Public endpoint — no authentication required. |
| hamqth_bioB | Fetch an operator's biography from HamQTH. |
| hamqth_activityB | Get recent DX cluster, RBN, and logbook activity for a callsign. |
| hamqth_dx_spotsA | Live DX cluster spots from HamQTH (public, no auth required). Spots update every ~15 seconds. Max 200 spots per request. |
| hamqth_rbnC | Reverse Beacon Network spots from HamQTH (public, no auth required). |
| hamqth_verify_qsoA | Verify a QSO via HamQTH SAVP protocol (public, no auth required). Checks if a QSO exists in HamQTH's database for both parties. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 8 tools
Each tool targets a distinct type of information: version, activity, biography, DXCC, DX spots, callsign lookup, RBN spots, and QSO verification. No overlapping purposes.
All tools follow a consistent hamqth_<descriptive_noun> pattern, making them predictable and easy to navigate.
8 tools cover the core functionality of the HamQTH interface without being excessive or insufficient.
Covers all major lookup and activity features, but lacks tools for advanced search or user account interaction, which are not essential for the scope.