@cloudblast/mcp-server

MCP (Model Context Protocol) server for the CloudBlast API v2. Manage KVM virtual servers, backups, IPs, security groups, and more — directly from any MCP-compatible client like Claude Desktop, Cursor, or Claude Code.

Quick Start

Using npx (recommended)

{
  "mcpServers": {
    "cloudblast": {
      "command": "npx",
      "args": ["-y", "@cloudblast/mcp-server"],
      "env": {
        "CLOUDBLAST_API_TOKEN": "your-api-token"
      }
    }
  }
}

Global install

npm install -g @cloudblast/mcp-server

Then run:

CLOUDBLAST_API_TOKEN=your-api-token cloudblast-mcp

Configuration

| Variable | Required | Description | |---|---|---| | CLOUDBLAST_API_TOKEN | Yes | Your CloudBlast API token | | CLOUDBLAST_API_URL | No | API base URL (default: https://console.cloudblast.io/api/v2) |

Available Tools

Account

• get_account — Get account info (name, email, credit balance, resource limits)
• get_account_usage — Get resource usage across all servers vs your limits
• list_invoices — List invoices (paginated)

Plans & Locations

• list_plans — List available server plans with pricing and specs
• list_locations — List all available data center locations
• list_location_templates — List OS templates for a location

SSH Keys

• list_ssh_keys — List all SSH keys on your account
• create_ssh_key — Add an SSH public key
• delete_ssh_key — Remove an SSH key

Servers

• list_servers — List servers (paginated, filterable by status)
• create_server — Create a new server
• get_server — Get full server details
• delete_server — Permanently delete a server
• server_power_action — Power actions (start, shutdown, restart, reset, kill, suspend, resume)
• get_server_status — Real-time hypervisor status
• reinstall_server — Reinstall with a new OS template
• rename_server — Rename a server

Server IPs

• list_server_ips — List all IPs assigned to a server
• add_server_ips — Allocate additional IPs
• remove_server_ip — Remove a secondary IP
• set_rdns — Set reverse DNS for an IP

Backups

• list_backups — List backups for a server
• create_backup — Create a backup (snapshot, suspend, or kill mode)
• restore_backup — Restore a server from a backup
• delete_backup — Delete a backup

Security Groups (Firewall)

• list_security_groups — List all security groups
• create_security_group — Create a new security group
• get_security_group — Get a security group with rules and attached servers
• delete_security_group — Delete a security group
• create_firewall_rule — Add a firewall rule
• delete_firewall_rule — Remove a firewall rule
• attach_server_to_security_group — Attach a server to a security group
• detach_server_from_security_group — Detach a server from a security group

License

MIT