LetsCloud MCP Server

by letscloud-community

Not rated
GitHub

About

Manage LetsCloud infrastructure through natural language conversations. Supports both English and Portuguese.

Details

Author
letscloud-community
Categories
Cloud Service, Infrastructure

Setup

Install LetsCloud MCP Server in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/letscloud-community/letscloud-mcp-server

Follow the installation instructions in the repository README, then restart your MCP client.

Manage LetsCloud infrastructure through natural language conversations. Supports both English and Portuguese.

Remote MCP server + REST API to manageLetsCloudinfrastructure with AI assistants.

This project exposes LetsCloud's cloud platform through theModel Context Protocol (MCP)so AI assistants likeClaude,Cursor,Windsurf,VS Code Copilot, and any MCP-compatible client can create and manage servers, snapshots and SSH keys on behalf of the user.

Unlike "local" MCP servers,this is a hosted service: any LetsCloud customer can connect by providing their API key β€”no installation required on the client side.

The same backend also exposes a cleanREST APIunder/api/v1for plain HTTP integrations (curl, scripts, automations).

- πŸ”ŒNative MCP transport(Streamable HTTP) at/mcp
- 🌐REST APIat/api/v1mirroring every MCP tool
- πŸ”‘Per-request authenticationviaAuthorization: Bearer <api-key>
- πŸ“¦ Full coverage of the LetsCloud API β€” instances, SSH keys, snapshots, plans, images, locations, account
- ⚑ Async, fast and lightweight (FastAPI + httpx + official MCP SDK)
- 🐳 Docker-ready
- πŸ“ Auto-generated OpenAPI docs at/docs

β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” Authorization: Bearer <api-key> β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ AI client (MCP) β”‚ ───────────────────────────────────────► β”‚ mcp.letscloud.io/mcp β”‚ β”‚ Claude, Cursor… β”‚ β”‚ (this server) β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”¬β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜ β”‚ api-token: <key> β–Ό β”Œβ”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β” β”‚ core.letscloud.io/api β”‚ β””β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”€β”˜

The user's API key never leaves the request: the server just relays it to the LetsCloud upstream and returns the response. The server itself stores no credentials.

Generate an API key in theLetsCloud dashboard.

Claude Desktop / Cursor / Windsurf (remote MCP)

{ "mcpServers": { "letscloud": { "url": "https://mcp.letscloud.io/mcp", "headers": { "Authorization": "Bearer YOUR_LETSCLOUD_API_KEY" } } } }

Note: the exact field names may differ slightly between clients (some usetransport: "streamable-http", others auto-detect). Check your client's docs for "remote MCP server".

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

Full interactive docs (with request/response schemas) are available at/docs.

This project ships as ahosted serviceathttps://mcp.letscloud.io, operated by the LetsCloud team. As an end user you only need your LetsCloud API key β€” there isnothing to install locally.

If you want to run yourown private instance(corporate VPC, offline tests, contributions), seeDEPLOY.mdfor a one-command Docker or Python setup.

Every request to/mcpand/api/v1/*must carry the user's LetsCloud API key inoneof:

- Authorization: Bearer <api-key>(recommended, MCP-friendly)
- X-LetsCloud-Token: <api-key>(fallback)

The server forwards the key to LetsCloud's API asapi-token: <key>(matching theofficial Go SDKbehavior).The server stores nothing.

src/letscloud_mcp/ β”œβ”€β”€ main.py # FastAPI app, mounts /mcp and /api/v1 β”œβ”€β”€ __main__.py # uvicorn entrypoint (python -m letscloud_mcp) β”œβ”€β”€ config.py # Settings via pydantic-settings β”œβ”€β”€ auth.py # Per-request token extraction (ContextVar) β”œβ”€β”€ logging_setup.py # structlog β”œβ”€β”€ letscloud/ β”‚ β”œβ”€β”€ client.py # Async httpx client for core.letscloud.io β”‚ β”œβ”€β”€ models.py # Pydantic models (Profile, Instance, Snapshot…) β”‚ └── exceptions.py β”œβ”€β”€ mcp_app/ β”‚ β”œβ”€β”€ server.py # FastMCP server (Streamable HTTP) β”‚ └── tools.py # @mcp.tool functions └── rest/ └── routes.py # FastAPI router for /api/v1

- LetsCloud– cloud provider
-
Official Go SDK– the basis for this client
-
Model Context Protocol
-
Self-hosting guide
-
Security policyΒ·Contributing

Core AWS MCP server providing prompt understanding and server management capabilities.

An AI-powered interface for managing the Dokploy infrastructure platform.

An AI-powered interface for managing the Dokploy infrastructure platform.

The official Impreza Host connector for offshore server management

Manage Railway infrastructure through natural language using the Railway API.

A remote Model Context Protocol (MCP) server for managing VPS servers and domains on Sitequest. Lets AI assistants provision, monitor, and configure infrastructure through natural language.

Manage your Bedrock server with natural language commands using the Bedrock Server Manager API.

Manage and interact with Microsoft Azure services.

An MCP service for deploying HTML content to EdgeOne Pages and obtaining a publicly accessible URL.

Create, build, deploy, and manage Netlify resources using natural language.

No reviews yet β€” be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.