fastdefault
A quick, confident user
- Pointer move
- 45 to 250 ms
- Typing
- keystrokes; text over 40 characters in word chunks
- Per site, per minute
- up to 400 actions and 60 navigations
Tools
Nineteen tools.
One cursor.
Everything Claude needs to read a page and act on it, over MCP. Reads are instant and send no input. Input tools move a real cursor and return only what changed.
- MCP over stdio
- 10 loaded up front
- Text snapshots, not screenshots
Showing all 19 tools.
-
Open a URL in Browzie's window (or back/forward/reload, or in a new tab) and return a compact snapshot. Interactive elements carry refs like [e12].
Parameter Type What it does urlstring The address to open actionback | forward | reload A history step instead of a URL newTabboolean Open the URL in a new tab snapshotfull | none Return the full snapshot (default) or nothing maxCharsinteger Snapshot size budget { "name": "navigate", "arguments": { "url": "news.ycombinator.com" } } -
Compact text snapshot of the current page (instant, no input). Scope with ref/selector, viewportOnly or interactiveOnly.
Parameter Type What it does refstring Element ref from a snapshot, e.g. "e12" or "f1e3" (best) selectorstring CSS selector (must match one element unless nth is given) viewportOnlyboolean Only what is on screen interactiveOnlyboolean Only elements you can act on maxCharsinteger Size budget { "name": "snapshot", "arguments": { "interactiveOnly": true } } -
Search the whole page (all frames) by text, name, role or CSS selector and get refs.
Parameter Type What it does querystring Text or accessible name to look for selectorstring CSS selector rolestring Only this role limitinteger Most results to return { "name": "find", "arguments": { "query": "Add to cart", "role": "button" } } -
Readable text of the page (or of ref/selector), with paging.
Parameter Type What it does refstring Element ref from a snapshot, e.g. "e12" or "f1e3" (best) selectorstring CSS selector (must match one element unless nth is given) offsetinteger Where to start, for paging maxinteger Most characters to return { "name": "read", "arguments": { "ref": "e9" } } -
Screenshot of the viewport in CSS pixels (x,y can be clicked directly). labels:true draws refs on the image. The virtual cursor is not in the image.
Parameter Type What it does labelsboolean Draw ref labels onto the image qualityinteger JPEG quality { "name": "screenshot", "arguments": { "labels": true } } -
Move the visible cursor to an element and click it with real mouse input (fast). Scrolls with the wheel if needed; waits up to 3 s for a text/selector target to appear. Returns what changed on the page.
Parameter Type What it does refstring Element ref from a snapshot, e.g. "e12" or "f1e3" (best) textstring Visible text or accessible name of the element selectorstring CSS selector (must match one element unless nth is given) rolestring With text: only this role (button, link, textbox...) nthinteger 1-based pick when several elements match snapshotdiff | none diff (default): what changed on the page; none: one line only (cheapest; dialogs, bot checks and navigation are still reported) waitinteger With text/selector: ms to wait for the element to appear (default 3000) xnumber X in the latest screenshot (CSS px) ynumber Y in the latest screenshot (CSS px) buttonleft | right | middle Mouse button doubleClickboolean Double-click modifiersarray Control, Shift, Alt, Meta held during the click forceboolean Click even if something covers it { "name": "click", "arguments": { "ref": "e12" } } -
Move the cursor onto an element and rest there (opens hover menus and tooltips).
Parameter Type What it does refstring Element ref from a snapshot, e.g. "e12" or "f1e3" (best) textstring Visible text or accessible name of the element selectorstring CSS selector (must match one element unless nth is given) rolestring With text: only this role (button, link, textbox...) nthinteger 1-based pick when several elements match snapshotdiff | none diff (default): what changed on the page; none: one line only (cheapest; dialogs, bot checks and navigation are still reported) waitinteger With text/selector: ms to wait for the element to appear (default 3000) xnumber X in the latest screenshot (CSS px) ynumber Y in the latest screenshot (CSS px) { "name": "hover", "arguments": { "text": "Account" } } -
Scroll with the mouse wheel: the page or the container holding ref, by direction/amount, to an edge, or bring ref into view.
Parameter Type What it does directionup | down | left | right Which way to turn the wheel amountnumber CSS px (default: most of a screen) totop | bottom | left | right Scroll to an edge refstring The container to scroll, or the element to bring into view snapshotdiff | none diff (default): what changed on the page; none: one line only (cheapest; dialogs, bot checks and navigation are still reported) { "name": "scroll", "arguments": { "direction": "down" } } -
Fill several form fields: click each field, select existing text, type it (fast). value: text; true/false for checkboxes and radios; option label for selects; YYYY-MM-DD for dates; a file path (or array) for file inputs or for a button that opens the file chooser.
Parameter Type What it does fieldsarray Each field: a target (ref, text, selector, role, nth) and its value submitboolean Press Enter after the last field snapshotdiff | none diff (default): what changed on the page; none: one line only (cheapest; dialogs, bot checks and navigation are still reported) { "name": "fill", "arguments": { "fields": [ { "text": "Email", "value": "ada@example.com" }, { "text": "Weekly summary", "value": true } ], "submit": true } } -
Upload files: clicks a file input, or a button / drop area that opens the file chooser, and answers the chooser with these files (the Windows dialog never opens).
Parameter Type What it does filesarray Full paths of the files refstring Element ref from a snapshot, e.g. "e12" or "f1e3" (best) textstring Visible text or accessible name of the element selectorstring CSS selector (must match one element unless nth is given) rolestring With text: only this role (button, link, textbox...) nthinteger 1-based pick when several elements match snapshotdiff | none diff (default): what changed on the page; none: one line only (cheapest; dialogs, bot checks and navigation are still reported) waitinteger With text/selector: ms to wait for the element to appear (default 3000) { "name": "upload", "arguments": { "text": "Choose file", "files": [ "C:\\Users\\ada\\cv.pdf" ] } } -
Type text into the focused element or into ref/selector (clicked first). Short text goes in as real keystrokes, long text (over 40 characters) a few words at a time, so a caption takes about a second. If typing stops part way, call type with resume: true.
Parameter Type What it does textstring Text to type refstring Element ref from a snapshot, e.g. "e12" or "f1e3" (best) selectorstring CSS selector (must match one element unless nth is given) clearboolean Select existing text first so it is replaced submitboolean Press Enter afterwards typosboolean Now and then hit a neighbouring key and fix it with Backspace, as people do (free text only, never codes, URLs or exact values) resumeboolean Finish a type call that stopped part way: checks the field, then types the rest snapshotdiff | none diff (default): what changed on the page; none: one line only (cheapest; dialogs, bot checks and navigation are still reported) { "name": "type", "arguments": { "text": "quiet café with good Wi-Fi", "submit": true } } -
Press keys or shortcuts, e.g. "Enter", "Escape", "Tab", "Control+A", "Shift+Tab". Space-separated combos run in order.
Parameter Type What it does keysstring One key or combo, or several separated by spaces repeatinteger Press each combo this many times snapshotdiff | none diff (default): what changed on the page; none: one line only (cheapest; dialogs, bot checks and navigation are still reported) { "name": "press", "arguments": { "keys": "Control+A Backspace" } } -
Wait for text, a selector, a URL (substring or /regex/), their disappearance, or a fixed time. enabled: true waits until the element named by text/selector (and role) is there and not disabled (a Next button after an upload). Returns a viewport snapshot unless snapshot: "none".
Parameter Type What it does textstring Text to appear textGonestring Text to disappear selectorstring Selector to appear selectorGonestring Selector to disappear rolestring With text: only this role (button, link, textbox...) nthinteger 1-based pick when several elements match enabledboolean Wait until the element is there and not disabled urlstring URL substring or /regex/ timenumber A fixed wait timeoutnumber ms, at most 110000 snapshotviewport | none What to return { "name": "wait_for", "arguments": { "text": "Next", "role": "button", "enabled": true } } -
List, open, switch to or close Browzie's tabs (its window, and popup windows the page opened, such as a sign-in window). select/close take the tab number from the list (1, 2, ...); without one they act on the current tab.
Parameter Type What it does actionlist | new | select | close What to do idinteger Tab number as listed (1-based) urlstring For new: the address to open { "name": "tabs", "arguments": { "action": "list" } } -
Accept or dismiss an open alert/confirm/prompt dialog.
Parameter Type What it does acceptboolean Accept (true) or dismiss (false) textstring Answer for a prompt { "name": "dialog", "arguments": { "accept": true } } -
Hand control to the human and wait: for CAPTCHAs and other bot checks (Browzie never solves them), logins with 2FA, payments, anything needing a person. Returns when the check is gone or the user clicks Done.
Parameter Type What it does reasonstring What you need the user to do timeoutnumber ms, default 300000 { "name": "handoff", "arguments": { "reason": "Please complete the check on the sign-in page." } } -
Sign in with a login saved in Chrome's password manager. Browzie never types, reads or sees the password: it clicks into the sign-in form so Chrome lists the saved logins, the user picks one in Chrome's own list (one click), and Browzie then presses the form's button. One step per call (a username-first page, then the password page). Returns when the step is gone.
Parameter Type What it does timeoutnumber ms, default 300000 { "name": "signin", "arguments": {} } -
Run JavaScript in the page and return JSON. The code goes in "script" (an expression, statements, or a function body with return). Runs in an isolated world by default (sees the DOM, not page globals, leaves no trace); world:"main" sees page globals.
Parameter Type What it does scriptstring An expression, statements, or a function body with return worldisolated | main isolated (default) leaves no trace; main sees page globals maxCharsinteger Result size limit (default 20000) { "name": "evaluate", "arguments": { "script": "return document.title" } } -
Run several steps in one call (saves a model turn per step). Each step is {action, ...that tool's arguments}; action is navigate, click, fill, type, press, hover, scroll, wait_for, upload or dialog. Target later steps by text/role/selector, since their refs do not exist yet. Stops at the first failing step. Returns one line per step and the full result of the last.
Parameter Type What it does stepsarray Each step: {action, ...that tool’s arguments} { "name": "batch", "arguments": { "steps": [ { "action": "navigate", "url": "example.com/contact" }, { "action": "fill", "fields": [ { "text": "Name", "value": "Ada" }, { "text": "Message", "value": "Hello!" } ] }, { "action": "click", "text": "Send" }, { "action": "wait_for", "text": "Thanks" } ] } }
No tool matches . Try , or .
Refs, not pixels
Read the page as text.
A snapshot is one line per meaningful element, with a ref like [e12] on everything Claude can act on. It costs a few milliseconds, and after an action only the difference comes back.
snapshot4 ms
- heading “Create your account”
- textbox “Email” [e7]
- textbox “Name” [e8]
- checkbox “Send me the weekly summary” [e9]
- button “Create account” [e12]
- link “I already have an account” [e13]
- − button “Create account” [e12]
- + heading “Check your inbox”
- + text “We sent a link to ada@example.com”
A shortened example. Refs live in the extension’s memory, never in the page.
example.com/signup
Create your account
Emailada@example.com NameAda Lovelace Send me the weekly summary Create account I already have an accountCheck your inbox
We sent a link to ada@example.com
batch
A whole flow, one turn.
The model’s round trips between steps are the largest cost in a task. With batch a known sequence runs as one call, each step keeps its human pacing, and it stops at the first step that fails.
{
"steps": [
{ "action": "navigate", "url": "example.com/contact" },
{ "action": "fill", "fields": [
{ "text": "Name", "value": "Ada" },
{ "text": "Message", "value": "Hello!" } ] },
{ "action": "click", "text": "Send" },
{ "action": "wait_for", "text": "Thanks" }
]
}one call per step
- navigate
- model turn
- fill
- model turn
- click
- model turn
- wait_for
with batch
- navigate
- fill
- click
- wait_for
- one line per step, full result of the last
Later steps target by text, role or selector, because their refs do not exist yet.
BROWZIE_PACE
Speed is a setting.
All three keep the same shapes: curved moves, separate button and key events, Shift as its own key. Only the clock changes.
brisk
A practised user
- Pointer move
- Fitts’ law, shorter
- Typing
- key by key, at a quicker rhythm
- Per site, per minute
- stays inside human ranges
human
A careful person
- Pointer move
- Fitts’ law, up to 1.7 s
- Typing
- key by key with natural pauses, optional typos that get corrected
- Per site, per minute
- at most 40 actions and 14 navigations
Pick a pace to see the same sentence typed three ways. A simulation of the model in extension/lib/human.js.
Configuration
Six switches, no config file.
Set them in the environment of the MCP server, for example with claude mcp add -e. The native host logs to %LOCALAPPDATA%\Browzie\host.log.
BROWZIE_PACEfastbriskhuman
How quickly the pointer moves and keys are typed. fast is the default.
BROWZIE_YIELDwindowanyoff
window (default): stop only for your input in the Browzie window. any: stop for any input anywhere. off: never stop.
BROWZIE_DESKTOPnumberGUIDoff
The virtual desktop for Browzie’s windows. By default, the desktop Claude Code runs on.
BROWZIE_CHROME_PATHpath
The
chrome.exeto start when Chrome is not running.BROWZIE_DEBUG1
Timing lines on stderr, for every hop.
BROWZIE_LENS_LOGfile
A file the cursor overlay writes its window decisions to.
Ready when you are
One browser.
Now, two cursors.
Clone it, run one installer, load the extension once, then ask Claude to open a page. You will see the purple cursor on its way.