Automate VPS provisioning, networking, security, backups, and monitoring through the public API, the HA CLI, or an MCP-compatible interface - all generated from the same OpenAPI contract.
Use the same HostAfrica token across the public API, the HA CLI, MCP, and SDKs.
Generate one bearer token, then use it from curl, the CLI, MCP, or an SDK.
Generate a token
Generate a bearer token in the HostAfrica Client Area (opens in new tab).
Make your first request
Make a first authenticated request to https://api.hostafrica.com.
Scale with the CLI or MCP
Switch to the CLI or MCP once you want reusable ops or agent workflows.
New to the API? Follow the full Getting Started guide.
export HA_TOKEN=<your-bearer-token>
curl https://api.hostafrica.com/vps/list-vps-services \
-H "Authorization: Bearer $HA_TOKEN" \
-H "Content-Type: application/json" \
-d '{"page":1,"page_size":10}'export HA_SERVER=https://api.hostafrica.com
export HA_TOKEN=<your-bearer-token>
./ha list-vps-services \
| jq .data.services{
"mcpServers": {
"hostafrica-api": {
"type": "http",
"url": "https://api.hostafrica.com/mcp",
"headers": {
"Authorization": "Bearer <your-token>"
}
}
}
}import {Configuration, VPSManagementApi} from "@hostafrica/ha-sdk-typescript";
const client = new VPSManagementApi(
new Configuration({
accessToken: "<your-bearer-token>",
}),
);
const vps = await client.listVpsServices();Everything below is a real endpoint you can call today.
List services, inspect configs, mount ISOs, and reinstall operating systems.
Explore VPS docsStart, stop, reboot, shutdown, and schedule recurring power actions.
Explore power docsCreate and manage backups without leaving your workflow.
Explore backup docsControl inbound and outbound rules, rotate credentials, and manage SSH keys.
Explore security docsMap allocated IPs back to hostnames and keep naming consistent across services.
Explore DNS docsSet alerts on critical metrics and respond before issues spread.
Explore monitoring docsReference docs, a Postman collection, the HA CLI, and official SDKs.
Both reach the same platform - pick by how your agents and scripts run.
For a full breakdown of all three approaches - including direct HTTP and token-cost tradeoffs - read the Using Agents guide.
Common questions about the HostAfrica API, CLI, and MCP surface.
Bearer header on your requests. The API itself is free - you only pay for the VPS services you run. Don't have an account yet? Register at HostAfrica first.Our support team is here around the clock to help you build on the HostAfrica platform.
