Create a Machine
varity_machines_createCreate a Varity CPU or GPU virtual machine developers can SSH into using their public key; supply profile and OS image, and delete it to stop hourly billing.
Instructions
Create a Varity CPU or GPU virtual machine the developer can SSH into. Requires the developer's own SSH PUBLIC key (e.g. the contents of ~/.ssh/id_ed25519.pub); never pass a private key. Get profile_id and os_image from varity_machines_list with include_profiles (and gpu: true for a GPU VM, then pass gpu: true here too). The machine bills hourly until varity_machines_delete.
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": {
"name": "<name>",
"profile_id": "<profile_id>",
"os_image": "<os_image>",
"ssh_public_key": "<ssh_public_key>"
},
"name": "varity_machines_create"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| gpu | No | Create a GPU virtual machine from a GPU VM profile. | |
| name | Yes | Lowercase machine name, e.g. 'dev-box'. | |
| os_image | Yes | OS image id offered by that profile (os-...). | |
| profile_id | Yes | Machine profile id (mp-...). | |
| ssh_public_key | Yes | The developer's SSH public key, e.g. 'ssh-ed25519 AAAA... user@host'. | |
| idempotency_key | No | Reuse the same key to retry a create without creating a second machine. | |
| additional_storage_gb | No | Extra disk in GB (CPU machines only). |