browserscale MCP server

Model Context Protocol endpoint (Streamable HTTP).

Lifecycle

• rent — Rent a fresh browser session and get back its sessionId + grpcUrl (pass both to the action
• stop — Release a session (frees the browser and its proxy).

Actions

• navigate — Navigate the session's page to a URL and wait for the main-frame navigation to commit.
• observe — First look at any unfamiliar page.
• evaluate — Run a JavaScript expression in the page's MAIN frame and get its JSON value back.
• wait — Wait until ANY of the given conditions matches — the first to match wins (this is the
• click — Click an element.
• fill — Type text into ONE specific input, strictly bound to it: it clicks to focus then sends real,
• type — Type text as a per-key keyboard stream into whatever currently has focus, WITHOUT targeting or
• select — Pick an <option> in a <select>.
• move_to — Move the mouse over an element without clicking — hover to reveal dropdowns/tooltips or warm
• scroll_to — Scroll an element into view without clicking it.
• drag — Drag an element.
• press_key — Send a full key press (down+up) to whatever currently has focus — Enter to submit, Tab to
• insert_text — Commit a whole string at once to the focused element via the IME path — NO per-key events
• screenshot — Capture the current viewport as an image and return it inline so you can SEE the page (great
• set_proxy — Change the session's upstream proxy at runtime (e.g.
• solve_captcha — Attempt to solve a captcha challenge on the current page and return the resulting token.

Identity

• get_cookies — Dump every cookie in the session as a JSON array — an identity snapshot.
• set_cookies — Inject/restore cookies.
• clear_cookies — Delete every cookie in the session — start from a clean identity.
• get_storage — Dump localStorage grouped by origin as JSON — the other half of an identity snapshot (pair with
• set_storage — Restore localStorage.
• clear_storage — Delete localStorage.