{
  "markdown": "<!-- mcp-name: io.github.qso-graph/adif-mcp -->\n# adif-mcp\n\nCore [Model Context Protocol](https://modelcontextprotocol.io/) (MCP) server for **Amateur Radio Logging**, built on the [ADIF 3.1.7 specification](https://adif.org.uk/317/ADIF_317.htm).\n\n## Overview\n\nadif-mcp gives AI agents safe, typed access to Amateur Radio logging data. It validates and parses ADIF records, searches the full ADIF 3.1.7 specification (fields, enumerations, data types), and provides geospatial utilities for Maidenhead locators.\n\n[![Made with Python](https://img.shields.io/badge/Made%20with-Python-blue)](https://www.python.org/)\n[![License: GPL-3.0](https://img.shields.io/badge/License-GPL--3.0-blue.svg)](LICENSE)\n[![ADIF 3.1.7](https://img.shields.io/badge/ADIF-3.1.7-blue)](https://adif.org.uk/317/ADIF_317.htm)\n[![PyPI](https://img.shields.io/pypi/v/adif-mcp)](https://pypi.org/project/adif-mcp/)\n[![CI](https://github.com/qso-graph/adif-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/qso-graph/adif-mcp/actions/workflows/ci.yml)\n[![Docs](https://img.shields.io/badge/docs-qso--graph.io-blue)](https://qso-graph.io/)\n\n## Quick Start\n\n```bash\npip install adif-mcp\n```\n\n## Configure Your MCP Client\n\nadif-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    \"adif\": {\n      \"command\": \"adif-mcp\"\n    }\n  }\n}\n```\n\n### Claude Code\n\nAdd to `.claude/settings.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"adif\": {\n      \"command\": \"adif-mcp\"\n    }\n  }\n}\n```\n\n### ChatGPT Desktop\n\nConfigure via Settings > Apps & Connectors, or in your agent definition:\n\n```json\n{\n  \"mcpServers\": {\n    \"adif\": {\n      \"command\": \"adif-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    \"adif\": {\n      \"command\": \"adif-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    \"adif\": {\n      \"command\": \"adif-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    \"adif\": {\n      \"command\": \"adif-mcp\"\n    }\n  }\n}\n```\n\n## Tools\n\nadif-mcp exposes **8 tools** via the Model Context Protocol:\n\n| Category | Tool | Description |\n|----------|------|-------------|\n| **Validation** | `validate_adif_record` | Validate a raw ADIF string against the 3.1.7 spec |\n| **Validation** | `parse_adif` | Streaming parser for large ADIF files with pagination |\n| **Spec** | `read_specification_resource` | Retrieve raw JSON for any spec module (band, mode, fields) |\n| **Spec** | `list_enumerations` | List all ADIF enumerations with entry counts |\n| **Spec** | `search_enumerations` | Search enumeration records by keyword |\n| **Geospatial** | `calculate_distance` | Great Circle distance (km) between two Maidenhead locators |\n| **Geospatial** | `calculate_heading` | Initial beam heading (azimuth) between two locators |\n| **System** | `get_version_info` | Active service version and ADIF spec version |\n\n## Architecture\n\nadif-mcp is the **ADIF specification package** -- validation, parsing, and geospatial tools. Credential management is handled by [qso-graph-auth](https://pypi.org/project/qso-graph-auth/). Service integrations are separate MCP servers:\n\n| Package | PyPI | What It Does |\n|---------|------|-------------|\n| [`qso-graph-auth`](https://pypi.org/project/qso-graph-auth/) | v0.1.1 | OS keyring credential management, persona CRUD |\n| [`adif-mcp`](https://pypi.org/project/adif-mcp/) | v1.1.0 | ADIF 3.1.7 spec tools, validation, parsing, geospatial |\n| [`eqsl-mcp`](https://pypi.org/project/eqsl-mcp/) | v0.3.1 | eQSL inbox, verification, AG status, last upload |\n| [`qrz-mcp`](https://pypi.org/project/qrz-mcp/) | v0.3.1 | Callsign lookup, DXCC, logbook status/fetch |\n| [`lotw-mcp`](https://pypi.org/project/lotw-mcp/) | v0.3.1 | LoTW confirmations, QSOs, DXCC credits, user activity |\n| [`hamqth-mcp`](https://pypi.org/project/hamqth-mcp/) | v0.4.0 | Callsign lookup, DXCC, bio, activity, DX spots, RBN, QSO verify |\n| [`pota-mcp`](https://pypi.org/project/pota-mcp/) | v0.2.1 | Parks on the Air spots, park info, stats, schedules |\n| [`sota-mcp`](https://pypi.org/project/sota-mcp/) | v0.1.5 | Summits on the Air spots, alerts, summit info, stats |\n| [`solar-mcp`](https://pypi.org/project/solar-mcp/) | v0.2.0 | Space weather conditions, forecasts, band outlook |\n| [`wspr-mcp`](https://pypi.org/project/wspr-mcp/) | v0.3.1 | WSPR beacon spots, propagation, band activity |\n| [`iota-mcp`](https://pypi.org/project/iota-mcp/) | v0.1.1 | Islands on the Air lookup, search, nearby groups |\n| [`n1mm-mcp`](https://pypi.org/project/n1mm-mcp/) | v0.1.3 | N1MM Logger+ contest state via UDP |\n| [`ionis-mcp`](https://pypi.org/project/ionis-mcp/) | v1.2.8 | HF propagation analytics (175M+ signatures) |\n| [`qsp-mcp`](https://pypi.org/project/qsp-mcp/) | v0.2.1 | Local LLM ↔ MCP tool relay |\n\nAuthenticated servers use [qso-graph-auth](https://pypi.org/project/qso-graph-auth/) for persona lookup and keyring-backed credentials. Operators install only the servers they need. Each server is independently versioned with no unnecessary dependencies.\n\n## Compliance & Provenance\n\nadif-mcp follows the [ADIF Specification](https://adif.org.uk) (currently 3.1.7) and uses **registered Program IDs** to identify all exports:\n\n- `ADIF-MCP` -- Core engine\n- `ADIF-MCP-LOTW` -- LoTW server\n- `ADIF-MCP-EQSL` -- eQSL server\n- `ADIF-MCP-QRZ` -- QRZ server\n\nThe project uses **APP_ fields** for provenance when augmenting records:\n\n- `APP_ADIF-MCP_OP` -- operation performed (`normalize`, `validate`, `merge`)\n- `APP_ADIF-MCP-LOTW_ACTION` -- LoTW server operation\n- `APP_ADIF-MCP-EQSL_TIME` -- timestamp of eQSL merge\n\n## License\n\nGPL-3.0-or-later. See [LICENSE](LICENSE) for details.\n",
  "bytes": 6037,
  "sha": "744e9dc6424ba1e026d797a49b8dadcbb98b6a081dde5d730ca930d1b6e4aa3b",
  "repo_slug": "qso-graph/adif-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_qso_graph_adif_mcp_d2eb79c0/readme"
}