Launch the agent browser. Default engine is patchright (stealth Chromium). Use engine=chromium for full-fidelity devtools/perf/local testing, or engine=obscura for a lightweight Rust engine (lower memory, strongest tracker blocking). Reusing an open browser keeps cookies and tabs; pass restart=true to relaunch with new options.

Close the browser, all tabs, and any Obscura child process.

Navigate the active tab to a URL. Opens the browser automatically if needed. Private-network URLs are blocked unless allow_private is enabled.

Go back in history.

Go forward in history.

Reload the active tab.

Report the active engine, URL, tabs, capture buffers, resolved config, and which engines are available on this machine.

List, create, switch, or close tabs. Switching preserves page state and JS globals.

Compact view of the current page: URL, title, actionable elements with refs (e1, e2…), control states, and visible text. Refs stay stable while the element remains in the DOM; a new snapshot does not renumber them. Use diff=true (or since=sN) to see only changes since the last observation. Prefer refs over CSS selectors.

Extract the main readable content of the current page as Markdown (article/main detection, boilerplate removal, absolute links). Best for articles, docs, and research. Use snapshot instead when you need to interact.

Deterministic extraction from the current page. Modes: links, tables, jsonld, meta, selector (CSS map), text. No LLM involved; pair with snapshot/markdown when you need to locate a selector first.

Evaluate a JavaScript expression in the page and return its value as JSON. Promises are awaited. Use for data extraction or page state, not for navigation (prefer navigate).

Capture the viewport, full page, or a single element as PNG. The image is returned inline; an optional path saves a copy under the artifact directory.

Render the current page to PDF and save it under the artifact directory.

Click an element. Target one of: ref (preferred), selector, text, or role+name. Humanized mouse movement is used by default. Returns a compact change observation so you rarely need a second snapshot.

Set an input/textarea/contenteditable value in one call (fires input + change). Target one of: ref (preferred), selector, text, or role+name.

Type into a field with humanized per-character delays. Target one of: ref (preferred), selector, text, or role+name. Use fill for long values or speed; use type for keystroke-driven UIs.

Press a keyboard key (Enter, Escape, Tab, ArrowDown, Control+A…). Optionally focus a target first.

Choose one or more values in a select element. Target one of: ref (preferred), selector, text, or role+name.

Move the mouse over an element (menus, tooltips). Target one of: ref (preferred), selector, text, or role+name.

Scroll the page by direction/amount, to the top/bottom, or bring an element into view. Humanized wheel events by default.

Attach local files to a file input. Paths are resolved from the current directory; ~ is expanded.

Wait for a selector or text to become visible, or wait a fixed number of milliseconds. Prefer this over sleep loops after triggering async UI.

Get, set, or clear cookies for the current browser context. get can be limited to URLs.

Export or import cookies + localStorage as a Playwright storage-state file. Use this to persist logins across browser restarts. Import applies cookies immediately and writes localStorage through CDP.

Fingerprint self-check on the current page: navigator.webdriver, UA-CH, plugins, chrome runtime, native function masking, canvas/WebGL, timezone/locale, screen, and permissions. Returns a verdict plus concrete warnings. Run after opening a protected site.

Per-origin memory for selector hints, notes, and reusable workflows. Entries are agent-authored only (never page text). navigate injects the top hints automatically. Use learn after a successful run to save the recent action sequence as a workflow; verify selectors before replaying them.

Inspect requests made by pages in this browser session: status, type, size, duration, and failures. URLs are redacted according to BROWSER_MCP_REDACT_PARAMS.

Read console messages and page errors captured since launch. Note: Patchright stealth mode disables the console API by design; use engine=chromium when console output matters.

Performance tools: web vitals (LCP/CLS/FCP/TTFB/long tasks), CDP runtime metrics, slowest resources, a combined overview, or a Chrome trace. trace_start → do work → trace_stop returns a summary and writes the full trace JSON to the artifact directory. Use engine=chromium for full devtools fidelity.