browserctl-mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 1 of 2 tools tried
Contacts while installing and starting: nothing
Its tool definitions changed since version 0.9.8. If you approved the earlier ones, read them again.
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y -p browserctl-mcp@1.0.0 browserctl-mcp
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
2 tools that take no input and look read-only were called once with nothing. 1 returned a result.
status | Returned a result under 0.1 s · 328 characters |
read | No usable answer tool reported an error: {"ok":false,"error":{"code":"NO_TAB","message":"this session has no current tab","hint":"Open or select a tab first: tabs({action: \"new |
During the calls it contacted nothing it had not already contacted.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
status allowDebugger
Show connected browsers, setup problems, your tabs, and where Chrome's debugging bar comes from. Call it first when a tool reports NO_BROWSER, USER_SCRIPTS_OFF or DEBUGGER_CANCELED.
tabs action, tab, url, focus, force, browser, all
Manage tabs. action: list | new | select | close | adopt | release. New tabs open in the background and become your current tab. adopt takes an existing tab (e.g. one the user opened) so you can act on it. select with focus: true shows the tab to the user.
navigate url, action, wait, tab
Open a URL in your current tab (opens a background tab if you have none), or action: back | forward | reload. Waits for the page to load. Does not change what the user is looking at.
snapshot target, depth, full, maxChars, maxText, tab
Read the page as an accessibility tree (YAML); each element you can act on has a ref ([ref=e5]) to pass as target to click, type, fill_form, evaluate. A ref stays valid until its element is removed or the page navigates. Extra brackets tell state: [empty], [type=email], [value=42], [near="label"] for unnamed fields, [ctx="..."] to tell identical buttons apart, [modal], [hidden] (no ref: open its menu first). Long lists and long text are folded; each fold line says how to see the rest (read target=eX). target: a ref to read only that part. If the first line says the page is not ready, snapshot again. Works in background tabs without the debugging bar.
read target, main, offset, maxChars, links, tab
Read the page (or target) as text: headings, paragraphs, lists, full tables, links, and form fields with their values and refs. main: true skips navigation and footers. Long pages come in slices: pass nextOffset as offset to continue.
14 more tools
get target, what, name, all, maxChars, timeout, tab
Read one thing about an element: what: text (default) | value | attribute | property | html | state | box; name: the attribute or property (href, dataset.id). target: a ref or a locator. all: true returns every match of a selector. Use it instead of evaluate to read a value.
click target, button, doubleClick, modifiers, timeout, scroll, wait, trusted, tab
Click an element (target: ref or locator). Works in background tabs. trusted: true sends real mouse input for sites that ignore synthetic clicks (shows Chrome's debugging bar). Returns the element hit and what changed (url, new tabs, dialogs, DOM).
hover target, timeout, scroll, wait, trusted, tab
Hover over an element to open its menu or tooltip. Menus that open only through CSS :hover need trusted: true (real pointer; shows Chrome's debugging bar).
type target, text, submit, slowly, timeout, scroll, wait, trusted, tab
Replace the text of an input, textarea or rich-text field. target: a ref or selector. submit: true presses Enter after. slowly: true types key by key for autocomplete fields. Returns the field's value afterwards.
fill_form fields, timeout, scroll, wait, trusted, tab
Set several form controls at once: fields: [{target, value}]. value is a string for text fields and selects (option value or label), true/false for checkboxes, radios and switches, a list for multi-selects. Stops at the first field that fails and says which.press_key key, target, timeout, wait, trusted, tab
Press a key or chord (Enter, Escape, Tab, ArrowDown, Control+A) on target or on the focused element. Enter submits forms, Tab moves focus. trusted: true for keys a site handles only from real keyboards.
scroll direction, amount, to, target, timeout, wait, trusted, tab
Scroll the page or a container (target), by direction and amount, or to: top | bottom; or bring target into view. Reports whether the end was reached and whether more content loaded. trusted: true uses real wheel input, needed for lazy loading in background tabs.
wait_for text, textGone, target, state, url, time, timeout, tab
Wait for text to appear (text) or disappear (textGone), for target to become visible / hidden / attached / detached, for the URL to match (url), or for time seconds. timeout defaults to 10 s.
take_screenshot target, fullPage, format, path, tab
Screenshot the viewport, the full page (fullPage: true) or one element (target). Saved to a file; the path is returned. Background tabs and full pages use Chrome's debugging bar briefly.
file_upload target, paths, timeout, wait, tab
Attach local files (absolute paths) to a file input or to the upload button that opens a file chooser. paths: [] clears it. Returns the files as the page sees them.
handle_dialog accept, promptText, scope, tab
Set how dialogs in your tab are answered: accept: true/false, promptText, scope: next | always. By default alert is accepted and confirm/prompt are dismissed; actions report each dialog and the answer given. To accept a dismissed confirm, call this and repeat the action.
evaluate function, target, trusted, tab
Run JavaScript in the page (page globals available). function: "() => document.title", or "(el) => el.value" with target: a ref. Promises are awaited. Use it whenever no other tool fits.
run code, timeout, tab
Run Playwright code for anything the other tools do not cover (drag, coordinates, routes, cookies, emulation, loops). page, context and a persistent state object are in scope; return a value. Shows Chrome's debugging bar while running.
network_requests filter, types, since, limit, id, body, captureBodies, tab
List the tab's network requests (filter, types, since, limit) or one request's details (id). Response bodies need captureBodies: true first (shows Chrome's debugging bar until turned off). To call an API with the page's cookies, use evaluate with fetch.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Files it wrote
/tmp/ .browserctl/ sessions.json /tmp/ .browserctl/ daemon.log /tmp/ .browserctl/ calls.jsonl /tmp/ .browserctl/ daemon-8765.json
Paths inside its sandbox, where its home folder is /tmp and its own folder cannot be written to.
Install facts
| License | MIT |
|---|---|
| Needs | node >=22 |
| Source | not stated |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-HRXhwaFNoEtlG+dXsYFztCoVXzAvopyP8r4VvC08minAwG+ZVEF62oWI3FJ6+noXImzkak2ZfwRWvUAuX1DTEg== |
Versions reported
| Version | Run | Result | Tools |
|---|---|---|---|
| 1.0.0 | 2026-11-16 | Starts with no setup | 19 |
| 0.9.8 | 2026-11-12 | Starts with no setup | 20 |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/browserctl-mcp)
New version out? Ask for a fresh report.