RadioChron MCP server

radiochron-mcp

radiochron.com · the chronicle of your radio.

A local-first Model Context Protocol server and command line for Wi-Fi incident diagnosis and Bluetooth Low Energy observation. It combines native radio collection with the radiochron Rust core, then returns typed conclusions instead of forcing an assistant to interpret raw operating-system output.

The two front ends are not two implementations. radiochron analyze and the wifi_analyze tool run the same handler with the same bounds and the same error text, so a conclusion never depends on how you asked for it.

The preferred MCP revision is 2025-11-25; clients that request 2025-06-18 receive the compatible legacy tool shape. Every tool has input and output schemas, structured content, safety annotations, explicit execution semantics, cancellation where work is long-running, and actionable separation between JSON-RPC protocol errors and tool execution errors.

RadioChron repositories remain independent:

• radiochron is the Rust/IoT core.
• radiochron-js is the Node/npm library; it does not ship MCP.
• radiochron-mcp is this pure-Rust MCP server and command line.
• radiochron-agent is the unattended durable collector/exporter and does not depend on MCP.
• radiochron-electron is the standalone desktop app and does not depend on MCP.

Install

The npm package carries verified native binaries for Windows x64, Linux x64/ARM64, Intel Mac, and Apple Silicon:

claude mcp add radiochron -- npx -y radiochron-mcp

Or install the Rust binary from source:

cargo install --git https://github.com/sergii-ziborov/radiochron-mcp

Building on Debian/Ubuntu requires libdbus-1-dev and pkg-config for the BlueZ adapter. Prebuilt npm users do not need a Rust toolchain.

Register an installed binary with any stdio MCP client:

{
  "mcpServers": {
    "radiochron": {
      "command": "radiochron"
    }
  }
}

RADIOCHRONCHRONICLEPATH optionally overrides the local chronicle path: %LOCALAPPDATA%\RadioChron on Windows, ~/Library/Application Support/RadioChron on macOS, or the XDG state directory on Linux.

Command line

The same binary is a CLI. Nothing extra to install — npx radiochron status works from the npm package, and cargo install puts radiochron on PATH.

radiochron status                  # association state of every adapter
radiochron scan                    # look again, then list what is there
radiochron analyze                 # findings about the environment
radiochron report                  # the full Markdown diagnostic report
radiochron incident --ble          # one composite answer for "the Wi-Fi is broken"
radiochron connectivity --dns example.com --tcp example.com:443
radiochron ble scan --duration 4000
radiochron chronicle recent --max 20
radiochron --help                  # every command and flag

Add --json to any command for the raw tool result, which is what a script wants:

radiochron networks --json | jq '.networks[] | select(.rssi_dbm > -60) | .ssid'

radiochron tool [--args ''] reaches any tool the catalogue publishes, including ones with no friendly spelling:

radiochron tool ble_evaluate --args '{"now_ms":1717000000000}'

Unknown flags are refused rather than ignored, so a mistyped --durations fails loudly instead of silently running with a default.

Shortened. The full README is on GitHub.