Imported from xCloudDev/xcloud-agent-skills (
SKILL.md). Install upstream withnpx skills add xCloudDev/xcloud-agent-skills. Copyright stays with the author.
xCloud Agent Skills v4.3.0
Version MCP License xCloud ClawHub OpenClaw
Built for xCloud hosting operators by xCloud · GitHub · MCP Docs · User Guide · Install Guide · API Docs · OpenClaw Tutorial · Tutorial Video · Security Notes
Security notice: agent-only xCloud operations toolkit. This package contains skill routing instructions, reference docs, and a small
bash/curlwrapper. It ships no API tokens and only calls the xCloud API after a user or agent explicitly invokes a skill — via the OAuth-connected xCloud MCP server (recommended) or withXCLOUD_API_TOKENconfigured.
This root skill describes the official xCloud Public API plugin bundle for agent marketplaces such as ClawHub and skills.mp.com.
The runnable skills live under plugins/xcloud/skills/ and are invoked as:
xcloud:deployxcloud:serversxcloud:sitesxcloud:wordpressxcloud:sslxcloud:billingxcloud:account
What It Provides
Use this package when an agent needs to operate xCloud hosting infrastructure. It pairs with the xCloud MCP server (https://app.xcloud.host/mcp — one native tool per authenticated Public API operation plus xcloud_agent_search and xcloud_docs_search, a five-tool compact profile, OAuth, per-action confirmation on destructive operations) and falls back to the bundled REST wrapper on agents without MCP support:
- Deploy any GitHub, GitLab or Bitbucket URL end to end — detect the app, preview with a dry run, ask once, provision, poll, verify the live URL — and diagnose and retry a failed deploy on the same site
- Deploy Docker Compose and Dockerfile apps, install one-click apps (Ghost, Uptime Kuma, Vaultwarden, …), create Git staging environments from a branch, and create WordPress sites
- Buy xCloud-managed servers (plans, prices, regions, provisioning progress); manage services, Node.js and PHP versions, verified reboots, monitoring, firewall rules, fail2ban, sudo users, cron, and DNS checks
- Manage sites, domains, cache, backups (including Docker app backups), staging, rescue workflows, SSH/SFTP, cron jobs, access logs, and safe site deletion
- Manage WordPress health, updates, plugins, themes, vulnerabilities (per site and team-wide), PageSpeed, broken links, WP_DEBUG, and magic-login URLs
- Manage SSL certificates, renewals, custom certificates, certificate status, and Cloudflare certificates
- Read plan, invoices, bills and prices; pay invoices and buy mailboxes or mail delivery — only after explicit approval
- Work across several teams from one connection; read and clear incident alerts; read identity, API tokens, Git and Cloudflare integrations, and WordPress blueprints
Agent Experience
- Every user-facing reply is xCloud branded with a clear header and
_via xcloud:*_footer. - The first xCloud interaction greets the user and shows the xCloud startup banner once per conversation.
- If no connection is configured, xCloud offers the MCP connector first (OAuth,
no secret to store), then falls back to explaining how to create a scoped API
token stored in the agent runtime as
XCLOUD_API_TOKEN; it does not ask users to paste production tokens into chat by default. - After setup, xCloud verifies the connection (
user_showvia MCP, or/health+/uservia REST) before continuing operational tasks.
Setup
Recommended — connect the xCloud MCP server (OAuth; no token to store):
claude mcp add xcloud --transport http https://app.xcloud.host/mcp
Then /mcp → Authenticate. Other clients: add a custom connector with URL
https://app.xcloud.host/mcp. Docs: https://app.xcloud.host/mcp/docs
REST fallback (agents without MCP support):
Create an xCloud API token from:
https://app.xcloud.host/settings/api-tokens
Then configure your runtime:
export XCLOUD_API_TOKEN="your-token-here"
export XCLOUD_API_BASE_URL="https://app.xcloud.host"
The shared command wrapper is:
"${CLAUDE_PLUGIN_ROOT}"/scripts/xcloud.sh GET /user
Official Links
- xCloud: https://xcloud.host
- MCP docs: https://app.xcloud.host/mcp/docs
- Dashboard: https://app.xcloud.host
- User guide: https://github.com/xCloudDev/xcloud-agent-skills/blob/main/docs/USER_GUIDE.md
- Install guide: https://github.com/xCloudDev/xcloud-agent-skills/blob/main/docs/SKILLS-GUIDE.md
- Official repository: https://github.com/xCloudDev/xcloud-agent-skills
- Development fork: https://github.com/Asif2BD/xcloud-agent-skills
- Public API docs: https://app.xcloud.host/api/v1/docs
- OpenClaw + ClawHub tutorial: https://xcloud.host/openclaw-skills-and-clawhub-on-xcloud-openclaw-agent/
- Tutorial video: https://www.youtube.com/watch?v=oEE9OHo3_48
Safety
This package contains documentation, skill routing instructions, and a small shell wrapper. It does not include real API tokens and does not run API calls during installation. Network requests are made only after a user or agent explicitly invokes an xCloud skill with an API token configured in the environment.