9.5 KiB
Chrome DevTools MCP Tool Reference
- Input automation (7 tools)
- Navigation automation (7 tools)
- Emulation (3 tools)
- Performance (3 tools)
- Network (2 tools)
- Debugging (4 tools)
Input automation
click
Description: Clicks on the provided element
Parameters:
- dblClick (boolean) (optional): Set to true for double clicks. Default is false.
- uid (string) (required): The uid of an element on the page from the page content snapshot
drag
Description: Drag an element onto another element
Parameters:
- from_uid (string) (required): The uid of the element to
drag - to_uid (string) (required): The uid of the element to drop into
fill
Description: Type text into a input, text area or select an option from a <select> element.
Parameters:
- uid (string) (required): The uid of an element on the page from the page content snapshot
- value (string) (required): The value to
fillin
fill_form
Description: Fill out multiple form elements at once
Parameters:
- elements (array) (required): Elements from snapshot to
fillout.
handle_dialog
Description: If a browser dialog was opened, use this command to handle it
Parameters:
- action (enum: "accept", "dismiss") (required): Whether to dismiss or accept the dialog
- promptText (string) (optional): Optional prompt text to enter into the dialog.
hover
Description: Hover over the provided element
Parameters:
- uid (string) (required): The uid of an element on the page from the page content snapshot
upload_file
Description: Upload a file through a provided element.
Parameters:
- filePath (string) (required): The local path of the file to upload
- uid (string) (required): The uid of the file input element or an element that will open file chooser on the page from the page content snapshot
Navigation automation
close_page
Description: Closes the page by its index. The last open page cannot be closed.
Parameters:
- pageIdx (number) (required): The index of the page to close. Call
list_pagesto list pages.
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:
- timeout (integer) (optional): Maximum wait time in milliseconds. If set to 0, the default timeout will be used.
- url (string) (required): URL to navigate the page to
navigate_page_history
Description: Navigates the currently selected page.
Parameters:
- navigate (enum: "back", "forward") (required): Whether to navigate back or navigate forward in the selected pages history
- timeout (integer) (optional): Maximum wait time in milliseconds. If set to 0, the default timeout will be used.
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_pagesto list pages.
wait_for
Description: Wait for the specified text to appear on the selected page.
Parameters:
- text (string) (required): Text to appear on the page
- timeout (integer) (optional): Maximum wait time in milliseconds. If set to 0, the default timeout will be used.
Emulation
emulate_cpu
Description: Emulates CPU throttling by slowing down the selected page's execution.
Parameters:
- throttlingRate (number) (required): The CPU throttling rate representing the slowdown factor 1-20x. Set the rate to 1 to disable throttling
emulate_network
Description: Emulates network conditions such as throttling on the selected page.
Parameters:
- throttlingOption (enum: "No emulation", "Slow 3G", "Fast 3G", "Slow 4G", "Fast 4G") (required): The network throttling option to emulate. Available throttling options are: No emulation, Slow 3G, Fast 3G, Slow 4G, Fast 4G. Set to "No emulation" to disable.
resize_page
Description: Resizes the selected page's window so that the page has specified dimension
Parameters:
- height (number) (required): Page height
- width (number) (required): Page width
Performance
performance_analyze_insight
Description: Provides more detailed information on a specific Performance Insight that was highlighted in the results of a trace recording.
Parameters:
- insightName (string) (required): The name of the Insight you want more information on. For example: "DocumentLatency" or "LCPBreakdown"
performance_start_trace
Description: Starts a performance trace recording on the selected page. This can be used to look for performance problems and insights to improve the performance of the page. It will also report Core Web Vital (CWV) scores for the page.
Parameters:
- autoStop (boolean) (required): Determines if the trace recording should be automatically stopped.
- reload (boolean) (required): Determines if, once tracing has started, the page should be automatically reloaded.
performance_stop_trace
Description: Stops the active performance trace recording on the selected page.
Parameters: None
Network
get_network_request
Description: Gets a network request by URL. You can get all requests by calling list_network_requests.
Parameters:
- url (string) (required): The URL of the request.
list_network_requests
Description: List all requests for the currently selected page
Parameters:
- 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 to run in the currently selected page.
Example without arguments:
() => { return document.title }orasync () => { return await fetch("example.com") }. Example with arguments:(el) => { return el.innerText; }
list_console_messages
Description: List all console messages for the currently selected page
Parameters: None
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. The snapshot lists page elements along with a unique identifier (uid). Always use the latest snapshot. Prefer taking a snapshot over taking a screenshot.
Parameters: None