> ## Documentation Index
> Fetch the complete documentation index at: https://docs.machine0.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Images

> MCP tools for managing images and versions.

## image\_list

List your images.

**Parameters:** None

***

## image\_get

| Parameter | Type | Required |
| --------- | ---- | -------- |
| `id`      | UUID | yes      |

***

## image\_create

Create an image from a stopped VM.

| Parameter      | Type   | Required | Description                  |
| -------------- | ------ | -------- | ---------------------------- |
| `instanceName` | string | yes      | Stopped VM name              |
| `imageName`    | string | yes      | New image name               |
| `description`  | string | yes      | Description                  |
| `metadata`     | object | no       | Version metadata (max 100KB) |

***

## image\_create\_version

Add a new version to an existing image.

| Parameter      | Type   | Required | Description                  |
| -------------- | ------ | -------- | ---------------------------- |
| `instanceName` | string | yes      | Stopped VM name              |
| `imageName`    | string | yes      | Existing image name          |
| `metadata`     | object | no       | Version metadata (max 100KB) |

***

## image\_update

| Parameter     | Type      | Required | Description        |
| ------------- | --------- | -------- | ------------------ |
| `name`        | string    | yes      | Current image name |
| `newName`     | string    | no       | New name           |
| `regions`     | string\[] | no       | Available regions  |
| `description` | string    | no       | New description    |

***

## image\_destroy

| Parameter | Type   | Required |
| --------- | ------ | -------- |
| `name`    | string | yes      |

***

## image\_version\_list

| Parameter   | Type   | Required |
| ----------- | ------ | -------- |
| `imageName` | string | yes      |

***

## image\_version\_get

| Parameter   | Type    | Required |
| ----------- | ------- | -------- |
| `imageName` | string  | yes      |
| `version`   | integer | yes      |

***

## image\_version\_promote

Promote a version to be the active version.

| Parameter   | Type    | Required |
| ----------- | ------- | -------- |
| `imageName` | string  | yes      |
| `version`   | integer | yes      |

***

## image\_version\_remove

| Parameter   | Type    | Required |
| ----------- | ------- | -------- |
| `imageName` | string  | yes      |
| `version`   | integer | yes      |