{
  "markdown": "<!-- mcp-name: io.github.qso-graph/hamqth-mcp -->\n# hamqth-mcp\n\nMCP server for [HamQTH.com](https://www.hamqth.com/) — callsign lookup, DX cluster spots, Reverse Beacon Network, DXCC resolution, and more through any MCP-compatible AI assistant.\n\nPart of the [qso-graph](https://qso-graph.io/) project. Authenticated tools use [qso-graph-auth](https://pypi.org/project/qso-graph-auth/) for persona and credential management.\n\n## Install\n\n```bash\npip install hamqth-mcp\n```\n\n## Tools\n\n| Tool | Auth | Description |\n|------|------|-------------|\n| `hamqth_lookup` | Yes | Callsign lookup (name, grid, DXCC, coordinates, QSL preferences) |\n| `hamqth_dxcc` | No | Resolve DXCC entity from callsign or ADIF code |\n| `hamqth_bio` | Yes | Fetch operator biography |\n| `hamqth_activity` | Yes | Recent DX cluster, RBN, and logbook activity |\n| `hamqth_dx_spots` | No | Live DX cluster spots — filter by band and/or callsign |\n| `hamqth_rbn` | No | Reverse Beacon Network decodes — filter by band, mode, continent, callsign |\n| `hamqth_verify_qso` | No | Verify a QSO via HamQTH SAVP protocol |\n| `get_version_info` | No | Service version + upstream HamQTH API version (fleet identity attestation) |\n\n## Quick Start\n\n### 1. Create a free HamQTH account\n\nSign up at [hamqth.com](https://www.hamqth.com/) — it's free, no subscription required.\n\n### 2. Set up credentials\n\nhamqth-mcp uses adif-mcp personas for credential management:\n\n```bash\n# Install adif-mcp if you haven't\npip install adif-mcp\n\n# Create a persona and add HamQTH credentials\nadif-mcp persona create ki7mt --callsign KI7MT\nadif-mcp persona provider ki7mt hamqth --username KI7MT\nadif-mcp persona secret ki7mt hamqth\n```\n\n### 3. Configure your MCP client\n\nhamqth-mcp works with any MCP-compatible client. Add the server config and restart — tools appear automatically.\n\n#### Claude Desktop\n\nAdd to `claude_desktop_config.json` (`~/Library/Application Support/Claude/` on macOS, `%APPDATA%\\Claude\\` on Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"hamqth\": {\n      \"command\": \"hamqth-mcp\"\n    }\n  }\n}\n```\n\n#### Claude Code\n\nAdd to `.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"hamqth\": {\n      \"command\": \"hamqth-mcp\"\n    }\n  }\n}\n```\n\n#### ChatGPT Desktop\n\n```json\n{\n  \"mcpServers\": {\n    \"hamqth\": {\n      \"command\": \"hamqth-mcp\"\n    }\n  }\n}\n```\n\n#### Cursor\n\nAdd to `.cursor/mcp.json` (project-level) or `~/.cursor/mcp.json` (global):\n\n```json\n{\n  \"mcpServers\": {\n    \"hamqth\": {\n      \"command\": \"hamqth-mcp\"\n    }\n  }\n}\n```\n\n#### VS Code / GitHub Copilot\n\nAdd to `.vscode/mcp.json` in your workspace:\n\n```json\n{\n  \"servers\": {\n    \"hamqth\": {\n      \"command\": \"hamqth-mcp\"\n    }\n  }\n}\n```\n\n#### Gemini CLI\n\nAdd to `~/.gemini/settings.json` (global) or `.gemini/settings.json` (project):\n\n```json\n{\n  \"mcpServers\": {\n    \"hamqth\": {\n      \"command\": \"hamqth-mcp\"\n    }\n  }\n}\n```\n\n### 4. Ask questions\n\n> \"Look up the callsign OK2CQR\"\n\n> \"What DXCC entity is VP8PJ?\"\n\n> \"Show me the biography for OK2CQR\"\n\n> \"What's the recent activity for KI7MT?\"\n\n> \"Show me DX spots for 3Y0K\"\n\n> \"What RBN decodes are there for 3Y0K on CW?\"\n\n> \"Show me 20m DX spots\"\n\n> \"Verify my QSO with OK2CQR on 20m on March 5\"\n\n## Testing Without Credentials\n\nThe DXCC tool (`hamqth_dxcc`) works without any credentials — it uses a public endpoint.\n\nFor testing all tools without a HamQTH account:\n\n```bash\nHAMQTH_MCP_MOCK=1 hamqth-mcp\n```\n\n## MCP Inspector\n\n```bash\nhamqth-mcp --transport streamable-http --port 8005\n```\n\nThen open the MCP Inspector at `http://localhost:8005`.\n\n## Development\n\n```bash\ngit clone https://github.com/qso-graph/hamqth-mcp.git\ncd hamqth-mcp\npip install -e .\n```\n\n## License\n\nGPL-3.0-or-later\n",
  "bytes": 3665,
  "sha": "c1d3620b098941b8e96e4a7ba195be4b324652011f881447841dc43b9c30a73e",
  "repo_slug": "qso-graph/hamqth-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_qso_graph_hamqth_mcp_81c1887f/readme"
}