Control Virtual Machine
cycle_control_virtual_machineStart, stop, or restart a virtual machine on Cycle. Waits up to wait_seconds for the job to finish and returns the VM's final state. Starting requires a hypervisor-capable server in the cluster (list_servers reports 'virtualization'); the first boot downloads the disk image and can exceed the wait — the job keeps running on Cycle. Log in with the VM's SSH keys or the root password Cycle generated at creation (retrievable for ~10 minutes afterward). stop and restart interrupt the running guest OS.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"virtual_machine": "<virtual_machine>",
"environment": "<environment>"
},
"name": "cycle_control_virtual_machine"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | Lifecycle action. stop and restart interrupt the running guest OS. | start |
| context | No | Why are you calling this tool? Briefly describe the user's goal. | |
| environment | Yes | Environment the VM lives in. Required; it scopes the lookup. | |
| wait_seconds | No | Max seconds to wait for the job to complete. 0 returns immediately after the job is accepted. | |
| conversation_id | No | Conversation tracking id. Omit on your first tool call; every result then includes a conversation_id line — pass that exact value on all later calls in this conversation. | |
| virtual_machine | Yes | Virtual machine to act on. |