@labwired/mcp

Model Context Protocol server for the LabWired deterministic firmware twin.
Your agent proposes; the oracle disposes — do not claim success without labwired_verify.

Install

Stdio (this package)

Claude Code

claude mcp add labwired -- npx -y @labwired/mcp

Cursor — ~/.cursor/mcp.json:

{
  "mcpServers": {
    "labwired": {
      "command": "npx",
      "args": ["-y", "@labwired/mcp"]
    }
  }
}

Global

npm install -g @labwired/mcp
labwired-mcp

Requires Node ≥ 20 and the labwired CLI on PATH:

curl -fsSL https://labwired.com/install.sh | sh
labwired --help

Hosted (compile + cloud agent)

claude mcp add labwired --transport http https://api.labwired.com/mcp
codex mcp add labwired --url https://api.labwired.com/mcp

Full product docs: docs.labwired.com/agent/mcp

Tools (labwired_<verb>)

Registry SoT: monorepo packages/board-config/src/mcp-tools.ts.
Stdio does not advertise labwired_compile (artifact-only run/verify).

| Tool | Stdio | Role | |------|:-----:|------| | labwired_search | ✅ | Search tool catalog | | labwired_list | ✅ | List boards / MCUs / components | | labwired_describe | ✅ | Pins, buses, attrs for any catalog id | | labwired_validate | ✅ | Diagram / ERC checks | | labwired_export | ✅ | Export diagram (KiCad / BOM / …) | | labwired_run | ✅ | Run firmware on the twin (firmware_ref + target) | | labwired_inspect | ✅ | Deep state from snapshot_id | | labwired_verify | ✅ | Oracle pass/fail | | labwired_debug | ✅* | Scripted breakpoints / probe | | labwired_fuzz | ✅ | Coverage-guided fuzz | | labwired_ingest_svd | ✅ | SVD → peripheral YAML | | labwired_validate_device | ✅ | Validate declarative device YAML | | labwired_part / datasheet tools | ✅* | Part knowledge when enabled |

*As advertised by toolsForSurface("stdio") for this release.

Hosted-only (not in this stdio server): labwired_compile, labwired_lab, labwired_project, labwired_catalog, labwired_put_source, …

Removed (hard rename — no aliases):
labwired_list_boards, labwired_run_lab, labwired_inspect_run, labwired_simulate, labwired_validate_system, labwired_validate_diagram, labwired_compile_diagram, labwired_search_tools, …

Example prompts

List boards with labwired_list, describe esp32-c3-supermini, then verify my flash image with labwired_verify.

Validate this diagram, run the ELF on the twin, and only report success if the oracle is green.

Environment

| Variable | Meaning | |----------|---------| | LABWIRED_CLI | Path to labwired binary (default: labwired on PATH) | | LABWIRED_REPO_ROOT | LabWired checkout root when resolving local configs |

Why determinism matters

Same firmware + same system + same seed → same result. Agents can iterate without trusting self-report. Details: docs.labwired.com/fidelity.

License

MIT. Issues: https://github.com/w1ne/labwired/issues.