Capture Browser Scenario
capture_browser_scenarioRuns scripted browser scenarios to drive app flows when passive observation is insufficient, capturing selected artifacts and network data for analysis.
Instructions
Run a controlled browser scenario when passive observation cannot exercise the application. Launch the selected executable or connect to a loopback CDP target, provide a start URL and actions, and select storage or artifacts when needed. Environment, empty storage, and a URL-only final capture are defaults. capture.network selects request_body, response_body, and header_values independently; selected content is returned inline with transaction and event references, byte digests, and explicit unavailable states. Credentials and declared secrets are redacted. Agents can run their own local fixture servers to control application responses. Actions run until completion or cancellation unless timeout_ms is set. Results are returned inline.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"actions": [
{
"action": "wait_for_timeout",
"step_id": "settle",
"duration_ms": 250
}
],
"browser": {
"mode": "launch",
"executable_path": "/opt/chromium/chrome"
},
"start_url": {
"url": "https://app.example.test/",
"query": []
}
},
"name": "capture_browser_scenario"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| actions | Yes | Required sequence of explicit browser actions. | |
| browser | Yes | Required launch/connect selection. Launch uses the selected executable and an owned temporary profile; connect uses one loopback CDP endpoint and target. | |
| capture | No | Optional retained artifacts and event families. Defaults to only a final sanitized URL; request screenshots, DOM, accessibility, history, storage, and event capture explicitly. | |
| secrets | No | Optional environment-variable references for values used in actions, URLs, storage, or replay, and for redacting matching observed text. Secret values are never supplied inline. | |
| storage | No | Optional initial cookies, local storage, or session storage. Defaults to empty; every supplied value and origin must be declared and within the allowed origins. | |
| start_url | Yes | Required initial HTTP(S) URL. Query values must be declared separately as public literals or secret references. | |
| environment | No | Optional deterministic browser settings. Defaults to 1280x720, en-US, UTC, light mode, reduced motion, and blocked service workers. |