{"skill":{"slug":"hostinger-vps-mcp-tools","displayName":"Hostinger VPS MCP Tools","summary":"Set up Hostinger VPS servers as AI virtual employees with GUI and Koda (OpenClaw). Use when deploying new VPS instances, setting up remote desktops, installi...","description":"---\nname: hostinger-vps-deploy\ndescription: Set up Hostinger VPS servers as AI virtual employees with GUI and Koda (OpenClaw). Use when deploying new VPS instances, setting up remote desktops, installing Koda/OpenClaw, or configuring AI agent workstations. Handles Ubuntu server setup, GUI (XFCE + VNC/XRDP), Docker, and Koda deployment.\n---\n\n# Hostinger VPS Deploy\n\nDeploy Koda (OpenClaw) on Hostinger VPS servers with GUI access for AI virtual employees.\n\n## Overview\n\nThis skill automates:\n1. **API-driven provisioning** — Deploy VPS instances via Hostinger API MCP tools\n2. **Server hardening** — SSH keys, firewall, fail2ban\n3. **GUI installation** — XFCE desktop + VNC/XRDP for remote access\n4. **Docker setup** — Container runtime for Koda\n5. **Koda deployment** — AI assistant with webchat interface\n6. **Identity config** — Unique name/persona for each virtual employee\n\n---\n\n## Hostinger API Integration (MCP)\n\n### Dashboard Tab\n\nOpenClaw has a built-in **Hostinger** tab in the Control dashboard (Integrations group).\n\nFrom the tab you can:\n- Enter your **Hostinger API token** (stored securely in vault)\n- Set your **GitHub repo URL** (OpenClaw fork to install on new VPS instances)\n- View all available **MCP tools** grouped by category\n- Reference the **Key VPS Tools** quick guide\n\n### Getting Your API Token\n\n1. Log into [hPanel](https://hpanel.hostinger.com)\n2. Go to **API Tokens** → Create new token\n3. Copy the token and paste it in the OpenClaw **Hostinger** tab\n\n### MCP Server\n\nThe `hostinger-api-mcp` npm package is Hostinger's official MCP server.\n\n- **Install**: `npm install -g hostinger-api-mcp` (already installed)\n- **Auth**: Bearer token via `API_TOKEN` env var\n- **Transport**: stdio (default) or HTTP streaming\n\n**Important:** The API token is stored in `~/.openclaw/secrets.json` (the vault), **not** in plaintext in mcporter config. A `SecretRef` points to the vault key `HOSTINGER_API_TOKEN`.\n\n### Key API Endpoints\n\n| Tool | Method | Path |\n|------|--------|------|\n| `vps_getVirtualMachineListV1` | GET | `/api/vps/v1/virtual-machines` |\n| `vps_createVirtualMachineV1` | POST | `/api/vps/v1/virtual-machines` |\n| `vps_getDataCenterListV1` | GET | `/api/vps/v1/data-centers` |\n| `vps_getOsListV1` | GET | `/api/vps/v1/os` |\n| `vps_startVirtualMachineV1` | POST | `/api/vps/v1/virtual-machines/{id}/start` |\n| `vps_stopVirtualMachineV1` | POST | `/api/vps/v1/virtual-machines/{id}/stop` |\n| `vps_restartVirtualMachineV1` | POST | `/api/vps/v1/virtual-machines/{id}/restart` |\n| `vps_resetPasswordV1` | POST | `/api/vps/v1/virtual-machines/{id}/reset-password` |\n| `vps_getMetricsV1` | GET | `/api/vps/v1/virtual-machines/{id}/metrics` |\n| `billing_getCatalogItemListV1` | GET | `/api/billing/v1/catalog` |\n| `billing_getPaymentMethodListV1` | GET | `/api/billing/v1/payment-methods` |\n\n### Using Tools via mcporter\n\n```bash\n# List all VPS instances\nmcporter call hostinger-api.vps_getVirtualMachineListV1\n\n# View available VPS plans (prices in cents)\nmcporter call hostinger-api.billing_getCatalogItemListV1 category=VPS\n\n# List data centers\nmcporter call hostinger-api.vps_getDataCenterListV1\n\n# List OS options\nmcporter call hostinger-api.vps_getOsListV1\n\n# Deploy a new VPS (requires plan item ID, OS ID, datacenter ID)\nmcporter call hostinger-api.vps_createVirtualMachineV1 ...\n```\n\n### API Documentation Links\n\n| Resource | URL |\n|----------|-----|\n| API Reference | https://developers.hostinger.com/ |\n| Overview | https://developers.hostinger.com/#description/overview |\n| Authentication | https://developers.hostinger.com/#description/authentication |\n| SDKs & Tools | https://developers.hostinger.com/#description/sdks--tools |\n| Official MCP Server (GitHub) | https://github.com/hostinger/api-mcp-server |\n| Postman Collection | https://app.getpostman.com/run-collection/36145449-4a733c4f-6704-49f6-832a-0ccd28c37021 |\n| hPanel API Tokens | https://hpanel.hostinger.com/api-tokens |\n\n---\n\n## VPS Deployment Workflow\n\n### Step 1: Get a VPS\n\n```bash\n# 1. Check available plans\nmcporter call hostinger-api.billing_getCatalogItemListV1 category=VPS\n\n# 2. Pick a data center\nmcporter call hostinger-api.vps_getDataCenterListV1\n\n# 3. Pick an OS (Ubuntu 24.04 recommended)\nmcporter call hostinger-api.vps_getOsListV1\n\n# 4. Deploy\nmcporter call hostinger-api.vps_createVirtualMachineV1 \\\n  --args '{\"plan\":\"...\", \"datacenter_id\": \"...\", \"os_id\": \"...\"}'\n```\n\n### Step 2: Set Up the Server\n\nOnce the VPS is running (get IP from `vps_getVirtualMachineListV1`):\n\n```bash\n# One-command full deploy\nscripts/deploy-all.sh SERVER_IP \"Agent Name\" [KODA_PORT] [SSH_PORT]\n\n# Examples:\nscripts/deploy-all.sh 1.2.3.4 \"Alex\"\nscripts/deploy-all.sh 1.2.3.4 \"Alex\" 9443 2222\n```\n\n### Step 3: Install OpenClaw Fork\n\nIf a GitHub repo is configured (via the Hostinger tab), Koda will:\n1. SSH into the new VPS\n2. Clone the configured repo (e.g., `https://github.com/your-org/openclaw`)\n3. Run the install script\n\n---\n\n## Manual Step-by-Step Scripts\n\n```bash\n# 1. Initial server setup (with custom ports)\nssh root@SERVER_IP 'bash -s 9443 2222' < scripts/01-server-setup.sh\n\n# 2. Install GUI + remote desktop\nssh -p 2222 root@SERVER_IP 'bash -s' < scripts/02-install-gui.sh\n\n# 3. Install Docker\nssh -p 2222 root@SERVER_IP 'bash -s' < scripts/03-install-docker.sh\n\n# 4. Deploy Koda (with custom port)\nssh -p 2222 root@SERVER_IP 'bash -s 9443' < scripts/04-deploy-koda.sh\n\n# 5. Configure identity\nssh -p 2222 root@SERVER_IP 'bash -s' < scripts/05-configure-identity.sh \"Agent Name\"\n```\n\n## Scripts\n\n| Script | Purpose |\n|--------|---------|\n| `01-server-setup.sh` | Updates, firewall, fail2ban, create user |\n| `02-install-gui.sh` | XFCE desktop + XRDP (Windows Remote Desktop) |\n| `03-install-docker.sh` | Docker + Docker Compose |\n| `04-deploy-koda.sh` | Pull/build Koda, start container |\n| `05-configure-identity.sh` | Set agent name, create workspace |\n| `deploy-all.sh` | Run all scripts in sequence |\n\n---\n\n## Connecting to Your VPS\n\nAfter deployment:\n\n- **Remote Desktop (RDP)**: Connect with Windows Remote Desktop or Remmina to `SERVER_IP:3389`\n- **VNC**: Connect to `SERVER_IP:5901` (if VNC installed)\n- **Webchat**: Open `http://SERVER_IP:18789` in browser\n- **SSH**: `ssh koda@SERVER_IP`\n\nDefault credentials (change after first login):\n- Username: `koda`\n- Password: Set during deployment\n\n## Firewall Ports\n\n| Port | Service | Customizable |\n|------|---------|--------------|\n| 22 (default) | SSH | ✅ Set via SSH_PORT |\n| 3389 | XRDP (Remote Desktop) | ❌ |\n| 18789 (default) | Koda webchat | ✅ Set via KODA_PORT |\n\n---\n\n## Security\n\n### Vault Storage\n\nThe Hostinger API token is stored in **`~/.openclaw/secrets.json`** under the key `HOSTINGER_API_TOKEN`. It is **never stored in plaintext** in mcporter.json — only a `SecretRef` pointer is stored there.\n\n### Post-Deployment Hardening\n\n```bash\n# Tailscale (zero-trust VPN — recommended)\nssh root@SERVER_IP 'bash -s' < scripts/security/setup-tailscale.sh\nssh root@SERVER_IP 'bash -s' < scripts/security/lockdown-public.sh\n\n# Or: Cloudflare Tunnel for HTTPS\nssh root@SERVER_IP 'bash -s' < scripts/security/setup-cloudflare-tunnel.sh\n```\n\n| Script | Purpose |\n|--------|---------|\n| `security/setup-ssh-keys.sh` | SSH key-only auth |\n| `security/setup-tailscale.sh` | Zero-trust VPN mesh |\n| `security/setup-cloudflare-tunnel.sh` | HTTPS via Cloudflare |\n| `security/setup-wireguard.sh` | Self-hosted VPN |\n| `security/setup-https.sh` | Let's Encrypt SSL + Nginx |\n| `security/harden-server.sh` | Kernel hardening, auto-updates |\n| `security/lockdown-public.sh` | Remove all public port access |\n\n---\n\n## Reference Files\n\n| File | Purpose |\n|------|---------|\n| `references/hostinger-backend.ts` | Gateway RPC handlers for Hostinger API |\n| `references/hostinger-views.ts` | UI tab rendering (Lit) |\n| `references/hostinger-controller.ts` | UI state management |\n| `references/hostinger-notes.md` | hPanel navigation notes |\n| `references/identity-setup.md` | Per-agent identity configuration |\n| `references/security-options.md` | Security comparison guide |\n\n---\n\n## VPS Plans\n\nRecommended for Koda/OpenClaw:\n- **KVM 2** (2 GB RAM) — Minimum for headless Koda\n- **KVM 4** (4 GB RAM) — Recommended for GUI + Koda\n- **KVM 8** (8 GB RAM) — Comfortable for heavy workloads\n\nOS: **Ubuntu 22.04 or 24.04 LTS**\n\n---\n\n## Troubleshooting\n\n**Can't connect via RDP?**\n- Ensure port 3389 is open: `sudo ufw status`\n- Check XRDP status: `sudo systemctl status xrdp`\n\n**Koda not starting?**\n- Check Docker: `docker ps`\n- View logs: `docker logs koda`\n\n**GUI slow?**\n- XFCE is lightweight but VPS needs 2GB+ RAM\n- Consider headless mode if GUI not needed\n\n**MCP tools not loading?**\n- Verify token is saved: check `~/.openclaw/secrets.json` for `HOSTINGER_API_TOKEN`\n- Run: `API_TOKEN=your-token mcporter list hostinger-api`\n","tags":{"latest":"1.0.0"},"stats":{"comments":0,"downloads":788,"installsAllTime":0,"installsCurrent":0,"stars":0,"versions":1},"createdAt":1772404703176,"updatedAt":1779077536070},"latestVersion":{"version":"1.0.0","createdAt":1772404703176,"changelog":"Initial release of Hostinger VPS MCP Tools skill for setting up AI agent workstations.\n\n- Automates deployment and configuration of Hostinger VPS servers as AI assistant workstations with GUI, Docker, and OpenClaw support.\n- Integrates with Hostinger API MCP tools for provisioning, OS selection, server hardening, and remote access setup.\n- Includes step-by-step scripts for full server setup, GUI installation (XFCE + XRDP), Docker install, and OpenClaw deployment.\n- Provides a dedicated UI tab for managing API tokens, viewing tools, and initiating deployments.\n- Emphasizes secure token storage and post-deployment hardening options (e.g., VPN, SSH keys, firewall).\n- Features clear documentation for both automated and manual deployment workflows.","license":null},"metadata":null,"owner":{"handle":"maverick-software","userId":"s172zy52hz8d9fxcmyr9padghd842s7c","displayName":"maverick-software","image":"https://avatars.githubusercontent.com/u/85259593?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089733953}}