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 the selected VM’s available runtimes, native UI support, permissions and desktop capabilities.",
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 "items": {
68 "oneOf": [
69 {
70 "type": "object",
71 "properties": {
72 "type": {
73 "const": "click"
74 },
75 "x": {
76 "type": "integer",
77 "minimum": 0
78 },
79 "y": {
80 "type": "integer",
81 "minimum": 0
82 },
83 "button": {
84 "enum": [
85 "left",
86 "right",
87 "middle"
88 ]
89 },
90 "count": {
91 "type": "integer",
92 "minimum": 1,
93 "maximum": 3
94 }
95 },
96 "required": [
97 "type",
98 "x",
99 "y"
100 ],
101 "additionalProperties": false
102 },
103 {
104 "type": "object",
105 "properties": {
106 "type": {
107 "const": "move"
108 },
109 "x": {
110 "type": "integer",
111 "minimum": 0
112 },
113 "y": {
114 "type": "integer",
115 "minimum": 0
116 }
117 },
118 "required": [
119 "type",
120 "x",
121 "y"
122 ],
123 "additionalProperties": false
124 },
125 {
126 "type": "object",
127 "properties": {
128 "type": {
129 "const": "drag"
130 },
131 "x": {
132 "type": "integer",
133 "minimum": 0
134 },
135 "y": {
136 "type": "integer",
137 "minimum": 0
138 },
139 "to_x": {
140 "type": "integer",
141 "minimum": 0
142 },
143 "to_y": {
144 "type": "integer",
145 "minimum": 0
146 },
147 "button": {
148 "enum": [
149 "left",
150 "right",
151 "middle"
152 ]
153 },
154 "duration_ms": {
155 "type": "integer",
156 "minimum": 1,
157 "maximum": 5000
158 }
159 },
160 "required": [
161 "type",
162 "x",
163 "y",
164 "to_x",
165 "to_y"
166 ],
167 "additionalProperties": false
168 },
169 {
170 "type": "object",
171 "properties": {
172 "type": {
173 "const": "scroll"
174 },
175 "x": {
176 "type": "integer",
177 "minimum": 0
178 },
179 "y": {
180 "type": "integer",
181 "minimum": 0
182 },
183 "direction": {
184 "enum": [
185 "up",
186 "down",
187 "left",
188 "right"
189 ]
190 },
191 "amount": {
192 "type": "integer",
193 "minimum": 1,
194 "maximum": 100
195 }
196 },
197 "required": [
198 "type",
199 "x",
200 "y",
201 "direction"
202 ],
203 "additionalProperties": false
204 },
205 {
206 "type": "object",
207 "properties": {
208 "type": {
209 "const": "key"
210 },
211 "keys": {
212 "type": "array",
213 "items": {
214 "type": "string"
215 },
216 "minItems": 1,
217 "maxItems": 8
218 }
219 },
220 "required": [
221 "type",
222 "keys"
223 ],
224 "additionalProperties": false
225 },
226 {
227 "type": "object",
228 "properties": {
229 "type": {
230 "const": "text"
231 },
232 "text": {
233 "type": "string",
234 "maxLength": 16384
235 }
236 },
237 "required": [
238 "type",
239 "text"
240 ],
241 "additionalProperties": false
242 },
243 {
244 "type": "object",
245 "properties": {
246 "type": {
247 "const": "wait"
248 },
249 "duration_ms": {
250 "type": "integer",
251 "minimum": 1,
252 "maximum": 5000
253 }
254 },
255 "required": [
256 "type",
257 "duration_ms"
258 ],
259 "additionalProperties": false
260 }
261 ]
262 },
263 "minItems": 1,
264 "maxItems": 100
265 },
266 "screenshot": {
267 "type": "boolean",
268 "default": true
269 }
270 },
271 "required": [
272 "vm",
273 "actions"
274 ],
275 "additionalProperties": false
276 },
277 "annotations": {
278 "readOnlyHint": false
279 }
280 },
281 {
282 "name": "computer_ui",
283 "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.",
284 "inputSchema": {
285 "type": "object",
286 "properties": {
287 "vm": {
288 "type": "string",
289 "description": "VM name from computer_list."
290 },
291 "pid": {
292 "type": "integer",
293 "minimum": 1
294 }
295 },
296 "required": [
297 "vm"
298 ],
299 "additionalProperties": false
300 },
301 "annotations": {
302 "readOnlyHint": true
303 }
304 },
305 {
306 "name": "computer_ui_action",
307 "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.",
308 "inputSchema": {
309 "type": "object",
310 "properties": {
311 "vm": {
312 "type": "string",
313 "description": "VM name from computer_list."
314 },
315 "target": {
316 "type": "object"
317 },
318 "operation": {
319 "type": "string"
320 },
321 "value": {
322 "type": "string"
323 },
324 "screenshot": {
325 "type": "boolean",
326 "default": true
327 }
328 },
329 "required": [
330 "vm",
331 "target",
332 "operation"
333 ],
334 "additionalProperties": false
335 },
336 "annotations": {
337 "readOnlyHint": false
338 }
339 },
340 {
341 "name": "computer_exec",
342 "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. 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.",
343 "inputSchema": {
344 "type": "object",
345 "properties": {
346 "vm": {
347 "type": "string",
348 "description": "VM name from computer_list."
349 },
350 "script": {
351 "type": "string",
352 "maxLength": 65536
353 },
354 "runtime": {
355 "type": "string",
356 "enum": [
357 "default",
358 "zsh",
359 "bash",
360 "powershell",
361 "cmd",
362 "ahk"
363 ],
364 "default": "default"
365 },
366 "timeout_ms": {
367 "type": "integer",
368 "minimum": 1,
369 "maximum": 180000,
370 "default": 60000
371 },
372 "screenshot": {
373 "type": "boolean",
374 "default": true
375 }
376 },
377 "required": [
378 "vm",
379 "script"
380 ],
381 "additionalProperties": false
382 },
383 "annotations": {
384 "readOnlyHint": false
385 }
386 },
387 {
388 "name": "computer_spawn",
389 "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.",
390 "inputSchema": {
391 "type": "object",
392 "properties": {
393 "vm": {
394 "type": "string",
395 "description": "VM name from computer_list."
396 },
397 "script": {
398 "type": "string",
399 "maxLength": 65536
400 },
401 "runtime": {
402 "type": "string",
403 "enum": [
404 "default",
405 "zsh",
406 "bash",
407 "powershell",
408 "cmd",
409 "ahk"
410 ],
411 "default": "default"
412 }
413 },
414 "required": [
415 "vm",
416 "script"
417 ],
418 "additionalProperties": false
419 },
420 "annotations": {
421 "readOnlyHint": false
422 }
423 },
424 {
425 "name": "computer_process",
426 "description": "Inspect or stop a process launched by computer_spawn. Use its returned id; handles reject PID reuse.",
427 "inputSchema": {
428 "type": "object",
429 "properties": {
430 "vm": {
431 "type": "string",
432 "description": "VM name from computer_list."
433 },
434 "id": {
435 "type": "string"
436 },
437 "operation": {
438 "enum": [
439 "status",
440 "stop"
441 ]
442 }
443 },
444 "required": [
445 "vm",
446 "id",
447 "operation"
448 ],
449 "additionalProperties": false
450 },
451 "annotations": {
452 "readOnlyHint": false
453 }
454 },
455 {
456 "name": "computer_file",
457 "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.",
458 "inputSchema": {
459 "type": "object",
460 "properties": {
461 "vm": {
462 "type": "string",
463 "description": "VM name from computer_list."
464 },
465 "path": {
466 "type": "string"
467 },
468 "operation": {
469 "enum": [
470 "stat",
471 "list",
472 "mkdir",
473 "remove"
474 ]
475 }
476 },
477 "required": [
478 "vm",
479 "path",
480 "operation"
481 ],
482 "additionalProperties": false
483 },
484 "annotations": {
485 "readOnlyHint": false
486 }
487 },
488 {
489 "name": "computer_upload",
490 "description": "Create a one-use HTTP PUT URL for uploading a local file into the VM without putting bytes in model context. Send the raw file body to the URL within 10 minutes. At most 64 MiB; destination replacement requires overwrite=true. The upload commits only after all declared bytes arrive.",
491 "inputSchema": {
492 "type": "object",
493 "properties": {
494 "vm": {
495 "type": "string",
496 "description": "VM name from computer_list."
497 },
498 "path": {
499 "type": "string"
500 },
501 "size": {
502 "type": "integer",
503 "minimum": 0,
504 "maximum": 67108864
505 },
506 "overwrite": {
507 "type": "boolean",
508 "default": false
509 }
510 },
511 "required": [
512 "vm",
513 "path",
514 "size"
515 ],
516 "additionalProperties": false
517 },
518 "annotations": {
519 "readOnlyHint": false
520 }
521 },
522 {
523 "name": "computer_download",
524 "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.",
525 "inputSchema": {
526 "type": "object",
527 "properties": {
528 "vm": {
529 "type": "string",
530 "description": "VM name from computer_list."
531 },
532 "path": {
533 "type": "string"
534 }
535 },
536 "required": [
537 "vm",
538 "path"
539 ],
540 "additionalProperties": false
541 },
542 "annotations": {
543 "readOnlyHint": true
544 }
545 },
546 {
547 "name": "computer_presets",
548 "description": "List approved Linux and Windows presets and enforced test-VM limits. Requires computer:create permission.",
549 "inputSchema": {
550 "type": "object",
551 "properties": {},
552 "required": [],
553 "additionalProperties": false
554 },
555 "annotations": {
556 "readOnlyHint": true
557 }
558 },
559 {
560 "name": "computer_create",
561 "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.",
562 "inputSchema": {
563 "type": "object",
564 "properties": {
565 "preset": {
566 "type": "string"
567 },
568 "name": {
569 "type": "string",
570 "pattern": "^[a-z0-9][a-z0-9-]{0,35}$"
571 },
572 "vcpus": {
573 "type": "integer",
574 "minimum": 1,
575 "maximum": 4,
576 "default": 2
577 },
578 "memory_gib": {
579 "type": "integer",
580 "minimum": 1,
581 "maximum": 8,
582 "default": 4
583 }
584 },
585 "required": [
586 "preset",
587 "name"
588 ],
589 "additionalProperties": false
590 },
591 "annotations": {
592 "readOnlyHint": false
593 }
594 },
595 {
596 "name": "computer_vm",
597 "description": "Start, shut down, or reboot a granted VM. For AI-owned test VMs only: extend idle expiry by up to 24 hours from now, or delete the VM and its disposable disk. Listing VMs does not extend expiry.",
598 "inputSchema": {
599 "type": "object",
600 "properties": {
601 "vm": {
602 "type": "string"
603 },
604 "operation": {
605 "type": "string",
606 "enum": [
607 "start",
608 "shutdown",
609 "reboot",
610 "extend",
611 "delete"
612 ]
613 },
614 "seconds": {
615 "type": "integer",
616 "minimum": 1,
617 "maximum": 86400,
618 "default": 3600
619 }
620 },
621 "required": [
622 "vm",
623 "operation"
624 ],
625 "additionalProperties": false
626 },
627 "annotations": {
628 "readOnlyHint": false
629 }
630 }
631]