UpCloud MCP by usefulapi

Inspect servers, storage, networks, databases and billing, and start, stop or back up servers.

Sollte ich dies verwenden

Qualität und Sicherheit

A
Qualität der Beschreibung
100%
Vollständigkeit des Schemas
78%
Qualität der Benennung
79%
Risiko der Vergiftung
100%
Übereinstimmung der Berechtigungen
100%
Einhaltung des Protokolls
100%

Befunde (1)

  • LOWTool 'upcloud_list_kubernetes_clusters' name length outside 3-30 rangein upcloud_list_kubernetes_clusters

Basierend auf einer automatisierten Analyse der Tool-Definitionen und der Einhaltung des Protokolls.

Kontextkosten

~4,523Tokens (Tool-Definitionen)
~1.2 KBTypische Antwortgröße
Erhebliche Auswirkung auf die Aufmerksamkeit (3.53% von 128k Kontext)

Dies ist die ungefähre Anzahl der Tokens, die jedes Mal verbraucht werden, wenn die Tools des Servers in den Kontext eines Modells geladen werden. Höhere Werte verringern die Aufmerksamkeit, die für andere Aufgaben verfügbar ist.

Installieren

Installation mit einem Klick

Fügen Sie dies Ihrer Datei `claude_desktop_config.json` hinzu:

{
  "mcpServers": {
    "upcloud": {
      "url": "https://upcloud.usefulapi.io/mcp"
    }
  }
}

Remote-Endpunkte

https://upcloud.usefulapi.io/mcpstreamable-http

Was es kann

Tool-Inventar

Tools (22)

🟢 Nur lesen🟡 Schreiben🔴 Löschen⚪ Unbekannt
🟢upcloud_get_account

The calling account: username, remaining credits and resource limits (cores, memory, storage per tier, IPs, networks, managed services). A cheap way to confirm the token works. UpCloud: GET /1.3/account.

Eingabe-Schema

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

Available zones (data centres) with id (e.g. fi-hel1, de-fra1, us-chi1), description and whether they are public or private-cloud. Zone ids are used by every other resource. UpCloud: GET /1.3/zone.

Eingabe-Schema

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

Fixed-price server plans: name (e.g. 2xCPU-4GB), cores, memory, included storage size/tier and transfer, plus GPU model/amount for GPU plans. UpCloud: GET /1.3/plan.

Eingabe-Schema

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

The price list per zone in the account's currency: per-hour prices for plans, cores, memory, storage tiers, backups, IPv4 addresses and traffic. UpCloud: GET /1.3/price.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢upcloud_get_billing_summary(yearmonth, resource_id)

Billing summary for one month with per-resource details (servers, storages, managed databases, object storage, …: amount, hours, plan, zone, labels) and totals. Needs an account allowed to read billing. UpCloud: GET /1.3/account/billing/summary/{yearmonth}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "yearmonth": {
      "type": "string",
      "pattern": "^\\d{4}-(0[1-9]|1[0-2])$",
      "description": "The month, YYYY-MM, e.g. 2026-09."
    },
    "resource_id": {
      "description": "Only this resource: its UUID, or for IP addresses the address itself.",
      "type": "string",
      "pattern": "^[0-9a-fA-F:.\\-]{2,64}$"
    }
  },
  "required": [
    "yearmonth"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢upcloud_list_servers(state, search, tag, label, limit, ...)

Cloud servers on the account (summary: uuid, title, hostname, zone, plan, cores, memory, state, tags, labels). Filter by state, a free-text search (name, title, uuid, zone, IP, hostname, tag or template), tags or labels. Use upcloud_get_server for IPs and disks. UpCloud: GET /1.3/server.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "state": {
      "description": "Only servers in this state.",
      "type": "string",
      "enum": [
        "started",
        "stopped",
        "maintenance",
        "error"
      ]
    },
    "search": {
      "description": "Match by name, title, uuid, zone, IP address, hostname, tag name or template name.",
      "type": "string",
      "maxLength": 255
    },
    "tag": {
      "description": "Tag filter: `a,b` matches servers with ANY of the tags, `a:b` servers with ALL of them.",
      "type": "string",
      "maxLength": 255
    },
    "label": {
      "description": "Label filters: a key (`env`) or key=value (`env=prod`). Several are ANDed. Keys match case-insensitively.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255
      }
    },
    "limit": {
      "description": "Max servers to return (use with offset to page).",
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    },
    "offset": {
      "description": "Offset into the results (API default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢upcloud_get_server(server_uuid)

Full details of one server: state, plan, cores/memory, network interfaces and IP addresses, attached storage devices, firewall on/off, simple-backup schedule, labels, tags and remote-access settings. UpCloud: GET /1.3/server/{uuid}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "server_uuid": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "The server UUID."
    }
  },
  "required": [
    "server_uuid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢upcloud_list_storages(kind, label)

Storage devices: disks, backups, CD-ROM images and OS templates (uuid, title, type, tier, size GB, state, zone, labels). Narrow by `kind`: private (yours), public (UpCloud-provided), normal (disks), backup, cdrom, template or favorite. UpCloud: GET /1.3/storage[/{kind}].

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "kind": {
      "description": "Narrow the list. Omit for every accessible storage.",
      "type": "string",
      "enum": [
        "private",
        "public",
        "normal",
        "backup",
        "cdrom",
        "template",
        "favorite"
      ]
    },
    "label": {
      "description": "Label filters: a key (`env`) or key=value (`env=prod`). Several are ANDed. Keys match case-insensitively.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢upcloud_get_storage(storage_uuid)

Details of one storage: size, tier, state (e.g. online, backuping), encryption, the servers it is attached to, its backups and backup_rule. Poll this to follow a backup started with upcloud_create_storage_backup. UpCloud: GET /1.3/storage/{uuid}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "storage_uuid": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "The storage UUID."
    }
  },
  "required": [
    "storage_uuid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢upcloud_list_ip_addresses

Every IP address on the account: address, family (IPv4/IPv6), access (public/utility/private), the server it is assigned to, zone, PTR record, floating flag and release policy. UpCloud: GET /1.3/ip_address.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢upcloud_list_firewall_rules(server_uuid)

The firewall rules of one server in evaluation order (position, direction, action, family, protocol, address and port ranges, comment). Whether the firewall is enabled at all is the `firewall` field of upcloud_get_server. UpCloud: GET /1.3/server/{uuid}/firewall_rule.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "server_uuid": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "The server UUID."
    }
  },
  "required": [
    "server_uuid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢upcloud_list_networks(zone, label)

Networks visible to the account — public, utility and private SDN networks — with their IP subnets, DHCP settings, routes, attached servers and peerings. Optionally only one zone. UpCloud: GET /1.3/network/.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "zone": {
      "description": "Only networks in this zone, e.g. fi-hel1.",
      "type": "string",
      "pattern": "^[a-z0-9-]{2,40}$"
    },
    "label": {
      "description": "Label filters: a key (`env`) or key=value (`env=prod`). Several are ANDed. Keys match case-insensitively.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢upcloud_list_databases(limit, offset, label)

Managed Database services (PostgreSQL, MySQL, Valkey, OpenSearch): uuid, title, type, plan, zone, state, component hosts/ports, backups and labels. Note the response can include connection URIs with credentials. UpCloud: GET /1.3/database.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max entries to return, 0-100 (API default 10).",
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "offset": {
      "description": "Offset into the results (API default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "label": {
      "description": "Label filters: a key (`env`) or key=value (`env=prod`). Several are ANDed. Keys match case-insensitively.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢upcloud_list_load_balancers(limit, offset, label)

Managed Load Balancer services with their frontends, backends and members, networks, plan, zone, configured status and operational state. UpCloud: GET /1.3/load-balancer.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max entries to return, 0-100 (API default 10).",
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "offset": {
      "description": "Offset into the results (API default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "label": {
      "description": "Label filters: a key (`env`) or key=value (`env=prod`). Several are ANDed. Keys match case-insensitively.",
      "type": "array",
      "items": {
        "type": "string",
        "minLength": 1,
        "maxLength": 255
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢upcloud_list_kubernetes_clusters

Managed Kubernetes clusters: name, uuid, zone, plan, state, network/CIDR, control-plane IP filter, labels and node groups (plan, count, state). UpCloud: GET /1.3/kubernetes.

Eingabe-Schema

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢upcloud_list_object_storages(limit, offset, sort)

Managed Object Storage (S3-compatible) services: uuid, name, region, configured status and operational state, public/private endpoints, custom domains and labels. UpCloud: GET /1.3/object-storage-2.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max entries to return, 0-100 (API default 10).",
      "type": "integer",
      "minimum": 0,
      "maximum": 100
    },
    "offset": {
      "description": "Offset into the results (API default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "sort": {
      "description": "Order of results; prefix - for descending (API default -created_at).",
      "type": "string",
      "enum": [
        "created_at",
        "-created_at",
        "service_name",
        "-service_name",
        "operational_state",
        "-operational_state",
        "region_name",
        "-region_name"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🟢upcloud_list_audit_logs(limit, offset, action, origin, resource_type, ...)

Security audit trail of the account (up to 180 days): who did what to which resource, when, from which IP and via API or Hub. Filter by action, origin, resource type, time window or a keyword (UUID, username or IP). Returns total_count for paging. UpCloud: GET /1.3/audit-logs.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "limit": {
      "description": "Max entries to return, 0-200 (API default 50).",
      "type": "integer",
      "minimum": 0,
      "maximum": 200
    },
    "offset": {
      "description": "Offset into the results (API default 0).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "action": {
      "description": "Only this action.",
      "type": "string",
      "enum": [
        "create",
        "read",
        "update",
        "delete",
        "access-update",
        "attach",
        "detach",
        "login",
        "logout"
      ]
    },
    "origin": {
      "description": "Only this origin.",
      "type": "string",
      "enum": [
        "api",
        "gui",
        "upcloud_internal"
      ]
    },
    "resource_type": {
      "description": "Only this resource type (uks = Kubernetes).",
      "type": "string",
      "enum": [
        "account",
        "auth",
        "init-script",
        "managed-database",
        "managed-loadbalancer",
        "managed-loadbalancer-certificate-bundle",
        "managed-object-storage",
        "server",
        "ssh-key",
        "storage",
        "uks"
      ]
    },
    "created_after": {
      "description": "ISO timestamp, e.g. 2026-09-01T00:00:00Z (inclusive). Default 180 days ago.",
      "type": "string"
    },
    "created_before": {
      "description": "ISO timestamp (inclusive). Default now.",
      "type": "string"
    },
    "q": {
      "description": "Keyword: a resource UUID, account username or IP address.",
      "type": "string",
      "maxLength": 255
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴upcloud_start_server(server_uuid, start_type)

Start a stopped server (billing for a started server resumes). Fails with 409 if it is not stopped. `async` returns immediately — poll upcloud_get_server for state=started. UpCloud: POST /1.3/server/{uuid}/start.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "server_uuid": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "The server UUID."
    },
    "start_type": {
      "description": "sync (default) waits for the start; async returns at once.",
      "type": "string",
      "enum": [
        "sync",
        "async"
      ]
    }
  },
  "required": [
    "server_uuid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴upcloud_stop_server(server_uuid, stop_type, timeout)

DISRUPTIVE: stop a running server — it goes offline until started again with upcloud_start_server. soft (default) sends an ACPI shutdown; with a timeout, a hard stop follows if it is still running. hard is like pulling the plug and can lose unsaved data. UpCloud: POST /1.3/server/{uuid}/stop.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "server_uuid": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "The server UUID."
    },
    "stop_type": {
      "description": "soft = ACPI shutdown signal (default); hard = equivalent of pulling the power cable.",
      "type": "string",
      "enum": [
        "soft",
        "hard"
      ]
    },
    "timeout": {
      "description": "Soft-stop timeout in seconds, 1-600.",
      "type": "integer",
      "minimum": 1,
      "maximum": 600
    }
  },
  "required": [
    "server_uuid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴upcloud_restart_server(server_uuid, stop_type, timeout, timeout_action)

DISRUPTIVE: stop and start a running server. soft (default) needs a timeout: after it, timeout_action=destroy hard-stops and restarts, ignore (API default) aborts and leaves the server running. hard power-cycles immediately. UpCloud: POST /1.3/server/{uuid}/restart.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "server_uuid": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "The server UUID."
    },
    "stop_type": {
      "description": "soft = ACPI shutdown signal (default); hard = equivalent of pulling the power cable.",
      "type": "string",
      "enum": [
        "soft",
        "hard"
      ]
    },
    "timeout": {
      "description": "Soft-stop timeout in seconds, 1-600. Required for a soft restart.",
      "type": "integer",
      "minimum": 1,
      "maximum": 600
    },
    "timeout_action": {
      "description": "What to do if the soft stop times out: destroy (hard stop, then start) or ignore (give up).",
      "type": "string",
      "enum": [
        "destroy",
        "ignore"
      ]
    }
  },
  "required": [
    "server_uuid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴upcloud_create_storage_backup(storage_uuid, title)

Take an on-demand, point-in-time backup of a storage device. Additive (nothing is overwritten) but backups are billed per GB. Asynchronous: the storage goes to a backuping/maintenance state and back to online — poll upcloud_get_storage. UpCloud: POST /1.3/storage/{uuid}/backup.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "storage_uuid": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "The storage UUID."
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "maxLength": 255,
      "description": "A short description for the backup, 1-255 characters."
    }
  },
  "required": [
    "storage_uuid",
    "title"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}
🔴upcloud_modify_server(server_uuid, title, hostname, simple_backup)

Change a server's title, hostname and/or simple-backup schedule. Only these reversible fields are exposed — no resizing or plan change (billing) and no firewall toggle. simple_backup is `HHMM,daily|dailies|weeklies|monthlies` (UTC time) or `no` to disable. UpCloud: PUT /1.3/server/{uuid}.

Eingabe-Schema

{
  "type": "object",
  "properties": {
    "server_uuid": {
      "type": "string",
      "pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$",
      "description": "The server UUID."
    },
    "title": {
      "description": "A short informational description, 0-255 characters.",
      "type": "string",
      "maxLength": 255
    },
    "hostname": {
      "description": "A valid hostname, e.g. web1.example.com (max 128).",
      "type": "string",
      "maxLength": 128,
      "pattern": "^[A-Za-z0-9.-]+$"
    },
    "simple_backup": {
      "description": "e.g. 0430,dailies — or `no` to turn simple backups off.",
      "type": "string",
      "pattern": "^(no|([01]\\d|2[0-3])[0-5]\\d,(daily|dailies|weeklies|monthlies))$"
    }
  },
  "required": [
    "server_uuid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Community

Diesen Server bewerten

Nachweis

Aktuelle Beobachtungen

verifiziertVersion nicht aufgezeichnet22 Tools
verifiziertVersion nicht aufgezeichnet22 Tools
verifiziertVersion nicht aufgezeichnet22 Tools
verifiziertVersion nicht aufgezeichnet22 Tools