The server marks this tool destructive: it may delete or overwrite data

civo_create_dns_record

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.

destructive

Argument	Type	Description
ttl	integer	TTL in seconds; Civo's minimum and default is 600.
name*	string	The subdomain part, e.g. www, or @ for the apex.
type*	string	Record type.
value*	string	An IP address, hostname or text value.
priority	integer	Priority, for MX/SRV records (Civo default 10).
domain_id*	string	The DNS domain's id (a UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "domain_id",
    "type",
    "name",
    "value"
  ],
  "properties": {
    "ttl": {
      "type": "integer",
      "maximum": 604800,
      "minimum": 600,
      "description": "TTL in seconds; Civo's minimum and default is 600."
    },
    "name": {
      "type": "string",
      "maxLength": 253,
      "minLength": 1,
      "description": "The subdomain part, e.g. www, or @ for the apex."
    },
    "type": {
      "enum": [
        "A",
        "CNAME",
        "MX",
        "TXT",
        "SRV",
        "NS"
      ],
      "type": "string",
      "description": "Record type."
    },
    "value": {
      "type": "string",
      "maxLength": 4096,
      "minLength": 1,
      "description": "An IP address, hostname or text value."
    },
    "priority": {
      "type": "integer",
      "maximum": 65535,
      "minimum": 0,
      "description": "Priority, for MX/SRV records (Civo default 10)."
    },
    "domain_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The DNS domain's id (a UUID)."
    }
  }
}

civo_create_firewall_rule

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.

destructive

Argument	Type	Description
cidr	array	Source (ingress) or destination (egress) CIDRs. Civo defaults to 0.0.0.0/0 — the whole internet.
label	string	A display name for the rule.
action	string	allow (default) or deny.
region	string	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.
end_port	string	Last port of a range. Omit for a single port.
protocol*	string	tcp, udp or icmp.
direction	string	ingress (default) or egress.
start_port	string	First port, e.g. "443". Required unless protocol is icmp.

civo_get_instance

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}.

read-only

Argument	Type	Description
region	string	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.
instance_id*	string	The instance's id (a UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "instance_id"
  ],
  "properties": {
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The instance's id (a UUID)."
    }
  }
}

civo_get_kubernetes_cluster

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}.

read-only

Argument	Type	Description
region	string	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.
cluster_id*	string	The cluster's id (a UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "cluster_id"
  ],
  "properties": {
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    },
    "cluster_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The cluster's id (a UUID)."
    }
  }
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

civo_list_charges

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.

read-only

Argument	Type	Description
to	string	End, RFC 3339. Defaults to now. At most 31 days after `from`.
from	string	Start, RFC 3339 (e.g. 2026-09-01T00:00:00Z). Defaults to the start of this month.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "to": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})$",
      "description": "End, RFC 3339. Defaults to now. At most 31 days after `from`."
    },
    "from": {
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}T\\d{2}:\\d{2}:\\d{2}(\\.\\d+)?(Z|[+-]\\d{2}:\\d{2})$",
      "description": "Start, RFC 3339 (e.g. 2026-09-01T00:00:00Z). Defaults to the start of this month."
    }
  }
}

civo_list_databases

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1.
region	string	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.
per_page	integer	Items per page, 1-100 (Civo default 20).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 1,
      "description": "Page number, from 1."
    },
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page, 1-100 (Civo default 20)."
    }
  }
}

civo_list_dns_domains

List the domains whose DNS Civo hosts for the account. Civo: GET /v2/dns.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

civo_list_dns_records

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.

read-only

Argument	Type	Description
name	string	Only records with this name (e.g. www, or @ for the apex).
type	string	Only records of this type.
domain_id*	string	The DNS domain's id (a UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "domain_id"
  ],
  "properties": {
    "name": {
      "type": "string",
      "maxLength": 253,
      "description": "Only records with this name (e.g. www, or @ for the apex)."
    },
    "type": {
      "enum": [
        "a",
        "cname",
        "mx",
        "txt",
        "srv",
        "ns"
      ],
      "type": "string",
      "description": "Only records of this type."
    },
    "domain_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The DNS domain's id (a UUID)."
    }
  }
}

civo_list_firewall_rules

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.

read-only

Argument	Type	Description
region	string	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.
firewall_id*	string	The firewall's id (a UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "firewall_id"
  ],
  "properties": {
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    },
    "firewall_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The firewall's id (a UUID)."
    }
  }
}

civo_list_firewalls

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.

read-only

Argument	Type	Description
region	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    }
  }
}

civo_list_instance_sizes

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.

read-only

Argument	Type	Description
region	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    }
  }
}

civo_list_instances

List compute instances in a region, optionally filtered by tags. Paginated: returns {page, per_page, pages, items}. Passwords are redacted. Civo: GET /v2/instances.

read-only

Argument	Type	Description
page	integer	Page number, from 1.
tags	array	Only instances carrying these tags.
region	string	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.
per_page	integer	Items per page, 1-100 (Civo default 20).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 1,
      "description": "Page number, from 1."
    },
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[^\\s]+$"
      },
      "description": "Only instances carrying these tags."
    },
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page, 1-100 (Civo default 20)."
    }
  }
}

civo_list_kubernetes_clusters

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.

read-only

Argument	Type	Description
page	integer	Page number, from 1.
region	string	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.
per_page	integer	Items per page, 1-100 (Civo default 20).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 1,
      "description": "Page number, from 1."
    },
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    },
    "per_page": {
      "type": "integer",
      "maximum": 100,
      "minimum": 1,
      "description": "Items per page, 1-100 (Civo default 20)."
    }
  }
}

civo_list_load_balancers

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.

read-only

Argument	Type	Description
region	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    }
  }
}

civo_list_networks

List the private networks in a region: label, CIDR, whether it is the default network, status and nameservers. Civo: GET /v2/networks.

read-only

Argument	Type	Description
region	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    }
  }
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

civo_list_volumes

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.

read-only

Argument	Type	Description
region	string	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.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    }
  }
}

civo_reboot_instance

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.

destructive

Argument	Type	Description
type	string	soft (default) or hard.
region	string	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.
instance_id*	string	The instance's id (a UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "instance_id"
  ],
  "properties": {
    "type": {
      "enum": [
        "soft",
        "hard"
      ],
      "type": "string",
      "description": "soft (default) or hard."
    },
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The instance's id (a UUID)."
    }
  }
}

civo_set_instance_tags

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.

destructive

Argument	Type	Description
tags*	array	The complete new tag list.
region	string	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.
instance_id*	string	The instance's id (a UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "instance_id",
    "tags"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^[^\\s]+$",
        "minLength": 1
      },
      "maxItems": 50,
      "description": "The complete new tag list."
    },
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The instance's id (a UUID)."
    }
  }
}

civo_start_instance

Boot a stopped instance. Undoes civo_stop_instance. Civo: PUT /v2/instances/{id}/start.

destructive

Argument	Type	Description
region	string	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.
instance_id*	string	The instance's id (a UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "instance_id"
  ],
  "properties": {
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The instance's id (a UUID)."
    }
  }
}

civo_stop_instance

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.

destructive

Argument	Type	Description
region	string	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.
instance_id*	string	The instance's id (a UUID).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "instance_id"
  ],
  "properties": {
    "region": {
      "type": "string",
      "pattern": "^[A-Za-z0-9-]{2,32}$",
      "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."
    },
    "instance_id": {
      "type": "string",
      "pattern": "^[A-Za-z0-9_-]{1,64}$",
      "description": "The instance's id (a UUID)."
    }
  }
}

Civo MCP by usefulapi

Try it

civo_create_dns_record Destructive

Civo MCP by usefulapi

Try it

civo_create_dns_record Destructive

Tools (22)