Civo MCP by usefulapi
List Civo instances, Kubernetes clusters, networks and DNS; reboot instances, add rules.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"civo": {
"url": "https://civo.usefulapi.io/mcp"
}
}
}Remote endpoints
https://civo.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (22)
🟢civo_list_regions
List the Civo regions available to the account, with which one is the default, whether each is out of capacity, and the features each supports (IaaS, Kubernetes, object store, load balancers, GPU, databases). A cheap way to confirm the API key works. Civo: GET /v2/regions.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_get_quota
The account's limits and current usage: instances, CPU cores, RAM, disk, volumes, snapshots, public IPs, networks, firewalls and rules, load balancers, object storage and databases. Answers 'can I launch another one?'. Civo: GET /v2/quota.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_charges(from, to)
List billable usage for a period: each resource's product code, label, region, time span and hours (size_gb for volumes). The range may be at most 31 days; defaults to the start of the current month until now. Civo: GET /v2/charges.
Input Schema
{
"type": "object",
"properties": {
"from": {
"description": "Start, RFC 3339 (e.g. 2026-09-01T00:00:00Z). Defaults to the start of this month.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})$"
},
"to": {
"description": "End, RFC 3339. Defaults to now. At most 31 days after `from`.",
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_instance_sizes(region)
List the sizes (plans) that can be launched — instances, Kubernetes nodes and databases — with CPU cores, RAM, disk, transfer allowance and GPU. Civo: GET /v2/sizes.
Input Schema
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_instances(region, tags, page, per_page)
List compute instances in a region, optionally filtered by tags. Paginated: returns {page, per_page, pages, items}. Passwords are redacted. Civo: GET /v2/instances.
Input Schema
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
},
"tags": {
"description": "Only instances carrying these tags.",
"type": "array",
"items": {
"type": "string",
"pattern": "^[^\\s]+$"
}
},
"page": {
"description": "Page number, from 1.",
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"per_page": {
"description": "Items per page, 1-100 (Civo default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_get_instance(instance_id, region)
Fetch one instance: status, size, CPU/RAM/disk, public and private IPs, network, firewall, tags, attached volumes and source image. Passwords are redacted. Civo: GET /v2/instances/{id}.
Input Schema
{
"type": "object",
"properties": {
"instance_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The instance's id (a UUID)."
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"instance_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_kubernetes_clusters(region, page, per_page)
List the Kubernetes (K3s/Talos) clusters in a region with status, version, node pools, API endpoint and installed applications. Paginated: {page, per_page, pages, items}. Kubeconfigs are redacted. Civo: GET /v2/kubernetes/clusters.
Input Schema
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
},
"page": {
"description": "Page number, from 1.",
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"per_page": {
"description": "Items per page, 1-100 (Civo default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_get_kubernetes_cluster(cluster_id, region)
Fetch one Kubernetes cluster: status, readiness, conditions, version and available upgrade, pools and their instances, network, firewall, CNI and installed marketplace apps. The kubeconfig is redacted. Civo: GET /v2/kubernetes/clusters/{id}.
Input Schema
{
"type": "object",
"properties": {
"cluster_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The cluster's id (a UUID)."
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"cluster_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_networks(region)
List the private networks in a region: label, CIDR, whether it is the default network, status and nameservers. Civo: GET /v2/networks.
Input Schema
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_firewalls(region)
List the firewalls in a region with their network, rule count and how many instances, clusters and load balancers use each. Civo: GET /v2/firewalls.
Input Schema
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_firewall_rules(firewall_id, region)
List the rules of one firewall: protocol, port range, CIDRs, direction (ingress/egress), action (allow/deny) and label — the answer to 'what is exposed to the internet?'. Civo: GET /v2/firewalls/{id}/rules.
Input Schema
{
"type": "object",
"properties": {
"firewall_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The firewall's id (a UUID)."
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"firewall_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_load_balancers(region)
List the load balancers in a region: algorithm, backends (IP, protocol, source/target ports), public IP, state and the Kubernetes service each fronts. Civo: GET /v2/loadbalancers.
Input Schema
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_volumes(region)
List the block-storage volumes in a region: size, status, type, and the instance or cluster each is attached to (unattached volumes still bill). Civo: GET /v2/volumes.
Input Schema
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_databases(region, page, per_page)
List the managed databases (MySQL, PostgreSQL) in a region: software and version, size, nodes, IPs, port, network, firewall and status. Paginated: {page, per_page, pages, items}. Passwords are redacted. Civo: GET /v2/databases.
Input Schema
{
"type": "object",
"properties": {
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
},
"page": {
"description": "Page number, from 1.",
"type": "integer",
"minimum": 1,
"maximum": 10000
},
"per_page": {
"description": "Items per page, 1-100 (Civo default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_dns_domains
List the domains whose DNS Civo hosts for the account. Civo: GET /v2/dns.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢civo_list_dns_records(domain_id, type, name)
List the records of one hosted domain (name, type, value, priority, TTL), optionally filtered by type or name. Civo: GET /v2/dns/{domain_id}/records.
Input Schema
{
"type": "object",
"properties": {
"domain_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The DNS domain's id (a UUID)."
},
"type": {
"description": "Only records of this type.",
"type": "string",
"enum": [
"a",
"cname",
"mx",
"txt",
"srv",
"ns"
]
},
"name": {
"description": "Only records with this name (e.g. www, or @ for the apex).",
"type": "string",
"maxLength": 253
}
},
"required": [
"domain_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴civo_reboot_instance(instance_id, type, region)
Reboot one instance. `soft` (default) asks the OS to restart cleanly; `hard` cuts power and boots it again, like pulling the plug — use only when soft does not work. Causes brief downtime. Civo: POST /v2/instances/{id}/soft_reboots or /hard_reboots.
Input Schema
{
"type": "object",
"properties": {
"instance_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The instance's id (a UUID)."
},
"type": {
"description": "soft (default) or hard.",
"type": "string",
"enum": [
"soft",
"hard"
]
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"instance_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴civo_stop_instance(instance_id, region)
Power off one instance. Anything it serves goes offline until it is started again with civo_start_instance. A stopped instance is still billed. Civo: PUT /v2/instances/{id}/stop.
Input Schema
{
"type": "object",
"properties": {
"instance_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The instance's id (a UUID)."
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"instance_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴civo_start_instance(instance_id, region)
Boot a stopped instance. Undoes civo_stop_instance. Civo: PUT /v2/instances/{id}/start.
Input Schema
{
"type": "object",
"properties": {
"instance_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The instance's id (a UUID)."
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"instance_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴civo_set_instance_tags(instance_id, tags, region)
REPLACE the full tag list of one instance (tags are used for filtering and by load-balancer instance pools, so changing them can move an instance in or out of a pool). Pass the complete desired list; an empty list clears all tags. Civo: PUT /v2/instances/{id}/tags.
Input Schema
{
"type": "object",
"properties": {
"instance_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The instance's id (a UUID)."
},
"tags": {
"maxItems": 50,
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"pattern": "^[^\\s]+$"
},
"description": "The complete new tag list."
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"instance_id",
"tags"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴civo_create_firewall_rule(firewall_id, protocol, start_port, end_port, cidr, ...)
Add one rule to a firewall — e.g. allow TCP 443 ingress from 0.0.0.0/0. This changes what is reachable on every instance, cluster and load balancer using the firewall, so prefer narrow CIDRs. Undo by deleting the rule in the Civo dashboard or CLI. Civo: POST /v2/firewalls/{id}/rules.
Input Schema
{
"type": "object",
"properties": {
"firewall_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The firewall's id (a UUID)."
},
"protocol": {
"type": "string",
"enum": [
"tcp",
"udp",
"icmp"
],
"description": "tcp, udp or icmp."
},
"start_port": {
"description": "First port, e.g. \"443\". Required unless protocol is icmp.",
"type": "string",
"pattern": "^\\d{1,5}$"
},
"end_port": {
"description": "Last port of a range. Omit for a single port.",
"type": "string",
"pattern": "^\\d{1,5}$"
},
"cidr": {
"description": "Source (ingress) or destination (egress) CIDRs. Civo defaults to 0.0.0.0/0 — the whole internet.",
"minItems": 1,
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-fA-F:.]+\\/\\d{1,3}$"
}
},
"direction": {
"description": "ingress (default) or egress.",
"type": "string",
"enum": [
"ingress",
"egress"
]
},
"action": {
"description": "allow (default) or deny.",
"type": "string",
"enum": [
"allow",
"deny"
]
},
"label": {
"description": "A display name for the rule.",
"type": "string",
"maxLength": 100
},
"region": {
"description": "Region code, e.g. LON1, NYC1, FRA1, PHX1 (see civo_list_regions). Defaults to CIVO_REGION; Civo resources are regional, so pass the region the resource lives in.",
"type": "string",
"pattern": "^[A-Za-z0-9-]{2,32}$"
}
},
"required": [
"firewall_id",
"protocol"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴civo_create_dns_record(domain_id, type, name, value, priority, ...)
Add one record to a Civo-hosted domain. Live DNS changes propagate to the world; undo by deleting the record in the Civo dashboard or CLI. Civo: POST /v2/dns/{domain_id}/records.
Input Schema
{
"type": "object",
"properties": {
"domain_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,64}$",
"description": "The DNS domain's id (a UUID)."
},
"type": {
"type": "string",
"enum": [
"A",
"CNAME",
"MX",
"TXT",
"SRV",
"NS"
],
"description": "Record type."
},
"name": {
"type": "string",
"minLength": 1,
"maxLength": 253,
"description": "The subdomain part, e.g. www, or @ for the apex."
},
"value": {
"type": "string",
"minLength": 1,
"maxLength": 4096,
"description": "An IP address, hostname or text value."
},
"priority": {
"description": "Priority, for MX/SRV records (Civo default 10).",
"type": "integer",
"minimum": 0,
"maximum": 65535
},
"ttl": {
"description": "TTL in seconds; Civo's minimum and default is 600.",
"type": "integer",
"minimum": 600,
"maximum": 604800
}
},
"required": [
"domain_id",
"type",
"name",
"value"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence