Appearance
Automation (MCP) API
The /mcp endpoint lets MCP clients - Claude and other assistants that speak the Model Context Protocol - drive your account. Ask in plain language ("clone my staging pod", "how much credit is left?") and the client calls the matching tool.
Authentication
MCP is API key only. A login token will not work here.
http
Authorization: Bearer mck_...Create a key, scope it to exactly what the assistant should be allowed to touch, and optionally IP-bind it - see API keys. The key's permissions decide which tools it can call, and a key only ever sees the tools it is allowed to use.
Protocol
/mcp speaks JSON-RPC 2.0 over plain HTTP POST. It is stateless (no sessions, no streaming), so every call is a self-contained request to:
POST https://cloud-api.microapps.io/mcp| Method | What it does |
|---|---|
initialize | Handshake; the client announces itself and gets server info back |
ping | Liveness check |
tools/list | List the tools this key may call |
tools/call | Run a tool, with params: { name, arguments } |
Most MCP clients only need the URL and your API key; they handle the JSON-RPC plumbing for you.
Tools
Each tool is gated by the same permission as its REST equivalent, so a key can never do more through MCP than it could through the API. Tools the key cannot use do not show up in tools/list.
| Tool | Does | Permission |
|---|---|---|
list_pods | List your pods | pods:read |
get_pod | Describe one pod | pods:read |
pod_action | Start, stop, or restart a pod (action: start / stop / restart) | pods:update |
clone_pod | Clone a pod into a new one | pods:create |
list_snapshots | List a pod's snapshots | snapshots:read |
create_snapshot | Take a snapshot | snapshots:create |
list_backups | List a pod's backups | backups:read |
list_account_backups | List every backup on the account | backups:read |
create_backup | Take a backup | backups:create |
list_domains | List your domains | domains:read |
list_networks | List your networks | networks:read |
get_account | Read credit, limits, and contact details | any key |
Tools that change things (pod_action, clone_pod, create_snapshot, create_backup) obey the same $3 credit minimum as the API and show up in your activity log, just like a console click.
Example: list tools
bash
curl -X POST https://cloud-api.microapps.io/mcp \
-H "Authorization: Bearer $MCK_KEY" \
-H "Content-Type: application/json" \
-d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'