{"report":{"v":1,"package":"browserctl-mcp","version":"1.0.0","ranAt":"2026-11-16T11:53:02.027Z","install":{"ok":true,"bin":"browserctl-mcp","integrity":"sha512-HRXhwaFNoEtlG+dXsYFztCoVXzAvopyP8r4VvC08minAwG+ZVEF62oWI3FJ6+noXImzkak2ZfwRWvUAuX1DTEg==","deps":97,"scripts":[],"bins":["browserctl","browserctl-mcp"],"license":"MIT","engines":"node >=22"},"start":{"ok":true,"ms":722,"serverName":"browserctl","serverVersion":"1.0.0","protocol":"2025-06-18"},"tools":[{"name":"status","description":"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.","params":["allowDebugger"]},{"name":"tabs","description":"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.","params":["action","tab","url","focus","force","browser","all"]},{"name":"navigate","description":"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.","params":["url","action","wait","tab"]},{"name":"snapshot","description":"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.","params":["target","depth","full","maxChars","maxText","tab"]},{"name":"read","description":"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.","params":["target","main","offset","maxChars","links","tab"]},{"name":"get","description":"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.","params":["target","what","name","all","maxChars","timeout","tab"]},{"name":"click","description":"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).","params":["target","button","doubleClick","modifiers","timeout","scroll","wait","trusted","tab"]},{"name":"hover","description":"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).","params":["target","timeout","scroll","wait","trusted","tab"]},{"name":"type","description":"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.","params":["target","text","submit","slowly","timeout","scroll","wait","trusted","tab"]},{"name":"fill_form","description":"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.","params":["fields","timeout","scroll","wait","trusted","tab"]},{"name":"press_key","description":"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.","params":["key","target","timeout","wait","trusted","tab"]},{"name":"scroll","description":"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.","params":["direction","amount","to","target","timeout","wait","trusted","tab"]},{"name":"wait_for","description":"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.","params":["text","textGone","target","state","url","time","timeout","tab"]},{"name":"take_screenshot","description":"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.","params":["target","fullPage","format","path","tab"]},{"name":"file_upload","description":"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.","params":["target","paths","timeout","wait","tab"]},{"name":"handle_dialog","description":"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.","params":["accept","promptText","scope","tab"]},{"name":"evaluate","description":"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.","params":["function","target","trusted","tab"]},{"name":"run","description":"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.","params":["code","timeout","tab"]},{"name":"network_requests","description":"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.","params":["filter","types","since","limit","id","body","captureBodies","tab"]}],"toolsHash":"c3774be7d70be4196854cf9fe6109637233c08d4997a0677074d1b5fc0d0f45f","wrote":["/tmp/.browserctl/sessions.json","/tmp/.browserctl/daemon.log","/tmp/.browserctl/calls.jsonl","/tmp/.browserctl/daemon-8765.json"],"callsAt":"2026-11-16T11:53:14.411Z","calls":[{"tool":"status","ok":true,"ms":10,"bytes":328},{"tool":"read","ok":false,"ms":5005,"bytes":0,"error":"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\\\"}).\"}}"}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":19,"wrote":4,"callsTried":2,"callsAnswered":1,"callContacts":[]},"history":[{"package":"browserctl-mcp","version":"1.0.0","ranAt":"2026-11-16T11:53:02.027Z","outcome":"started","tools":19,"contacts":0,"flags":0,"serious":0,"toolsHash":"c3774be7d70be4196854cf9fe6109637233c08d4997a0677074d1b5fc0d0f45f"},{"package":"browserctl-mcp","version":"0.9.8","ranAt":"2026-11-12T18:05:13.830Z","outcome":"started","tools":20,"contacts":0,"flags":0,"serious":0,"toolsHash":"b99229a41ea22534d15918a452c19fc4e9492c415f3a3902e553220ebe4bb58b"}],"page":"https://bragproof.smaverk.com/r/browserctl-mcp"}