darc-dok-mcp
This server serves offline, cited DARC DOK and special-DOK reference data.
Look up a DOK or special DOK by code, including district/club or purpose, callsign, validity window, and sponsoring club.
Check whether a DOK or special DOK was valid on a given QSO date, including merged-DOK replacement info.
Search DOKs by club, town, district, prefix, area wording, or purpose with a configurable result limit.
Get source/ownership details, served edition, terms, source-file URLs, and SHA-256 hashes.
Get service version and the DARC edition served.
Query the ADIF subdivision compatibility tool, which reports no DOK-to-subdivision mapping.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@darc-dok-mcp Which club is DOK A01?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
darc-dok-mcp
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 installRelated MCP server: arma-mcp
Tools
Tool | Description | Key Parameters |
| One DOK or special DOK: district and club, or purpose, callsign, window and sponsoring club | code |
| Whether a DOK or special DOK was valid on a QSO's date | code, on_date |
| Find DOKs by club, town, district or purpose | text, limit |
| Kept for the shared tool set; DOKs map to no ADIF subdivision | dxcc, subdivision |
| Owner, editions, terms, and the owner's files' URLs and SHA-256 hashes | — |
| 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 8018Then 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 pytestscripts/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 toolsdarc_dok_codes_forDarc Dok Codes ForBRead-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 LookupBRead-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_searchDarc Dok SearchBRead-onlyIdempotent
Find codes whose name, prefixes, area wording or attributes contain every word of text.
Inputs: text (required), limit. Returns: object
darc_dok_source_infoDarc Dok Source InfoBRead-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 OnARead-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 InfoARead-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
Scored across 6 tools
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.
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.
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.
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
Related MCP Connectors
Offline, keyless lookup of the US civil aircraft registry — decode N-numbers, search records.
Offline US medical code lookup and crosswalk — ICD-10-CM/PCS, HCPCS Level II, RxNorm. Keyless.
Offline IBAN/BIC/EU VAT/card/ISBN/GTIN validators + live USD stablecoin peg-health verdict.
WHO ICD-10/ICD-11 diagnosis codes. Lookup, search, chapters via official WHO API.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables 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.91MIT
- FlicenseNot gradedqualityBmaintenanceProvides 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-
- AlicenseAqualityAmaintenanceEnables 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.6106 PyPIGPL 3.0
- AlicenseAqualityAmaintenanceEnables 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.6100 PyPIGPL 3.0