# agvps Small VPS Provisioning

> agvps Small VPS Provisioning is a paid API for AI agents from agvps.shveik.dev, paid per call via x402, $10.012/call, status unknown (last checked 2026-10-12).

Provisions a small Linux VPS (1 vCPU) with root access and a dedicated IPv4 in Germany or Finland, paid via stablecoin with no account signup required.

## Facts

- Endpoint: POST https://agvps.shveik.dev/x402/vps-small?utm_source=zero.xyz
- Price: $10.012/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-12
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/agvps-small-vps-provisioning-b6ca5df2
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_cOoWLSPjDweVLFfUTlicd

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 agvps-small-vps-provisioning-b6ca5df2 -d '<json body>'
```

Example prompt: Spin up a small Linux VPS for me called 'agent-node' in Germany — pay with USDC, no card needed.

## When to prefer this

Choose this endpoint when you need a disposable or persistent Linux server quickly, want to pay with USDC or other stablecoins without a credit card or account, and need a European location (Germany or Finland). Ideal for AI agents that need compute infrastructure autonomously without human-in-the-loop account creation.

## Known failure modes

- Invalid hostname format (must match ^[a-z0-9]([a-z0-9-]{0,38}[a-z0-9])?$) returns a 422 validation error
- Invalid location value (only 'de' or 'fi' accepted) returns a 422 error
- Payment failure or insufficient USDC balance causes a 402 or payment error
- Server provisioning queued but may take time — status must be polled via status_url
- Capacity unavailable in selected location may result in a delayed or failed provision

## How this service works

Rent a Linux server for a month and get root access: 1 vCPU, 1 GB RAM, 10 GB NVMe, a dedicated IPv4 address, Ubuntu 24.04, in Germany or Finland. Pay per month in stablecoins with x402 or MPP, no account and no card. The answer carries a server id and secret; the IP and the root password follow in about 5 to 10 minutes. Extend it with the renew route.

## Output

Returns a JSON object with the new server's ID, OS, plan, specs (1 vCPU etc.), hostname, location, a secret key for access, the initial status (queued), and a status URL to poll for readiness.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "hostname": {
   "type": "string",
   "pattern": "^[a-z0-9]([a-z0-9-]{0,38}[a-z0-9])?$"
  },
  "location": {
   "enum": [
    "de",
    "fi"
   ],
   "type": "string"
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "id": "vps_0123…",
  "os": "Ubuntu 2…",
  "next": "The serv…",
  "plan": "small",
  "specs": "1 vCPU,…",
  "secret": "sk_01234…",
  "status": "queued",
  "hostname": "my-serve…",
  "location": "de",
  "status_url": "https://…"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/agvps-small-vps-provisioning-b6ca5df2/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from agvps.shveik.dev](https://www.zero.xyz/host/agvps.shveik.dev/llms.txt)