In the console, under Account → API Keys, create a key and allow the IP address of the machine your agent runs on. Keys only work from the addresses you choose, and you can limit a key to read-only.
Your account comes with its own MCP endpoint, hosted by Hostereo. Point Claude Code, Cursor, Codex, Windsurf, Claude Desktop or any other MCP client at it with your key. Nothing to install, nothing to update.
"Create an Ubuntu 24.04 server in Tel Aviv on the Basic plan and give me its IP." The agent picks the plan, region and image from the live catalogue, creates the instance and reports back when it is running.
Nothing to download. Your agent talks to https://api-public.hostereo.com/mcp with your key. Replace hst_live_your_key with the key from the console.
claude mcp add --transport http hostereo https://api-public.hostereo.com/mcp \ --header "X-Api-Key: hst_live_your_key"
Then, inside Claude Code: "List my Hostereo instances" or "Create a WordPress server in Amsterdam".
Settings → MCP → Add new global MCP server, or edit ~/.cursor/mcp.json:
{
"mcpServers": {
"hostereo": {
"url": "https://api-public.hostereo.com/mcp",
"headers": { "X-Api-Key": "hst_live_your_key" }
}
}
}
In ~/.codex/config.toml:
[mcp_servers.hostereo]
url = "https://api-public.hostereo.com/mcp"
http_headers = { "X-Api-Key" = "hst_live_your_key" }
Every MCP client accepts the same definition in its MCP settings file (for Claude Desktop: claude_desktop_config.json):
{
"mcpServers": {
"hostereo": {
"url": "https://api-public.hostereo.com/mcp",
"headers": { "X-Api-Key": "hst_live_your_key" }
}
}
}
- Browse the live catalogue: regions, plans, OS images, 1-click apps (WordPress, Supabase, OpenVPN and more)
- Create instances from an OS image or an app, prepaid or postpaid
- Start, stop, reboot, hard reboot, resize
- Read live status, connection details and the console URL
- Organise instances in projects and tags
- Follow every operation until it succeeds or fails
- Creates run as a dry run first: every check, nothing built or charged, until you confirm
- Every create, power action or resize needs an explicit confirmation from you
- Keys are bound to your IP addresses and can be scoped to read-only
- Deleting a server is deliberately not possible through the API: that stays in the console
- Hosted by Hostereo for your account: 33 tools, nothing to install or update, every call is logged under your account
The MCP server is a thin layer over our public REST API. Same key, same capabilities, from any language, CI pipeline or Terraform.
curl -s https://api-public.hostereo.com/api/v1/regions
curl -s -X POST https://api-public.hostereo.com/api/v1/instances \
-H "X-Api-Key: hst_live_your_key" -H "Idempotency-Key: $(uuidgen)" \
-H "Content-Type: application/json" \
-d '{"plan_id":"<plan uuid>","region":"tlv-dc-1","image_id":"<image uuid>","name":"build-1","dry_run":true}'
Interactive reference and OpenAPI 3.1 specification: https://api-public.hostereo.com/api/docs
Sign up, create a key, paste one line into your agent. Your first servers are minutes away.
Create a free account