Skip to main content
Glama
darc-dok-mcp

darc-dok-mcp

by qso-graph

darc-dok-mcp

PyPI MCP Registry

Source: the Deutscher Amateur-Radio-Club e. V. (DARC): the DOK-Liste (DARC DX-Referat, by Karsten Radwan, DL2ABM, December 26, 2016) and the special-DOK list (DARC SDOK-Referat). DOKs are DARC's: this package serves the lists' rows as facts, each citing its page or row, and links to DARC's files rather than copying them. Our GPL-3.0-or-later license covers our code, not DARC's data.

MCP server for DARC DOKs and special DOKs as DARC publishes them: the local-club codes of DARC's DOK-Liste (2016-12-26) and the event codes of DARC's special-DOK list, with each special DOK's validity window. DOKs are used for DARC's DLD award, the DOK best-lists and the WAG contest, and in ADIF's DARC_DOK field.

Part of the qso-graph project. No network, no authentication: the facts from the owner's list ship with the package, and every answer names its source.

Install

uvx darc-dok-mcp            # run it; nothing to install

Related MCP server: arma-mcp

Tools

Tool

Description

Key Parameters

darc_dok_lookup

One DOK or special DOK: district and club, or purpose, callsign, window and sponsoring club

code

darc_dok_valid_on

Whether a DOK or special DOK was valid on a QSO's date

code, on_date

darc_dok_search

Find DOKs by club, town, district or purpose

text, limit

darc_dok_codes_for

Kept for the shared tool set; DOKs map to no ADIF subdivision

dxcc, subdivision

darc_dok_source_info

Owner, editions, terms, and the owner's files' URLs and SHA-256 hashes

—

get_version_info

Service version + the owner's edition served (fleet identity attestation)

—

Quick Start

No credentials needed—just install and configure your MCP client.

Configure your MCP client

darc-dok-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": {
    "darc-dok": {
      "command": "uvx",
      "args": ["darc-dok-mcp"]
    }
  }
}

Claude Code

Add to .claude/settings.json:

{
  "mcpServers": {
    "darc-dok": {
      "command": "uvx",
      "args": ["darc-dok-mcp"]
    }
  }
}

ChatGPT Desktop

{
  "mcpServers": {
    "darc-dok": {
      "command": "uvx",
      "args": ["darc-dok-mcp"]
    }
  }
}

Cursor

Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "darc-dok": {
      "command": "uvx",
      "args": ["darc-dok-mcp"]
    }
  }
}

VS Code / GitHub Copilot

Add to .vscode/mcp.json in your workspace:

{
  "servers": {
    "darc-dok": {
      "command": "uvx",
      "args": ["darc-dok-mcp"]
    }
  }
}

Gemini CLI

Add to ~/.gemini/settings.json (global) or .gemini/settings.json (project):

{
  "mcpServers": {
    "darc-dok": {
      "command": "uvx",
      "args": ["darc-dok-mcp"]
    }
  }
}

Ask questions

"Which club is DOK A01?"

"Was special DOK 01ALT valid on 2004-06-01?"

"Which DOKs are in district Baden?"

MCP Inspector

darc-dok-mcp --transport streamable-http --port 8018

Then open the MCP Inspector at http://localhost:8018.

Development

git clone https://github.com/qso-graph/darc-dok-mcp.git
cd darc-dok-mcp
uv sync --group dev
uv run pytest

scripts/fetch_published.py fetches the owner's documents into published/ (not committed) and checks their SHA-256 hashes; uv run pytest --live runs the tests that need them. scripts/build.py regenerates derived/ and load.sql, a PostgreSQL load for QSO Graph's reference data (load QG ADIF's adif schema first).

License

darc-dok-mcp's own code is GPL-3.0-or-later. See LICENSE. The data it serves is the owner's, credited at the top of this page: our license doesn't cover it, and we claim no rights in it. The owner's document itself is not included; data/SOURCE.json records its URL and SHA-256 so anyone can check the facts against it. Files we built from the facts (data/derived/) are ours and labelled as ours. How the owner's text was read is recorded in docs/TRANSCRIPTION.md. See NOTICE.

Available Tools

6 tools
darc_dok_codes_forDarc Dok Codes ForB
Read-onlyIdempotent

DOK lists don't map to ADIF subdivisions: this answers for entity 230 (Germany) with nothing per subdivision. Use darc_dok_search for a district or town.

Inputs: dxcc (required), subdivision. Returns: object

darc_dok_lookupDarc Dok LookupB
Read-onlyIdempotent

One DOK or special DOK: the district and local club (DOKs), or the purpose, callsign, validity window and sponsoring club (special DOKs), with the citation.

Inputs: code (required). Returns: object

darc_dok_source_infoDarc Dok Source InfoB
Read-onlyIdempotent

Who owns this list, which edition is served, its terms, and the owner's files' URLs and SHA-256s.

Inputs: no named parameters. Returns: object

darc_dok_valid_onDarc Dok Valid OnA
Read-onlyIdempotent

Whether a DOK or special DOK was valid on a date: a special DOK counts only inside the window DARC published for it. A DOK merged into another (e.g. A49, merged into A12 in 2001) shows replaced_by.

Inputs: code (required), on_date (required). Returns: object

get_version_infoGet Version InfoA
Read-onlyIdempotent

Get darc-dok-mcp's version and the edition of DARC's list it serves.

Inputs: no named parameters. Returns: object

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3.4/5.0

    Scored across 6 tools

    Disambiguation3/5

    Several pairs have unclear boundaries: get_version_info and darc_dok_source_info both report the served edition, and darc_dok_lookup overlaps with both darc_dok_valid_on (validity window) and darc_dok_codes_for, since lookup already returns validity windows for special DOKs. The descriptions are rich enough to mostly sort it out, but an agent must read carefully to choose between lookup, search, and codes_for.

    Naming Consistency4/5

    Five tools follow a clean darc_dok_<verb/preposition> snake_case pattern (lookup, search, valid_on, codes_for, source_info). get_version_info breaks the prefix convention, a minor but noticeable deviation.

    Tool Count4/5

    Six tools is well-scoped for a read-only reference lookup server. The only redundancy is the version/source-info pair, which could arguably be one tool.

    Completeness4/5

    The surface covers point lookup, free-text search, date-validity, entity-level code listing, provenance/citation, and version info, which is solid for a static reference dataset. A reverse listing of all DOKs within a district is only indirectly available via search, a minor gap.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Enables read-only access to Turbo HAMLOG amateur radio logs, allowing natural-language search and aggregation of contacts, station history, award progress, and statistics by importing logs from ADIF/CSV or HAMLOG.HDB via the DLL.
      9
      1
      MIT
    • F
      license
      Not graded
      quality
      B
      maintenance
      Provides offline, read-only access to Bohemia Interactive scripting documentation—SQF commands, functions, event handlers, and config classnames—across OFP and Arma 1/2/3, with search, comparison, and SQF validation against game/version availability.
      1
      -
    • A
      license
      A
      quality
      A
      maintenance
      Enables querying WAZ zone definitions, mapping ADIF DXCC entities and subdivisions to zone codes, searching zones by name or prefix, and checking zone validity with source citations. Runs locally without network access or authentication.
      6
      106 PyPI
      GPL 3.0
    • A
      license
      A
      quality
      A
      maintenance
      Enables querying the 90 amateur ITU zones as the IARU publishes them, with each zone's ADIF DXCC and subdivision prefixes, boundary wording, and source citation, so users can find which zones cover a DXCC entity or subdivision, search zones by prefix or text, and check validity on a given date — all offline, without credentials.
      6
      100 PyPI
      GPL 3.0