# meshtastic-mcp

> MCP server + agent skills for AI tooling to discover, drive, observe, and test Meshtastic
> devices and the apps that talk to them. Portable core (serial/TCP device admin + recorder +
> replay/simulated-device streaming with a synthetic-mesh generator and fuzzer), with optional
> firmware (build/flash), android/apple emulator (hardware-free e2e), local-model offload, and
> RTL-SDR RF-compliance capabilities — plus FleetSuite, a local web control plane for a
> multi-board hardware bench ([web] extra, `meshtastic-mcp-web`).
> Run `meshtastic-mcp doctor` (or the `doctor` tool) to see + acquire any missing dependencies.

## Docs
- [README](README.md): install, capabilities, hardware-free e2e overview
- [AGENTS.md](AGENTS.md): architecture, capability model, rules
- [CONTRIBUTING](CONTRIBUTING.md): setup + gates
- [docs/local-models.md](docs/local-models.md): local-model offload (tools, backends, config)
- [docs/sdk-cli-bridge.md](docs/sdk-cli-bridge.md): experimental Kotlin-SDK device-IO backend
- [tests/README.md](tests/README.md): tiered hardware test suite + bench roles
- [docs/bench-setup.md](docs/bench-setup.md): set up your own hardware bench
- [web-ui/README.md](web-ui/README.md): FleetSuite SPA development

## Skills
- [meshtastic-device-ops](src/meshtastic_mcp/skills/meshtastic-device-ops/SKILL.md): discover,
  connect, configure, observe, recover, and flash devices via the MCP tool surface.
- [meshtastic-e2e](src/meshtastic_mcp/skills/meshtastic-e2e/SKILL.md): closed-loop device<->app
  testing; references/ has per-loop recipes and the emulator lab.
- [meshtastic-org-knowledge](src/meshtastic_mcp/skills/meshtastic-org-knowledge/SKILL.md):
  cross-repo questions about the Meshtastic GitHub org (status, docs, what changed).
