xCloud Agent Skills v4.0.1
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:serversxcloud:sitesxcloud:wordpressxcloud:sslxcloud: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 — 110 native tools, OAuth, per-action confirmation on destructive operations) and falls back to the bundled REST wrapper on agents without MCP support:
- Manage servers, services, monitoring, PHP versions, databases, firewall rules, fail2ban, and snapshots
- Provision WordPress sites and Git-deployed sites (Laravel, Node.js, custom PHP, Lovable) onto servers
- Manage sites, domains, cache, backups, deployment logs, rescue workflows, SSH/SFTP, cron jobs, access logs, and safe site deletion
- Manage Git deployment settings and trigger manual Git deployments for xCloud sites
- Manage WordPress health, updates, plugins, themes, vulnerabilities, PageSpeed, WP_DEBUG, and magic-login URLs
- Run team-wide vulnerability rollups across all xCloud sites
- Manage SSL certificates, renewals, custom certificates, certificate status, and Cloudflare certificates
- Read account identity, API health, API tokens, 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.
