AI Agent Hosting API
Provision websites, manage DNS, deploy code, and change plans — all via REST API, MCP server, or Stripe ACP.
What your agent can do
46 tools covering the complete lifecycle of your hosting. Your AI assistant manages everything — you supervise.
Hosting
Purchase, provision, scale
Deployment
Deploy, rollback
DNS
A, CNAME, MX, TXT, SRV
Files
Read, write, upload
Snapshots
Local, B2 cloud, scheduled
Backups
Auto, manual, restore
Domains
Search, register, DNS
SSH
Connection, SSH keys
AI Modules
Chatbot, SEO, translation
Security
Per-site keys, permissions
Three Ways to Integrate
REST API
Standard JSON endpoints with Bearer token authentication. Works with any language.
https://borealhost.ai/api/v1/
MCP Server
Model Context Protocol server for Claude, ChatGPT, and other AI assistants. 46 tools available.
https://borealhost.ai/mcp/
Stripe ACP
Agent Checkout Protocol for automated payments. Agents can purchase directly.
/.well-known/acp.json
Quick Start — Agent Self-Service
1. Register and Get an API Key
No authentication required. The key is shown once only.
curl -X POST https://borealhost.ai/api/v1/auth/register/ \
-H "Content-Type: application/json" \
-d '{"email": "[email protected]", "name": "My Agent"}'
2. Browse Plans
curl https://borealhost.ai/api/v1/plans/
3. Create a Checkout
curl -X POST https://borealhost.ai/api/v1/acp/checkouts/ \
-H "Content-Type: application/json" \
-d '{"sku": "bh_site_starter_monthly"}'
4. Set Buyer Info
curl -X POST https://borealhost.ai/api/v1/acp/checkouts/CHECKOUT_ID/update/ \
-H "Content-Type: application/json" \
-d '{"buyer_email": "[email protected]", "requested_slug": "my-site"}'
5. Pay and Provision
Returns a Stripe URL for payment. The site is provisioned automatically after payment.
curl -X POST https://borealhost.ai/api/v1/acp/checkouts/CHECKOUT_ID/complete/ \
-H "Content-Type: application/json" \
-d '{"payment_method": "stripe_checkout"}'
6. Check Status and Get API Key
After payment, poll this endpoint. The response includes your API key and site info.
curl https://borealhost.ai/api/v1/acp/checkouts/CHECKOUT_ID/
7. Manage Your Site
curl -H "Authorization: Bearer bh_YOUR_KEY" \
https://borealhost.ai/api/v1/sites/my-site/
Endpoint Reference
Registration (no auth required)
/api/v1/auth/register/
Register and get an API key
/api/v1/auth/whoami/
Verify API key and account
Discovery (no auth required)
/api/v1/plans/
List plans
/api/v1/plans/{slug}/
Plan details
/api/v1/status/
Platform status
Sites (authenticated)
/api/v1/sites/create/
Provision a site
/api/v1/sites/
List my sites
/api/v1/sites/{slug}/
Site details
/api/v1/sites/{slug}/dns/
Manage DNS
/api/v1/sites/{slug}/deploy/
Trigger deployment
/api/v1/sites/{slug}/snapshot/
Create snapshot
/api/v1/sites/{slug}/metrics/
Traffic metrics
/api/v1/sites/{slug}/scale/
Change plan
/api/v1/sites/{slug}/delete/
Delete site
File Management (authenticated)
/api/v1/sites/{slug}/files/
List directory contents
/api/v1/sites/{slug}/files/read/
Read a file
/api/v1/sites/{slug}/files/write/
Write a file
/api/v1/sites/{slug}/files/upload/
Upload a file (base64)
/api/v1/sites/{slug}/files/mkdir/
Create a directory
/api/v1/sites/{slug}/files/delete/
Delete a file
SSH Access (authenticated, VPS only)
/api/v1/sites/{slug}/ssh/
SSH connection info
/api/v1/sites/{slug}/ssh/keys/
Inject an SSH public key
Logs (authenticated)
/api/v1/sites/{slug}/logs/
View container logs
AI Modules (authenticated)
/api/v1/sites/{slug}/modules/
List modules
/api/v1/sites/{slug}/modules/{name}/toggle/
Enable/disable a module
Domain Management (authenticated)
/api/v1/domains/
List my domains
/api/v1/domains/search/
Check domain availability
/api/v1/domains/register/
Register a domain
/api/v1/domains/{name}/
Domain details
/api/v1/domains/{name}/dns/
List DNS records
/api/v1/domains/{name}/dns/add/
Add a DNS record
/api/v1/domains/{name}/dns/delete/
Delete a DNS record
/api/v1/domains/{name}/link/
Link a domain to a site
/api/v1/domains/{name}/settings/
Domain settings
ACP Checkout (no auth required)
/api/v1/acp/checkouts/
Create checkout session
/api/v1/acp/checkouts/{id}/
Checkout status
/api/v1/acp/checkouts/{id}/update/
Buyer info
/api/v1/acp/checkouts/{id}/complete/
Pay and provision
API Keys
/api/v1/keys/create/
Create key
/api/v1/keys/
List my keys
/api/v1/keys/{id}/rotate/
Rotate key
Account Management
/api/v1/account/update/
Update profile
/api/v1/account/delete/
Delete account
/api/v1/account/subscriptions/
List subscriptions
/api/v1/account/billing-portal/
Stripe billing portal