capture_screenshot
Capture an OS-level PNG screenshot of a Linux TestClient X display, optionally limited to one window by title. Returns a saved file path for visual QA verification.
Instructions
Capture an OS-level PNG screenshot of the TestClient's X display (Linux).
display is the one from launch_test_client(display=…) status (e.g. ":101"). Optional window is a title
substring (xdotool) to capture a single window instead of the whole display; if no window matches, falls back to
the full display (matched_window_id=null). Captures with scrot (fallback ImageMagick import). Returns {path,
display, window, matched_window_id, size_bytes, tool}; read the PNG at 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": {
"display": "<display>"
},
"name": "capture_screenshot"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| window | No | ||
| display | Yes | ||
| out_path | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||