Part of Empire Cloud

CloudHostAI for agents

Job: deploy a Git repo (with a Dockerfile) to your own Hetzner server from an agent.

Quickstart (remote MCP)

{
  "mcpServers": {
    "cloudhostai": {
      "type": "http",
      "url": "https://cloudhostai.eliteaiempire.com/mcp",
      "headers": { "Authorization": "Bearer chai_YOUR_KEY" }
    }
  }
}

stdio: uvx cloudhostai-mcp with CLOUDHOSTAI_API_KEY set (proxies to the same server).

  1. Create an account (free, no card) and a key at /account (scopes read + write).
  2. Connect your Hetzner token once in Settings.
  3. Call cloudhosting_preview_deploy (no key needed), then cloudhosting_create_project, then cloudhosting_deploy_project with confirm=true; poll cloudhosting_get_project_status.

Tools

ToolScopeNeedsDescription
cloudhosting_list_projectsreadList your projects.
cloudhosting_get_projectreadGet one project.
cloudhosting_get_project_statusreadRefresh and return the server status from Hetzner.
cloudhosting_list_deploysreadDeploy history for a project (last 20).
cloudhosting_get_logsreadFetch container logs over SSH from the project server.
cloudhosting_get_hetzner_statusreadWhether your Hetzner token is connected (never returns it).
cloudhosting_get_usagereadAPI/MCP calls this month against the free quota.
cloudhosting_exportreadExport all your objects (json, or csv of projects).
cloudhosting_get_accountbillingPlan, project limit and usage of the account.
cloudhosting_create_projectwriteRegister a project (repo + server size). Creates no server.
cloudhosting_deploy_projectwriteconfirm=trueDeploy (creates or redeploys the server in YOUR Hetzner account; Hetzner bills you). Requires confirm=true.
cloudhosting_destroy_serverwriteconfirm=trueDESTRUCTIVE: delete the project server from your Hetzner account. Requires confirm=true.
cloudhosting_delete_projectwriteconfirm=trueDESTRUCTIVE: delete a project record (server must be destroyed first). Requires confirm=true.
cloudhosting_preview_deploynoneDry run: check a public repo + branch and show what a deploy would create. Public, no key, creates nothing.
cloudhosting_get_pricingnonePublic plan prices and the agent API quota.

Auth

Bearer API key per customer, scopes read/write/billing, hashed at rest, revoke or rotate at /account. initialize and tools/list are open; tools/call checks the key.

Limits

60 requests/min on the free plan, 240/min on paid plans, 20/min without a key. Over the limit: HTTP 429 with Retry-After.

Prices

Agent API: 5000 api_call units per month included on every plan; unit price $0 today (metering only). Hetzner compute is billed by Hetzner directly.

PlanPriceProjects
Free$0/mo1
Indie$8/mo2
Team$20/mo5
Scale$79/mo20
EnterpriseContact usUnlimited

Full price page: /pricing. Machine-readable: /v1/pricing, x-pricing in /openapi.json.

Example

curl -s https://cloudhostai.eliteaiempire.com/v1/deploy/preview -H 'Content-Type: application/json' \
  -d '{"repo_url":"https://github.com/OWNER/REPO"}'
curl -s -X POST https://cloudhostai.eliteaiempire.com/v1/projects/42/deploy -H 'Authorization: Bearer chai_...' \
  -H 'Content-Type: application/json' -d '{"confirm": true}'

Links: OpenAPI · MCP endpoint · server card · llms.txt · status