> ## Documentation Index
> Fetch the complete documentation index at: https://docs.cloudblast.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Getting Started

> Control CloudBlast from AI assistants like Claude, Cursor, and Windsurf

# 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.

<CardGroup cols={2}>
  <Card title="Claude Desktop" icon="message-bot">
    Use CloudBlast tools directly in Claude Desktop conversations.
  </Card>

  <Card title="Cursor & Windsurf" icon="code">
    Manage infrastructure from your AI-powered code editor.
  </Card>

  <Card title="Claude Code" icon="terminal">
    Full server management from the Claude Code CLI.
  </Card>

  <Card title="Any MCP Client" icon="plug">
    Works with any client that supports the Model Context Protocol.
  </Card>
</CardGroup>

## Connection Options

There are two ways to connect. Both require a CloudBlast API token — get yours from [Account Settings](https://console.cloudblast.io/settings/api).

<CardGroup cols={2}>
  <Card title="Hosted Server (recommended)" icon="cloud">
    Nothing to install. Connect any remote-capable MCP client to `https://mcp.cloudblast.io` and authenticate with your API token.
  </Card>

  <Card title="Local via npm" icon="box">
    Run the server locally with `npx @cloudblast/mcp-server` over stdio. Works with every MCP client.
  </Card>
</CardGroup>

## Hosted Server

The hosted server supports both remote MCP transports:

| Transport                     | Endpoint                        |
| ----------------------------- | ------------------------------- |
| 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

```bash theme={null}
claude mcp add --transport http cloudblast https://mcp.cloudblast.io/mcp --header "Authorization: Bearer your-api-token"
```

Or with the legacy SSE transport:

```bash theme={null}
claude mcp add --transport sse cloudblast https://mcp.cloudblast.io/sse --header "Authorization: Bearer your-api-token"
```

### Cursor

Add this to `.cursor/mcp.json`:

```json theme={null}
{
  "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:

```json theme={null}
{
  "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:

```bash theme={null}
npm install -g @cloudblast/mcp-server
```

Or run directly with npx (no install needed):

```bash theme={null}
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`

```json theme={null}
{
  "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`):

```json theme={null}
{
  "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:

```bash theme={null}
claude mcp add cloudblast -- npx -y @cloudblast/mcp-server
```

Then set your API token as an environment variable:

```bash theme={null}
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"*