Civo

You set up and run a Civo MCP Server to manage cloud resources through the MCP protocol. This server connects to the Civo cloud platform, letting you create and control instances, networks, disk images, and Kubernetes clusters from your MCP client in a unified way.

How to use

Connect your MCP client to the Civo MCP Server using the provided configuration. Once connected, you can perform common cloud operations directly from your MCP client. Create new cloud instances with specific sizes and regions, list and inspect disk images, manage networks, and handle Kubernetes clusters. You can also resize, start, stop, reboot, or delete existing instances, and query available regions, sizes, and Kubernetes versions. Use the server as a centralized automation point for your Civo resources.

How to install

Prerequisites: install Node.js 20 or newer. Have a valid Civo account API key. Choose an MCP client such as Claude Desktop, VS Code, Cursor, Ampcode, Gemini CLI, Windsurf, Claude Code, or Claude Desktop.

Install the Civo MCP server by configuring the MCP server entry in your client. The server runs via a standard runtime like npx and uses your CIVO_API_KEY for authentication.

{
  "mcpServers": {
    "civo": {
      "command": "npx",
      "args": ["civo-mcp"],
      "env": {
        "CIVO_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Install in VS Code

Add the Civo MCP server to your VS Code setup using the CLI.

# For VS Code
code --add-mcp '{"name":"civo","command":"npx","args":["civo-mcp"],"env":{"CIVO_API_KEY":"YOUR_API_KEY_HERE"}}'

Install in Ampcode

Configure the Amp MCP server with the same pattern used elsewhere.

"amp.mcpServers": {
  "civo": {
      "command": "npx",
      "args": ["civo-mcp"],
      "env": {
        "CIVO_API_KEY": "YOUR_API_KEY_HERE"
      }
  }
}

Available tools

create_instance

Create new cloud instances on Civo with a hostname, size, image (template_id), optional count, and region.

list_instances

List all instances with optional region filter and pagination.

reboot_instance

Reboot an existing instance by its ID and region.

shutdown_instance

Shutdown an existing instance by its ID and region.

start_instance

Start a stopped instance by its ID and region.

resize_instance

Resize an existing instance by its ID, new size, and region.

delete_instance

Delete an existing instance by its ID and region.

list_disk_images

List available disk images for a region.

get_disk_image

Get details of a specific disk image by ID and optional region.

list_networks

List all available networks.

create_network

Create a new network with a label and optional region.

rename_network

Rename an existing network by ID with a new label and optional region.

delete_network

Delete an existing network by ID and region.

list_kubernetes_clusters

List all Kubernetes clusters with optional region filter and pagination.

create_kubernetes_cluster

Create a new Kubernetes cluster with name, region, network, nodes, node size, and version.

delete_kubernetes_cluster

Delete a Kubernetes cluster by ID and region.

list_kubernetes_versions

List available Kubernetes versions.

list_sizes

List all available instance sizes.

list_regions

List all available regions.