Load a web page in the browser. Use this whenever you need to go to a specific website or web address. Automatically waits for page to load.

Go back to the previous page in browser history. Use this instead of navigating to the previous URL directly when possible.

Go forward to the next page in browser history. Only works if you previously navigated back.

Refresh the current page. Use this if the page seems stuck, outdated, or needs fresh data.

Get a list of ALL open browser tabs. Use this to find tab IDs, see what pages are open, or locate a specific website you need to interact with. Returns tab ID, URL, title, and active status.

Switch to a specific tab. Use this when you need to interact with a different open tab. Makes the tab active and brings its window to front.

Open a brand new browser tab. You can optionally provide a URL to navigate to immediately. Returns the new tab ID so you can interact with it.

Close a specific browser tab. Use this to clean up tabs you no longer need. Be careful - closed tabs cannot be recovered through this tool!

Capture URL, title, and a DOM hash for quick tab state comparison. Useful for verifying cross-tab state sync.

Verify two tabs have the same state (URL, title, DOM hash). Useful for cross-tab state sync testing.

Test cross-tab localStorage synchronization. Sets a value in tab A and checks if it appears in tab B.

Press a single keyboard key with optional modifiers. Use this for special keys: Enter, Tab, Escape, arrows, function keys, or keyboard shortcuts. Does NOT type text - use type_text for that.

Type regular text into the currently focused input field. Use this for typing usernames, passwords, search queries, form data, etc. Each character is typed individually like a real user.

Take a screenshot of what's currently visible in the browser window. Use this to see the current state of the page, verify UI elements, or debug layout issues. Returns an image you can view.

Take a screenshot of the ENTIRE page, including content you need to scroll down to see. Automatically scrolls and stitches images together. Use this when you need to see everything on the page.

Take a screenshot of a specific element only. Provide a CSS selector or XPath to capture just that element.

Click on any element on the page. Use this for buttons, links, checkboxes, dropdowns, or any interactive element. Simulates real human mouse behavior with Bézier curve movement, randomized delays, and natural press/release timing.

One-stop tool for filling form fields. Automatically clicks the input, clears existing text, types your text, and optionally submits with Enter. Use this for search boxes, login forms, registration fields, etc.

Drag an element from one location to another. Use this for sliders, sortable lists, file upload drop zones, or any drag-interactive elements. Simulates realistic human drag speed.

Move mouse over an element without clicking. Use this to reveal dropdown menus, tooltips, hover-only buttons, or to trigger CSS :hover states.

Read the full HTML source of the current page

Read CSS stylesheets loaded on the page. Returns all stylesheets or a specific one by URL.

Read JavaScript sources loaded on the page. Returns all scripts or a specific one by URL.

List all resources loaded on the page (images, fonts, scripts, stylesheets) with their URLs and sizes

Search for a regex pattern in page HTML and loaded scripts. Returns matches with file URL, line number, and surrounding context.

Modify DOM elements on the page (set HTML, attributes, or remove elements)

Modify CSS styles of elements on the page

Get network request/response logs collected since the debugger was attached. Optionally filter by URL pattern, method, status code, or resource type.

Get detailed information about a specific network request, including headers and optionally the response body

Clear all collected network logs for a tab

Get cookies for the current page or a specific URL

Set a cookie

Delete a specific cookie

Read localStorage entries for the current page

Set a localStorage entry on the current page

Remove a localStorage entry from the current page

Read sessionStorage entries for the current page

Set a sessionStorage entry on the current page

Remove a sessionStorage entry from the current page

Get all console messages from the page (console.log, console.error, warnings, etc.). Use this to debug JavaScript errors, see what the page is logging, or verify your code is running.

Run ANY JavaScript code directly in the page. This is your escape hatch for anything the other tools can't do: extract data, modify the page, trigger events, check values, etc. Full access to window, document, and all page APIs.

Get a text-based accessibility tree snapshot of the page. This shows the page structure with ARIA roles, names, and states — ideal for understanding page layout when you cannot see screenshots.

Get layout information for a specific element or all visible elements on the page. Returns bounding rectangles, overflow, z-index, position, display, visibility, and opacity.

Detect layout problems like overflow, element overlap, viewport clipping, and z-index stacking issues.

Compare two page state snapshots (from browser_snapshot or read_page_html) and return the differences. Use this to verify state changes after an action.

Get the raw accessibility tree as structured JSON. Companion to browser_snapshot which returns formatted text. Optionally filter to a subtree with a selector.

Compare two HTML strings structurally and return the differences (added nodes, removed nodes, attribute changes, text changes). Use this to detect DOM changes after an action.

Resize the browser viewport to specific dimensions. Use this to test responsive layouts at different screen sizes.

Emulate a specific device preset (iPhone 14, Pixel 7, iPad Pro, desktop). Automatically sets viewport, DPR, user agent, and touch emulation.

Reset viewport emulation to the browser's default size and user agent.

Check which CSS media queries are currently active and which breakpoints match the current viewport.

Get current viewport dimensions, device pixel ratio, viewport meta tag, screen info, and user agent.

Find an element by visible text, ARIA role, ARIA label, CSS selector, or XPath. Returns a unique CSS selector and element details. Use this when you need to locate an element but don't know its exact selector. Role matching supports both explicit role="..." attributes AND semantic HTML (e.g., matches role "button", matches role "link"). When multiple filters are provided (e.g., role + text), they are combined with AND logic.

Get the state of an element: exists, visible, enabled, focused, checked, selected, readOnly, required, valid, and more. Essential for verifying element conditions during testing.

Query an element inside a shadow DOM root. Provide the host element selector and the inner selector within the shadow root.

Get computed CSS styles for an element. Optionally filter to specific properties or query pseudo-elements like ::before and ::after.

Query an element inside a deep shadow DOM tree by providing a path of host selectors.

Return the full shadow DOM tree structure as JSON for a given host element.

Run an axe-core accessibility audit on the page. Returns violations, incomplete items (need manual review), and pass counts. Use this to find WCAG compliance issues.

Check color contrast ratios for text elements against WCAG AA and AAA standards. Returns contrast ratios and pass/fail status.

Get a static list of all focusable elements on the page in tab order, with unique CSS selectors and visibility flags. Use this for a one-time snapshot of the tab order. For interactive focus path recording (simulating Tab presses and tracking where focus lands), use record_focus_path instead.

Get page load performance metrics: navigation timing, paint metrics (FCP), LCP, CLS, FID, and memory usage.

Verify that all web fonts have loaded correctly. Returns font family, status, weight, and style for each font.

Find broken images, failed stylesheets, font errors, and other resource loading problems on the page.

Inspect security-related HTTP response headers for the page: CSP, HSTS, X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy, and XSS-Protection.

Detect cookie consent banners and CMP (Consent Management Platform) UI patterns on the page. Returns detected banners with text and button labels.

Start, stop, or get a performance timeline recording. Records memory, LCP, CLS at intervals during a user sequence.

Simulate Tab key presses N times and record where focus lands at each step, flagging invisible or hidden focus targets. This is an interactive alternative to get_tab_order — use record_focus_path when you want to verify the actual focus behavior during keyboard navigation, and get_tab_order when you just need a static list.

Hover over an element and capture any resulting DOM or style changes. Useful for testing dropdown menus, tooltips, and hover effects.

Force a CSS pseudo-state (hover, focus, active, visited, focus-within, focus-visible) on an element and read the resulting computed styles. Useful for testing CSS state styles without actual interaction.

Hover over an element and extract any tooltip text. Checks title attribute, aria-describedby, aria-labelledby, CSS tooltips, and custom tooltip components.

Monitor localStorage and sessionStorage changes. IMPORTANT: Due to the Web Storage API spec, storage events only fire in OTHER tabs — same-tab changes are NOT captured. Start monitoring, get recorded events (from all tabs of same origin), or stop monitoring.

Monitor cookie changes across all tabs. Start monitoring, get recorded changes, or stop. Optionally filter by domain.

Real-time console event monitoring. Start monitoring, get events since last read, or stop. Filter by log level.

Assert a condition on an element. Returns whether the assertion passed, the actual value, and a message. Essential for automated testing workflows.

Check HTML5 form validation state for a form or all form elements within a selector. Returns validity details per element including valueMissing, typeMismatch, patternMismatch, etc.

Simulate Tab key navigation and track focus movement. Returns previous and current focused element info, and whether focus wrapped around.

Set files on a file input element for testing file uploads. Uses CDP DOM.setFileInputFiles for virtual file creation.

Simulate slow or offline network conditions. Use this to test how pages behave on poor connections. Set reset=true to restore normal conditions.

Intercept and modify or block network requests. Use block to abort requests, modify to return custom responses, or clear to remove all intercepts.

Capture a complete snapshot of the page state: HTML, localStorage, sessionStorage, cookies, scroll position, and form values. Use with restore_page_state to return to this exact state.

Restore a page from a previously captured snapshot. Navigates to the URL, restores storage, cookies, HTML, and scroll position.

Wait until a JavaScript condition evaluates to true. Polls the expression at the specified interval until the timeout. Returns whether the condition was met and how long it took.

Assert that there are no console errors (or specified level entries) for the tab. Returns error count, list of errors, and pass/fail.

Assert that there are no failed network requests (4xx, 5xx, or failed) for the tab. Returns failed count, list of failed requests, and pass/fail.

Get only failed/errored network requests for the tab. Useful for debugging resource loading issues.

Refresh page N times with cache bypass, running an assertion after each refresh. Returns pass/fail per iteration. Useful for catching intermittent font bugs, race conditions, and cache-dependent issues.

Assert that a computed CSS property value matches expected for an element.

Assert that a network request matching a pattern was made. Useful for verifying analytics, API calls, or resource loading.

Assert that the page load time (navigation timing loadEventEnd) is within a threshold.

Unified diagnostic tool that returns console errors, network errors, and broken resources in a single call. Use this for a quick health check. For deeper inspection of a specific category, use get_console_logs, get_network_errors, or audit_broken_resources individually. Note: resource inspection requires the CDP debugger to be attached. If Chrome DevTools is open on the tab, resource inspection may be skipped but console/network data will still be returned.

Simulate double-tap at coordinates or on an element. Useful for testing double-tap-to-zoom, double-tap-to-edit, or other mobile interactions.

Simulate touch swipe from point A to point B with duration. Ensure viewport is set to mobile/touch enabled first via emulate_device or resize_viewport.

Simulate long-press at coordinates or on an element. Useful for context menus or selection.

Simulate pinch zoom with two touch points converging or diverging. Positive startRadius > endRadius = pinch in (zoom out). Negative = pinch out (zoom in).

Start recording user actions (clicks, typing, navigation) in a tab. Inject the macro recorder content script.

Stop recording and return the macro JSON with recorded events.

Replay a recorded macro with optional speed multiplier. Events are replayed with original timing preserved.

Compare two screenshots pixel-by-pixel using pixelmatch. Returns match percentage, mismatched pixel count, and a diff image.