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).
- Create an account (free, no card) and a key at /account (scopes read + write).
- Connect your Hetzner token once in Settings.
- Call
cloudhosting_preview_deploy(no key needed), thencloudhosting_create_project, thencloudhosting_deploy_projectwithconfirm=true; pollcloudhosting_get_project_status.
Tools
| Tool | Scope | Needs | Description |
|---|---|---|---|
cloudhosting_list_projects | read | List your projects. | |
cloudhosting_get_project | read | Get one project. | |
cloudhosting_get_project_status | read | Refresh and return the server status from Hetzner. | |
cloudhosting_list_deploys | read | Deploy history for a project (last 20). | |
cloudhosting_get_logs | read | Fetch container logs over SSH from the project server. | |
cloudhosting_get_hetzner_status | read | Whether your Hetzner token is connected (never returns it). | |
cloudhosting_get_usage | read | API/MCP calls this month against the free quota. | |
cloudhosting_export | read | Export all your objects (json, or csv of projects). | |
cloudhosting_get_account | billing | Plan, project limit and usage of the account. | |
cloudhosting_create_project | write | Register a project (repo + server size). Creates no server. | |
cloudhosting_deploy_project | write | confirm=true | Deploy (creates or redeploys the server in YOUR Hetzner account; Hetzner bills you). Requires confirm=true. |
cloudhosting_destroy_server | write | confirm=true | DESTRUCTIVE: delete the project server from your Hetzner account. Requires confirm=true. |
cloudhosting_delete_project | write | confirm=true | DESTRUCTIVE: delete a project record (server must be destroyed first). Requires confirm=true. |
cloudhosting_preview_deploy | none | Dry run: check a public repo + branch and show what a deploy would create. Public, no key, creates nothing. | |
cloudhosting_get_pricing | none | Public 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.
| Plan | Price | Projects |
|---|---|---|
| Free | $0/mo | 1 |
| Indie | $8/mo | 2 |
| Team | $20/mo | 5 |
| Scale | $79/mo | 20 |
| Enterprise | Contact us | Unlimited |
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