| name | browser |
| description | Drive a live browser via accessibility-tree snapshots — navigate, click, fill forms, select, press keys, screenshot. Use when a task needs interacting with a real web page (logins, JS-rendered content, multi-step flows), not a static read (that's web_fetch). |
Browser Tool Reference
Control a browser using accessibility tree snapshots and element refs.
Concept
The browser renders pages and captures an accessibility tree snapshot as YAML.
Each interactive element gets a ref like [ref=s1e5]. Use these refs to interact.
Workflow
navigate to a URL → auto-returns snapshot- Read the snapshot to find element refs
- Use
click/fill/select with the ref to interact
- Each action auto-returns a fresh snapshot
Actions
| Action | Params | Notes |
|---|
| start | incognito | Explicitly start the browser. Pass incognito=false to use persistent profile. |
| snapshot | — | Capture current page accessibility tree |
| navigate | url | Go to URL. Auto-snapshot. |
| click | ref, element | Click element. Auto-snapshot. |
| fill | ref, element, value, submit | Fill single input. Auto-snapshot. |
| fill (multi) | fields [{ref,value},...], submit | Fill multiple fields. Single snapshot scoped to form context. |
| select | ref, element, values | Select option(s). Auto-snapshot. |
| press | key | Press keyboard key (Enter, Tab, Escape, etc.) |
| go_back | — | Browser back. Auto-snapshot. |
| go_forward | — | Browser forward. Auto-snapshot. |
| reload | — | Reload page. Auto-snapshot. |
| screenshot | fullPage, returnPath | Capture screenshot |
| pdf | — | Save page as PDF |
| evaluate | script | Run JavaScript in page context |
| wait | waitType: load or idle | Wait for page state |
| close | — | Close browser |
Parameters
- ref — The
[ref=...] value from the snapshot. This is the actual element locator.
- element — A human-readable description (e.g., "Login button"). For logging only.
- value — Text to fill into an input field.
- fields — Array of
{ref, value} objects for filling multiple fields at once.
- submit — Boolean. Press Enter after filling.
- key — Key name to press (Enter, Tab, Escape, etc.).
- script — JavaScript code to evaluate in the page context.
- waitType — Either
load (page load) or idle (network idle).
- fullPage — Boolean. Capture full scrollable page instead of viewport.
- returnPath — Boolean. Return file path instead of base64-encoded image.
- incognito — Boolean. Enable (
true, default) or disable (false) incognito mode. Used with start action.
