Browser

Browser — MCP tools exposed to agents.

4 tools in this group.

browser_start

Start/activate the current session's browser without navigating (opens about:blank), creating the session if a named one does not yet exist. If the MCP server is configured with a remote WebDriver-BiDi endpoint, this connects to that endpoint instead of launching locally. To navigate to a page, use browser_open; to stop the session, use browser_stop.

ParameterTypeRequiredDefaultDescription
headlessbooleannofalseRun browser in headless mode (no visible window)
sessionstringnoOptional: named session to run this call in (default: current session).

browser_stop

Stop the current session's run: close its tabs/context and end its trace. The shared browser process and other sessions keep running (an isolated session closes its own dedicated browser). No-op if the session has no active browser. To start or re-run a session, use browser_start; to navigate, use browser_open.

ParameterTypeRequiredDefaultDescription
sessionstringnoOptional: named session to run this call in (default: current session).

browser_get_window

Get the OS browser window dimensions and state

ParameterTypeRequiredDefaultDescription
sessionstringnoOptional: named session to run this call in (default: current session).

browser_set_window

Set the OS browser window size, position, or state

ParameterTypeRequiredDefaultDescription
heightintegernoWindow height in pixels
sessionstringnoOptional: named session to run this call in (default: current session).
statestringnoWindow state: normal, maximized, minimized, or fullscreen (one of: normal, maximized, minimized, fullscreen)
widthintegernoWindow width in pixels
xintegernoWindow x position in pixels (may be negative on multi-monitor setups)
yintegernoWindow y position in pixels (may be negative on multi-monitor setups)

On this page