clickClicks on the provided elementInput schema{
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "The uid of an element on the page from the page content snapshot"
},
"dblClick": {
"type": "boolean",
"description": "Set to true for double clicks. Default is false."
},
"includeSnapshot": {
"type": "boolean",
"description": "Whether to include a snapshot in the response. Default is false."
}
},
"required": [
"uid"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "input",
"readOnlyHint": false
} | — | Writes | — |
close_pageCloses the page by its index. The last open page cannot be closed.Input schema{
"type": "object",
"properties": {
"pageId": {
"type": "number",
"description": "The ID of the page to close. Call list_pages to list pages."
}
},
"required": [
"pageId"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "navigation",
"readOnlyHint": false
} | — | Writes | — |
dragDrag an element onto another elementInput schema{
"type": "object",
"properties": {
"from_uid": {
"type": "string",
"description": "The uid of the element to drag"
},
"to_uid": {
"type": "string",
"description": "The uid of the element to drop into"
},
"includeSnapshot": {
"type": "boolean",
"description": "Whether to include a snapshot in the response. Default is false."
}
},
"required": [
"from_uid",
"to_uid"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "input",
"readOnlyHint": false
} | — | Writes | — |
emulateEmulates various features on the selected page.Input schema{
"type": "object",
"properties": {
"networkConditions": {
"type": "string",
"enum": [
"Offline",
"Slow 3G",
"Fast 3G",
"Slow 4G",
"Fast 4G"
],
"description": "Throttle network. Omit to disable throttling."
},
"cpuThrottlingRate": {
"type": "number",
"minimum": 1,
"maximum": 20,
"description": "Represents the CPU slowdown factor. Omit or set the rate to 1 to disable throttling"
},
"geolocation": {
"type": "string",
"description": "Geolocation (`<latitude>,<longitude>`) to emulate. Latitude between -90 and 90. Longitude between -180 and 180. Omit to clear the geolocation override."
},
"userAgent": {
"type": "string",
"description": "User agent to emulate. Set to empty string to clear the user agent override."
},
"colorScheme": {
"type": "string",
"enum": [
"dark",
"light",
"auto"
],
"description": "Emulate the dark or the light mode. Set to \"auto\" to reset to the default."
},
"viewport": {
"type": "string",
"description": "Emulate device viewports '<width>x<height>x<devicePixelRatio>[,mobile][,touch][,landscape]'. 'touch' and 'mobile' to emulate mobile devices. 'landscape' to emulate landscape mode."
},
"extraHttpHeaders": {
"type": "string",
"description": "Extra HTTP headers as a JSON string object, e.g. {\"X-Custom\": \"value\", \"Authorization\": \"Bearer token\"}. Headers are included into every HTTP request originating from the page and persist across navigations until cleared. Pass an empty string to clear all extra headers."
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "emulation",
"readOnlyHint": false
} | — | Writes | — |
evaluate_scriptEvaluate a JavaScript function inside the currently selected page. Returns the response as JSON, so returned values have to be JSON-serializable.Input schema{
"type": "object",
"properties": {
"function": {
"type": "string",
"description": "A JavaScript function declaration to be executed by the tool in the currently selected page.\nExample without arguments: `() => document.title` or `async () => await fetch(\"example.com\")`.\nExample with arguments: `(el) => el.innerText`\n"
},
"args": {
"type": "array",
"items": {
"type": "string",
"description": "The uid of an element on the page from the page content snapshot"
},
"description": "An optional list of arguments to pass to the function."
},
"filePath": {
"type": "string",
"description": "The absolute or relative path to a file to save the script output to. If omitted, the output is returned inline."
},
"dialogAction": {
"type": "string",
"description": "Handle dialogs while execution. \"accept\", \"dismiss\", or string for response of window.prompt. Defaults to accept."
}
},
"required": [
"function"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "debugging",
"readOnlyHint": false
} | — | Writes | — |
fillType text into an input, text area or select an option from a <select> element.Input schema{
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "The uid of an element on the page from the page content snapshot"
},
"value": {
"type": "string",
"description": "The value to fill in. \"true\" or \"false\" for checkboxes and toggles, \"true\" for radio buttons."
},
"includeSnapshot": {
"type": "boolean",
"description": "Whether to include a snapshot in the response. Default is false."
}
},
"required": [
"uid",
"value"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "input",
"readOnlyHint": false
} | — | Writes | — |
fill_formFill out multiple form elements (inputs, selects, checkboxes, radios) at once. ALWAYS prefer this tool over multiple individual 'fill' or 'click' calls when interacting with forms. It is significantly faster, more reliable, and reduces turn count. Example: Fill username, password, and check "Remember Me" in one call.Input schema{
"type": "object",
"properties": {
"elements": {
"type": "array",
"items": {
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "The uid of the element to fill out"
},
"value": {
"type": "string",
"description": "Value for the element. \"true\" or \"false\" for checkboxes and toggles, \"true\" for radio buttons."
}
},
"required": [
"uid",
"value"
],
"additionalProperties": false
},
"description": "Elements from snapshot to fill out."
},
"includeSnapshot": {
"type": "boolean",
"description": "Whether to include a snapshot in the response. Default is false."
}
},
"required": [
"elements"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "input",
"readOnlyHint": false
} | — | Writes | — |
get_console_messageGets a console message by its ID. You can get all messages by calling list_console_messages.Input schema{
"type": "object",
"properties": {
"msgid": {
"type": "number",
"description": "The msgid of a console message on the page from the listed console messages"
}
},
"required": [
"msgid"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "debugging",
"readOnlyHint": true
} | — | Read only | — |
get_network_requestGets a network request by an optional reqid, if omitted returns the currently selected request in the DevTools Network panel.Input schema{
"type": "object",
"properties": {
"reqid": {
"type": "number",
"description": "The reqid of the network request. If omitted returns the currently selected request in the DevTools Network panel."
},
"requestFilePath": {
"type": "string",
"description": "The absolute or relative path to a .network-request file to save the request body to. If omitted, the body is returned inline."
},
"responseFilePath": {
"type": "string",
"description": "The absolute or relative path to a .network-response file to save the response body to. If omitted, the body is returned inline."
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "network",
"readOnlyHint": false
} | — | Writes | — |
handle_dialogIf a browser dialog was opened, use this command to handle itInput schema{
"type": "object",
"properties": {
"action": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"description": "Whether to dismiss or accept the dialog"
},
"promptText": {
"type": "string",
"description": "Optional prompt text to enter into the dialog."
}
},
"required": [
"action"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "input",
"readOnlyHint": false
} | — | Writes | — |
hoverHover over the provided elementInput schema{
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "The uid of an element on the page from the page content snapshot"
},
"includeSnapshot": {
"type": "boolean",
"description": "Whether to include a snapshot in the response. Default is false."
}
},
"required": [
"uid"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "input",
"readOnlyHint": false
} | — | Writes | — |
lighthouse_auditGet Lighthouse score and reports for accessibility, SEO, best practices, and agentic browsing. This excludes performance. For performance audits, run performance_start_traceInput schema{
"type": "object",
"properties": {
"mode": {
"type": "string",
"enum": [
"navigation",
"snapshot"
],
"default": "navigation",
"description": "\"navigation\" reloads & audits. \"snapshot\" analyzes current state."
},
"device": {
"type": "string",
"enum": [
"desktop",
"mobile"
],
"default": "desktop",
"description": "Device to emulate."
},
"outputDirPath": {
"type": "string",
"description": "Directory for reports. If omitted, uses temporary files."
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "debugging",
"readOnlyHint": false
} | — | Writes | — |
list_console_messagesList all console messages for the currently selected page since the last navigation.Input schema{
"type": "object",
"properties": {
"pageSize": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "Maximum number of messages to return. When omitted, returns all messages."
},
"pageIdx": {
"type": "integer",
"minimum": 0,
"description": "Page number to return (0-based). When omitted, returns the first page."
},
"types": {
"type": "array",
"items": {
"type": "string",
"enum": [
"log",
"debug",
"info",
"error",
"warn",
"dir",
"dirxml",
"table",
"trace",
"clear",
"startGroup",
"startGroupCollapsed",
"endGroup",
"assert",
"profile",
"profileEnd",
"count",
"timeEnd",
"verbose",
"issue"
]
},
"description": "Filter messages to only return messages of the specified resource types. When omitted or empty, returns all messages."
},
"includePreservedMessages": {
"type": "boolean",
"default": false,
"description": "Set to true to return the preserved messages over the last 3 navigations."
},
"serviceWorkerId": {
"type": "string",
"description": "Filter messages to only return messages of the specified service worker."
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "debugging",
"readOnlyHint": true
} | — | Read only | — |
list_network_requestsLists the most recent requests for the currently selected page since the last navigation.Input schema{
"type": "object",
"properties": {
"pageSize": {
"type": "integer",
"exclusiveMinimum": 0,
"description": "Maximum number of requests to return. When omitted, returns all requests."
},
"pageIdx": {
"type": "integer",
"minimum": 0,
"description": "Page number to return (0-based). When omitted, returns the first page."
},
"resourceTypes": {
"type": "array",
"items": {
"type": "string",
"enum": [
"document",
"stylesheet",
"image",
"media",
"font",
"script",
"texttrack",
"xhr",
"fetch",
"prefetch",
"eventsource",
"websocket",
"manifest",
"signedexchange",
"ping",
"cspviolationreport",
"preflight",
"fedcm",
"other"
]
},
"description": "Filter requests to only return requests of the specified resource types. When omitted or empty, returns all requests."
},
"includePreservedRequests": {
"type": "boolean",
"default": false,
"description": "Set to true to return the preserved requests over the last 3 navigations."
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "network",
"readOnlyHint": true
} | — | Read only | — |
list_pagesGet a list of pages open in the browser.Input schema{
"type": "object",
"properties": {},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "navigation",
"readOnlyHint": true
} | — | Read only | — |
navigate_pageGo to a URL, or back, forward, or reload. Use project URL if not specified otherwise.Input schema{
"type": "object",
"properties": {
"type": {
"type": "string",
"enum": [
"url",
"back",
"forward",
"reload"
],
"description": "Navigate the page by URL, back or forward in history, or reload."
},
"url": {
"type": "string",
"description": "Target URL (only type=url)"
},
"ignoreCache": {
"type": "boolean",
"description": "Whether to ignore cache on reload."
},
"handleBeforeUnload": {
"type": "string",
"enum": [
"accept",
"dismiss"
],
"description": "Whether to auto accept or beforeunload dialogs triggered by this navigation. Default is accept."
},
"initScript": {
"type": "string",
"description": "A JavaScript script to be executed on each new document before any other scripts for the next navigation."
},
"timeout": {
"type": "integer",
"description": "Maximum wait time in milliseconds. If set to 0, the default timeout will be used."
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "navigation",
"readOnlyHint": false
} | — | Writes | — |
new_pageOpen a new tab and load a URL. Use project URL if not specified otherwise.Input schema{
"type": "object",
"properties": {
"url": {
"type": "string",
"description": "URL to load in a new page."
},
"background": {
"type": "boolean",
"description": "Whether to open the page in the background without bringing it to the front. Default is false (foreground)."
},
"isolatedContext": {
"type": "string",
"description": "If specified, the page is created in an isolated browser context with the given name. Pages in the same browser context share cookies and storage. Pages in different browser contexts are fully isolated."
},
"timeout": {
"type": "integer",
"description": "Maximum wait time in milliseconds. If set to 0, the default timeout will be used."
}
},
"required": [
"url"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "navigation",
"readOnlyHint": false
} | — | Writes | — |
performance_analyze_insightProvides more detailed information on a specific Performance Insight of an insight set that was highlighted in the results of a trace recording.Input schema{
"type": "object",
"properties": {
"insightSetId": {
"type": "string",
"description": "The id for the specific insight set. Only use the ids given in the \"Available insight sets\" list."
},
"insightName": {
"type": "string",
"description": "The name of the Insight you want more information on. For example: \"DocumentLatency\" or \"LCPBreakdown\""
}
},
"required": [
"insightSetId",
"insightName"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "performance",
"readOnlyHint": true
} | — | Read only | — |
performance_start_traceStart a performance trace on the selected webpage. Use to find frontend performance issues, Core Web Vitals (LCP, INP, CLS), and improve page load speed.Input schema{
"type": "object",
"properties": {
"reload": {
"type": "boolean",
"default": true,
"description": "Determines if, once tracing has started, the current selected page should be automatically reloaded. Navigate the page to the right URL using the navigate_page tool BEFORE starting the trace if reload or autoStop is set to true."
},
"autoStop": {
"type": "boolean",
"default": true,
"description": "Determines if the trace recording should be automatically stopped."
},
"filePath": {
"type": "string",
"description": "The absolute file path, or a file path relative to the current working directory, to save the raw trace data. For example, trace.json.gz (compressed) or trace.json (uncompressed)."
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "performance",
"readOnlyHint": false
} | — | Writes | — |
performance_stop_traceStop the active performance trace recording on the selected webpage.Input schema{
"type": "object",
"properties": {
"filePath": {
"type": "string",
"description": "The absolute file path, or a file path relative to the current working directory, to save the raw trace data. For example, trace.json.gz (compressed) or trace.json (uncompressed)."
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "performance",
"readOnlyHint": false
} | — | Writes | — |
press_keyPress a key or key combination. Use this when other input methods like fill() cannot be used (e.g., keyboard shortcuts, navigation keys, or special key combinations).Input schema{
"type": "object",
"properties": {
"key": {
"type": "string",
"description": "A key or a combination (e.g., \"Enter\", \"Control+A\", \"Control++\", \"Control+Shift+R\"). Modifiers: Control, Shift, Alt, Meta"
},
"includeSnapshot": {
"type": "boolean",
"description": "Whether to include a snapshot in the response. Default is false."
}
},
"required": [
"key"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "input",
"readOnlyHint": false
} | — | Writes | — |
resize_pageResizes the selected page's window so that the page has specified dimensionInput schema{
"type": "object",
"properties": {
"width": {
"type": "number",
"description": "Page width"
},
"height": {
"type": "number",
"description": "Page height"
}
},
"required": [
"width",
"height"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "emulation",
"readOnlyHint": false
} | — | Writes | — |
select_pageSelect a page as a context for future tool calls.Input schema{
"type": "object",
"properties": {
"pageId": {
"type": "number",
"description": "The ID of the page to select. Call list_pages to get available pages."
},
"bringToFront": {
"type": "boolean",
"description": "Whether to focus the page and bring it to the top."
}
},
"required": [
"pageId"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "navigation",
"readOnlyHint": true
} | — | Read only | — |
take_heapsnapshotCapture a heap snapshot of the currently selected page. Use to analyze the memory distribution of JavaScript objects and debug memory leaks.Input schema{
"type": "object",
"properties": {
"filePath": {
"type": "string",
"description": "A path to a .heapsnapshot file to save the heapsnapshot to."
}
},
"required": [
"filePath"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "memory",
"readOnlyHint": false
} | — | Writes | — |
take_screenshotTake a screenshot of the page or element.Input schema{
"type": "object",
"properties": {
"format": {
"type": "string",
"enum": [
"png",
"jpeg",
"webp"
],
"default": "png",
"description": "Type of format to save the screenshot as. Default is \"png\""
},
"quality": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "Compression quality for JPEG and WebP formats (0-100). Higher values mean better quality but larger file sizes. Ignored for PNG format."
},
"uid": {
"type": "string",
"description": "The uid of an element on the page from the page content snapshot. If omitted, takes a page screenshot."
},
"fullPage": {
"type": "boolean",
"description": "If set to true takes a screenshot of the full page instead of the currently visible viewport. Incompatible with uid."
},
"filePath": {
"type": "string",
"description": "The absolute path, or a path relative to the current working directory, to save the screenshot to instead of attaching it to the response."
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "debugging",
"readOnlyHint": false
} | — | Writes | — |
take_snapshotTake 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).Input schema{
"type": "object",
"properties": {
"verbose": {
"type": "boolean",
"description": "Whether to include all possible information available in the full a11y tree. Default is false."
},
"filePath": {
"type": "string",
"description": "The absolute path, or a path relative to the current working directory, to save the snapshot to instead of attaching it to the response."
}
},
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "debugging",
"readOnlyHint": false
} | — | Writes | — |
type_textType text using keyboard into a previously focused inputInput schema{
"type": "object",
"properties": {
"text": {
"type": "string",
"description": "The text to type"
},
"submitKey": {
"type": "string",
"description": "Optional key to press after typing. E.g., \"Enter\", \"Tab\", \"Escape\""
}
},
"required": [
"text"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "input",
"readOnlyHint": false
} | — | Writes | — |
upload_fileUpload a file through a provided element.Input schema{
"type": "object",
"properties": {
"uid": {
"type": "string",
"description": "The uid of the file input element or an element that will open file chooser on the page from the page content snapshot"
},
"filePath": {
"type": "string",
"description": "The local path of the file to upload"
},
"includeSnapshot": {
"type": "boolean",
"description": "Whether to include a snapshot in the response. Default is false."
}
},
"required": [
"uid",
"filePath"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "input",
"readOnlyHint": false
} | — | Writes | — |
wait_forWait for the specified text to appear on the selected page.Input schema{
"type": "object",
"properties": {
"text": {
"type": "array",
"items": {
"type": "string"
},
"minItems": 1,
"description": "Non-empty list of texts. Resolves when any value appears on the page."
},
"timeout": {
"type": "integer",
"description": "Maximum wait time in milliseconds. If set to 0, the default timeout will be used."
}
},
"required": [
"text"
],
"additionalProperties": true,
"$schema": "http://json-schema.org/draft-07/schema#"
}Annotations{
"category": "navigation",
"readOnlyHint": true
} | — | Read only | — |