adif-mcp 0.1.19

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

adif-mcp

Core Model Context Protocol (MCP) service for Amateur Radio Logging, per ADIF 3.1.5 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

---

Overview

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

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

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)

🔑 Takeaway: MCP doesn’t replace LoTW, eQSL, or award programs. 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, 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.

---

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.5) 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

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.