# OpenVPS — AI-Agent VPS Hosting

> Servers that AI agents buy themselves. Pay USDC, get SSH in seconds.

## What is OpenVPS?

OpenVPS provisions isolated Linux VMs and accepts payment via HTTP 402.
AI agents request compute, pay with USDC on Base, Celo, or Tempo,
and get root SSH access to Ubuntu 24.04 VMs in under 3 seconds.

No accounts. No API keys. No human in the loop.

## How to use

Your agent should read the skill file for complete instructions:

    curl https://openvps.sh/skill.md

## API Endpoints

### VPS Provisioning (v1 — SSH key auth)
    POST /v1/provision     — Pay → get VM + SSH private key
    GET  /v1/vms/{id}      — Check VM status
    DELETE /v1/vms/{id}    — Terminate VM early

### VPS Provisioning (v2 — wallet auth, no SSH keys)
    POST /v2/provision     — Pay → get challenge to sign
    POST /v2/session       — Sign challenge → one-time SSH token
    POST /v2/auth/verify   — PAM verifies token on SSH login

### Jobs (run any command, auto-cleanup)
    POST /v1/jobs          — Pay → submit command → VM runs it → returns output
    GET  /v1/jobs/{id}     — Poll job status and output

### Discovery & Status
    GET  /health           — Health check
    GET  /status           — Live capacity (available slots, CPUs, RAM)
    GET  /.well-known/x402 — x402 resource discovery
    GET  /openapi.json     — OpenAPI 3.0 spec with payment info

## Payment Protocols

- x402 (Coinbase standard) — Base USDC, Celo USDC
- MPP (Machine Payments Protocol) — Tempo USDC.e, pathUSD

## Payment Networks

| Network | Token | Chain ID |
|---------|-------|----------|
| Base    | USDC  | 8453     |
| Celo    | USDC  | 42220    |
| Tempo   | USDC.e | 4217    |

## Pricing

- 1 vCPU: $0.005/hour
- 1 GB RAM: $0.002/hour
- 1 GB Disk: $0.0001/hour

## Links

- Skill file: https://openvps.sh/skill.md
- OpenAPI spec: https://openvps.sh/openapi.json
- x402 discovery: https://openvps.sh/.well-known/x402
- Source: https://github.com/kartojal/openvps
- x402scan: https://www.x402scan.com/server/a7ad4651-cc49-4448-bbb7-b7cf18c29893