navigate

navigate

Go to a URL. Returns the resulting URL and page title.

MCP tool	navigate
HTTP	POST /browser/navigate

Use this to move somewhere unconditionally. To act on a page in one step, prefer passing url to click, write, extract or screenshot.

Parameters

Name	Type	Required	Default	Notes
url	string	yes	—
session_id	string	yes over HTTP	—	The session_id returned by /browser/open. Required here.

Returns

Field	Type	Notes
url	string	Current URL after the action.
title	string	Page title after the action.

Errors

Status	Means
400	The request cannot succeed as sent — a missing field, a value that was rejected, or a locator that matched nothing before the wait ran out. Do not retry it unchanged.
401	Missing or wrong bearer token.
404	No such browser session. It ended, the Grid reaped it, or the id was never real. Open a new one and retry.
500	Something failed that this server did not expect.
503	The Grid could not serve this — unreachable, or no free slot for a new browser. Worth retrying after a wait.

Over MCP the same failures arrive as a tool error.

Example

MCP

navigate(url="…")

HTTP

curl -X POST $SELENIUM_FLOW/browser/navigate \
  -H "Authorization: Bearer $TOKEN" \
  -H 'Content-Type: application/json' \
  -d '{
    "session_id": "…",
    "url": "…"
  }'

---

← All actions · Installing · Deployment