Craft House Cloud API

Let an AI agent order servers, VPN, databases and one-click apps for you. Prices in USD; paid from your account balance at my.crafthouse.ai.

Quick start

curl -s https://api.crafthouse.ai/v1/register -H 'Content-Type: application/json' -d '{"email":"you@example.com"}'
# → api_key (shown once), password for my.crafthouse.ai

curl -s https://api.crafthouse.ai/v1/orders -H "Authorization: Bearer $KEY" -H 'Content-Type: application/json' \
  -d '{"product":"n8n-start","plan":"trial"}'
curl -s https://api.crafthouse.ai/v1/services/ID -H "Authorization: Bearer $KEY"        # wait for "state": "ready"
curl -s https://api.crafthouse.ai/v1/services/ID/credentials -H "Authorization: Bearer $KEY"

CLI

curl -fsSL https://api.crafthouse.ai/dl/crafthouse.py -o ~/.local/bin/crafthouse && chmod +x ~/.local/bin/crafthouse
crafthouse register you@example.com
crafthouse order n8n-start --plan trial --wait
crafthouse creds ID

MCP

Add a remote MCP server with URL https://api.crafthouse.ai/mcp and header Authorization: Bearer chk_…. Tools: list_services, register, order, status, get_credentials, renew, cancel, balance, topup.

Webhooks

POST /v1/keys {"webhook_url":"https://…"} returns a new key and a webhook_secret. Events service.active and invoice.created arrive as JSON with header X-Crafthouse-Signature: sha256=HMAC_SHA256(body, webhook_secret).

Limits

60 requests per minute per key. Sign-ups and trials are limited per IP per day. A new account may hold 2 services before its first payment. Every call is logged.