# Droplets

Generated on 16 Mar 2026

> This content is automatically generated from [https://github.com/digitalocean-labs/mcp-digitalocean/blob/main/pkg/registry/droplet/README.md](https://github.com/digitalocean-labs/mcp-digitalocean/blob/main/pkg/registry/droplet/README.md).

## Droplet MCP Tools

This directory contains tools for managing DigitalOcean Droplets, Images, and Sizes via the MCP Server. All operations are exposed as tools with argument-based input—no resource URIs are used. Pagination and filtering are supported where applicable.

* * *

## Supported Tools

### Droplet Tools

- **droplet-create**
  Create a new Droplet.
  **Arguments:**

  - `Name` (string, required): Name of the Droplet
  - `Size` (string, required): Slug of the Droplet size (e.g., `s-1vcpu-1gb`)
  - `ImageID` (number, required): ID of the image to use
  - `Region` (string, required): Slug of the region (e.g., `nyc3`)
  - `Backup` (boolean, optional, default: false): Enable backups
  - `Monitoring` (boolean, optional, default: false): Enable monitoring
- **droplet-delete**
  Delete a Droplet.
  **Arguments:**

  - `ID` (number, required): ID of the Droplet to delete
- **droplet-get**
  Get information about a specific Droplet by its ID.
  **Arguments:**

  - `ID` (number, required): Droplet ID
- **droplet-list**
  List all droplets for the user. Supports pagination.
  **Arguments:**

  - `Page` (number, default: 1): Page number
  - `PerPage` (number, default: 50): Items per page

* * *

### Droplet Actions Tools

- **droplet-action**
  Get information about a specific action performed on a Droplet.
  **Arguments:**

  - `DropletID` (number, required): Droplet ID
  - `ActionID` (number, required): Action ID
- **droplet-reboot**
  Reboot a Droplet.
  **Arguments:**

  - `ID` (number, required): Droplet ID

* * *

## Example Usage

- **Create a new Droplet:**
  Tool: `droplet-create`
  Arguments:

  - `Name`: `"web-1"`
  - `Size`: `"s-1vcpu-1gb"`
  - `ImageID`: `123456`
  - `Region`: `"nyc3"`
  - `Backup`: `true`
  - `Monitoring`: `true`
- **Get a Droplet by ID:**
  Tool: `droplet-get`
  Arguments:

  - `ID`: `12345`
- **Reboot a Droplet:**
  Tool: `droplet-reboot`
  Arguments:

  - `ID`: `12345`
- **reset-droplet-password**
  Reset password for a Droplet.
  **Arguments:**

  - `ID` (number, required): Droplet ID
- **rename-droplet**
  Rename a Droplet.
  **Arguments:**

  - `ID` (number, required): Droplet ID
  - `Name` (string, required): New name
- **change-kernel-droplet**
  Change a Droplet’s kernel.
  **Arguments:**

  - `ID` (number, required): Droplet ID
  - `KernelID` (number, required): Kernel ID
- **enable-ipv6-droplet**
- **enable-private-net-droplet**
- **enable-backups-droplet**
- **disable-backups-droplet**
  Enable/disable features on a Droplet.
  **Arguments:**

  - `ID` (number, required): Droplet ID

#### Tag-based Bulk Actions

- **power-cycle-droplets-tag**
- **power-on-droplets-tag**
- **power-off-droplets-tag**
- **shutdown-droplets-tag**
- **enable-backups-droplets-tag**
- **disable-backups-droplets-tag**
- **snapshot-droplets-tag**
- **enable-ipv6-droplets-tag**
- **enable-private-net-droplets-tag**
  All require:

  - `Tag` (string, required): Tag of the droplets
    Some require:
  - `Name` (string, required): Name for the snapshot (for snapshot-by-tag)

* * *

### Additional Droplet Actions Tools

- **rebuild-droplet-by-slug**
  Rebuild a droplet using an image slug.
  **Arguments:**

  - `ID` (number, required): Droplet ID
  - `ImageSlug` (string, required): Slug of the image to rebuild from
- **power-cycle-droplet**
  Power cycle a droplet.
  **Arguments:**

  - `ID` (number, required): Droplet ID
- **power-on-droplet**
  Power on a droplet.
  **Arguments:**

  - `ID` (number, required): Droplet ID
- **power-off-droplet**
  Power off a droplet.
  **Arguments:**

  - `ID` (number, required): Droplet ID
- **shutdown-droplet**
  Shutdown a droplet.
  **Arguments:**

  - `ID` (number, required): Droplet ID
- **restore-droplet**
  Restore a droplet from a backup/snapshot.
  **Arguments:**

  - `ID` (number, required): Droplet ID
  - `ImageID` (number, required): ID of the backup/snapshot image
- **resize-droplet**
  Resize a droplet.
  **Arguments:**

  - `ID` (number, required): Droplet ID
  - `Size` (string, required): Slug of the new size (e.g., s-1vcpu-1gb)
  - `ResizeDisk` (boolean, optional, default: false): Whether to resize the disk
- **rebuild-droplet**
  Rebuild a droplet from an image.
  **Arguments:**

  - `ID` (number, required): Droplet ID
  - `ImageID` (number, required): ID of the image to rebuild from
- **snapshot-droplet**
  Take a snapshot of a droplet.
  **Arguments:**

  - `ID` (number, required): Droplet ID
  - `Name` (string, required): Name for the snapshot

* * *

### Image Tools

- **image-list** List available images (snapshots, backups, distributions, applications). Supports filtering by type. **Arguments:**

  - `Page` (number, default: 1): Page number
  - `PerPage` (number, default: 50): Items per page
  - `Type` (string, optional): Filter by type: ‘distribution’, ‘application’, ‘user’ (snapshots/backups). If omitted, lists all.
- **image-get** Get a specific image by its numeric ID. **Arguments:**

  - `ID` (number, required): Image ID
- **image-create** Create a custom image from a URL (e.g. QCOW2, ISO). **Arguments:**

  - `Name` (string, required): Name of the new image
  - `Url` (string, required): URL to import the image from
  - `Region` (string, required): Region slug (e.g. nyc3)
  - `Distribution` (string, optional): Distribution name (e.g. Ubuntu)
  - `Description` (string, optional): Description of the image
  - `Tags` (array, optional): Tags to apply
- **image-update** Update an image’s name. **Arguments:**

  - `ID` (number, required): Image ID
  - `Name` (string, required): New name for the image
- **image-delete** Delete an image or snapshot. **Arguments:**

  - `ID` (number, required): ID of the image to delete

* * *

### Image Actions Tools

- **image-action-transfer** Transfer an image to another region. **Arguments:**

  - `ID` (number, required): ID of the image to transfer
  - `Region` (string, required): Region slug to transfer to (e.g., nyc3)
- **image-action-convert** Convert an image (backup) to a snapshot. **Arguments:**

  - `ID` (number, required): ID of the image to convert
- **image-action-get** Retrieve the status of an image action. **Arguments:**

  - `ImageID` (number, required): ID of the image
  - `ActionID` (number, required): ID of the action

* * *

### Size Tools

- **size-list**
  List all available Droplet sizes. Supports pagination.
  **Arguments:**

  - `Page` (number, default: 1): Page number
  - `PerPage` (number, default: 50): Items per page

* * *

## Notes

- All tools use argument-based input; do not use resource URIs.
- Pagination is supported for list endpoints via `Page` and `PerPage` arguments.
- Tag-based tools allow you to perform bulk actions on all Droplets with a given tag.
- All responses are returned in JSON format for easy parsing and integration.
- For endpoints that require an ID or tag, provide the appropriate value in your query.