Set Breakpoints
Place breakpoints at any file and line. Add conditions or log messages. Remove them just as easily.
debug_set_breakpointMCP · VS Code Extension · Free
AI debugging,
without the config.
Blackbox connects your AI agent to VS Code's debugger via MCP tools. Set breakpoints, inspect variables, evaluate expressions — all from a single prompt.
› blackbox debug_start
[INIT] Session active · node · src/server.ts
› debug_set_breakpoint
[SET] src/auth.ts:42 — condition: "user.role === 'admin'"
[HIT] Paused at src/auth.ts:42
› debug_get_variables()
[VAR] user → { id: 1, role: "admin" }
[VAR] token → "eyJhbGc..."
› debug_evaluate("user.id * 2")
[EVAL] 2 · number
›
Features
Everything your AI needs
to debug your code.
12 MCP tools that wire your AI agent directly into VS Code's Debug Adapter Protocol. Works with every language VS Code can debug.
Inspect Variables
Get every in-scope variable when paused. Filter by name. Expand nested objects and arrays.
debug_get_variablesEvaluate Expressions
Run any expression in the current debug context. Call functions, check values, test logic mid-session.
debug_evaluateStack Traces
Get the full call stack when paused — file, line, and function name for each frame.
debug_get_stack_traceDiagnostics
Pull errors and warnings from every language server — TypeScript, ESLint, PHP, and more.
workspace_get_diagnosticsFile Navigation
Open files, jump to lines, list open tabs, find files by glob — your AI sees what you see.
editor_open_fileHow it works
Ask. Debug. Understand.
01
You ask your AI
Tell your AI agent (Copilot, Claude, Cursor) to debug a function, inspect a value, or trace a crash.
02
Blackbox calls MCP tools
The extension handles the DAP protocol. It sets breakpoints, starts sessions, and retrieves variables on demand.
03
Your AI gets the answer
Live variable values, stack frames, and expression results flow back to the AI — no manual inspection needed.
MCP Tools
12 tools. Every debug operation.
| Tool | Description | Category |
|---|---|---|
| debug_set_breakpoint | Set a breakpoint with optional condition or log message | debug |
| debug_remove_breakpoint | Remove a breakpoint by file and line number | debug |
| debug_list_breakpoints | List all active breakpoints with file, line, and condition | debug |
| debug_start | Start a debug session — PHP, Node, Python, Go, C++, any adapter | debug |
| debug_stop | Stop the currently active debug session | debug |
| debug_evaluate | Evaluate any expression at a breakpoint — call functions, check values | debug |
| debug_get_variables | Get all in-scope variables; expand nested objects and arrays | debug |
| debug_get_stack_trace | Inspect the full call stack — file, line, function per frame | debug |
| editor_open_file | Open a file in the editor, optionally scrolling to a line | editor |
| editor_get_open_files | List all open editor tabs with their active and dirty status | editor |
| workspace_find_file | Find files in the workspace by glob pattern | workspace |
| workspace_get_diagnostics | Get errors and warnings from all language servers; filter by severity | workspace |
Debug smarter, not harder.
Free. Open source. Works with every VS Code debug adapter.