MCP perfetto_start

Description

Start a Perfetto trace session on the target device.

Optional parameters:

  • device (string): Device id, name, or IP (defaults to active device)
  • host (string): Direct target host/IP (bypasses device store selection)
  • password (string): Device password override (can override stored password)
  • output (string): Output trace file path. If omitted, auto-generated under project root.

Response:

  • sessionId (string): Active session identifier used by perfetto_stop.
  • filePath (string): Absolute path to the trace file being written.

Notes:

  • Only one active session per device is allowed.
  • Duplicate start on same device returns 409 SESSION_ALREADY_ACTIVE.

See also

Parameters

additionalProperties: false

NameTypeRequiredValues
devicestringNo
hoststringNo
passwordstringNo
outputstringNo

device

Target device id, name, or IP. Uses active device when omitted.

host

Direct target host/IP (bypasses device store selection)

password

Device password override (can override stored password)

output

Output trace file path (must stay within project root when provided)


Did this page help you?