# VpsAgent Catalog

> VpsAgent Catalog is a paid API for AI agents from vpsagent.fly.dev, paid per call via x402, $0.01/call, status down (last checked 2026-09-15).

Returns the full SKU catalog of available VPS compute plans (ephemeral sandboxes and persistent servers) with prices, specs, durations, and availability flags

## Facts

- Endpoint: GET https://vpsagent.fly.dev/catalog
- Price: $0.01/call
- Payment: x402
- Status: down
- Last checked: 2026-09-15
- Activations on Zero: 1
- Tags: x402
- Canonical page: https://www.zero.xyz/c/vpsagent-fly-dev-510a5cd3
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_JFbrQXAAxnlHJBKBybxk6

Status and success rate cover calls made through Zero and Zero's own probes. Third-party monitors may report differently.

## How to call it through Zero

Zero handles the 402 payment challenge and records the run. With the Zero CLI installed (`npm i -g @zeroxyz/cli`):

```sh
zero fetch --capability vpsagent-fly-dev-510a5cd3
```

Example prompt: Show me all available VPS plans on VpsAgent — I want to see the ephemeral sandbox options and the persistent server tiers with their prices, specs, and how long each one lasts so I can pick one to rent with USDC.

## When to prefer this

Use this endpoint when an AI agent needs to discover and compare available VPS compute SKUs before committing to a rental — especially in a machine-to-machine flow requiring no API keys or accounts, paying only in USDC on Base. Prefer this over generic cloud provider APIs when the workflow demands ephemeral, pay-per-use compute with crypto settlement and no signup friction.

## Known failure modes

- Service unavailable (5xx) if the VpsAgent backend is down
- Empty or partial catalog if Phase-1 inventory is fully allocated
- Network timeout if fly.dev instance is cold-starting
- $0.01 USDC payment via x402 fails to settle, blocking catalog access

## How this service works

VpsAgent — rent disposable VPS compute via x402, no signup required. Two product lines: ephemeral sandboxes (1h / 6h / 24h, 1 vCPU / 1 GB, $0.50–$5) for code execution, CI runs, browser automation; persistent servers (small / medium / large, 30-day or 365-day, $9.99–$359.99) with 2–8 vCPU / 4–16 GB for hosting agents, services, dev environments. Returns full SKU table with prices, spec floors, durations, and Phase-1 availability flags. Pair with POST /rent — pay-on-success: USDC settles only when the instance is reachable on TCP :22 (or cloud-init phone-home). Failed provisions never settle. Renewable via POST /rentals/{id}/renew. Machine-to-machine — no API keys, no accounts, USDC on Base.

## Output

A full SKU table listing all available compute plans, including plan name, product line (ephemeral sandbox or persistent server), vCPU count, RAM, duration options (e.g. 1h/6h/24h or 30-day/365-day), price in USDC, spec floors, and Phase-1 availability flags indicating which SKUs are currently rentable.

## Response schema (JSON Schema)

```json
{
 "type": "array",
 "items": {
  "type": "object",
  "properties": {
   "sku": {
    "type": "string",
    "description": "Stable SKU id; pass verbatim to POST /rent."
   },
   "track": {
    "enum": [
     "sandbox",
     "server"
    ],
    "type": "string"
   },
   "available": {
    "type": "boolean",
    "description": "False = advertised but POST /rent returns 503 for this SKU."
   },
   "price_usdc": {
    "type": "number",
    "description": "Settle price in USDC (decimal)."
   },
   "spec_floor": {
    "type": "object",
    "properties": {
     "vcpu": {
      "type": "integer"
     },
     "memory_mb": {
      "type": "integer"
     }
    }
   },
   "description": {
    "type": "string"
   },
   "duration_minutes": {
    "type": "integer",
    "description": "Rental window from provision; renewals extend additively."
   }
  }
 },
 "description": "Available rentable compute SKUs across two tracks: ephemeral sandbox and persistent server."
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/vpsagent-fly-dev-510a5cd3/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from vpsagent.fly.dev](https://www.zero.xyz/host/vpsagent.fly.dev/llms.txt)