Tool Reference

This is the complete reference for every MCP tool exposed by mcesptool. Tools are grouped by component. Each component page documents parameter signatures, return values, and usage examples.

Tool Summary

Chip Control (7 tools)

Tool	Description
`esp_detect_chip`	Detect chip type and basic information
`esp_connect_advanced`	Advanced connection with retry logic and stub loading
`esp_reset_chip`	Reset chip via hard, soft, or bootloader reset
`esp_scan_ports`	Scan all serial ports for ESP devices (includes QEMU)
`esp_load_test_firmware`	Load test firmware for chip validation
`esp_load_ram`	Load and execute binary in RAM without touching flash
`esp_serial_monitor`	Capture serial output from an ESP device

Flash Operations (7 tools)

Tool	Description
`esp_flash_firmware`	Flash a single binary to device
`esp_flash_multi`	Flash multiple binaries at different addresses in one operation
`esp_flash_read`	Read flash memory contents to a file
`esp_flash_erase`	Erase flash regions or entire flash
`esp_flash_backup`	Create a complete flash backup
`esp_verify_flash`	Verify flash contents match a file

Partition Management (3 tools)

Tool	Description
`esp_partition_create_ota`	Generate an OTA-capable partition table
`esp_partition_custom`	Create a custom partition table from configuration
`esp_partition_analyze`	Read and parse partition table from a connected device

Security (4 tools)

Tool	Description
`esp_security_audit`	Comprehensive security audit of device posture
`esp_enable_flash_encryption`	Check or enable flash encryption status
`esp_efuse_read`	Read eFuse values (individual or full summary)
`esp_efuse_burn`	Burn an eFuse value (irreversible on real hardware)

Firmware Builder (3 tools)

Tool	Description
`esp_elf_to_binary`	Convert ELF file to flashable binary
`esp_elf_to_ram_binary`	Convert ELF file to RAM-loadable binary
`esp_firmware_analyze`	Analyze firmware binary structure and segments

OTA Management (3 tools)

Tool	Description
`esp_ota_package_create`	Create OTA update package (zip with manifest)
`esp_ota_deploy`	Deploy OTA update to a device via HTTP POST
`esp_ota_rollback`	Rollback to previous firmware by erasing otadata

Production Tools (3 tools)

Tool	Description
`esp_factory_program`	Full factory programming pipeline (erase, flash, verify)
`esp_batch_program`	Program multiple devices concurrently
`esp_quality_control`	Run quality control tests (basic or extended)

Diagnostics (3 tools)

Tool	Description
`esp_memory_dump`	Hex dump of device memory via dump-mem
`esp_performance_profile`	Profile serial transport speed and latency
`esp_diagnostic_report`	Comprehensive device identification report

QEMU Manager (5 tools)

Tool	Description
`esp_qemu_start`	Start a virtual ESP device with QEMU
`esp_qemu_stop`	Stop one or all QEMU instances
`esp_qemu_list`	List all QEMU instances and their status
`esp_qemu_status`	Detailed status of a specific instance
`esp_qemu_flash`	Write firmware directly into a stopped instance’s flash image

Server Tools (3 tools)

Tool	Description
`esp_server_info`	Server name, version, uptime, and capabilities
`esp_list_tools`	List all tools by category
`esp_health_check`	Environment health check

Additional References

MCP Resources Real-time server status, configuration, and capability resources

Configuration Environment variables and server configuration options