create_cloud_vm
Creates an Ubuntu VM from a cloud image on Proxmox with first-boot setup, optional desktop, remote desktop, and SSH key access—no manual OS installation.
Instructions
Create an Ubuntu VM from a cloud image (see get_cloud_image) — no installer: a user, its password (the USER types it in Proxmox Controller's window; you never give or see a password), optionally an SSH public key, network by DHCP. It sets itself up on the first start, from a setup disc the app makes and deletes afterwards: the updates and the QEMU guest agent (a server: 2-5 minutes). edition 'desktop' adds a SPICE display, sound and a USB tablet, and installs Ubuntu Desktop too (10-20 minutes); remote_desktop turns on Ubuntu's own Remote Desktop (GNOME Remote Desktop: RDP, port 3389, the Ubuntu desktop itself with its sound) with the same user and password; dark_theme makes the desktop dark.
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": {
"host": "<host>",
"name": "<name>",
"image": "<image>",
"reason": "<reason>"
},
"name": "create_cloud_vm"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | The host's id, from list_hosts. | |
| name | Yes | ||
| node | No | ||
| vmid | No | ||
| cores | No | ||
| image | Yes | The image's volid. | |
| start | No | Default: true. | |
| bridge | No | ||
| reason | Yes | Why you are doing this, in a sentence. The user sees it in the approval window and in the log. | |
| disk_gb | No | ||
| edition | No | ||
| storage | No | ||
| host_cpu | No | The host's own CPU type (else x86-64-v2-AES). Default: true for the desktop, false for a server. | |
| username | No | Default: user. | |
| static_ip | No | A fixed address such as 192.168.1.50; the network's size, gateway and DNS are the host's own (on the VM's bridge). Default: DHCP. | |
| dark_theme | No | Desktop only. | |
| memory_mib | No | ||
| start_at_boot | No | ||
| remote_desktop | No | Desktop only. | |
| ssh_public_key | No | ||
| sudo_asks_password | No | As a normal Ubuntu, sudo asks for the user's password (at a console prompt: console_type_password). Default: true. false: sudo without a password, as the cloud image's own default. |