Agent-Native

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)

POST /api/v1/auth/register/ Register and get an API key
GET /api/v1/auth/whoami/ Verify API key and account

Discovery (no auth required)

GET /api/v1/plans/ List plans
GET /api/v1/plans/{slug}/ Plan details
GET /api/v1/status/ Platform status

Sites (authenticated)

POST /api/v1/sites/create/ Provision a site
GET /api/v1/sites/ List my sites
GET /api/v1/sites/{slug}/ Site details
POST /api/v1/sites/{slug}/dns/ Manage DNS
POST /api/v1/sites/{slug}/deploy/ Trigger deployment
POST /api/v1/sites/{slug}/snapshot/ Create snapshot
GET /api/v1/sites/{slug}/metrics/ Traffic metrics
POST /api/v1/sites/{slug}/scale/ Change plan
DELETE /api/v1/sites/{slug}/delete/ Delete site

File Management (authenticated)

GET /api/v1/sites/{slug}/files/ List directory contents
GET /api/v1/sites/{slug}/files/read/ Read a file
POST /api/v1/sites/{slug}/files/write/ Write a file
POST /api/v1/sites/{slug}/files/upload/ Upload a file (base64)
POST /api/v1/sites/{slug}/files/mkdir/ Create a directory
POST /api/v1/sites/{slug}/files/delete/ Delete a file

SSH Access (authenticated, VPS only)

GET /api/v1/sites/{slug}/ssh/ SSH connection info
POST /api/v1/sites/{slug}/ssh/keys/ Inject an SSH public key

Logs (authenticated)

GET /api/v1/sites/{slug}/logs/ View container logs

AI Modules (authenticated)

GET /api/v1/sites/{slug}/modules/ List modules
POST /api/v1/sites/{slug}/modules/{name}/toggle/ Enable/disable a module

Domain Management (authenticated)

GET /api/v1/domains/ List my domains
GET /api/v1/domains/search/ Check domain availability
POST /api/v1/domains/register/ Register a domain
GET /api/v1/domains/{name}/ Domain details
GET /api/v1/domains/{name}/dns/ List DNS records
POST /api/v1/domains/{name}/dns/add/ Add a DNS record
POST /api/v1/domains/{name}/dns/delete/ Delete a DNS record
POST /api/v1/domains/{name}/link/ Link a domain to a site
POST /api/v1/domains/{name}/settings/ Domain settings

ACP Checkout (no auth required)

POST /api/v1/acp/checkouts/ Create checkout session
GET /api/v1/acp/checkouts/{id}/ Checkout status
POST /api/v1/acp/checkouts/{id}/update/ Buyer info
POST /api/v1/acp/checkouts/{id}/complete/ Pay and provision

API Keys

POST /api/v1/keys/create/ Create key
GET /api/v1/keys/ List my keys
POST /api/v1/keys/{id}/rotate/ Rotate key

Account Management

POST /api/v1/account/update/ Update profile
DELETE /api/v1/account/delete/ Delete account
GET /api/v1/account/subscriptions/ List subscriptions
GET /api/v1/account/billing-portal/ Stripe billing portal

We respect your privacy

We use cookies to analyze traffic and improve your experience. In accordance with Quebec's Law 25, some cookies require your consent. Learn more