Skip to main content
Glama
Cloady

Cloady

Official
by Cloady
README.md
# @cloady/mcp

Local [MCP](https://modelcontextprotocol.io) server for [Cloady](https://cloady.com) — gives AI assistants the whole Cloady API as tools: workspaces, apps, deploys, environment variables, domains, volumes, members, integrations, billing and support tickets.

Generated from Cloady's OpenAPI contract, so every REST operation is a tool named after its operation id (`listVars`, `createVar`, `deployApp`, `execCommand`). It runs over stdio and calls `https://cloady.com` with your API token.

## Setup

For the OAuth-based Claude plugin, see [Cloady for Claude](./plugin). It connects to the hosted MCP endpoint without installing the npm server or copying an API token.

### Gemini CLI extension

Install the extension from this repository:

```sh
gemini extensions install https://github.com/Cloady/cloady-mcp
```

Open Gemini CLI and run `/mcp auth cloady` to sign in to Cloady through OAuth. Complete any required account verification and choose the narrowest scope for your task: read, deploy, or full. No API key or local npm server is needed for this extension.

Try "List my Cloady workspaces and running apps", "Explain the latest deployment failure from my app's build logs", or "Show available database templates and pricing before creating anything."

The extension sends tool arguments to `https://cloady.com/api/mcp` and returns permitted results to Gemini. These can include account and workspace metadata, application configuration, code, logs, metrics, database content, and support messages, depending on the tools you request. Google handles received results under its own policies; Cloady's handling, retention, and deletion are described in the [Privacy Policy](https://cloady.com/privacy). An account-level connection can cover all workspaces the account belongs to, subject to scope and workspace role. Revoke its token in **Cloady Account → API tokens** to stop future requests. Revocation does not delete hosted data or copies already received by Gemini.

Review the target workspace, app, environment, region, and any charges before authorizing changes. Write tools can change or delete resources. The extension is free; hosted resources follow [Cloady pricing](https://cloady.com). Support and deletion requests: **hello@cloady.com**.

The Gemini extension and Claude plugin are versioned separately from the local npm package.

### Qwen Code

Qwen Code supports Gemini CLI extensions and converts their manifest during installation:

```sh
qwen extensions install https://github.com/Cloady/cloady-mcp
```

Use Cloady's OAuth connection in your client. The same account permissions, data handling, and hosting charges described above apply. See [Qwen Code's extension documentation](https://qwenlm.github.io/qwen-code-docs/en/users/extension/introduction/).

### Local stdio package

Create an API token in the dashboard under **Account → API tokens**.

### Claude Code

```sh
claude mcp add cloady -e BEARER_TOKEN_CLOADY=cldy_… -- npx -y @cloady/mcp
```

### Claude Desktop / Cursor / any MCP client

```json
{
  "mcpServers": {
    "cloady": {
      "command": "npx",
      "args": ["-y", "@cloady/mcp"],
      "env": { "BEARER_TOKEN_CLOADY": "cldy_…" }
    }
  }
}
```

`API_BASE_URL` overrides the target if you run Cloady elsewhere.

## Tools

One per API operation. Arguments are the operation's path parameters, query parameters and body fields flattened into one object, so `createVar` takes `workspaceSlug`, `appSlug`, `env`, `region`, `key`, `value` and `isSecret`.

The token's scope (`read` / `deploy` / `full`) and your workspace role are enforced by the API on every call, exactly as they are for the dashboard and the SDKs.

## Docs

Full reference at [cloady.com/docs](https://cloady.com/docs).

## Distribution

This repository contains the source and build published as `@cloady/mcp@0.18.0` on npm, plus directory packaging. Run `npm install` and `npm start`. The Cursor plugin uses the pinned npm release. MCPB bundles include production dependencies.

## Privacy Policy

This local server forwards tool arguments to the Cloady API using your configured API token. See [Cloady Privacy Policy](https://cloady.com/privacy) for data handling and contact information. Use the minimum necessary token scope; write tools can change or delete resources.

The 0.18.0 desktop bundle adds tool titles and conservative read/write annotations to the 0.18.0 API implementation. The Cursor configuration uses the published npm 0.18.0 release.

TDQS

C2.9/5.0

Scored across 160 tools

Disambiguation3/5

The 160-tool surface covers many subdomains, and most tools have distinct scopes documented in detail, but several families are easy to confuse: getStatusPage vs getPublicStatus, queryAppMetrics vs streamAppMetrics vs queryAppMetricsRange vs queryWorkspaceMetrics, listWorkspaceDomains vs listAppDomains vs listDnsRecords, and createSshSession vs getSshSession. Descriptions usually resolve the ambiguity, so boundaries are mostly clear but not effortless.

Naming Consistency5/5

Almost all names are camelCase verb-first (list..., get..., create..., update..., delete..., stream..., read..., query...). The convention is consistent across 160 tools, with only natural verb variety rather than style mixing.

Tool Count1/5

160 tools is far beyond the 3-15 well-scoped range and even beyond the 25+ 'too many' threshold; the platform is broad, but this is an extreme surface for one MCP server. Each subdomain could be split into separate servers.

Completeness4/5

Coverage is unusually broad: workspace/app lifecycle, deploys, domains/DNS, variables, volumes/backups, billing, support, observability, git, database, mail, alerts, and integrations. Minor gaps remain, such as no obvious standalone getApp/listApps tool, but getWorkspace appears to expose app details and most workflows have a path.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues