<!-- AUTO GENERATED DO NOT EDIT - run 'npm run docs' to update-->
# Chrome DevTools MCP Tool Reference
- **[Navigation automation](#navigation-automation)** (4 tools)
- [`list_pages`](#list_pages)
- [`navigate_page`](#navigate_page)
- [`new_page`](#new_page)
- [`select_page`](#select_page)
- **[Network](#network)** (2 tools)
- [`get_network_request`](#get_network_request)
- [`list_network_requests`](#list_network_requests)
- **[Debugging](#debugging)** (5 tools)
- [`evaluate_script`](#evaluate_script)
- [`get_console_message`](#get_console_message)
- [`list_console_messages`](#list_console_messages)
- [`take_screenshot`](#take_screenshot)
- [`take_snapshot`](#take_snapshot)
- **[JS Reverse Engineering](#js-reverse-engineering)** (26 tools)
- [`break_on_xhr`](#break_on_xhr)
- [`evaluate_on_callframe`](#evaluate_on_callframe)
- [`find_in_script`](#find_in_script)
- [`get_paused_info`](#get_paused_info)
- [`get_request_initiator`](#get_request_initiator)
- [`get_script_source`](#get_script_source)
- [`get_storage`](#get_storage)
- [`hook_function`](#hook_function)
- [`inspect_object`](#inspect_object)
- [`list_breakpoints`](#list_breakpoints)
- [`list_hooks`](#list_hooks)
- [`list_scripts`](#list_scripts)
- [`monitor_events`](#monitor_events)
- [`pause`](#pause)
- [`remove_breakpoint`](#remove_breakpoint)
- [`remove_xhr_breakpoint`](#remove_xhr_breakpoint)
- [`resume`](#resume)
- [`search_in_sources`](#search_in_sources)
- [`set_breakpoint`](#set_breakpoint)
- [`set_breakpoint_on_text`](#set_breakpoint_on_text)
- [`step_into`](#step_into)
- [`step_out`](#step_out)
- [`step_over`](#step_over)
- [`stop_monitor`](#stop_monitor)
- [`trace_function`](#trace_function)
- [`unhook_function`](#unhook_function)
## Navigation automation
### `list_pages`
**Description:** Get a list of pages open in the browser.
**Parameters:** None
---
### `navigate_page`
**Description:** Navigates the currently selected page to a URL.
**Parameters:**
- **ignoreCache** (boolean) _(optional)_: Whether to ignore cache on reload.
- **timeout** (integer) _(optional)_: Maximum wait time in milliseconds. If set to 0, the default timeout will be used.
- **type** (enum: "url", "back", "forward", "reload") _(optional)_: Navigate the page by URL, back or forward in history, or reload.
- **url** (string) _(optional)_: Target URL (only type=url)
---
### `new_page`
**Description:** Creates a new page
**Parameters:**
- **timeout** (integer) _(optional)_: Maximum wait time in milliseconds. If set to 0, the default timeout will be used.
- **url** (string) **(required)**: URL to load in a new page.
---
### `select_page`
**Description:** Select a page as a context for future tool calls.
**Parameters:**
- **pageIdx** (number) **(required)**: The index of the page to select. Call [`list_pages`](#list_pages) to list pages.
---
## Network
### `get_network_request`
**Description:** Gets a network request by an optional reqid, if omitted returns the currently selected request in the DevTools Network panel.
**Parameters:**
- **reqid** (number) _(optional)_: The reqid of the network request. If omitted returns the currently selected request in the DevTools Network panel.
---
### `list_network_requests`
**Description:** List all requests for the currently selected page since the last navigation.
**Parameters:**
- **includePreservedRequests** (boolean) _(optional)_: Set to true to return the preserved requests over the last 3 navigations.
- **pageIdx** (integer) _(optional)_: Page number to return (0-based). When omitted, returns the first page.
- **pageSize** (integer) _(optional)_: Maximum number of requests to return. When omitted, returns all requests.
- **resourceTypes** (array) _(optional)_: Filter requests to only return requests of the specified resource types. When omitted or empty, returns all requests.
---
## Debugging
### `evaluate_script`
**Description:** Evaluate a JavaScript function inside the currently selected page. Returns the response as JSON
so returned values have to JSON-serializable.
**Parameters:**
- **args** (array) _(optional)_: An optional list of arguments to pass to the function.
- **function** (string) **(required)**: A JavaScript function declaration to be executed by the tool in the currently selected page.
Example without arguments: `() => {
return document.title
}` or `async () => {
return await fetch("example.com")
}`.
Example with arguments: `(el) => {
return el.innerText;
}`
---
### `get_console_message`
**Description:** Gets a console message by its ID. You can get all messages by calling [`list_console_messages`](#list_console_messages).
**Parameters:**
- **msgid** (number) **(required)**: The msgid of a console message on the page from the listed console messages
---
### `list_console_messages`
**Description:** List all console messages for the currently selected page since the last navigation.
**Parameters:**
- **includePreservedMessages** (boolean) _(optional)_: Set to true to return the preserved messages over the last 3 navigations.
- **pageIdx** (integer) _(optional)_: Page number to return (0-based). When omitted, returns the first page.
- **pageSize** (integer) _(optional)_: Maximum number of messages to return. When omitted, returns all requests.
- **types** (array) _(optional)_: Filter messages to only return messages of the specified resource types. When omitted or empty, returns all messages.
---
### `take_screenshot`
**Description:** Take a screenshot of the page or element.
**Parameters:**
- **filePath** (string) _(optional)_: The absolute path, or a path relative to the current working directory, to save the screenshot to instead of attaching it to the response.
- **format** (enum: "png", "jpeg", "webp") _(optional)_: Type of format to save the screenshot as. Default is "png"
- **fullPage** (boolean) _(optional)_: If set to true takes a screenshot of the full page instead of the currently visible viewport. Incompatible with uid.
- **quality** (number) _(optional)_: Compression quality for JPEG and WebP formats (0-100). Higher values mean better quality but larger file sizes. Ignored for PNG format.
- **uid** (string) _(optional)_: The uid of an element on the page from the page content snapshot. If omitted takes a pages screenshot.
---
### `take_snapshot`
**Description:** Take a text snapshot of the currently selected page based on the a11y tree. The snapshot lists page elements along with a unique
identifier (uid). Always use the latest snapshot. Prefer taking a snapshot over taking a screenshot. The snapshot indicates the element selected
in the DevTools Elements panel (if any).
**Parameters:**
- **filePath** (string) _(optional)_: The absolute path, or a path relative to the current working directory, to save the snapshot to instead of attaching it to the response.
- **verbose** (boolean) _(optional)_: Whether to include all possible information available in the full a11y tree. Default is false.
---
## JS Reverse Engineering
### `break_on_xhr`
**Description:** Sets a breakpoint that triggers when an XHR/Fetch request URL contains the specified string.
**Parameters:**
- **url** (string) **(required)**: URL pattern to break on (partial match).
---
### `evaluate_on_callframe`
**Description:** Evaluates a JavaScript expression in the context of a specific call frame while paused. This allows you to inspect variables and execute code in the paused scope.
**Parameters:**
- **expression** (string) **(required)**: The JavaScript expression to evaluate.
- **frameIndex** (integer) _(optional)_: The call frame index to evaluate in (0 = top frame, default: 0).
---
### `find_in_script`
**Description:** Finds a string in a specific script and returns its exact line/column position with surrounding context. Ideal for setting breakpoints in minified files where the entire code is on one line.
**Parameters:**
- **caseSensitive** (boolean) _(optional)_: Whether the search is case-sensitive (default: true).
- **contextChars** (integer) _(optional)_: Number of characters to show before and after the match (default: 100).
- **occurrence** (integer) _(optional)_: Which occurrence to find (1 = first, 2 = second, etc.).
- **query** (string) **(required)**: The string to find in the script.
- **scriptId** (string) **(required)**: The script ID to search in (from [`list_scripts`](#list_scripts)).
---
### `get_paused_info`
**Description:** Gets information about the current paused state including call stack, current location, and scope variables. Use this after a breakpoint is hit to understand the execution context.
**Parameters:**
- **includeScopes** (boolean) _(optional)_: Whether to include scope variables (default: true).
- **maxScopeDepth** (integer) _(optional)_: Maximum scope depth to traverse (default: 2).
---
### `get_request_initiator`
**Description:** Gets the JavaScript call stack that initiated a network request. This helps trace which code triggered an API call.
**Parameters:**
- **requestId** (integer) **(required)**: The request ID (from [`list_network_requests`](#list_network_requests)) to get the initiator for.
---
### `get_script_source`
**Description:** Gets the source code of a JavaScript script by its script ID. Supports line range (for normal files) or character offset (for minified single-line files). Use [`list_scripts`](#list_scripts) first to find the script ID.
**Parameters:**
- **endLine** (integer) _(optional)_: End line number (1-based). Use for multi-line files.
- **length** (integer) _(optional)_: Number of characters to return when using offset (default: 1000).
- **offset** (integer) _(optional)_: Character offset to start from (0-based). Use for minified single-line files.
- **scriptId** (string) **(required)**: The script ID (from [`list_scripts`](#list_scripts)) to get the source code for.
- **startLine** (integer) _(optional)_: Start line number (1-based). Use for multi-line files.
---
### `get_storage`
**Description:** Gets browser storage data including cookies, localStorage, and sessionStorage.
**Parameters:**
- **filter** (string) _(optional)_: Optional filter string to match against keys/names.
- **type** (enum: "all", "cookies", "localStorage", "sessionStorage") _(optional)_: Which storage to retrieve (default: all).
---
### `hook_function`
**Description:** Hooks a JavaScript function to log its calls, arguments, and return values. Useful for understanding how functions are used without setting breakpoints.
**Parameters:**
- **hookId** (string) _(optional)_: Custom identifier for this hook. Used to unhook later. Defaults to target name.
- **logArgs** (boolean) _(optional)_: Whether to log function arguments (default: true).
- **logResult** (boolean) _(optional)_: Whether to log return value (default: true).
- **logStack** (boolean) _(optional)_: Whether to log call stack (default: false).
- **target** (string) **(required)**: The function to hook. Can be: global function name ("fetch"), object method ("XMLHttpRequest.prototype.open"), or path ("window.app.api.request").
---
### `inspect_object`
**Description:** Deeply inspects a JavaScript object, showing its properties, prototype chain, and methods. Useful for understanding object structure.
**Parameters:**
- **depth** (integer) _(optional)_: How deep to inspect nested objects (default: 2).
- **expression** (string) **(required)**: JavaScript expression to evaluate and inspect (e.g., "window.app", "document.body", "myObject").
- **showMethods** (boolean) _(optional)_: Whether to show methods (default: true).
- **showPrototype** (boolean) _(optional)_: Whether to show prototype chain (default: true).
---
### `list_breakpoints`
**Description:** Lists all active breakpoints in the current debugging session.
**Parameters:** None
---
### `list_hooks`
**Description:** Lists all active function hooks.
**Parameters:** None
---
### `list_scripts`
**Description:** Lists all JavaScript scripts loaded in the current page. Returns script ID, URL, and source map information. Use this to find scripts before setting breakpoints or searching.
**Parameters:**
- **filter** (string) _(optional)_: Optional filter string to match against script URLs (case-insensitive partial match).
---
### `monitor_events`
**Description:** Monitors DOM events on a specified element or window. Events will be logged to console.
**Parameters:**
- **events** (array) _(optional)_: Specific events to monitor (e.g., ["click", "keydown"]). If not specified, monitors common events.
- **monitorId** (string) _(optional)_: Custom ID for this monitor. Used to stop monitoring later.
- **selector** (string) _(optional)_: CSS selector for element to monitor, or "window"/"document" (default: window).
---
### `pause`
**Description:** Pauses JavaScript execution at the current point. Use this to interrupt running code.
**Parameters:** None
---
### `remove_breakpoint`
**Description:** Removes a breakpoint by its ID. Use [`list_breakpoints`](#list_breakpoints) to see active breakpoints.
**Parameters:**
- **breakpointId** (string) **(required)**: The breakpoint ID to remove (from [`list_breakpoints`](#list_breakpoints) or [`set_breakpoint`](#set_breakpoint)).
---
### `remove_xhr_breakpoint`
**Description:** Removes an XHR/Fetch breakpoint.
**Parameters:**
- **url** (string) **(required)**: The URL pattern to remove breakpoint for.
---
### `resume`
**Description:** Resumes JavaScript execution after being paused at a breakpoint. Execution continues until the next breakpoint or completion.
**Parameters:** None
---
### `search_in_sources`
**Description:** Searches for a string or regex pattern in all loaded JavaScript sources. Returns matching lines with script ID, URL, and line number. Use [`get_script_source`](#get_script_source) with startLine/endLine to view full context around matches.
**Parameters:**
- **caseSensitive** (boolean) _(optional)_: Whether the search should be case-sensitive.
- **excludeMinified** (boolean) _(optional)_: Skip minified files (files with very long lines). Default: true.
- **isRegex** (boolean) _(optional)_: Whether to treat the query as a regular expression.
- **maxLineLength** (integer) _(optional)_: Maximum characters per line preview (default: 150). Set to 0 for full lines.
- **maxResults** (integer) _(optional)_: Maximum number of results to return (default: 30).
- **query** (string) **(required)**: The search query (string or regex pattern).
- **urlFilter** (string) _(optional)_: Only search scripts whose URL contains this string (case-insensitive).
---
### `set_breakpoint`
**Description:** Sets a breakpoint in a JavaScript file at the specified line. The breakpoint will trigger when the code executes.
**Parameters:**
- **columnNumber** (integer) _(optional)_: Optional column number (0-based).
- **condition** (string) _(optional)_: Optional condition expression. The breakpoint only triggers when this evaluates to true.
- **isRegex** (boolean) _(optional)_: Whether to treat the URL as a regex pattern.
- **lineNumber** (integer) **(required)**: The line number to set the breakpoint (1-based).
- **url** (string) **(required)**: The URL of the JavaScript file (can be a partial match or regex pattern).
---
### `set_breakpoint_on_text`
**Description:** Sets a breakpoint on specific code (function name, statement, etc.) by searching for it and automatically determining the exact position. Works with both normal and minified files.
**Parameters:**
- **condition** (string) _(optional)_: Optional condition expression. Breakpoint only triggers when this evaluates to true.
- **occurrence** (integer) _(optional)_: Which occurrence to break on (1 = first, 2 = second, etc.).
- **text** (string) **(required)**: The code text to find and set breakpoint on (e.g., "function myFunc", "fetchData(", "apiCall").
- **urlFilter** (string) _(optional)_: Only search in scripts whose URL contains this string (case-insensitive).
---
### `step_into`
**Description:** Steps into the next function call. Use this to enter and debug function bodies.
**Parameters:** None
---
### `step_out`
**Description:** Steps out of the current function, continuing until the function returns. Use this to quickly exit a function.
**Parameters:** None
---
### `step_over`
**Description:** Steps over to the next statement, treating function calls as a single step. Use this to move through code without entering function bodies.
**Parameters:** None
---
### `stop_monitor`
**Description:** Stops an event monitor.
**Parameters:**
- **monitorId** (string) **(required)**: The monitor ID to stop.
---
### `trace_function`
**Description:** Traces calls to a function by its name in the source code. Works for ANY function including module-internal functions (webpack/rollup bundled). Uses "logpoints" (conditional breakpoints) to log arguments without pausing execution.
**Parameters:**
- **functionName** (string) **(required)**: The function name to trace. Will search for "function NAME" or "NAME = function" or "NAME(" patterns.
- **logArgs** (boolean) _(optional)_: Whether to log function arguments (default: true).
- **logThis** (boolean) _(optional)_: Whether to log "this" context (default: false).
- **pause** (boolean) _(optional)_: Whether to actually [`pause`](#pause) execution (default: false, just logs).
- **traceId** (string) _(optional)_: Custom ID for this trace. Used to identify in logs.
- **urlFilter** (string) _(optional)_: Only search in scripts matching this URL pattern.
---
### `unhook_function`
**Description:** Removes a previously installed function hook.
**Parameters:**
- **hookId** (string) **(required)**: The hook ID to remove (from [`hook_function`](#hook_function)).
---
