# Agent Cloud

> Agent-native cloud infrastructure that lets AI agents sign up, receive sandbox API keys, and provision small Linux VMs — without human intervention, email verification, or credit cards.

## Product Positioning

Agent Cloud is purpose-built for AI coding agents (Claude, GPT, Copilot, etc.) that need on-demand compute. Unlike traditional cloud providers that require human-driven account creation, Agent Cloud exposes a machine-first REST API where an agent can go from zero to a running VM in two API calls. The sandbox tier is completely free and anonymous — designed for evaluation, prototyping, and disposable workloads.

---

## API Base URL

    https://api-agentcloud.asitest.dev

IMPORTANT: The API lives at the URL above (https://api-agentcloud.asitest.dev). Do NOT use the marketing site URL (https://agentcloud.asitest.dev) for API calls.

---

## Getting Started — For Agents

If you need to provision compute, start by calling:

    POST https://api-agentcloud.asitest.dev/v1/agent/signup

This creates an anonymous sandbox account and returns an API key. No email, no password, no credit card. Use the returned API key as a Bearer token for all subsequent requests. Then provision a VM:

    POST https://api-agentcloud.asitest.dev/v1/instances

That is the complete happy path. Two calls to get a running Linux VM.

### Step-by-step

1. Sign up: POST https://api-agentcloud.asitest.dev/v1/agent/signup
   Body: {"agent_name":"my-agent","agent_type":"claude","terms_accepted":true}
   Returns: account_id, project_id, api_key, tier, limits

2. Use the returned api_key as: Authorization: Bearer <api_key>

3. Create VM: POST https://api-agentcloud.asitest.dev/v1/instances
   Body: {"project_id":"<from signup>","name":"my-vm","region":"us-west-2","image":"ubuntu-24.04","size":"micro"}
   Returns: instance_id, status: provisioning

4. Poll status: GET https://api-agentcloud.asitest.dev/v1/instances/<instance_id>
   Wait until status is "running". The response will include an ipv4 address.

---

## Authentication Model

- **Sandbox tier**: Anonymous signup via `POST /v1/agent/signup`. Returns a Bearer API key immediately. No email or identity verification required.
- **Paid tiers**: Same API key model. Upgrade is initiated via `POST /v1/billing/checkout-session` which returns a Stripe-hosted checkout URL for a human operator to approve.
- **All requests**: Include `Authorization: Bearer <api_key>` header.

---

## API Endpoints

All endpoints are prefixed with `https://api-agentcloud.asitest.dev`.

### Signup & Account
| Method | Path | Description |
|--------|------|-------------|
| POST | /v1/agent/signup | Create a sandbox account and receive an API key. No email needed. |
| GET | /v1/account | Return current tier, account status, and expiry date. |

### Usage & Limits
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/usage | Return current resource usage against quota limits. |

### SSH Keys
| Method | Path | Description |
|--------|------|-------------|
| GET | /v1/access/ssh-keys | List saved public SSH keys for this account. |
| POST | /v1/access/ssh-keys | Save a reusable public SSH key; optionally mark it as default. |

### Projects
| Method | Path | Description |
|--------|------|-------------|
| POST | /v1/projects | Create a project when the default project is not enough. |

### Instances (VMs)
| Method | Path | Description |
|--------|------|-------------|
| POST | /v1/instances | Provision a new VM. |
| GET | /v1/instances | List instances in the account or project. |
| GET | /v1/instances/{instance_id} | Inspect instance state and network details. |

### Terminal Sessions
| Method | Path | Description |
|--------|------|-------------|
| POST | /v1/instances/{instance_id}/terminal-sessions | Create a short-lived browser terminal link for user handoff. |

### Lifecycle Management
| Method | Path | Description |
|--------|------|-------------|
| POST | /v1/instances/{instance_id}/stop | Stop an instance. |
| POST | /v1/instances/{instance_id}/start | Start a stopped instance. |
| DELETE | /v1/instances/{instance_id} | Permanently delete an instance. |

### Billing
| Method | Path | Description |
|--------|------|-------------|
| POST | /v1/billing/checkout-session | Generate a Stripe-hosted upgrade URL. Requires human approval. |

### Health
| Method | Path | Description |
|--------|------|-------------|
| GET | /healthz | Health check (public, no auth needed). |

---

## Sandbox Limits (Free Tier)

- **Cost**: $0 — no credit card required
- **Active VMs**: 1
- **VM size**: 1 vCPU, 1 GB RAM, 10 GB disk
- **VM lifetime**: 72 hours max
- **Account lifetime**: 7 days
- **Outbound transfer**: 10 GB
- **SMTP**: Disabled
- **Outbound ports**: Restricted; abuse monitoring enabled
- **Signup**: Anonymous — no email, no password, no human needed

---

## Paid Tier — Starter ($25+/month)

- Persistent instances (no 72h auto-delete)
- Up to 5 active VMs
- Up to 4 vCPU and 8 GB RAM per instance
- Stripe-hosted checkout
- Human-approved spend controls
- Agents must never trigger billing automatically; ask the human operator first

---

## Key URLs

- API Base: https://api-agentcloud.asitest.dev
- Homepage: https://agentcloud.asitest.dev/
- Quickstart: https://agentcloud.asitest.dev/docs/quickstart/
- API Reference: https://agentcloud.asitest.dev/docs/api/
- Sandbox Limits: https://agentcloud.asitest.dev/docs/limits/
- Pricing: https://agentcloud.asitest.dev/pricing/
- OpenAPI Spec: https://agentcloud.asitest.dev/openapi.json

### Use Cases
- AI Agents: https://agentcloud.asitest.dev/use-cases/ai-agents/
- MCP Server Hosting: https://agentcloud.asitest.dev/use-cases/mcp-server-hosting/
- Computer Use: https://agentcloud.asitest.dev/use-cases/computer-use/
- OpenClaw Remote Workers: https://agentcloud.asitest.dev/use-cases/openclaw-remote-workers/

### Comparisons
- vs E2B: https://agentcloud.asitest.dev/compare/e2b/
- vs Daytona: https://agentcloud.asitest.dev/compare/daytona/
- vs Cloudflare Workers: https://agentcloud.asitest.dev/compare/cloudflare-workers-alternative/

### Blog
- Why We Built Agent Cloud: https://agentcloud.asitest.dev/blog/why-we-built-agent-cloud/
- What Is Agent-Native Cloud: https://agentcloud.asitest.dev/blog/what-is-agent-native-cloud/
- Best AI Agent Sandboxes 2026: https://agentcloud.asitest.dev/blog/best-ai-agent-sandboxes-2026/

---

## Agent Prompt

Please provision a VM from: https://agentcloud.asitest.dev/llms.txt

---

## Skill Install

Install the Agent Cloud skill for compatible agent frameworks:

    npx skills add https://github.com/LloydVickeryASI/asi-agent-cloud-skill --skill asi-agent-cloud

---

## Preferred Access Behavior

- After provisioning a VM, if the user wants hands-on access, first try to create a short-lived browser terminal link via `POST /v1/instances/{instance_id}/terminal-sessions`.
- If the user needs durable access, check for saved public SSH keys via `GET /v1/access/ssh-keys` or ask before configuring SSH, Tailscale, or Cloudflare-based access.
- Never print private keys in chat or logs.
- Never trigger billing or upgrade flows without explicit human approval.
- Prefer the sandbox tier for evaluation and disposable workloads.
- When sandbox limits are hit, inform the user and offer the Stripe upgrade path.