Chrome Debugger MCP Server

Chrome breakpoint debugging MCP server for inspecting runtime values and stepping through code

Local serverstdio

What is the Chrome Debugger MCP Server?

Chrome breakpoint debugging MCP server for inspecting runtime values and stepping through code

The short version

chrome-debugger-mcp exposes Chrome DevTools Protocol primitives as MCP tools so an AI agent can attach to a real Chrome tab, pause execution, inspect scope values, evaluate expressions inside the current call frame, and step through code with runtime facts instead of guessing from static source.

  • guessing which tab to attach to
  • concluding behavior without inspecting runtime values
  • ending the turn between reloadPage() and waitForSpecificPause()

The tools it exposes

The server publishes 14 tools. What each one is for:

  • startDebuggingSession — returns the recommended debugging workflow and critical rules for agent behavior
  • launchChrome — launches a dedicated Chrome instance with remote debugging enabled
  • listTargets — lists available Chrome tabs and requires the user to pick one
  • connect — attaches to the confirmed tab
  • setBreakpoint — creates a CDP breakpoint without modifying source files
  • removeBreakpoint — removes a breakpoint created by setBreakpoint
  • reloadPage — reloads the current page through CDP
  • waitForSpecificPause — waits for the next pause and checks whether it matches a target file and line
  • waitForPause — waits for any pause without location matching
  • getScopeVariables — reads local, closure, and module scope values from the paused frame
  • evaluate — executes JavaScript in the paused call frame
  • resume — resumes execution after inspection

What it needs from you

  • Google Chrome installed locally - An MCP client that supports stdio servers and tool calling - Access to the application you want to debug - Local source access if you plan to insert temporary debugger; statements

Recorded tools

  • startDebuggingSession — returns the recommended debugging workflow and critical rules for agent behavior
  • launchChrome — launches a dedicated Chrome instance with remote debugging enabled
  • listTargets — lists available Chrome tabs and requires the user to pick one
  • connect — attaches to the confirmed tab
  • setBreakpoint — creates a CDP breakpoint without modifying source files
  • removeBreakpoint — removes a breakpoint created by setBreakpoint
  • reloadPage — reloads the current page through CDP
  • waitForSpecificPause — waits for the next pause and checks whether it matches a target file and line
  • waitForPause — waits for any pause without location matching
  • getScopeVariables — reads local, closure, and module scope values from the paused frame
  • evaluate — executes JavaScript in the paused call frame
  • resume — resumes execution after inspection
  • getStatus — non-blocking polling for connected or paused state
  • forcePause — requests a pause at the next JavaScript statement

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
startDebuggingSessionreturns the recommended debugging workflow and critical rules for agent behavior
launchChromelaunches a dedicated Chrome instance with remote debugging enabled
listTargetslists available Chrome tabs and requires the user to pick one
connectattaches to the confirmed tab
setBreakpointcreates a CDP breakpoint without modifying source files
removeBreakpointremoves a breakpoint created by setBreakpoint
reloadPagereloads the current page through CDP
waitForSpecificPausewaits for the next pause and checks whether it matches a target file and line
waitForPausewaits for any pause without location matching
getScopeVariablesreads local, closure, and module scope values from the paused frame
evaluateexecutes JavaScript in the paused call frame
resumeresumes execution after inspection
getStatusnon-blocking polling for connected or paused state
forcePauserequests a pause at the next JavaScript statement

How to install the Chrome Debugger MCP Server

{
  "mcpServers": {
    "chrome-debugger": {
      "command": "npx",
      "args": ["-y", "chrome-debugger-mcp"]
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

  • Google Chrome installed locally - An MCP client that supports stdio servers and tool calling - Access to the application you want to debug - Local source access if you plan to insert temporary debugger; statements

Example prompts to try

  • “Use Chrome Debugger MCP to startDebuggingSession.”
  • “Use Chrome Debugger MCP to launchChrome.”
  • “Use Chrome Debugger MCP to listTargets.”

Frequently asked questions

Chrome breakpoint debugging MCP server for inspecting runtime values and stepping through code Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.