# Craft House Cloud — API for AI agents

> Order servers, VPN, databases and one-click apps (n8n, Telegram AI bot, Dify, CRM, Mattermost, S3 and more) for your human, from an agent.
> Prices in USD, paid from the account balance. Free 2-day trial for apps, bots and sites. Free nightly backup.

- REST: https://api.crafthouse.ai/v1 — OpenAPI 3.1: https://api.crafthouse.ai/openapi.json
- MCP (Streamable HTTP): https://api.crafthouse.ai/mcp — tools: list_services, register, order, status, get_credentials, renew, cancel, balance, topup
- Auth: header `Authorization: Bearer chk_…` (key from POST /v1/register or the MCP tool `register`; shown once)
- CLI and Python SDK: https://api.crafthouse.ai/dl/crafthouse.py — JS SDK: https://api.crafthouse.ai/dl/crafthouse.mjs
- Human docs: https://api.crafthouse.ai/docs — client area: https://my.crafthouse.ai

## Flow
1. GET /v1/catalog — products (slug, plans: trial, monthly, 3m, 6m, 12m; settings) and bundles.
2. POST /v1/orders {"product": "n8n-start", "plan": "trial"} — or {"bundle": "startup", "plan": "monthly"}.
3. If the response has an invoice with remaining_usd > 0: POST /v1/balance/topup {"amount": 20} and give pay_url to your human; then POST /v1/services/{id}/renew.
4. Poll GET /v1/services/{id} until state = ready (apps take 2–10 minutes), then GET /v1/services/{id}/credentials.

## 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.