Screenshot
CUTools
Description
Take screenshots of the entire screen or specific areas! Whether for documentation, error analysis, or visual reporting - Screenshot delivers high-quality captures directly and reliably.
With support for different capture modes (full screen, window, region) and output formats (PNG, JPG, BMP), you can take screenshots for any use case - without additional software or manual editing.
Why This Tool Stands Out
- Instant Capture via API call
- Multiple Formats supported
- Region Selection with precision
- Direct Saving or Base64
Perfect for:
Tech writers, QA testers, support staff, and developers who need to create visual documentation. Ideal for manuals, bug reports, tutorials, and automated test logs.
Workflow support; time savings depend on the task
Instead of taking screenshots, cropping them, and saving them manually, you get the perfect image with a single API call - ready to use in documentation right away.
JSON Parameters
- mode REQUIRED (String)The capture mode. Possible values: "fullscreen", "window", "region". Determines which part of the screen is captured.
- outputPath OPTIONAL (String)The path for saving the screenshot. If omitted, Base64 data is returned.
- format OPTIONAL (String)The output format. Possible values: "PNG", "JPG", "BMP". Default: "PNG"
- quality OPTIONAL (Integer)The image quality for JPG (1-100). Higher values = better quality. Default: 85
- region OPTIONAL (Object)Region for mode "region": {"x": 0, "y": 0, "width": 800, "height": 600}
- windowTitle OPTIONAL (String)Window title for mode "window". If omitted, the active window is used.
Example Call
{
"tool": "Screenshot",
"params": {
"mode": "fullscreen",
"format": "PNG",
"outputPath": "C:\\Screenshots\\desktop.png"
}
}
Example Usage
AI Command
- "Take a screenshot of the current window and save it as error.png"
The AI assistant automatically recognizes that the Screenshot tool should be used and passes the appropriate parameters.
Related Tools
Return Values
The tool returns an object with the following properties:
- success (Boolean)
True if the capture was successful - imageData (String)
Base64-encoded image (if outputPath is not specified) - filePath (String)
Path to the saved file (if outputPath is specified) - width (Integer)
Image width in pixels - height (Integer)
Image height in pixels - format (String)
Image format used - error (String, optional)
Error message if the capture failed
Download CUTools Now for Free
Experience the power of AI-driven computer control. Compatible with Windows 10/11.
Download for Free