Take a screenshot
browser_take_screenshotTake a screenshot of the current page. Use browser_snapshot for actions by default. With the vision capability enabled, use screenshot coordinates with the coordinate-based mouse tools for elements not exposed in the accessibility snapshot. Takes the session_id from open_browser. 0.1¢ a step that runs.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"session_id": "<session_id>",
"scale": "<scale>"
},
"name": "browser_take_screenshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| type | No | Image format for the screenshot. If unset, inferred from the filename extension, otherwise png. | |
| scale | Yes | Image resolution scale. "css" produces a screenshot sized in CSS pixels (smaller, consistent across devices). "device" produces a high-resolution screenshot using device pixels (larger, accounts for the device pixel ratio). Default is css. | css |
| target | No | Exact target element reference from the page snapshot, or a unique element selector | |
| element | No | Human-readable element description used to obtain permission to interact with the element | |
| filename | No | File name to save the screenshot to. Relative file names are resolved against the workspace root. If not specified, the screenshot is saved into the output directory as `page-{timestamp}.{png|jpeg|webp}`. | |
| fullPage | No | When true, takes a screenshot of the full scrollable page, instead of the currently visible viewport. Cannot be used with element screenshots. | |
| session_id | Yes | The session id open_browser returned. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| url | No | The address of the page after the step. | |
| error | No | Why the step failed, when it failed. | |
| title | No | The page title. | |
| read_at | No | When the page was read. | |
| took_ms | No | How long the step took. | |
| price_usd | No | What the step cost, in dollars. |