Navigate the active browser page to a URL. Returns the HTTP status code, final URL and page title. Resets the console and network logs.

Return the page's accessibility tree as YAML: roles, accessible names, values and states, including iframe contents. Every element has a [ref=eN] handle; pass it to other tools as selector "aria-ref=eN". Use this before interacting with a page instead of guessing selectors. Refs from older snapshots may go stale.

Click the first element matching a selector. Waits for any navigation the click triggers. Note "text=" is a case-insensitive substring match against any element (headings included); prefer aria-ref from get_page_snapshot or scoped selectors like button:has-text("Login").

Clear an input, textarea or contenteditable element and fill it with text. Values typed into password and payment-card fields are masked in recordings. Card fields are refused if the page uses a LIVE payment environment; use the provider's test mode and test cards (e.g. Stripe 4242 4242 4242 4242).

Choose option(s) in a element, matching each by its value or its visible label.

Press a key or chord, e.g. "Enter", "Tab", "Escape", "ArrowDown", "Control+A". Focuses the element first when a selector is given, otherwise sends it to whatever has focus. Waits for any navigation it triggers.

Move the mouse over an element, e.g. to open a dropdown menu or reveal a tooltip.

Wait until an element (by selector) or a piece of visible text reaches a state: visible (default), hidden, attached or detached. Useful after actions that load content asynchronously.

Capture a PNG of the current page (full scrollable page or just the viewport) and save it to the screenshot directory. Returns the file path and, unless returnImage is false or the image is very large, the image itself.

Test assertion: PASS if the text is visible on the page (or inside the element matched by selector) within the timeout, otherwise FAIL (isError) with the text that was actually there.

Test assertion: PASS if the element is visible (or, with visible=false, hidden/absent) within the timeout, otherwise FAIL (isError).

Return JavaScript console errors, uncaught exceptions, failed network requests, HTTP >= 400 responses and guard blocks recorded since the last navigate_url. Chrome's duplicate "Failed to load resource" messages are merged into the matching network entry.

List HTTP requests made by the page since the last navigate_url: method, URL, resource type, status, duration, failure reason and whether a mock answered it. Static assets are hidden by default.

Intercept browser requests matching a URL glob and answer them with a canned response, an error, or a delay, without contacting the real server. Tests UI behavior for API errors, payment declines, timeouts and outages. Only the browser sees the mock; no backend is contacted. Mocks persist until clear_mocks.

Remove one mock by id, or all mocks when no id is given. Returns the mocks still active and their hit counts.

Start recording the browser session for later review by a developer: a Playwright trace (DOM snapshots, network, console for every step), an optional video, and a log of every tool call. With video on, the page is reloaded into a fresh recording context (cookies and localStorage are kept). Call stop_recording when done to save everything.

Stop the active recording and save its trace.zip, video, screenshots, actions.json and an HTML report. Returns the overall verdict, the failed checks and errored steps with explanations, the number of website errors, the file paths and the command to open the trace viewer. If anything failed, follow up with suggest_fix for each failed step. When email delivery is configured, the report is emailed to the configured recipients once every failure has a suggested fix (see delivery in the result).

Add your suggested fix for a failed step to the recording's report, shown in the "AI agent's suggested fix" column. Use the step numbers from stop_recording (failedChecks / toolErrors) or from failed tool calls during the recording. Diagnose the actual cause from the evidence (error explanation, actual page text, screenshot, console and network errors) and give a concrete fix: name the selector, file, endpoint or setting to change. Say whether the fix belongs in the app (a real bug), the test (wrong selector or expectation) or the environment (server down, missing data). Works during a recording or after stop_recording; calling it again for a step replaces the earlier suggestion.