MCP tools
The hosted MCP server (https://api.agents.computeengines.com/mcp) and the local cec mcp server expose the same tools. The hosted server lists only the tools your key's scopes allow and hides computer creation for a key restricted to specific computers; the local server lists every tool and enforces scopes when a tool is called. Read-only, destructive and idempotent flags are hints that describe behavior; they do not authorize an action. See the MCP server page for configuration.
| Tool | What it does | Scope | Hints |
|---|---|---|---|
create_computer |
Create computer. | computers:write |
|
list_computers |
List computers. | computers:read |
read-only, idempotent |
get_computer |
Get computer. | computers:read |
read-only, idempotent |
start_computer |
Start computer. | computers:write |
idempotent |
stop_computer |
Stop computer. | computers:write |
destructive, idempotent |
pause_computer |
Pause computer. | computers:keepalive |
idempotent |
resume_computer |
Resume computer. | computers:keepalive |
idempotent |
restart_computer |
Restart computer. | computers:write |
destructive |
extend_timeout |
Extend timeout. | computers:keepalive |
|
delete_computer |
Delete computer. | computers:delete |
destructive, idempotent |
get_operation |
Get operation. | computers:read |
read-only, idempotent |
get_setup_log |
Get setup log. | computers:exec |
read-only, idempotent |
exec |
Exec. | computers:exec |
destructive |
start_process |
Start process. | computers:exec |
destructive |
read_process_output |
Read process output. | computers:exec |
read-only, idempotent |
kill_process |
Kill process. | computers:exec |
destructive |
read_file |
Read file. At most 1,000,000 bytes; use exec or the CLI/SDK for larger files. | computers:exec |
read-only, idempotent |
write_file |
Write file. | computers:exec |
destructive |
list_files |
List files. | computers:exec |
read-only, idempotent |
list_ports |
List ports. | computers:exec |
read-only, idempotent |
create_preview |
Create preview. | computers:write |
|
screenshot |
Screenshot. | computers:exec |
read-only, idempotent |
click |
Click. Coordinates are display pixels. | computers:exec |
destructive |
type_text |
Type text. Coordinates are display pixels. | computers:exec |
destructive |
press_keys |
Press keys. Coordinates are display pixels. | computers:exec |
destructive |
scroll |
Scroll. Coordinates are display pixels. | computers:exec |
|
drag |
Drag. Coordinates are display pixels. | computers:exec |
destructive |
desktop_link |
Desktop link. | computers:exec |
|
get_desktop_control |
Get desktop control. | computers:exec |
read-only, idempotent |
end_desktop_session |
End desktop session. | computers:exec |
destructive |
open_url |
Open url. | computers:exec |
|
cdp_url |
Cdp url. | computers:exec |
|
create_snapshot |
Create snapshot. | snapshots:write |
|
list_snapshots |
List snapshots. | snapshots:read |
read-only, idempotent |
restore_snapshot |
Restore snapshot. | snapshots:write |
destructive |
get_balance |
Get balance. | billing:read |
read-only, idempotent |
Create tools return the idempotency key they used; keep it and reuse it after a lost response instead of creating another computer. Tool errors keep the problem object. Desktop coordinates are display pixels. read_file is limited to 1,000,000 bytes and write_file to 700,000 bytes.
Dory is in development; these pages describe the planned service and may change. Questions: support@computeengines.com.