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 the modern Streamable HTTP transport:

Transport	Endpoint
Streamable HTTP	`https://mcp.cloudblast.io/mcp`

Authenticate every request with your API token in a header — either Authorization: Bearer <token> or X-API-Key: <token>. If your client only supports the legacy SSE transport, use the local npm install over stdio instead.

Claude Code

claude mcp add --transport http cloudblast https://mcp.cloudblast.io/mcp --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 the local npm install over stdio 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:

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`)

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

Tool	Description
`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

Tool	Description
`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

Tool	Description
`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

Tool	Description
`list_servers`	List servers (paginated, filterable by status)
`create_server`	Create a new server
`get_server`	Get full server details including root password
`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

Tool	Description
`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

Tool	Description
`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)

Tool	Description
`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

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”

​MCP Server

Claude Desktop

Cursor & Windsurf

Claude Code

Any MCP Client

​Connection Options

Hosted Server (recommended)

Local via npm

​Hosted Server

​Claude Code

​Cursor

​Other Remote Clients

​Local Installation (npm)

​Configuration

​Claude Desktop

​Cursor

​Claude Code

​Available Tools

​Account

​Plans & Locations

​SSH Keys

​Servers

​Server IPs

​Backups

​Security Groups (Firewall)

​Example Prompts

MCP Server

Connection Options

Hosted Server

Claude Code

Cursor

Other Remote Clients

Local Installation (npm)

Configuration

Claude Desktop

Cursor

Claude Code

Available Tools

Account

Plans & Locations

SSH Keys

Servers

Server IPs

Backups

Security Groups (Firewall)

Example Prompts