adif-mcp
Core Model Context Protocol (MCP) server for Amateur Radio Logging, built on the ADIF 3.1.7 specification.
Overview
adif-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.
Quick Start
pip install adif-mcp
Configure Your MCP Client
adif-mcp works with any MCP-compatible client. Add the server config and restart -- tools appear automatically.
Claude Desktop
Add to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):
{
"mcpServers": {
"adif": {
"command": "adif-mcp"
}
}
}
Claude Code
Add to .claude/settings.json:
{
"mcpServers": {
"adif": {
"command": "adif-mcp"
}
}
}
ChatGPT Desktop
Configure via Settings > Apps & Connectors, or in your agent definition:
{
"mcpServers": {
"adif": {
"command": "adif-mcp"
}
}
}
Cursor
Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):
{
"mcpServers": {
"adif": {
"command": "adif-mcp"
}
}
}
VS Code / GitHub Copilot
Add to .vscode/mcp.json in your workspace:
{
"servers": {
"adif": {
"command": "adif-mcp"
}
}
}
Gemini CLI
Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):
{
"mcpServers": {
"adif": {
"command": "adif-mcp"
}
}
}
Tools
adif-mcp exposes 8 tools via the Model Context Protocol:
| Category | Tool | Description |
|---|---|---|
| Validation | validate_adif_record |
Validate a raw ADIF string against the 3.1.7 spec |
| Validation | parse_adif |
Streaming parser for large ADIF files with pagination |
| Spec | read_specification_resource |
Retrieve raw JSON for any spec module (band, mode, fields) |
| Spec | list_enumerations |
List all ADIF enumerations with entry counts |
| Spec | search_enumerations |
Search enumeration records by keyword |
| Geospatial | calculate_distance |
Great Circle distance (km) between two Maidenhead locators |
| Geospatial | calculate_heading |
Initial beam heading (azimuth) between two locators |
| System | get_version_info |
Active service version and ADIF spec version |
Architecture
adif-mcp is the ADIF specification package -- validation, parsing, and geospatial tools. Credential management is handled by qso-graph-auth. Service integrations are separate MCP servers:
| Package | PyPI | What It Does |
|---|---|---|
qso-graph-auth |
v0.1.1 | OS keyring credential management, persona CRUD |
adif-mcp |
v1.1.0 | ADIF 3.1.7 spec tools, validation, parsing, geospatial |
eqsl-mcp |
v0.3.1 | eQSL inbox, verification, AG status, last upload |
qrz-mcp |
v0.3.1 | Callsign lookup, DXCC, logbook status/fetch |
lotw-mcp |
v0.3.1 | LoTW confirmations, QSOs, DXCC credits, user activity |
hamqth-mcp |
v0.4.0 | Callsign lookup, DXCC, bio, activity, DX spots, RBN, QSO verify |
pota-mcp |
v0.2.1 | Parks on the Air spots, park info, stats, schedules |
sota-mcp |
v0.1.5 | Summits on the Air spots, alerts, summit info, stats |
solar-mcp |
v0.2.0 | Space weather conditions, forecasts, band outlook |
wspr-mcp |
v0.3.1 | WSPR beacon spots, propagation, band activity |
iota-mcp |
v0.1.1 | Islands on the Air lookup, search, nearby groups |
n1mm-mcp |
v0.1.3 | N1MM Logger+ contest state via UDP |
ionis-mcp |
v1.2.8 | HF propagation analytics (175M+ signatures) |
qsp-mcp |
v0.2.1 | Local LLM ↔ MCP tool relay |
Authenticated servers use 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.
Compliance & Provenance
adif-mcp follows the ADIF Specification (currently 3.1.7) and uses registered Program IDs to identify all exports:
ADIF-MCP-- Core engineADIF-MCP-LOTW-- LoTW serverADIF-MCP-EQSL-- eQSL serverADIF-MCP-QRZ-- QRZ server
The project uses APP_ fields for provenance when augmenting records:
APP_ADIF-MCP_OP-- operation performed (normalize,validate,merge)APP_ADIF-MCP-LOTW_ACTION-- LoTW server operationAPP_ADIF-MCP-EQSL_TIME-- timestamp of eQSL merge
License
GPL-3.0-or-later. See LICENSE for details.
1 maintainer
Metadata
1 maintainer
Release files for adif-mcp 1.1.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| adif_mcp-1.1.1.tar.gz | 456.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| adif_mcp-1.1.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 933.9 kB
Release files / adif_mcp-1.1.1.tar.gz
| Download URL | adif_mcp-1.1.1.tar.gz |
|---|---|
| Size | 456.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ef07029c01b7ae33270e2e625a040c13e4bc8578a17d2d6cccdd694220755c22
|
|
BLAKE2b-256 checksum How to use checksums |
a55f7359c22518a1345689f1f7d1baaa5378e6121a5ec4a1062d7bebe3beeb28
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.
Transparency logRelease files / adif_mcp-1.1.1-py3-none-any.whl
| Download URL | adif_mcp-1.1.1-py3-none-any.whl |
|---|---|
| Size | 477.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
4ada8db5db0eaea7afc6e635488e1faa4fc3e909c36e6ef5a054051db696d86b
|
|
BLAKE2b-256 checksum How to use checksums |
838d0fb1871cea4db065df8bb6eb9a1947a4bfe9c1fd9934a9bc18b14a659c39
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Sep 26, 2026.
Transparency log
