SCREENCAST-MCP / TOOLS / CAPTURE
Take Screenshot
screenshot
Capture one PNG of the screen, a monitor, a window, or a region, returned inline and by path.
capturewritesdestructivesince v0.2.0
00:00PARAMETERS
| Name | Type | Description |
|---|---|---|
target required | string | 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. |
exactTitle | boolean | window: targets match the whole title only, never a substring (default false). |
backend | "gdigrab" | "wgc" | gdigrab (default, ~0.2 s): what is visible. wgc (window:, FFmpeg 8+, ~1-2 s): the window even if covered. |
output | string | Optional output .png path. Defaults to a file under SCREENCAST_HOME/screenshots. |
overwrite | boolean | Allow replacing an existing file at the output path (default false). |
returnImage | boolean | Return the image inline (default true; the PNG on disk stays full size). |
maxImageWidth | integer | Max inline image width (default 1280). ≥ 16, ≤ 9007199254740991 |
00:05A MINIMAL CALL
screenshot { "target": "window:Notepad" }The required arguments only, with placeholder values. Everything else takes its default.
00:10WHAT COMES BACK
Structured content (structuredContent), alongside a text summary and any inline images:
| Field | Type | Description |
|---|---|---|
outputPath always | string | |
target always | string | |
backend always | string | |
inlineImages always | integer | ≥ -9007199254740991, ≤ 9007199254740991 |
00:15SEEN IN