HostAfrica Claude connector

Public documentation for Anthropic reviewers, operators, and customers.

What this connector does

This connector lets Claude manage HostAfrica VPS infrastructure, domains, and billing through the HostAfrica MCP server at https://mcp.hostafrica.com/mcp. The shim adds OAuth 2.0 so Claude's hosted connector flow can authenticate: you paste a HostAfrica API token once at consent, and the shim maps Claude's OAuth tokens to that credential for protected tool calls.

Connector URL

https://mcp.hostafrica.com/mcp

Public domain-search connector (no OAuth)

https://mcp.hostafrica.com/domains/mcp exposes only check_domain_availability and suggest_domains. It never starts OAuth and never lists VPS or account tools. Use this URL when the client should only search domains. The full connector above is unchanged.

Setup (about 10 minutes)

Open Claude → Settings → Connectors → Add custom connector.
Paste the connector URL above.
If prompted for an OAuth Client ID, use hostafrica-mcp-client.
Try a public prompt below (domain check) — no Connect step required.
Try a protected prompt (e.g. list VPS) — Claude shows Connect; complete consent and paste your API token from panel.hostafrica.com/public-api.
Retry the protected prompt; Claude should call the tool with your account data.

Auth requirements

Request	Auth required	Notes
`tools/list`, `initialize`	No	Full catalog (71 tools) returned for discovery.
`check_domain_availability`, `suggest_domains`	No	Public domain search; no OAuth required.
All other `tools/call`	Yes	OAuth consent + HostAfrica API token. Missing auth returns HTTP 401 and triggers Connect.

See architecture for the mixed-authentication model and full tool schemas.

Sample prompts to test

Use these in Claude after adding the connector. They exercise public discovery, protected read, and a second protected capability.

Prompt	Tool(s)	Auth	Expected outcome
Is example.co.za available? Show pricing in ZAR.	`check_domain_availability`	None	Availability status, pricing for the requested currency, optional suggestions, and a `register_url` when the domain is available. Works before Connect.
Suggest domain names for a coffee shop in Cape Town.	`suggest_domains`	None	List of suggested domains with availability and pricing. Works before Connect.
List my HostAfrica VPS services.	`list_vps_services`	OAuth + API token	Connect card on first use; after consent, JSON list of VPS services (service IDs, hostnames, status) for the authenticated account.
Show firewall rules for VPS service ID <your-service-id>.	`list_firewall_rules`	OAuth + API token	Rules for that service (position, action, ports, sources) or an upstream error if the service ID is invalid or not owned by the account.

Known limitations

Protected tools require a HostAfrica API token from panel.hostafrica.com/public-api; this is API-token delegation, not HostAfrica password login.
Only the two public domain tools (check_domain_availability, suggest_domains) work before OAuth; VPS, infrastructure, monitoring, and billing tools require Connect.
Mutating tools (power, reinstall, snapshots, orders, etc.) affect real services — use a staging account for write tests when possible.
Order tools (create_order, validate_pricing) call HostAfrica WHMCS checkout/pricing APIs; incorrect pid / plan_id / config options from get_catalogue will fail validation.

Privacy and support

Privacy policy (HostAfrica): www.hostafrica.com/privacy-policy/
Connector notes: mcp.hostafrica.com/docs/claude/privacy
ChatGPT / anonymous domains MCP: developers/connecting-chatgpt-via-mcp
Support: www.hostafrica.com/contact-us/ · support@hostafrica.com

Revoke access

Remove the connector in Claude settings.
Revoke or rotate your API token at panel.hostafrica.com/public-api.
Revoke OAuth sessions via POST https://mcp.hostafrica.com/revoke (RFC 7009).