Skip to main content

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

Project description

adif-mcp

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


Resources

Made with Python License: MIT

Core Project Health

ADIF GitHub release GitHub tag CI Docs pre-commit Conventional Commits SSL Certificate Expiry Check

MCP / API Readiness

MCP API Docs JSON Schema Manifest Validate

Compliance and Program Registry

ADIF 3.1.5 Program ID


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)

Why?

Every amateur radio logger supports ADIF, but implementations are fragmented. adif-mcp offers a single, standards-based interface to make QSO data portable, auditable, and agent-friendly.

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.

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

adif_mcp-0.1.14.tar.gz (9.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

adif_mcp-0.1.14-py3-none-any.whl (7.3 kB view details)

Uploaded Python 3

File details

Details for the file adif_mcp-0.1.14.tar.gz.

File metadata

  • Download URL: adif_mcp-0.1.14.tar.gz
  • Upload date:
  • Size: 9.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for adif_mcp-0.1.14.tar.gz
Algorithm Hash digest
SHA256 1e4009d8f49325e60f9111f028c0469f14f986d41ca7363606e049d061c58341
MD5 f1e113461273e5de4f8c6a2a6ea41259
BLAKE2b-256 c1dd373e84f588ae68bd8c65a9e2328fe659c0c5d0682a65f0d978ba84f4484c

See more details on using hashes here.

Provenance

The following attestation bundles were made for adif_mcp-0.1.14.tar.gz:

Publisher: release.yml on KI7MT/adif-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

File details

Details for the file adif_mcp-0.1.14-py3-none-any.whl.

File metadata

  • Download URL: adif_mcp-0.1.14-py3-none-any.whl
  • Upload date:
  • Size: 7.3 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? Yes
  • Uploaded via: twine/6.1.0 CPython/3.12.9

File hashes

Hashes for adif_mcp-0.1.14-py3-none-any.whl
Algorithm Hash digest
SHA256 11d7fd0c11a1e487adc9f239e7b5935b766540cec777bdb3bf0ea6cf5ee393c2
MD5 dfff333571ee6d753a3c6d29291b1db6
BLAKE2b-256 8ab757d9c1cf851ccc5d505899f7a9e023fe5fbf86f48a840eecb090168b3033

See more details on using hashes here.

Provenance

The following attestation bundles were made for adif_mcp-0.1.14-py3-none-any.whl:

Publisher: release.yml on KI7MT/adif-mcp

Attestations: Values shown here reflect the state when the release was signed and may no longer be current.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page