⚡ Powered by x402 Protocol · USDC on Base

Docker containers for
AI agents.
Pay per hour.

Spin up a container in under 2 seconds. Pay with USDC on Base. No signup, no API key, no dashboard. Your wallet is your identity.

# Agent sends HTTP request POST https://x402vps.com/api/provision Content-Type: application/json { "plan": "A", "leaseHours": 1 } # ← 402 Payment Required ($0.25 USDC) # Agent pays via x402, retries with proof # ← 200 OK { "id": "ctr_f0c0db", "plan": "A", "status": "running", "ip": "172.18.0.5" }

How it works

Four steps. No humans involved.

1

Agent requests

Agent sends POST /api/provision with plan + lease hours

2

Gets 402

Server responds with HTTP 402 + payment details (USDC on Base)

3

Agent pays

Agent signs USDC payment, retries request with payment proof

4

Container runs

Server provisions Docker container, returns ID + IP. Exec commands.

Simple pricing

Pay per day or per hour. No subscriptions. No commitments.

PLAN A
$0.01/hr
$0.25/day
  • CPU 0.1 vCPU
  • RAM 256 MB
  • Disk 2 GB
  • Best for Scripts
PLAN B
$0.02/hr
$0.50/day
  • CPU 0.25 vCPU
  • RAM 512 MB
  • Disk 5 GB
  • Best for Python/Node
PLAN C
$0.04/hr
$1.00/day
  • CPU 0.5 vCPU
  • RAM 1 GB
  • Disk 10 GB
  • Best for Scraping
PLAN D
$0.08/hr
$2.00/day
  • CPU 1.0 vCPU
  • RAM 2 GB
  • Disk 20 GB
  • Best for Browsers

API Reference

All endpoints accept JSON. Paid endpoints return 402 without payment.

GET / Service info + plans FREE
GET /health Server health + capacity FREE
GET /api/status/:id Container status + remaining time FREE
GET /api/list List all containers FREE
POST /api/create {plan, image?, leaseHours?} → container By plan
POST /api/exec {id, command} → output FREE
POST /api/extend {id, hours} → updated lease Hourly
POST /api/destroy {id} → destroyed FREE

Quick Start (cURL)

# Create a container (Plan A, 1 hour) curl -X POST https://x402vps.com/api/create \ -H "Content-Type: application/json" \ -H "X-Wallet: 0xYourWallet" \ -d '{"plan":"A","leaseHours":1}' # Run a command inside the container curl -X POST https://x402vps.com/api/exec \ -H "Content-Type: application/json" \ -H "X-Wallet: 0xYourWallet" \ -d '{"id":"ctr_f0c0db","command":"python3 script.py"}' # Check status curl -H "X-Wallet: 0xYourWallet" https://x402vps.com/api/status/ctr_f0c0db # Destroy when done curl -X POST https://x402vps.com/api/destroy \ -H "Content-Type: application/json" \ -H "X-Wallet: 0xYourWallet" \ -d '{"id":"ctr_f0c0db"}'

MCP Server (for Claude/Cursor)

# Install MCP server npx @x402vps/mcp # Or add to claude_desktop_config.json { "mcpServers": { "x402vps": { "command": "npx", "args": ["@x402vps/mcp"] } } }