List Virtual Machines
list_virtual_machinesList virtual machines on the hub with their current state, image, resources, and assigned public IPs. Filter by environment and/or state. Use this to check on a VM (e.g. whether a deploy or start finished — the disk image download on first boot can take a while) and to find a VM's ID before controlling it. VM names are not guaranteed unique; disambiguate with the identifier or ID. Created VMs live in an environment and share its IPv6-only private network with containers there.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_virtual_machines"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | No | Only return VMs currently in this state. | |
| context | No | Why are you calling this tool? Briefly describe the user's goal. | |
| environment | No | Only list VMs in this environment. Omit for all environments. | |
| 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. |