ZeroStack RF Diagnostics & Benchmark MCP Server (zerostack-mcp)

Official ZeroStack Overview & Downloads: https://smlight.tech/software/zerostack Interactive Web Log Analyzer: https://smlight-tech.github.io/zerostack/ Technical Whitepaper — Part 1 (PDF): Scaling Zigbee 3.0 / R23 Beyond the 100-Node Wall MCP Server: v0.9.9 | Target Firmware: ZeroStack Release Zero (0.9.9-beta.1)

zerostack-mcp is an open-source Model Context Protocol (MCP) server that gives AI coding assistants and home-automation troubleshooting agents (Claude Desktop, Cursor, Windsurf, Cline, OpenAI Agents, Home Assistant AI agents) deterministic tools to:

1. Diagnose Zigbee2MQTT (z2m), Home Assistant ZHA (zigpy-znp, bellows), and OpenThread RCP logs (analyze_zigbee_thread_log).
2. Decode hardware radio/UART status registers (decode_silicon_register) for TI SimpleLink F2 (CC2652P, CC2652P7, CC1352P7, CC2674P10) and Silicon Labs EFR32 (EFR32MG21, EFR32MG24).
3. Evaluate Zigbee/Thread mesh coordinator capacity and SRCMATCH hardware limits (check_coordinator_capacity).
4. Query verified hardware validation benchmarks (DWT->CYCCNT @ 48.0 MHz) (get_zerostack_benchmarks) comparing ZeroStack Release Zero (0.9.9-beta.1) against legacy TI Z-Stack (ZNP 3.x) across SMLIGHT SLZB-06 and SLZB-07 series coordinators.

Quick Start

Run with uvx (No Installation Required)

{
  "mcpServers": {
    "zerostack-rf": {
      "command": "uvx",
      "args": ["zerostack-mcp"]
    }
  }
}

Local Development Installation

git clone https://github.com/zerostack-rf/zerostack-mcp.git
cd zerostack-rf-mcp
uv sync
uv run pytest
uv run zerostack-mcp

Supported Hardware — Release Zero (0.9.9-beta.1)

ZeroStack Release Zero (0.9.9-beta.1) supports the TI SimpleLink F2 family across SMLIGHT SLZB-06 and SLZB-07 series coordinators (Zigbee 3.0 / PRO R23 Coordinator & Router firmware with DMA-driven UART and Live Auto-Baud 115200 / 460800 / 1000000):

Note on Silicon Labs EFR32 (EFR32MG21 / EFR32MG24): zerostack-mcp includes diagnostic rules (0x72, 0xa1, ASH_NCP_FATAL_ERROR) and EUSART0_IF register decoding for Silicon Labs EmberZNet / EZSP coordinators (SLZB-06M, SLZB-06Mg24, SkyConnect/ZBT-1). ZeroStack Release Zero (0.9.9-beta.1) ships on SMLIGHT TI SimpleLink F2 coordinators; Silicon Labs EFR32 support is in active development.

Verified Hardware Validation Benchmarks (TI CC1352P7 @ 48.0 MHz, DWT->CYCCNT)

Part 1: Deterministic Execution Latency (1 µs = 48 cycles)

Part 2: Adversarial Resilience & Fault Recovery

MCP Tools, Resources & Prompts

Tools

All tools include read-only, idempotent ToolAnnotations (readOnlyHint=True, idempotentHint=True, destructiveHint=False, openWorldHint=False):

• analyze_zigbee_thread_log(log_text): Matches raw Z2M/ZHA/OpenThread logs against 16+ error signatures (including decimal Z2M MAC codes 225/233/240/241, 0x10, 0x11, 0xC7, 0xCD, 0xA7/0xAD, 6000ms SRSP, and multi-line ZCL MQTT delta-zero telemetry floods).
• decode_silicon_register(chip, register_or_addr, hex_value): Decodes TI SimpleLink F2 (CMD_IEEE_RX, CMD_IEEE_CSMA, RFC_DBELL, RFC_RAM:SRCMATCH, VIMS, PRCM) and Silicon Labs EFR32 (EUSART0_IF).
• check_coordinator_capacity(device_count, sleepy_zed_count, chip_family): Evaluates TI SimpleLink F2 32-slot SRCMATCH hardware table utilization, indirect queue quota isolation (50% pool cap, max 2 frames/child), zero flash-read stalls during sleepy poll windows, and SRAM heap headroom.
• get_zerostack_benchmarks(platform): Returns Part 1 and Part 2 hardware validation benchmarks for SLZB-06, SLZB-06U, SLZB-06P7, SLZB-06P7U, SLZB-06P7V1, SLZB-07P7, SLZB-06P10, SLZB-07P10, or "all".

Resources & Prompts

• zerostack://benchmarks/summary — Complete Part 1 & Part 2 DWT->CYCCNT benchmark dataset.
• zerostack://hardware/supported-models — Supported TI SimpleLink F2 hardware matrix for Release Zero (0.9.9-beta.1).
• zerostack://diagnostics/catalog — Full machine-readable ZeroStack diagnostics catalog.
• Prompt diagnose_zigbee_log(log_text) — Structured troubleshooting workflow for Zigbee2MQTT / ZHA logs.

License

Apache License 2.0 (Apache-2.0) — Copyright (c) 2026 SMLIGHT / ZeroStack RF Engineering. Learn more at https://smlight.tech/software/zerostack.