Start a browser session. Defaults to patchright chromium headed Chrome with a persistent profile.

Return current browser status.

Navigate the active page to a URL.

Open a new page/tab and make it active. Optionally navigate to a URL.

List open pages/tabs with ids, active state, URL, and title.

Switch the active page/tab by pageId from browser_pages.

Close a page/tab by pageId, or the active page if omitted.

Return a distilled AI-oriented aria snapshot (verbose /url lines dropped and data: URLs collapsed to save tokens). Use [ref=eN] values with browser_click/fill/type/hover/press/wait_for.

Search the current page's aria snapshot for text or a regex. Returns matching nodes with their [ref] and a few lines of surrounding context — cheaper than a full browser_snapshot when you only need to locate an element.

Take a screenshot. Returns base64 if path is omitted.

Click an element by CSS selector or aria ref from browser_snapshot.

Fill an input by CSS selector or aria ref from browser_snapshot.

Type text into an element (CSS selector or aria ref) with human-like input: real per-key events, real Shift keyDown/up for capitals & symbols, variable dwell and inter-key gaps. Verifies the result against the request for input/textarea and errors on mismatch.

Hover an element by CSS selector or aria ref from browser_snapshot.

Press a keyboard key, optionally focused on a selector or aria ref first.

Wait for time or for selector/ref state. If no selector/ref, waits timeout milliseconds.

Evaluate JavaScript in the active page. Pass 'function' for a function body, 'expression' for a plain expression, or 'script' (deprecated). By default JS runs in an isolated stealth world (DOM is shared, but the page's own window globals are NOT visible). Set world:'main' to run in the page's real world — required to read or call globals the page defined (e.g. a page-registered callback). Pass frameSelector to run inside a specific iframe (including cross-origin ones, e.g. a captcha widget hosted on a different domain) instead of the top-level page — same CSS selector browser_click/browser_fill/browser_type already accept.

Collect browser fingerprint diagnostics from the active page.

Navigate back in browser history.

Select options from a element by CSS selector or aria ref.

Accept or dismiss a JavaScript dialog (alert / confirm / prompt).

Upload files to a by CSS selector or aria ref.

List captured network requests. Set activeOnly=true for in-flight only.

Get details for a single network request by stable id from browser_network_requests. Legacy zero-based index is also accepted.

List captured console messages (log / warn / error etc.).

Resize the active page viewport.

Drag an element from source to target by CSS selector or aria ref.

Fill multiple form fields at once. Each field needs selector or ref, and value.

Execute arbitrary JavaScript in page context. Prefer browser_evaluate when possible. Runs in the isolated stealth world by default; set world:'main' to run in the page's real world (page-defined window globals visible/callable).

Register JavaScript that runs before any page script, on every navigation (Playwright's page.addInitScript — always in the page's main world). Unlike browser_evaluate, this is proactive: it wins the race against a site's own inline (e.g. Cloudflare/Turnstile checks that run synchronously on document parse), which a reactive evaluate call issued over the MCP connection cannot. Call this BEFORE browser_navigate to the target URL — it has no effect on a page already loaded, only on the page it's called on and future navigations of that same page. Scoped to the current page only.

Set network state: pass offline=true to simulate offline, offline=false to restore connectivity.

Make an HTTP request reusing the browser session's cookies/storage (authenticated API calls without re-login). Returns status, headers, and body.

Get the visible text (document.body.innerText) of the active page. Lighter than a full aria snapshot.

Get page HTML, optionally scoped to a selector. Strips script/style/svg by default for token efficiency.

Shorthand for clicking inside an iframe. (Most tools now accept a frameSelector directly — prefer browser_click with frameSelector.)

Shorthand for filling inside an iframe. (Most tools now accept a frameSelector directly — prefer browser_fill with frameSelector.)

Block requests by resource type and/or URL pattern (e.g. block images/fonts/media to speed up loads and shrink fingerprint surface). Applies to all pages in the context.

Mock matching requests with a canned response (fulfill). Useful for stubbing APIs or bypassing endpoints.

Remove all active block/mock routes.

Export current session (cookies + localStorage) as a Playwright storageState. Saves to path, or returns the state JSON if path omitted.

Restore a session from a storageState (cookies + localStorage). Provide a file path or an inline state object. Note: localStorage restore navigates to each origin.

List cookies in the current session, optionally filtered by domain and/or path.

Get a single cookie by name. Returns null if not present.

Set a cookie with optional flags. Provide url, or domain (path defaults to /). If neither given, the active page's origin is used.

Delete cookies by name, optionally narrowed by domain/path.

Clear all cookies in the current session.

List all localStorage key-value pairs for the active page's origin.

Get a localStorage item by key. Returns null if absent.

Set a localStorage item on the active page's origin.

Delete a localStorage item by key.

Clear all localStorage for the active page's origin.

List all sessionStorage key-value pairs for the active page's origin.

Get a sessionStorage item by key. Returns null if absent.

Set a sessionStorage item on the active page's origin.

Delete a sessionStorage item by key.

Clear all sessionStorage for the active page's origin.

Install Patchright's virtual WebAuthn authenticator in the current browser context. Call before a page first uses navigator.credentials.

Generate or import a virtual passkey. To import, provide all four key-material fields. Private keys are omitted unless includePrivateKey=true.

List virtual passkeys, optionally filtered by rpId or credential id. Private keys are omitted unless includePrivateKey=true.

Delete one virtual passkey by its base64url credential id.

Direct the active page's session recording to a specific output path (requires the session to have been started with recordVideo). The .webm finalizes when the page or browser closes. Without a path, returns the pending video location.

Draw a persistent highlight overlay around an element (by CSS selector or aria ref). Useful for screenshots and video recording to show what the agent is focusing on. Does not affect page behavior.

Remove highlight overlays. Pass label/selector/ref to remove a specific one, or omit all to clear every highlight.

Evaluate JavaScript in the page and write the result straight to a file on disk — the value itself never passes through this tool's response. Use this instead of browser_evaluate whenever you need to get a large/opaque blob (base64 image(s), a full page's HTML, a big JSON dump) out of the live page and into a request body: reading it via browser_evaluate and then re-typing/pasting it into another tool call's arguments (e.g. create_task's imagesBase64/htmlPageBase64) risks silently corrupting it — a dropped character or an unclosed quote partway through a multi-KB string merges what should be several array elements into one, with no clear error. Pass 'function' or 'expression' (same as browser_evaluate); pass encoding:'base64' when the value is a base64 string (a data:...;base64, prefix is stripped automatically) to write raw decoded bytes, or omit it to write the value as UTF-8 text (non-strings are JSON-stringified).

Render the active page to PDF via CDP (works in headed/stealth mode). Saves to path, or returns base64 if path omitted.

Close the browser session.