← All toolsVision & Controlcomputer_controlAll editions

SCREENSHOT

Take a screenshot of the current screen. Returns base64 image and dimensions.

Parameters

This tool takes no parameters.

How to use it

You normally trigger this by describing what you want in chat — the agent selects SCREENSHOT automatically. For example:

Try saying
“use computer control to screenshot …”

In a workflow

As a step in a multi-step workflow DAG:

json
{
  "id": "s1",
  "agent": "computer_control",
  "action": "SCREENSHOT",
  "args": {},
  "depends_on": [],
  "outputs": []
}

Direct call

For scripting, call it directly via POST /execute_tool. Every tool returns { success, message, data }.

bash
curl -X POST http://127.0.0.1:8000/execute_tool \
  -H "Content-Type: application/json" \
  -d '{"tool_name":"SCREENSHOT","args":{}}'

Part of the computer_control plugin. Browse the full Plugin & Tool Catalog or the relevant feature guide.