civo
List Civo instances, Kubernetes clusters, networks and DNS; reboot instances, add rules.
使うべきか
品質と安全性
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"civo": {
"url": "https://civo.usefulapi.io/mcp"
}
}
}リモートエンドポイント
https://civo.usefulapi.io/mcpstreamable-httpできること
ツール一覧
ツール（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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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.
入力スキーマ
{
"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}.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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.
入力スキーマ
{
"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"
}コミュニティ
エビデンス