take_screenshot
Capture the current page's visible state—or full page—to verify layout, UI, selector targets, dialogs, and navigation/click effects; optionally save the image to a reusable file.
Instructions
Captures the visual state of the currently selected page. Use it to verify page layout, visible UI state, selector targets, in-page dialogs/modals, or the effect of a navigation/click; it is not a substitute for DOM values, network evidence, or script inspection. By default it returns the visible viewport, while fullPage=true captures the whole document; oversized captures may be saved as a temporary artifact instead of attached. Pass filePath for a reusable local artifact; existing files require confirmOverwrite=true and remain subject to --allowedRoots.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "take_screenshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| format | No | Image format for the attachment or saved file. Defaults to png; use jpeg when smaller lossy output is preferred. | png |
| quality | No | Compression quality for JPEG format (0-100). Higher values mean better quality but larger file sizes. Ignored for PNG format. | |
| filePath | No | Optional absolute or working-directory-relative path for a reusable screenshot artifact. Omit it to attach the image directly. Subject to --allowedRoots when configured. | |
| fullPage | No | Capture the entire scrollable document when true; leave false or omit it for the currently visible viewport. | |
| confirmOverwrite | No | Must be true when filePath already exists. New files do not require confirmation. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | Whether the tool completed successfully. | |
| data | No | Machine-readable result payload. | |
| tool | Yes | Stable MCP tool name. | |
| error | No | ||
| summary | Yes | Concise human-readable outcome. |