Cloudways MCP
Operational guide for managing Cloudways servers and applications, across one or several Cloudways accounts, via the official Cloudways MCP server (Cloudways' hosted MCP / Remote MCP, per their support docs). Use whenever the user mentions Cloudways, a Cloudways server or app, server monitoring, app monitoring, bandwidth, disk usage, PHP/MySQL/traffic analytics, Varnish cache, app cloning, backups/restore on Cloudways, Git deployments on Cloudways, SSL/Let's Encrypt on Cloudways, malware scans / Security Suite, staging sync, team members, AgencyOS client billing, or running an audit/onboarding on a Cloudways-hosted client site. Any write operation (start/stop/restart server, backup, restore, update CNAME, purge cache, change service state, git pull, SSL install/revoke, IP whitelist update, staging sync, team/billing changes, delete server/app) requires explicit confirmation of target server/app and intended action before execution.
Rank
62
Safety
84
Downloads
1.7k
Updated
Oct 10, 2026
Version
1.5.3
Source
CLAWHUB
About
What it does, and when to use it.
Capability contract not published. No trust telemetry is available yet. 1.7K downloads reported by the source. Last updated 10/10/2026.
Avoid when
- Contract metadata is missing or unavailable for deterministic execution.
Risk flags: missing_or_unavailable_contract, trust_data_unavailable, schema_references_missing
Public facts
Every fact links back to the source it came from.
- Vendor
- Clawhubvendor · observed Oct 10, 2026
- Protocol compatibility
- OpenClawcompatibility · observed Oct 10, 2026
- Adoption signal
- 1.7K downloadsadoption · observed Oct 10, 2026
- Latest release
- 1.5.3release · observed Sep 13, 2026
- Handshake status
- UNKNOWNsecurity
Install and run
Setup complexity: low.
clawhub skill install s17b8qfjfq0g8kveh2g8v1179h83ejwb:cloudways-mcp- Install using `clawhub skill install s17b8qfjfq0g8kveh2g8v1179h83ejwb:cloudways-mcp` in an isolated environment before connecting it to live workloads.
- No published capability contract is available yet, so validate auth and request/response behavior manually.
- Review the upstream CLAWHUB listing at https://clawhub.ai/benkalsky/cloudways-mcp before using production credentials.
Contract: missing
curl -s "https://www.xpersona.co/api/v1/agents/clawhub-benkalsky-cloudways-mcp/snapshot"
Documentation
CLAWHUB
151,683 characters of source documentation, loaded on request.
Extracted files
5 files captured from the source.
SKILL.md
--- name: cloudways-mcp version: 1.5.3 license: MIT description: | Operational guide for managing Cloudways servers and applications, across one or several Cloudways accounts, via the official Cloudways MCP server (Cloudways' hosted MCP / Remote MCP, per their support docs). Use whenever the user mentions Cloudways, a Cloudways server or app, server monitoring, app monitoring, bandwidth, disk usage, PHP/MySQL/traffic analytics, Varnish cache, app cloning, backups/restore on Cloudways, Git deployments on Cloudways, SSL/Let's Encrypt on Cloudways, malware scans / Security Suite, staging sync, team members, AgencyOS client billing, or running an audit/onboarding on a Cloudways-hosted client site. Any write operation (start/stop/restart server, backup, restore, update CNAME, purge cache, change service state, git pull, SSL install/revoke, IP whitelist update, staging sync, team/billing changes, delete server/app) requires explicit confirmation of target server/app and intended action before execution. --- # Cloudways MCP — Operational Skill Managing Cloudways infrastructure through the Cloudways MCP server. > **Connection:** This skill targets the **official Cloudways (Remote) MCP** — an MCP hosted by Cloudways at `https://mcp.cloudways.com/mcp/` that you connect to directly. The source of truth for connecting is the **official article**: `support.cloudways.com/en/articles/14654372`. See `references/installation.md`. > > **Tool names match the official articles.** The tool catalog and workflows in this skill use the official Cloudways MCP tool names (verified against the setup article and the dedicated [tools article](https://support.cloudways.com/en/articles/15798823-cloudways-mcp-server-tools)). Always treat the live `mcp__cloudways*__*` tools as the source of truth if Cloudways changes them (see "Versioning and source of truth" below). > **Context:** The skill is built for day-to-day work managing clients/environments on Cloudways — monitoring, routine maintenance, onboarding/audit for new clients, and automations. All monetary values reported by the API are in $ (USD), not ₪. --- ## Quick Route | Intent | Load | |--------|------| | Initial installation/configuration of the MCP server | `references/installation.md` | | Don't know which tool exists / searching for a tool by name | `references/tools-catalog.md` | | Monitoring, status check, bandwidth, analytics | `references/workflows-monitoring.md` | | Cache clear, SSL, backup, restart, IP whitelist | `references/workflows-maintenance.md` | | New audit / onboarding a new client | `references/workflows-onboarding.md` | | Building an automated workflow for n8n/Make/Claude Code | `references/workflows-automation.md` | | Multiple Cloudways accounts / multi-account configuration | `references/installation.md` (Multi-account section) | **Load only what's needed.** Maximum 2-3 references per task. If the user just asks "show me my servers", don't load the entire catalog — call `server_list`
_meta.json
{
"ownerId": "kn7afv05r120atbc75whrv1zkx825tt5",
"slug": "cloudways-mcp",
"version": "1.5.3",
"publishedAt": 1789340302484
}references/installation.md
# Installation — Cloudways MCP Server This skill targets the **official Cloudways (Remote) MCP** — a Cloudways-hosted MCP at `https://mcp.cloudways.com/mcp/` that you connect to directly, without self-hosting. > **Source of truth:** [How to Use Cloudways MCP Server for AI-Based Server Management](https://support.cloudways.com/en/articles/14654372-how-to-use-cloudways-mcp-server-for-ai-based-server-management). The endpoint, headers, and steps below are from that article; if Cloudways changes them, the article wins. **Prerequisites** - A valid Cloudways account with API access. - A Cloudways **Access Token** (see Step 1). - **Node.js v24.14.1+** (only for the Claude Desktop path, which uses the `mcp-remote` bridge). Claude Code connects over native HTTP and does not need it. --- ## Step 1 — Generate an Access Token 1. Log in to [platform.cloudways.com](https://platform.cloudways.com). 2. Open the **API** section (bottom-left of the platform — the same place the legacy API key lived). 3. Generate an **Access Token** (Access Token Details → Create Access Token). Note: only the **primary account owner** can create/manage API credentials — team-member accounts have no API Integration section. Give the token a name, an expiration period (1 day → never; shortest that works), and a **role**: - **READ** — look-ups only (status, config, monitoring). Recommended starting point for every new integration, and for monitoring-only connections. - **LIMITED** — only the endpoint groups you select. - **FULL ACCESS** — everything the account can do, including destructive actions. Only for connections that genuinely need to make changes. 4. Copy the token. > Treat the token like a password — never commit it or print it in responses. Prefer one token **per integration** (per MCP connection), each with the minimum role it needs, so tokens can be revoked individually. > **Legacy API key — deprecated.** The old flow (API key + `X-CW-Email`/`X-CW-Api-Key` headers) still works but the API key **stops working on October 15, 2026**. If you have an existing connection using the old headers, regenerate as an Access Token and update the connection before then. Until migrated, a legacy connection retains **unrestricted full-account access** — the RBAC roles apply only to Access Tokens. And note there is still **no per-tool permission control at the MCP layer** beyond the token's role: a FULL ACCESS token can call every tool. **Required headers** (every request; header names are case-sensitive): | Header | Value | |--------|-------| | `X-Access-Token` | your Cloudways Access Token | | `X-Mcp-Host` | the client you connect from — official values: `claude-code`, `claude-desktop`, `cursor`, `Devin` (the client formerly called Windsurf — the article's own snippet sends the capitalised `Devin`, and header values are case-sensitive), `vs-code`, `gemini-cli`, `codex`, `codex-cli` | --- ## Step 2 — Connect Claude to the MCP ### Env var (zero-config — devices and c
references/tools-catalog.md
# Tools Catalog — Cloudways MCP The official tool catalog for the **Cloudways (Remote) MCP** (`https://mcp.cloudways.com/mcp/`), taken from the official support articles: [Cloudways MCP Server Tools](https://support.cloudways.com/en/articles/15798823-cloudways-mcp-server-tools) (the dedicated tool reference) and [How to Use Cloudways MCP Server](https://support.cloudways.com/en/articles/14654372-how-to-use-cloudways-mcp-server-for-ai-based-server-management) (setup). Tools appear in Claude as `mcp__cloudways__<tool>` (or `mcp__cloudways-<client>__<tool>` per account). **MCP v1.2 scale:** **244 tools** — 241 spread across 22 toolsets plus the 3 meta-tools, live-verified 2026-07-20 (see the toolset table below). This matches the [v1.2 announcement](https://www.cloudways.com/blog/cloudways-mcp-v1-2-112-new-tools-role-based-access-tokens-and-full-cloudways-api-coverage/) exactly (112 added in v1.2, covering essentially the full Cloudways API). Your client initially sees only **65 tools** (62 high-frequency direct tools + the 3 meta-tools below). Those 62 are **members of the toolsets**, not a separate tier, so the hidden remainder is **179** (241 − 62) — discovered and invoked on demand through the meta-tools. > **The official tools article over-lists.** It documents endpoint-style aliases for the Security and Service categories (`security_dns_create`, `service_state_update`, …) plus whole categories — Bot Protection, Client Billing, CloudwaysCDN legacy, a "Lists API", `oauth_access_token_generate` — that **have no live counterpart**. Live re-enumeration on 2026-07-20 found 64 such phantom identifiers and **zero** real alias mismatches: every name in the tables below matches the live `tool_name` exactly. They have been removed from this catalog; if you see them in Cloudways' docs, don't build automation on them. Flags: **R** = read-only · **W** = write (requires confirmation) · **W!** = destructive / irreversible (requires double confirmation). > The **live server is the source of truth.** Every section of this file — including the "New in MCP v1.2" half — was reconciled against the live MCP on 2026-07-20 via `list_available_toolsets` + `get_toolset_tools` on a connected account: all 22 toolsets enumerated, every tool name verified byte-for-byte, phantom entries removed. You do **not** need to memorize tool names to use the MCP (it resolves natural language), but knowing them sharpens prompts and lets you confirm an action maps to the tool you expect. > > **Most tools are grouped into on-demand toolsets.** Only a subset appears in your default tool list; the rest live inside toolsets (`apps`, `servers`, `git`, `ssh_keys`, `projects`, `staging_management`, `dns_made_easy`, `cloudflare`, and the v1.2 additions) and are invoked through the `execute_tool` proxy. A tool being absent from the default list does **not** mean it is absent from the MCP — `git_*`, `project_*`, `ssh_key_*`, `app_restore_rollback`, `app_db_password_update`, `server_local_bac
references/workflows-automation.md
# Workflows — Automation & Integration
How to build automations around the Cloudways MCP — connecting to n8n, Make.com, Claude Code, or cron jobs. Suitable for any infrastructure management stack.
> **Basic principle:** The MCP server is first and foremost an interface for Claude. For automation without human-in-the-loop, it's usually **better to call the Cloudways API directly** (curl/n8n HTTP node) rather than going through the MCP. The MCP adds overhead, and in automation it's not necessary.
---
## When to use MCP vs. direct API?
| Scenario | Choose |
|--------|-----|
| Live conversation in Claude / Claude Code | MCP |
| Daily report generated automatically | Direct API (n8n/Make) |
| Alerting → automatic action | Direct API |
| Audit one-off | MCP |
| CI/CD trigger (post-deploy backup, etc.) | Direct API |
| Claude Code headless running pipelines | MCP (if Claude is the orchestrator) |
The MCP saves time in an interactive context. In automation — overhead.
---
## 1. Cloudways API direct (for automation)
### Authentication flow (current — Access Token, API v2)
Generate an **Access Token** at platform.cloudways.com → **API Integration** → Create Access Token (name + expiration + scope; use **Read-Only** for reporting loops, **Limited** for specific write workflows). Only the **primary account owner** can create/manage tokens — team-member accounts have no API Integration section. There is **no token-exchange step**: send the Access Token directly on every request.
```bash
# Current flow: one header, no exchange
curl -sH "Authorization: Bearer $CLOUDWAYS_ACCESS_TOKEN" \
"https://api.cloudways.com/api/v2/server"
```
- **API v2 is the current API** ([announcement](https://www.cloudways.com/blog/introducing-cloudways-api-v2/)); the official migration rule is "replace `v1` with `v2` in the API call URL structure". v1 is deprecated (its docs remain up until **March 2026**).
- Rate limit: 100 requests/minute (per the [access-tokens article](https://support.cloudways.com/en/articles/5136065)).
- The token is long-lived per its configured expiration (1 day → never) — no hourly regeneration; rotate per your security policy, and revoke it the moment the integration is retired.
### Common endpoints
Paths are relative to `https://api.cloudways.com/api/v2` (same structure as v1 during the transition):
| Endpoint | Method | What it is |
|----------|--------|--------|
| `/server` | GET | list servers |
| `/server/{id}` | GET | server details |
| `/app/manage/varnish` | POST | Varnish operations |
| `/app/manage/backup` | POST | trigger backup |
| `/app/letsencrypt_renew` | POST | renew SSL |
| `/app/analytics/visitor` | GET | traffic |
| `/app/manage/cache` | POST | clear cache |
Full documentation: `https://developers.cloudways.com/docs/` (Redocly portal + API Playground; the Playground runs against your **real** account — prefer a test server).
### Legacy authentication (works until 2026-10-15 only)
> The `email` + `api_key` OAuth exchAionUi
Free, local, open-source 24/7 Cowork app and OpenClaw for Gemini CLI, Claude Code, Codex, OpenCode, Qwen Code, Goose CLI, Auggie, and more | 🌟 Star if you like it!
activepieces
AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents
cherry-studio
AI productivity studio with smart chat, autonomous agents, and 300+ assistants.
CopilotKit
The Frontend for Agents & Generative UI. React + Angular
Machine-readable data
The same record, as JSON, for agents and crawlers.
{
"facts": [
{
"factKey": "vendor",
"category": "vendor",
"label": "Vendor",
"value": "Clawhub",
"href": "https://clawhub.ai/benkalsky/skills/cloudways-mcp",
"sourceUrl": "https://clawhub.ai/benkalsky/skills/cloudways-mcp",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T05:20:18.733Z",
"isPublic": true
},
{
"factKey": "protocols",
"category": "compatibility",
"label": "Protocol compatibility",
"value": "OpenClaw",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-benkalsky-cloudways-mcp/contract",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-benkalsky-cloudways-mcp/contract",
"sourceType": "contract",
"confidence": "medium",
"observedAt": "2026-10-10T05:20:18.733Z",
"isPublic": true
},
{
"factKey": "traction",
"category": "adoption",
"label": "Adoption signal",
"value": "1.7K downloads",
"href": "https://clawhub.ai/benkalsky/cloudways-mcp",
"sourceUrl": "https://clawhub.ai/benkalsky/cloudways-mcp",
"sourceType": "profile",
"confidence": "medium",
"observedAt": "2026-10-10T05:20:18.733Z",
"isPublic": true
},
{
"factKey": "latest_release",
"category": "release",
"label": "Latest release",
"value": "1.5.3",
"href": "https://clawhub.ai/benkalsky/cloudways-mcp",
"sourceUrl": "https://clawhub.ai/benkalsky/cloudways-mcp",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-13T22:58:22.484Z",
"isPublic": true
},
{
"factKey": "handshake_status",
"category": "security",
"label": "Handshake status",
"value": "UNKNOWN",
"href": "https://www.xpersona.co/api/v1/agents/clawhub-benkalsky-cloudways-mcp/trust",
"sourceUrl": "https://www.xpersona.co/api/v1/agents/clawhub-benkalsky-cloudways-mcp/trust",
"sourceType": "trust",
"confidence": "medium",
"observedAt": null,
"isPublic": true
}
],
"events": [
{
"eventType": "release",
"title": "Release 1.5.3",
"description": "Cloudways MCP Skill v1.5.3 - Updated tool catalog, monitoring, and maintenance workflow references for accuracy and alignment with current Cloudways MCP documentation. - Improved organization by removing the redundant skill-card.md file. - No changes to core safety policies or operational logic; content and workflows remain authoritative per the updated references.",
"href": "https://clawhub.ai/benkalsky/cloudways-mcp",
"sourceUrl": "https://clawhub.ai/benkalsky/cloudways-mcp",
"sourceType": "release",
"confidence": "medium",
"observedAt": "2026-09-13T22:58:22.484Z",
"isPublic": true
}
]
}Record generated Oct 10, 2026.
