# Cloud for Bots

> Cloud infrastructure for AI bots: sandboxes, logged-in browser sessions, KV and file storage, secrets with a fetch proxy, queues, cron and timers, locks and shared rate counters, bot inboxes and topics, signed webhooks, run replay, a run ledger, a daily report, Login Vault and Human Handoff. One key, one HTTP API, one MCP server. Works alongside Grok Bot and any MCP client. Free to start; All Access is $49/month. Built by Supa Humans (https://supahumans.ai).

## Start
- Free key (one call): POST https://cloudforbots.com/api/offer-free {"email":"you@company.com"} -> {"ok":true,"keys":[{"tool","key"}]}. Any key on the account works for every service.
- MCP (Streamable HTTP): https://cloudforbots.com/mcp with header Authorization: Bearer <key> (or ?key=<key>)
- HTTP API: https://cloudforbots.com/api/v1/<service> with Authorization: Bearer <key>. Catalog: GET https://cloudforbots.com/api/v1
- OpenAPI: https://cloudforbots.com/openapi.json · Docs: https://cloudforbots.com/docs · Install: https://cloudforbots.com/install
- SDKs: https://cloudforbots.com/sdk/cloudforbots.mjs (TypeScript/JS, zero deps) · https://cloudforbots.com/sdk/cloudforbots.py (Python, stdlib)
- Manifest: https://cloudforbots.com/.well-known/cloudforbots.json · Pricing: https://cloudforbots.com/pricing.json
- Full reference for agents: https://cloudforbots.com/llms-full.txt
- Status: https://cloudforbots.com/status
- Setup for Grok Bot, Claude and ChatGPT: https://cloudforbots.com/free-your-bot

## Pricing
- Free: platform services with daily allowances (3 sandboxes and 60 sandbox minutes/day, 100 MB storage, 25 secrets, 1,000 locks, 200 rate counters, 1,000 schedules and timers). Run Budget Guard, Loop Breaker, Approval Rules, Login Vault and Human Handoff are watch-only (they log, they do not act).
- All Access: $49/month, https://cloudforbots.com/#bundle. The same keys switch to acting mode. Cancel any time in the billing portal.

## Notes
- Complements Grok Bot; does not replace it.

## Services (POST JSON with {"action": ...})
- /api/v1/sandbox run|write_file|read_file|sync_from_store|sync_to_store|status|pause|kill|list. Pauses after 1 idle minute; files and running processes survive. run {secrets:["NAME"]} lets code call the fetch proxy without seeing the value.
- /api/v1/browser open|run(steps)|screenshot|pause|kill|list. Chromium profile and cookies survive pause. {{secret:NAME}} fill locked to allowed hosts.
- /api/v1/store get|set|delete|list and file_put|file_get|file_meta|file_delete. 100 MB free.
- /api/v1/secrets set|list|delete (allowed_hosts). /api/v1/fetch {url,method,headers,body} with {{secret:NAME}}.
- /api/v1/queue push|pull|ack|nack|stats|dead|retry_dead|purge. /api/v1/cron set|list|history|pause|resume|delete|run_now|timer {delay_s|at, queue|webhook|request, payload}.
- /api/v1/lock acquire|renew|release|status|list (TTL, fencing). /api/v1/rate take|peek|list ("6/6h" shared window).
- /api/v1/inbox create|list|delete -> public https://cloudforbots.com/in/<token> into queue inbox.<name>. /api/v1/topic subscribe|unsubscribe|publish|list.
- /api/v1/webhooks (HMAC-signed, retried, delivery log). /api/v1/replay, /api/v1/ledger record|feed|rollup, /api/v1/report subscribe, /api/v1/alerts, /api/v1/audit.
- /api/v1/vault and /api/v1/handoff: watch-only on free keys, live on All Access.
- Errors: {ok:false,error:{type,message},request_id}. 429 with Retry-After. Idempotency-Key supported.

## Measured in production (p50, Oct 15 2026, from our own box)
lock acquire 212 ms · rate take 228 ms · queue push 213 ms · warm browser open 0.84 s · sandbox resume 354 ms · inbox ingest 238 ms

## New in Round 6
- Install: https://cloudforbots.com/install (one-line MCP for Grok Bot, ChatGPT, Claude)
- Login Vault: POST /api/v1/vault (free watch-only)
- Human Handoff: POST /api/v1/handoff (free watch-only)
- Run Replay: GET/POST /api/v1/replay or https://cloudforbots.com/runs
- Daily report: POST /api/v1/report {action:subscribe}
- OpenUI cards: pass ui:"openui" (open-source OpenUI Lang, no paid Gateway)

## Bot storage (KV + files)
POST https://cloudforbots.com/api/v1/store {"action":"set","key":"cursor","value":{"page":3}} with Authorization: Bearer <key>. Actions: get, set (ttl_seconds, if_version), incr, delete, list, file_put, file_get, file_meta, file_delete, file_list, usage. REST: /api/v1/store/kv/<ns>/<key>, /api/v1/store/files/<ns>/<name>. MCP tool: store. Free: 100 MB, 100k items per account.

## Secrets, queues, cron
- POST /api/v1/secrets {action:set,name:"OPENAI_KEY",value,allowed_hosts:["api.openai.com"]} — values encrypted, never returned. list / delete.
- POST /api/v1/fetch {url,method,headers,body} — use {{secret:NAME}}; https only, allowed hosts only, no private networks, no redirects; values redacted from the reply.
- POST /api/v1/queue {action:push|pull|ack|nack|stats|dead|retry_dead, queue, ...} — at-least-once with visibility timeout and dead letters. Free: 1,000 queues, 10,000 pushes/day.
- POST /api/v1/cron {action:set,name,schedule:"*/5 * * * *",request:{url,...}|{queue,message}} — UTC; list/history/pause/resume/delete/run_now. Free: 1,000 schedules.
- MCP tools: secrets, fetch, queue, cron.