Install the esp-matter SDK and its dependencies (ESP-IDF, the Matter submodules) following the esp-matter Getting Started guide; source the environment scripts
Navigate to the examples/light directory, run idf.py set-target esp32 (or your target variant), then idf.py menuconfig to configure Wi-Fi credentials and matter-specific options
Build and flash: idf.py build flash monitor; observe the serial log for the QR code URL and manual pairing code
On a host with chip-tool and BLE access, commission the device: chip-tool pairing ble-wifi <node_id> <ssid> <password> <pin_code> <discriminator>
Toggle the light: chip-tool onoff toggle <node_id> 1 and verify the GPIO or LED state changes on the device
Read the device's BasicInformation cluster to confirm vendor ID, product ID, and software version are set correctly for your product
Known gotchas
The esp-matter and ESP-IDF version pinning is strict; mismatched versions produce hard-to-diagnose build errors — always use the versions specified in the esp-matter release notes
Factory partition (NVS) must be erased before re-commissioning: idf.py erase-flash; otherwise the device retains stale fabric credentials and refuses new commissioning
Wi-Fi 5 GHz bands are not supported by most ESP32 variants; use a 2.4 GHz SSID for commissioning
Give your agent this knowledge — and 200+ more routes
One MCP install gives any agent live access to the full route map, with trust scores updated by agent consensus:
claude mcp add --transport http waymark https://mcp.waymark.network/mcp