current_workspace

workspace://current

What this workspace is, and whether it holds a browser.

MCP resource	workspace://current
HTTP	GET /browser

The workspace this client named, and the session (browser) open in it.

Returns the workspace name, which browser it is, the page it is on, the window size as WxH, whether it is inside a frame, and whether a session is currently open (live). Read it before judging anything about layout — the window is not a fixed size and is what decides whether something is off-screen.

grid_timeout is how many seconds the Grid lets a session in this workspace sit idle before it ends it; every call starts that clock again.

capture says whether this workspace's browsers capture their console and network (open_session(capture=true)); capturing is whether that is happening right now — false while it is paused, until the next call; captured counts what was kept since the last navigation.

Reading this never opens a browser: live is false when no session is open.

Parameters

This action takes no parameters.

Every call names its workspace: an X-Workspace header, or ?workspace=<name>. Sending both is refused. See Workspaces.

Returns

Field	Type	Notes
workspace	string	The name you called with.
named_by	string	Which mechanism supplied the name.
principal	object	Who the credential says you are: kind admin or oidc, with subject and username for oidc. Null on an open server.
browser	string
url	string	The page it is on.
live	boolean	Whether a session is open in this workspace.
recording	boolean	Whether the browser this workspace holds is being recorded.
capture	boolean	Whether this workspace opens its browsers with capture on.
capturing	boolean	Whether the console and network are being captured right now; false while capture is paused.
captured	object	What was captured since the last navigation.
in_frame	boolean
window	string	Window size as WxH, when one is known.
grid_timeout	integer	Seconds the Grid lets a session in this workspace sit idle before it ends it, read from its node at the last open. Null when the Grid did not say.
store	string
settings	object
site_data	object	Present only when the workspace has saved site data.
guidance	string	The skill reference that explains workspaces.

Errors

Status	Means
400	No workspace named, or two names given.
401	Missing or wrong bearer token.

Over MCP the same failures arrive as a tool error.

Example

MCP

read workspace://current

read_resource(uri="workspace://current")

HTTP

curl -X GET $SELENIUM_FLOW/browser \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Workspace: $WORKSPACE"

---

← All actions · Installing · Deployment