civo
List Civo instances, Kubernetes clusters, networks and DNS; reboot instances, add rules.
¿Debería usar esto?
Calidad y seguridad
Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.
Costo de contexto
Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.
Instalar
Instalación con un clic
Agrega esto a tu archivo `claude_desktop_config.json`:
{
"mcpServers": {
"civo": {
"url": "https://civo.usefulapi.io/mcp"
}
}
}Puntos de conexión remotos
https://civo.usefulapi.io/mcpstreamable-httpQué puede hacer
Inventario de herramientas
Herramientas (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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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}.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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.
Esquema de entrada
{
"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"
}Comunidad
Evidencia