current_session

current_session

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

MCP tool	current_session
HTTP	GET /browser

The browser session this client is currently using.

Returns the session name, which browser it is, the page it is on, the window size as WxH, whether it is inside a frame, and whether a browser 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.

Reading this never opens a browser: live is false when none is held yet.

Parameters

This action takes no parameters.

Every call names its session: an X-Session-Key header, or ?session=<name>. Sending both is refused. See Sessions.

Returns

Field	Type	Notes
session	string	The name you called with.
named_by	string	Which mechanism supplied the name.
browser	string
url	string	The page it is on.
live	boolean	Whether a browser is open for this session.
in_frame	boolean
window	string	Window size as WxH, when one is known.
store	string
settings	object
guidance	string	The skill reference that explains sessions.

Errors

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

Over MCP the same failures arrive as a tool error.

Example

MCP

current_session()

HTTP

curl -X GET $SELENIUM_FLOW/browser \
  -H "Authorization: Bearer $TOKEN" \
  -H "X-Session-Key: $SESSION"

---

← All actions · Installing · Deployment