MCP debug_errors_read
Description
Reads captured errors across BOTH runtimes in a debug session, merged into one chronologically-ordered stream and tagged by source. A "brs" entry from a BrightScript RUNTIME_ERROR/CAUGHT_RUNTIME_ERROR stop carries the stopped thread id, stop reason, top-of-stack frame, and code snippet when available.
A BrightScript COMPILE error (the app failed to build/launch at all, e.g. debug_session_create itself failed) is NEVER reported here -- it is raw device-console text, not a structured error, and never gets invented structure. If a session failed to launch, use debug_console_read({runtime: "device"}) instead and look for "*** ERROR compiling"/"Syntax Error"/"Compilation Failed" in the text.
Optional parameters:
- runtime (string): Filter to one source: "ts" or "brs".
- since (integer): Only return entries with timestamp >= this value (epoch ms).
- limit (integer): Maximum number of entries to return, keeping the most recent. 0 returns none. Defaults to 50.
- sessionId (string): Session id returned by debug_session_create. Uses the active session when omitted.
Aliases
Aliases: cdp_errors_read.
See also
- HTTP debugReadErrors (
GET /api/debug/errors) - rk debug errors
Parameters
additionalProperties: false
| Name | Type | Required | Values |
|---|---|---|---|
| runtime | "ts" | "brs" | No | enum: "ts", "brs" |
| since | integer | No | |
| limit | integer | No | default: 50; minimum: 0 |
| sessionId | string | No |
runtime
Filter to one runtime
since
Only return entries with timestamp >= this value (epoch ms)
limit
Maximum number of entries to return, keeping the most recent. 0 returns none.
sessionId
Session id returned by debug_session_create. Uses the active session when omitted.
Updated about 4 hours ago