Skip to main content

​
MCP Server

The CloudBlast MCP (Model Context Protocol) server lets AI assistants manage your cloud infrastructure directly. Create servers, configure firewalls, manage backups, and more — all through natural language.

Claude Desktop

Use CloudBlast tools directly in Claude Desktop conversations.

Cursor & Windsurf

Manage infrastructure from your AI-powered code editor.

Claude Code

Full server management from the Claude Code CLI.

Any MCP Client

Works with any client that supports the Model Context Protocol.

​
Connection Options

There are two ways to connect. Both require a CloudBlast API token — get yours from Account Settings.

Hosted Server (recommended)

Nothing to install. Connect any remote-capable MCP client to https://mcp.cloudblast.io and authenticate with your API token.

Local via npm

Run the server locally with npx @cloudblast/mcp-server over stdio. Works with every MCP client.

​
Hosted Server

The hosted server supports both remote MCP transports:
TransportEndpoint
Streamable HTTP (recommended)https://mcp.cloudblast.io/mcp
SSE (legacy)https://mcp.cloudblast.io/sse
Authenticate every request with your API token in a header — either Authorization: Bearer <token> or X-API-Key: <token>.

​
Claude Code

claude mcp add --transport http cloudblast https://mcp.cloudblast.io/mcp --header "Authorization: Bearer your-api-token"
Or with the legacy SSE transport: 
claude mcp add --transport sse cloudblast https://mcp.cloudblast.io/sse --header "Authorization: Bearer your-api-token"

​
Cursor

Add this to .cursor/mcp.json: 
{
  "mcpServers": {
    "cloudblast": {
      "url": "https://mcp.cloudblast.io/mcp",
      "headers": {
        "Authorization": "Bearer your-api-token"
      }
    }
  }
}

​
Other Remote Clients

Any client that supports remote MCP servers can connect with a config like: 
{
  "mcpServers": {
    "cloudblast": {
      "type": "http",
      "url": "https://mcp.cloudblast.io/mcp",
      "headers": {
        "Authorization": "Bearer your-api-token"
      }
    }
  }
}
If your client only supports the older SSE transport, use "type": "sse" with https://mcp.cloudblast.io/sse instead.

​
Local Installation (npm)

Install the MCP server from npm: 
npm install -g @cloudblast/mcp-server
Or run directly with npx (no install needed): 
npx @cloudblast/mcp-server

​
Configuration

The local server reads these environment variables:
VariableRequiredDescription
CLOUDBLAST_API_TOKENYesYour CloudBlast API token
CLOUDBLAST_API_URLNoAPI base URL (default: https://console.cloudblast.io/api/v2)

​
Claude Desktop

Add this to your Claude Desktop config file:
  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "cloudblast": {
      "command": "npx",
      "args": ["-y", "@cloudblast/mcp-server"],
      "env": {
        "CLOUDBLAST_API_TOKEN": "your-api-token"
      }
    }
  }
}

​
Cursor

Add this to your Cursor MCP settings (.cursor/mcp.json): 
{
  "mcpServers": {
    "cloudblast": {
      "command": "npx",
      "args": ["-y", "@cloudblast/mcp-server"],
      "env": {
        "CLOUDBLAST_API_TOKEN": "your-api-token"
      }
    }
  }
}

​
Claude Code

Run this command to add the MCP server to Claude Code: 
claude mcp add cloudblast -- npx -y @cloudblast/mcp-server
Then set your API token as an environment variable: 
export CLOUDBLAST_API_TOKEN=your-api-token

​
Available Tools

Once connected, your AI assistant will have access to the following tools:

​
Account

ToolDescription
get_accountGet account info (name, email, credit balance, resource limits)
get_account_usageGet resource usage across all servers vs your limits
list_invoicesList invoices (paginated)

​
Plans & Locations

ToolDescription
list_plansList available server plans with pricing and specs
list_locationsList all available data center locations
list_location_templatesList OS templates for a location

​
SSH Keys

ToolDescription
list_ssh_keysList all SSH keys on your account
create_ssh_keyAdd an SSH public key
delete_ssh_keyRemove an SSH key

​
Servers

ToolDescription
list_serversList servers (paginated, filterable by status)
create_serverCreate a new server
get_serverGet full server details including root password
delete_serverPermanently delete a server
server_power_actionPower actions (start, shutdown, restart, reset, kill, suspend, resume)
get_server_statusReal-time hypervisor status
reinstall_serverReinstall with a new OS template
rename_serverRename a server

​
Server IPs

ToolDescription
list_server_ipsList all IPs assigned to a server
add_server_ipsAllocate additional IPs
remove_server_ipRemove a secondary IP
set_rdnsSet reverse DNS for an IP

​
Backups

ToolDescription
list_backupsList backups for a server
create_backupCreate a backup (snapshot, suspend, or kill mode)
restore_backupRestore a server from a backup
delete_backupDelete a backup

​
Security Groups (Firewall)

ToolDescription
list_security_groupsList all security groups
create_security_groupCreate a new security group
get_security_groupGet a security group with rules and attached servers
delete_security_groupDelete a security group
create_firewall_ruleAdd a firewall rule
delete_firewall_ruleRemove a firewall rule
attach_server_to_security_groupAttach a server to a security group
detach_server_from_security_groupDetach a server from a security group

​
Example Prompts

Once the MCP server is connected, you can ask your AI assistant things like:
  • “List all my servers and their status”
  • “Create a new Ubuntu 24.04 server in the US location”
  • “Take a backup of server abc12345”
  • “Add a firewall rule to allow SSH (port 22) on my web security group”
  • “What’s my current resource usage?”
  • “Restart server abc12345”