Drive Bot-Hosting from your code, your editor or your AI.
A REST API, an MCP server, OAuth sign-in and a CLI, all on the same operations, permissions and rate limits as the dashboard.
Public beta. Build, experiment and have fun with it, but use it with care: endpoints may still change, and every call acts on your real deployments.
REST API 71 endpoints to drive your account: deployments, files, env vars, backups, packages, domains. Bearer bhk_ keys, 120 requests a minute MCP server The same 71 operations as tools, so ChatGPT, Claude Desktop or Cursor can manage your deployments. OAuth for ChatGPT, API key for the others OAuth 2.1 Let your users sign in with their Bot-Hosting account and act within the scopes they approve. PKCE, access 7 days, refresh 30 days CLI Link a folder to a deployment and push every save from your own editor. npm i -g bot-hosting
One key, one request
Create a key in your developer settings, give it only the scopes it needs, and pass it as a Bearer token.
Scopes
The same catalog for API keys, MCP and OAuth. A request runs only if the key holds the scope and you have permission on the resource.
Deployments
- deployments:read List and inspect deployments
- deployments:power Start, stop, restart, console
- deployments:write Create, edit, delete, resize, move
- deployments:shell Run shell commands in a container
- projects:read List your projects
- projects:write Create and delete projects
- files:read Browse and download files
- files:write Upload, edit, rename, delete files
- env:read Read env vars, secrets masked
- env:write Set env vars
- backups:read List restore points
- backups:write Take, restore, delete restore points
- packages:read View installed packages
- packages:write Add and remove packages
Account
- account:read Read profile and quota
- billing:read Read invoices and plan
- credits:spend Spend credits to create resources
Templates and docs
- templates:read Browse public templates
- docs:read Search and read the docs