Debugging

Debugging Tools

This collection of tools allows the agent to debug either by triggering the execution on its own by sending a request to a HTTP endpoint or by interacting with the user. Basic debugging actions are supported (set / remove break-points, navigate, read variables and call stack).

Available MCP Tools

Tool Name	Description
sap_debug_trace	Recommended (Track A): One-shot execution trace. Sets a breakpoint (across line, statement, exception, or message targets), fires an asynchronous HTTP/RFC trigger request, catches the session, steps forward, evaluates watched variables and SY system fields, and guarantees unconditional auto-cleanup in a single tool call.
sap_debug_breakpoint	Unified breakpoint manager: set, list, or clear external or session-scoped breakpoints across strictly typed sub-objects (line, statement, exception, or message). Fail-fast validation prevents ambiguity or conflicting parameters.
sap_debug_attach	Stage 2: Initialize background listener, optionally trigger request, and catch session.
sap_debug_context	Stage 3: Retrieves variables, auto-evaluated SY fields, and stack frame arrays from an active session.
sap_debug_step	Stage 3: Executes a debugging step action and automatically returns the updated context with SY fields when halted.
sap_debug_evaluate	Stage 3: Evaluates and drills down into a complex internal table or structure variable.
sap_debug_cleanup	Stage 4: Drops debug session and wipes external breakpoints.