Skip to content

MCP Resources

mcesptool exposes 3 MCP resources that provide real-time server state without requiring tool invocations. Resources are read-only and can be accessed by any MCP client using the read_resource protocol method.

esp://server/status

Real-time server status including uptime, component count, and operating mode.

URI

esp://server/status

Example

result = await client.read_resource("esp://server/status")

Response

{
  "status": "running",
  "uptime_seconds": 1234.56,
  "components_loaded": 9,
  "production_mode": false,
  "last_updated": 1708732800.0
}

Fields

Field	Type	Description
`status`	`str`	Always `"running"` while the server is operational.
`uptime_seconds`	`float`	Seconds since server startup.
`components_loaded`	`int`	Number of components successfully initialized.
`production_mode`	`bool`	Whether the server is running in production mode.
`last_updated`	`float`	Unix timestamp of the response.

esp://config

Current server configuration as a serialized dictionary. Reflects the active runtime configuration including any environment variable overrides.

URI

esp://config

Example

result = await client.read_resource("esp://config")

Response

{
  "esptool_path": "esptool",
  "esp_idf_path": "/home/user/esp/esp-idf",
  "project_roots": ["/home/user/esp_projects"],
  "default_baud_rate": 460800,
  "connection_timeout": 30,
  "enable_stub_flasher": true,
  "max_concurrent_operations": 5,
  "production_mode": false,
  "idf_available": true,
  "qemu_available": true,
  "qemu_xtensa_path": "/home/user/.espressif/tools/qemu-xtensa/.../qemu-system-xtensa",
  "qemu_riscv_path": "/home/user/.espressif/tools/qemu-riscv32/.../qemu-system-riscv32"
}

Fields

Field	Type	Description
`esptool_path`	`str`	Path or command name for esptool.
`esp_idf_path`	`str \| null`	ESP-IDF installation path, or null if not detected.
`project_roots`	`list[str]`	Directories scanned for ESP projects.
`default_baud_rate`	`int`	Default serial baud rate for connections.
`connection_timeout`	`int`	Default connection timeout in seconds.
`enable_stub_flasher`	`bool`	Whether the ROM stub loader is enabled.
`max_concurrent_operations`	`int`	Maximum parallel esptool operations.
`production_mode`	`bool`	Production mode flag.
`idf_available`	`bool`	Whether ESP-IDF was detected and is usable.
`qemu_available`	`bool`	Whether at least one QEMU binary is available.
`qemu_xtensa_path`	`str \| null`	Path to qemu-system-xtensa binary.
`qemu_riscv_path`	`str \| null`	Path to qemu-system-riscv32 binary.

esp://capabilities

Server capabilities listing supported chips, available feature categories, and integration availability. Useful for clients that need to adapt their UI based on what the server can do.

URI

esp://capabilities

Example

result = await client.read_resource("esp://capabilities")

Response

{
  "esp_chip_support": [
    "ESP32", "ESP32-S2", "ESP32-S3", "ESP32-C3", "ESP32-C6", "ESP8266"
  ],
  "flash_operations": ["read", "write", "erase", "verify", "encrypt"],
  "partition_features": ["custom_tables", "ota_support", "nvs_management"],
  "security_features": ["efuse_management", "secure_boot", "flash_encryption"],
  "production_features": ["factory_programming", "batch_operations", "quality_control"],
  "debugging_features": ["memory_dump", "performance_profiling", "diagnostic_reports"],
  "esp_idf_integration": true,
  "host_applications": true,
  "qemu_emulation": true
}

Fields

Field	Type	Description
`esp_chip_support`	`list[str]`	Chip families supported by esptool operations.
`flash_operations`	`list[str]`	Available flash operation types.
`partition_features`	`list[str]`	Partition management capabilities.
`security_features`	`list[str]`	Security-related capabilities.
`production_features`	`list[str]`	Production line capabilities.
`debugging_features`	`list[str]`	Diagnostic and debugging capabilities.
`esp_idf_integration`	`bool`	Whether ESP-IDF tools are available.
`host_applications`	`bool`	Whether host application building is available (requires ESP-IDF).
`qemu_emulation`	`bool`	Whether QEMU virtual device support is available.