1[
2 {
3 "name": "computer_list",
4 "description": "List VMs granted to this connection, with their operating systems and current power state.",
5 "inputSchema": {
6 "type": "object",
7 "properties": {},
8 "required": [],
9 "additionalProperties": false
10 },
11 "annotations": {
12 "readOnlyHint": true
13 }
14 },
15 {
16 "name": "computer_status",
17 "description": "Report VM power, command readiness, CPU acceleration, runtimes, execution context and desktop capabilities. Status and screenshots remain available during commands on Linux-hosted VMs. Use active_operation.id with computer_process to inspect or cancel an active operation. Available runtimes do not prove a particular command succeeded.",
18 "inputSchema": {
19 "type": "object",
20 "properties": {
21 "vm": {
22 "type": "string",
23 "description": "VM name from computer_list."
24 }
25 },
26 "required": [
27 "vm"
28 ],
29 "additionalProperties": false
30 },
31 "annotations": {
32 "readOnlyHint": true
33 }
34 },
35 {
36 "name": "computer_shot",
37 "description": "Capture the VM desktop as an image. Input coordinates are pixels in this screenshot, with (0,0) at its top left.",
38 "inputSchema": {
39 "type": "object",
40 "properties": {
41 "vm": {
42 "type": "string",
43 "description": "VM name from computer_list."
44 }
45 },
46 "required": [
47 "vm"
48 ],
49 "additionalProperties": false
50 },
51 "annotations": {
52 "readOnlyHint": true
53 }
54 },
55 {
56 "name": "computer_input",
57 "description": "Perform an ordered batch of desktop actions on Windows, macOS or Linux. Coordinates use screenshot pixels. Key chords use Control, Alt, Shift, Meta (Command on Mac, Windows/Super elsewhere), Enter, Tab, Escape, arrows, Home/End, PageUp/PageDown, F1–F12, or one ASCII character. Use text for literal Unicode and key for shortcuts; legacy Windows text supports ASCII on a US keyboard. Returns an optional screenshot after the batch. Stops at the first error; preceding actions may already have run.",
58 "inputSchema": {
59 "type": "object",
60 "properties": {
61 "vm": {
62 "type": "string",
63 "description": "VM name from computer_list."
64 },
65 "actions": {
66 "type": "array",
67 "description": "Waits and drags, including default drag durations, may total at most 15 seconds.",
68 "items": {
69 "oneOf": [
70 {
71 "type": "object",
72 "properties": {
73 "type": {
74 "const": "click"
75 },
76 "x": {
77 "type": "integer",
78 "minimum": 0
79 },
80 "y": {
81 "type": "integer",
82 "minimum": 0
83 },
84 "button": {
85 "enum": [
86 "left",
87 "right",
88 "middle"
89 ]
90 },
91 "count": {
92 "type": "integer",
93 "minimum": 1,
94 "maximum": 3
95 }
96 },
97 "required": [
98 "type",
99 "x",
100 "y"
101 ],
102 "additionalProperties": false
103 },
104 {
105 "type": "object",
106 "properties": {
107 "type": {
108 "const": "move"
109 },
110 "x": {
111 "type": "integer",
112 "minimum": 0
113 },
114 "y": {
115 "type": "integer",
116 "minimum": 0
117 }
118 },
119 "required": [
120 "type",
121 "x",
122 "y"
123 ],
124 "additionalProperties": false
125 },
126 {
127 "type": "object",
128 "properties": {
129 "type": {
130 "const": "drag"
131 },
132 "x": {
133 "type": "integer",
134 "minimum": 0
135 },
136 "y": {
137 "type": "integer",
138 "minimum": 0
139 },
140 "to_x": {
141 "type": "integer",
142 "minimum": 0
143 },
144 "to_y": {
145 "type": "integer",
146 "minimum": 0
147 },
148 "button": {
149 "enum": [
150 "left",
151 "right",
152 "middle"
153 ]
154 },
155 "duration_ms": {
156 "type": "integer",
157 "minimum": 1,
158 "maximum": 5000
159 }
160 },
161 "required": [
162 "type",
163 "x",
164 "y",
165 "to_x",
166 "to_y"
167 ],
168 "additionalProperties": false
169 },
170 {
171 "type": "object",
172 "properties": {
173 "type": {
174 "const": "scroll"
175 },
176 "x": {
177 "type": "integer",
178 "minimum": 0
179 },
180 "y": {
181 "type": "integer",
182 "minimum": 0
183 },
184 "direction": {
185 "enum": [
186 "up",
187 "down",
188 "left",
189 "right"
190 ]
191 },
192 "amount": {
193 "type": "integer",
194 "minimum": 1,
195 "maximum": 100
196 }
197 },
198 "required": [
199 "type",
200 "x",
201 "y",
202 "direction"
203 ],
204 "additionalProperties": false
205 },
206 {
207 "type": "object",
208 "properties": {
209 "type": {
210 "const": "key"
211 },
212 "keys": {
213 "type": "array",
214 "items": {
215 "type": "string"
216 },
217 "minItems": 1,
218 "maxItems": 8
219 }
220 },
221 "required": [
222 "type",
223 "keys"
224 ],
225 "additionalProperties": false
226 },
227 {
228 "type": "object",
229 "properties": {
230 "type": {
231 "const": "text"
232 },
233 "text": {
234 "type": "string",
235 "maxLength": 16384
236 }
237 },
238 "required": [
239 "type",
240 "text"
241 ],
242 "additionalProperties": false
243 },
244 {
245 "type": "object",
246 "properties": {
247 "type": {
248 "const": "wait"
249 },
250 "duration_ms": {
251 "type": "integer",
252 "minimum": 1,
253 "maximum": 5000
254 }
255 },
256 "required": [
257 "type",
258 "duration_ms"
259 ],
260 "additionalProperties": false
261 }
262 ]
263 },
264 "minItems": 1,
265 "maxItems": 100
266 },
267 "screenshot": {
268 "type": "boolean",
269 "default": true
270 }
271 },
272 "required": [
273 "vm",
274 "actions"
275 ],
276 "additionalProperties": false
277 },
278 "annotations": {
279 "readOnlyHint": false
280 }
281 },
282 {
283 "name": "computer_ui",
284 "description": "Read a bounded native accessibility tree: macOS AX, Windows UI Automation or Linux AT-SPI. Nodes include names, roles, values, targets, available actions, and screen bounds where supported. Optionally restrict to an application PID. Use a fresh returned target with computer_ui_action; custom-drawn apps may need screenshot/input.",
285 "inputSchema": {
286 "type": "object",
287 "properties": {
288 "vm": {
289 "type": "string",
290 "description": "VM name from computer_list."
291 },
292 "pid": {
293 "type": "integer",
294 "minimum": 1
295 }
296 },
297 "required": [
298 "vm"
299 ],
300 "additionalProperties": false
301 },
302 "annotations": {
303 "readOnlyHint": true
304 }
305 },
306 {
307 "name": "computer_ui_action",
308 "description": "Act on a native UI element from computer_ui. Pass its target unchanged and choose an action it reports, such as press, AXPress, focus, toggle, select or set_value. Read a fresh tree if the element changes.",
309 "inputSchema": {
310 "type": "object",
311 "properties": {
312 "vm": {
313 "type": "string",
314 "description": "VM name from computer_list."
315 },
316 "target": {
317 "type": "object"
318 },
319 "operation": {
320 "type": "string"
321 },
322 "value": {
323 "type": "string"
324 },
325 "screenshot": {
326 "type": "boolean",
327 "default": true
328 }
329 },
330 "required": [
331 "vm",
332 "target",
333 "operation"
334 ],
335 "additionalProperties": false
336 },
337 "annotations": {
338 "readOnlyHint": false
339 }
340 },
341 {
342 "name": "computer_exec",
343 "description": "Run a script in the VM’s logged-in desktop session. Runtimes come from computer_status: zsh/bash on Unix, PowerShell/cmd/AutoHotkey v2 on Windows. Default uses the platform shell. Windows uses the desktop account's highest available privileges; check execution_context in computer_status. AHK sets Mouse/Pixel CoordMode to Screen; SendText types literal text and FileAppend(text,\"*\") writes stdout. Returns bounded stdout/stderr, exit status, timeout state and optional screenshot. Timeout stops the command group; effects already performed remain. Use computer_spawn for persistent apps.",
344 "inputSchema": {
345 "type": "object",
346 "properties": {
347 "vm": {
348 "type": "string",
349 "description": "VM name from computer_list."
350 },
351 "script": {
352 "type": "string",
353 "maxLength": 65536
354 },
355 "runtime": {
356 "type": "string",
357 "enum": [
358 "default",
359 "zsh",
360 "bash",
361 "powershell",
362 "cmd",
363 "ahk"
364 ],
365 "default": "default"
366 },
367 "timeout_ms": {
368 "type": "integer",
369 "minimum": 1,
370 "maximum": 180000,
371 "default": 60000
372 },
373 "screenshot": {
374 "type": "boolean",
375 "default": true
376 }
377 },
378 "required": [
379 "vm",
380 "script"
381 ],
382 "additionalProperties": false
383 },
384 "annotations": {
385 "readOnlyHint": false
386 }
387 },
388 {
389 "name": "computer_spawn",
390 "description": "Launch a persistent app or command in the VM desktop. Returns a process handle for computer_process. Standard input/output are detached; use computer_exec when output is needed.",
391 "inputSchema": {
392 "type": "object",
393 "properties": {
394 "vm": {
395 "type": "string",
396 "description": "VM name from computer_list."
397 },
398 "script": {
399 "type": "string",
400 "maxLength": 65536
401 },
402 "runtime": {
403 "type": "string",
404 "enum": [
405 "default",
406 "zsh",
407 "bash",
408 "powershell",
409 "cmd",
410 "ahk"
411 ],
412 "default": "default"
413 }
414 },
415 "required": [
416 "vm",
417 "script"
418 ],
419 "additionalProperties": false
420 },
421 "annotations": {
422 "readOnlyHint": false
423 }
424 },
425 {
426 "name": "computer_process",
427 "description": "Inspect or stop a process from computer_spawn or an active operation from computer_status. Active operation handles remain available while execution is busy. Stop requests can require cleanup; inspect until running is false. A null running value means cleanup remains unconfirmed. Spawned process handles reject PID reuse.",
428 "inputSchema": {
429 "type": "object",
430 "properties": {
431 "vm": {
432 "type": "string",
433 "description": "VM name from computer_list."
434 },
435 "id": {
436 "type": "string"
437 },
438 "operation": {
439 "enum": [
440 "status",
441 "stop"
442 ]
443 }
444 },
445 "required": [
446 "vm",
447 "id",
448 "operation"
449 ],
450 "additionalProperties": false
451 },
452 "annotations": {
453 "readOnlyHint": false
454 }
455 },
456 {
457 "name": "computer_file",
458 "description": "Inspect a guest path, list a directory, create directories, or remove one file. Paths are absolute inside the selected VM. Use computer_upload/download for file contents.",
459 "inputSchema": {
460 "type": "object",
461 "properties": {
462 "vm": {
463 "type": "string",
464 "description": "VM name from computer_list."
465 },
466 "path": {
467 "type": "string"
468 },
469 "operation": {
470 "enum": [
471 "stat",
472 "list",
473 "mkdir",
474 "remove"
475 ]
476 }
477 },
478 "required": [
479 "vm",
480 "path",
481 "operation"
482 ],
483 "additionalProperties": false
484 },
485 "annotations": {
486 "readOnlyHint": false
487 }
488 },
489 {
490 "name": "computer_upload",
491 "description": "Create a one-use HTTP PUT URL for uploading a local file into the VM without putting bytes in model context. Start the raw HTTP PUT within 10 minutes. At most 64 MiB; destination replacement requires overwrite=true. The upload commits only after all declared bytes arrive.",
492 "inputSchema": {
493 "type": "object",
494 "properties": {
495 "vm": {
496 "type": "string",
497 "description": "VM name from computer_list."
498 },
499 "path": {
500 "type": "string"
501 },
502 "size": {
503 "type": "integer",
504 "minimum": 0,
505 "maximum": 67108864
506 },
507 "overwrite": {
508 "type": "boolean",
509 "default": false
510 }
511 },
512 "required": [
513 "vm",
514 "path",
515 "size"
516 ],
517 "additionalProperties": false
518 },
519 "annotations": {
520 "readOnlyHint": false
521 }
522 },
523 {
524 "name": "computer_download",
525 "description": "Create a one-use HTTP GET URL for downloading a guest file to the caller’s filesystem without putting bytes in model context. URL expires after 10 minutes and remains subject to this connection’s access. At most 64 MiB.",
526 "inputSchema": {
527 "type": "object",
528 "properties": {
529 "vm": {
530 "type": "string",
531 "description": "VM name from computer_list."
532 },
533 "path": {
534 "type": "string"
535 }
536 },
537 "required": [
538 "vm",
539 "path"
540 ],
541 "additionalProperties": false
542 },
543 "annotations": {
544 "readOnlyHint": true
545 }
546 },
547 {
548 "name": "computer_presets",
549 "description": "List approved Linux and Windows presets and enforced test-VM limits. Requires computer:create permission.",
550 "inputSchema": {
551 "type": "object",
552 "properties": {},
553 "required": [],
554 "additionalProperties": false
555 },
556 "annotations": {
557 "readOnlyHint": true
558 }
559 },
560 {
561 "name": "computer_create",
562 "description": "Create a disposable VM from an approved preset. It belongs to your account, is tagged AI-owned, receives an ai- name, and is granted to this connection. Deleted after one hour without targeted tool calls. Maximum 2 per user, 8 per host, 4 vCPUs and 8 GiB RAM per VM. Base images stay unchanged.",
563 "inputSchema": {
564 "type": "object",
565 "properties": {
566 "preset": {
567 "type": "string"
568 },
569 "name": {
570 "type": "string",
571 "pattern": "^[a-z0-9][a-z0-9-]{0,35}$"
572 },
573 "vcpus": {
574 "type": "integer",
575 "minimum": 1,
576 "maximum": 4,
577 "default": 2
578 },
579 "memory_gib": {
580 "type": "integer",
581 "minimum": 1,
582 "maximum": 8,
583 "default": 4
584 }
585 },
586 "required": [
587 "preset",
588 "name"
589 ],
590 "additionalProperties": false
591 },
592 "annotations": {
593 "readOnlyHint": false
594 }
595 },
596 {
597 "name": "computer_vm",
598 "description": "Start, shut down, reboot, force off, or reset a granted VM. Force off and reset lose unsaved work and are unavailable on managed Macs. For AI-owned test VMs, extend idle expiry by up to 24 hours or delete the VM and disk. Listing does not extend expiry.",
599 "inputSchema": {
600 "type": "object",
601 "properties": {
602 "vm": {
603 "type": "string"
604 },
605 "operation": {
606 "type": "string",
607 "enum": [
608 "start",
609 "shutdown",
610 "reboot",
611 "force_off",
612 "reset",
613 "extend",
614 "delete"
615 ]
616 },
617 "seconds": {
618 "type": "integer",
619 "minimum": 1,
620 "maximum": 86400,
621 "default": 3600
622 }
623 },
624 "required": [
625 "vm",
626 "operation"
627 ],
628 "additionalProperties": false
629 },
630 "annotations": {
631 "readOnlyHint": false
632 }
633 }
634]