execute_script

execute_script

Run JavaScript in the page and return its result.

MCP tool	execute_script
HTTP	POST /browser/script

The escape hatch for anything the other tools do not cover: scrolling (window.scrollTo(0, 2000)), drag and drop, computed styles, direct DOM access. Use return to send a value back.

Parameters

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

Returns

Field	Type	Notes
result	any	Whatever the script returned. Any JSON type.
url	string	Current URL after the action.
title	string	Page title after the action.

Errors are 400 for a bad argument, 401 without a token, 500 when the Grid refuses. Over MCP the same failures arrive as a tool error.

Example

MCP

execute_script(script="…")

HTTP

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

---

← All actions · Installing · Deployment