adif-mcp 0.5.1

ADIF MCP core engine with plugin support (LoTW, eQSL, QRZ, Clublog)

adif-mcp

Core Model Context Protocol (MCP) service for Amateur Radio Logging, per ADIF 3.1.6 specification

Pretty Code • Pretty Output • Iterative Docs - A simple mantra: keep the code clean, the output clear, and the docs evolving.

---

Resources

Core Project Health

MCP / API Readiness

Compliance and Program Registry

---

Project Ethos

ADIF-MCP is a community-driven effort. It is not intended to replace or compete with existing ADIF libraries, utilities, or logging applications. Instead, it provides a common foundation that others can build upon.

• Interoperability — a schema-driven, spec-compliant core that makes it easier for tools, logs, and services to talk to each other.
• Extensibility — a plugin and integration framework for services like LoTW, eQSL, QRZ, and future platforms.
• Collaboration — designed to complement, not fragment, the ecosystem of ADIF tools already enjoyed by the ham community.
• Future-facing — introduces safe, typed access to ADIF data in contexts such as AI agents and MCP integrations, opening doors for innovation while preserving compatibility.

Our goal is simple: support and enhance the Amateur Radio logging ecosystem while keeping the project open, transparent, and aligned with the spirit of the hobby.

---

Specifications & Standards

ADIF-MCP is built upon the official Amateur Data Interchange Format (ADIF).

• Current Spec Version: 3.1.6 (Released 2025-09-15)
• Source: All field definitions, data types, and enumerations are derived from the official resources provided by the ADIF Developers Group.
• Compliance: This tool aims for 100% compliance with the ADIF 3.1.6 standard, including support for ADI and ADX formats.

Note: ADIF is a trademark of the ADIF Developers Group. This project is an independent implementation intended to support the amateur radio community.

---

ADIF-MCP Engines

This package defines the ADIF MCP core engine, with plugins for:

• LoTW (adif-mcp-lotw)
• eQSL (adif-mcp-eqsl)
• qrz (adif-mcp-qrz)
• clublog (adif-mcp-clublog)

Performs these tasks

• Validation & normalization of ADIF records
• Unified schema for consistent QSO storage and exchange
• MCP-ready tools for safe AI-agent access
• Foundation for service adapters (e.g., LoTW, eQSL, Qrx, Clublog)

🔑 Takeaway: MCP doesn’t replace LoTW, eQSL, Clublog, Qrz, or award / logging program(s). Instead, it gives operators visibility and accessibility into their award progress, across sponsors, without them needing to export, filter, or code.

---

Why ADIF-MCP Matters

Unlike existing ADIF editors and one-off utilities, ADIF-MCP is a shared protocol engine for the Amateur Radio community:

• Spec-compliant & typed — ADIF fields are validated against the official standard.
• Extensible — integrations (LoTW, eQSL, QRZ, Clublog, and other logging apps) plug into a common base.
• AI-ready — exposes safe, typed tools to AI agents via the Model Context Protocol.
• Foundation, not silo — one engine many apps can trust, instead of everyone re-implementing ADIF parsing.

👉 ADIF-MCP turns ADIF from a static file format into a living protocol interface.

---

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

---

Next Steps

• Build adif-mcp-lotw and adif-mcp-eqsl adapters
• Expose MCP tools for validation, award tracking, and service sync
• Support cross-logger interoperability with AI-driven agents

Compliance & Provenance

ADIF-MCP and its plugins follow the ADIF Specification (currently 3.1.6) and use registered Program IDs to identify all exports:

• ADIF-MCP — Core engine
• ADIF-MCP-LOTW — Plugin for ARRL Logbook of The World
• ADIF-MCP-EQSL — Plugin for eQSL.cc
• ADIF-MCP-QRZ — Plugin for Qrz.com
• ADIF-MCP-CLUBLOG — Plugin for Clublog.com
• ADIF-MCP-NEXT — Whatever else operators want integrated

To ensure transparency and auditability, the project also uses APP_ fields for provenance when augmenting records. Examples include:

• APP_ADIF-MCP_OP → operation performed (normalize, validate, merge)
• APP_ADIF-MCP-LOTW_ACTION → LoTW plugin operation
• APP_ADIF-MCP-EQSL_TIME → timestamp of eQSL merge

See the Program ID & APP_ Field Policy for full details.

License

MIT — open and free for amateur radio use.