v1.x · runningREMOTE MCP

LetsCloud MCP Server

Remote Model Context Protocol server + REST API to manage LetsCloud infrastructure directly from AI assistants like Claude, Cursor, Windsurf, VS Code Copilot and any MCP-compatible client.

Connect an MCP client

The LetsCloud MCP Server is a remote, HTTP-based MCP server. Pick your client below and follow the step-by-step guide. In every case you will need your LetsCloud API key — generate one in the LetsCloud panel (Account → API).
Generic config
{
  "mcpServers": {
    "letscloud": {
      "url": "https://mcp.letscloud.io",
      "headers": {
        "Authorization": "Bearer YOUR_LETSCLOUD_API_KEY"
      }
    }
  }
}

Requires VS Code 1.102+ with GitHub Copilot Chat.

⚑ One-click install

Install in VS Code Β  Install in VS Code Insiders

After clicking, VS Code prompts you to confirm. Then open the generated mcp.json and add your Authorization header.

⌨️ One-line CLI install

code --add-mcp '{"name":"letscloud","type":"http","url":"https://mcp.letscloud.io","headers":{"Authorization":"Bearer YOUR_LETSCLOUD_API_KEY"}}'

πŸ› οΈ Manual setup

  1. Open Command Palette: Ctrl+Shift+P (macOS: ⌘+Shift+P)
  2. Run MCP: Add Server… β†’ choose HTTP (server-sent events)
  3. Server URL: https://mcp.letscloud.io
  4. Server ID / name: letscloud
  5. Choose User Settings (global) or Workspace
  6. Open generated mcp.json and add the Authorization header:
    {
      "servers": {
        "letscloud": {
          "type": "http",
          "url": "https://mcp.letscloud.io",
          "headers": {
            "Authorization": "Bearer YOUR_LETSCLOUD_API_KEY"
          }
        }
      }
    }
  7. Open Copilot Chat β†’ switch to Agent mode β†’ click πŸ› οΈ tools icon β†’ confirm letscloud tools enabled β†’ try: “List my LetsCloud servers.”

Tip: you can also edit .vscode/mcp.json by hand to share the config with your team.

  1. Open Claude Desktop β†’ Settings β†’ Developer β†’ Edit Config
  2. Opens claude_desktop_config.json:
    • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
    • Windows: %APPDATA%\Claude\claude_desktop_config.json
  3. Add the entry under mcpServers:
    {
      "mcpServers": {
        "letscloud": {
          "url": "https://mcp.letscloud.io",
          "headers": {
            "Authorization": "Bearer YOUR_LETSCLOUD_API_KEY"
          }
        }
      }
    }
  4. Save and fully quit and restart Claude Desktop
  5. Open a new chat β†’ click the πŸ”Œ plug icon β†’ confirm letscloud is connected
  6. Try: “Show my LetsCloud account balance.”
  1. Open Cursor β†’ Settings β†’ Cursor Settings β†’ MCP (or edit ~/.cursor/mcp.json)
  2. Click + Add new MCP server
  3. Paste:
    {
      "mcpServers": {
        "letscloud": {
          "url": "https://mcp.letscloud.io",
          "headers": {
            "Authorization": "Bearer YOUR_LETSCLOUD_API_KEY"
          }
        }
      }
    }
  4. Save β€” the status indicator next to letscloud turns green
  5. Open Composer / Chat in Agent mode β†’ try: “List my LetsCloud snapshots.”
  1. Open Windsurf β†’ Settings β†’ Cascade β†’ MCP servers β†’ Add custom server
  2. Or edit ~/.codeium/windsurf/mcp_config.json:
    {
      "mcpServers": {
        "letscloud": {
          "serverUrl": "https://mcp.letscloud.io",
          "headers": {
            "Authorization": "Bearer YOUR_LETSCLOUD_API_KEY"
          }
        }
      }
    }

    Note: Windsurf uses serverUrl, not url.

  3. Click Refresh in the MCP panel
  4. Open Cascade chat β†’ try: “Reboot my server web-prod-01.”
  1. Open Continue β†’ gear βš™ β†’ Open config
  2. Edit ~/.continue/config.yaml and add:
    mcpServers:
      - name: letscloud
        url: https://mcp.letscloud.io
        headers:
          Authorization: Bearer YOUR_LETSCLOUD_API_KEY

    Note: YAML format, not JSON.

  3. Save β€” Continue auto-reloads
  4. In chat, type @letscloud to invoke any tool

Most MCP-compatible clients accept the generic snippet at the top of this section. To verify the server is reachable end-to-end:

curl -H "Authorization: Bearer YOUR_LETSCLOUD_API_KEY" \
     https://mcp.letscloud.io/api/v1/account

You should receive a JSON payload with your LetsCloud profile.

⚑ Try it from curl

curl -H "Authorization: Bearer YOUR_LETSCLOUD_API_KEY" \
     https://mcp.letscloud.io/api/v1/account

πŸ€– Talk to your cloud β€” prompt examples

Once connected, just chat with the AI in plain English (or Portuguese). The assistant picks the right tool, asks for confirmation when needed, and executes against your LetsCloud account.

πŸ“Š Inventory & billing
  • "List all my LetsCloud servers and their status."
  • "Which instances are powered off right now?"
  • "Show my account balance and current plan."
πŸš€ Provisioning
  • "Create a 2 GB Ubuntu 22.04 VPS in Miami called web-prod-01."
  • "Spin up 3 Debian 12 servers in SΓ£o Paulo with my SSH key laptop."
  • "What plans are available in the Brazil region?"
βš™οΈ Lifecycle ops
  • "Reboot the server web-prod-01."
  • "Shutdown every server whose name starts with staging."
  • "Reset the root password of db-01."
πŸ’Ύ Snapshots & backups
  • "Take a snapshot of db-01 called pre-upgrade."
  • "List all snapshots older than 30 days."
  • "Rename the snapshot snap-12 to weekly-backup."
πŸ”‘ SSH keys
  • "Add this public key to my account as laptop-2026."
  • "Which servers were created with my laptop key?"
  • "Delete the SSH key old-macbook."
🧹 Cleanup & cost saving
  • "Find shutdown servers I haven't powered on in 14 days."
  • "Estimate my monthly spend if I delete every staging-*."
  • "Snapshot test-vm-07, then delete the server."