letscloud-mcp-server by letscloud-community - MCP Server

🚀 LetsCloud MCP Server

🎯 MCP Server for Managing LetsCloud Infrastructure

The LetsCloud MCP Server allows you to manage your LetsCloud infrastructure through the MCP (Model Context Protocol), seamlessly integrating with Claude Desktop and other MCP clients.

⚡ Quick Start - Public Server (Recommended)

1. Get LetsCloud API Token

Access LetsCloud Dashboard
Go to API Keys → Create New Key
Copy the generated token

2. Configure Claude Desktop

{
  "mcpServers": {
    "letscloud": {
      "command": "wss://mcp.letscloud.io/mcp",
      "env": {
        "LETSCLOUD_API_TOKEN": "your-token-here"
      }
    }
  }
}

3. Test Connection

# Test via HTTP (optional)
curl -X POST -H "Content-Type: application/json" \
  https://mcp.letscloud.io/tools/list_servers \
  -d '{"letscloud_token": "your-token-here", "arguments": {}}'

🔧 HTTP Usage Examples

# List available tools
curl https://mcp.letscloud.io/tools

# Health check
curl https://mcp.letscloud.io/health

# Create server
curl -X POST -H "Content-Type: application/json" \
  https://mcp.letscloud.io/tools/create_server \
  -d '{
    "letscloud_token": "your-token-here",
    "arguments": {
      "label": "my-server",
      "plan_slug": "basic-1gb",
      "image_slug": "ubuntu-22-04",
      "location_slug": "nyc1"
    }
  }'

4. Start Using

Open Claude Desktop and type:

"Hello! Show me my current servers and help me manage my infrastructure."

🛠️ Available Tools (28 total)

🖥️ Server Management

Tool	Description	Usage Example
`list_servers`	List all servers	"Show me my servers"
`get_server`	Get server details	"Details of server 123"
`create_server`	Create new server	"Create an Ubuntu server"
`delete_server`	Delete server	"Delete server 123"
`reboot_server`	Reboot server	"Reboot server 123"
`start_server`	Start server	"Start server 123"
`shutdown_server`	Shutdown server	"Shutdown server 123"
`shutdown_instance`	Shutdown instance	"Shutdown instance ABC123"
`change_instance_plan`	Change instance plan	"Upgrade to 4GB RAM"

🔑 SSH Key Management

Tool	Description	Usage Example
`list_ssh_keys`	List SSH keys	"Show my SSH keys"
`get_ssh_key`	Get SSH key details	"Details of key 456"
`create_ssh_key`	Create new SSH key	"Create a new SSH key"
`delete_ssh_key`	Delete SSH key	"Delete key 456"
`delete_ssh_key_by_slug`	Delete key by slug	"Delete key 'dev-key'"

📸 Snapshot Management

Tool	Description	Usage Example
`create_snapshot`	Create snapshot	"Create a server snapshot"
`list_snapshots`	List snapshots	"Show my snapshots"
`get_snapshot`	Get snapshot details	"Details of snapshot 789"
`delete_snapshot`	Delete snapshot	"Delete snapshot 789"
`restore_snapshot`	Restore snapshot	"Restore snapshot 789"
`get_snapshot_status`	Snapshot status	"Status of snapshot ABC"
`update_snapshot_label`	Update label	"Rename the snapshot"
`delete_snapshot_by_slug`	Delete snapshot by slug	"Delete snapshot 'backup-2024'"

📊 Resource Information

Tool	Description	Usage Example
`list_plans`	List available plans	"Show available plans"
`list_images`	List available images	"Show available images"
`list_locations`	List locations	"Show locations"
`get_account_info`	Account information	"My account information"
`list_plans_by_location`	Plans by location	"Plans in São Paulo"
`list_images_by_location`	Images by location	"Images in Miami"

📖 Complete Documentation

For complete details of each tool, see:

🔍 Public Server Status

Check Status

# Health check
curl https://mcp.letscloud.io/health

# List available tools
curl https://mcp.letscloud.io/tools

Available Endpoints

🌐 WebSocket (Primary)

URL: wss://mcp.letscloud.io/mcp
Usage: Primary connection for Claude Desktop
Authentication: Multiple methods supported (see Security Guide)

🔧 HTTP API

List Tools: GET https://mcp.letscloud.io/tools
Call Tool: POST https://mcp.letscloud.io/tools/{tool_name}
Health Check: GET https://mcp.letscloud.io/health
Root: GET https://mcp.letscloud.io/

📚 Documentation

Swagger UI: https://mcp.letscloud.io/docs
ReDoc: https://mcp.letscloud.io/redoc

🔐 Public Server Security

SSL/TLS: Secure connection via wss://
Rate Limiting: 100 requests/minute per IP
Authentication: Multiple secure methods supported
Monitoring: 24/7 logs and alerts
Uptime: 99.9% guaranteed

Authentication Method

Environment Variable (Most Secure) - LETSCLOUD_API_TOKEN

The server uses environment variable authentication, following the DigitalOcean MCP standard.

💬 Usage Examples

Create Website

"I need a server for my e-commerce website"

Automatic Backup

"Create daily snapshots of my servers"

Monitoring

"Show me the status of all my servers"

📖 Detailed Guides

- Advanced configuration
- REST API for integration
- API reference
- Tools documentation in English
- Tools documentation in Portuguese

🏠 Local Installation (Optional)

If you prefer to install locally or for development:

Installation via pip

pip install letscloud-mcp-server

Local Configuration

{
  "mcpServers": {
    "letscloud-local": {
      "command": "python",
      "args": ["-m", "letscloud_mcp_server"],
      "env": {
        "LETSCLOUD_API_TOKEN": "your-token-here"
      }
    }
  }
}

✅ Note: Environment variable authentication is the recommended and most secure method.

🆘 Support

Support: letscloud.io/help
GitHub: github.com/letscloud-community

📄 License

MIT License - see for details.

🎯 Why Use the Public Server?

✅ Advantages

Instant Setup: Configure in 2 minutes
No Maintenance: Always updated and monitored
High Availability: 99.9% uptime guaranteed
Professional Security: Rate limiting and DDoS protection
Optimized Performance: Latency optimized for LetsCloud API
24/7 Support: Dedicated support team

🏠 Local Installation (When to use)

Development: Testing and development
Isolated Environment: Specific security requirements
Customization: Custom modifications
Offline: Use without internet (except LetsCloud API)

Recommendation: Use the public server for production and local installation only for development! 🚀

letscloud-community/letscloud-mcp-server