Docs
Dashboard
SDKs / MCP serverBeta

browser_navigate

Open a URL in the session's browser.

Loads the URL in the current tab and waits for the page to load.

Inputs

NameTypeDefaultAllowed valuesDescription
sessionIdrequiredstring––The session's id, from session_create.
urlrequiredstring––The page to open.

This tool works in a session with a browser. On a shell-only session (created with browser: false) it answers browser_disabled. See the three kinds of session.

sessionId is the id that session_create returned. The server keeps no default session. If that session is stopped, this tool resumes it first, as it was (a resume starts a machine again, and billing with it).

Example call

This is what an MCP client sends. You do not write it yourself: ask the model in plain words and it calls the tool.

tools/call
{  "name": "browser_navigate",  "arguments": {    "sessionId": "6c1f3c9e-1d2a-4f67-9b0e-1b2c3d4e5f60",    "url": "https://example.com"  }}

What it returns

The final URL, the HTTP status and the page title.

Result
Loaded https://example.com/ (HTTP 200) — Example Domain

When a call fails, the result is marked as an error. Its text starts with the API’s error code, such as unauthorized or session_not_running, followed by its message.

Annotations

The server tells every client what this tool does to the world, so a client can decide what to ask you about before it runs.

AnnotationValue
titleOpen a URL
readOnlyHintfalse
destructiveHintfalse
openWorldHinttrue

The same thing with the API

EndpointReference
POST /v1/sessions/{id}/browser/actionsRun browser actions

These docs describe a beta API. Endpoints, fields and SDK methods may change before general availability; breaking changes will be listed in the changelog.