Take Screenshot
screenshotCapture a single PNG of the full screen, monitor, window, or region and return it inline and by file path for on-screen verification.
Instructions
Capture one PNG of the screen, a monitor, a window, or a region, returned inline and by path.
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": {
"target": "<target>"
},
"name": "screenshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| output | No | Optional output .png path. Defaults to a file under SCREENCAST_HOME/screenshots. | |
| target | Yes | full | monitor:<i> (0 = primary) | window:<title> (or window:exe=<app.exe> / window:hwnd=<n>) | region:<x>,<y>,<w>,<h>. Titles match exactly, else as a substring; topmost wins. | |
| backend | No | gdigrab (default, ~0.2 s): what is visible. wgc (window:, FFmpeg 8+, ~1-2 s): the window even if covered. | |
| overwrite | No | Allow replacing an existing file at the output path (default false). | |
| exactTitle | No | window: targets match the whole title only, never a substring (default false). | |
| returnImage | No | Return the image inline (default true; the PNG on disk stays full size). | |
| maxImageWidth | No | Max inline image width (default 1280). |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| target | Yes | ||
| backend | Yes | ||
| outputPath | Yes | ||
| inlineImages | Yes |