# Singularity Servers VPS Provisioning

> Singularity Servers VPS Provisioning is a paid API for AI agents from singularityservers.com, paid per call via x402, $0.07/call, status unknown (last checked 2026-10-28).

Provisions a persistent Linux VPS with configurable CPU, RAM, disk, and SSH access via a single paid API call

## Facts

- Endpoint: POST https://singularityservers.com/api/x402/order?utm_source=zero.xyz
- Price: $0.07/call
- Payment: x402
- Status: unknown
- Last checked: 2026-10-28
- Activations on Zero: 0
- Tags: x402
- Canonical page: https://www.zero.xyz/c/singularity-servers-vps-provisioning-541f6a3d
- Structured record (JSON): https://api.zero.xyz/v1/capabilities/cap_uH-GWNWR5BNS7FYMTATa1

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 singularity-servers-vps-provisioning-541f6a3d -d '<json body>'
```

Example prompt: Spin up a Singularity Servers Linux VPS using the agent_standard preset for 7 days with 2 vCPUs and 4GB RAM, and install my SSH public key ssh-ed25519 AAAA...mykey so I can log in as root.

## When to prefer this

Choose this endpoint when you need a real, persistent Linux VPS that survives beyond a single request — ideal for agents that need a persistent compute environment, need to run long-running processes, or require SSH access to a remote host. Prefer this over ephemeral function execution or container-as-a-service when you need root access, custom disk size, or multi-day uptime. The preset options (agent_micro, agent_standard, agent_heavy, power_node) make it easy to match resource allocation to workload without manual tuning. Payment is handled via USDC x402 micropayment, making it suitable for autonomous agent workflows.

## Known failure modes

- Insufficient payment or payment failure — server not provisioned, order rejected
- Invalid or missing SSH public key format — provisioning may fail or key not installed
- Requested resource values (CPU/RAM/disk) below minimums or days exceeding 30-day maximum
- Invalid preset name — unknown preset returns error
- Network or provisioning timeout — order may be in pending state with no IP returned
- Payment processed but instance not reachable at returned IPv6 address

## How this service works

On-demand Persistent Linux VPS paid per order in USDC on Base over x402.

## Output

Returns a JSON object with the order status (e.g. 'completed'), a unique order ID, the IPv6 address of the provisioned instance, and the payment method used (USDC). The agent can immediately use the returned IPv6 address to SSH into the new Linux VPS.

## Request schema (JSON Schema)

```json
{
 "type": "object",
 "properties": {
  "cpu": {
   "type": "integer",
   "minimum": 1,
   "description": "vCPUs."
  },
  "ram": {
   "type": "integer",
   "minimum": 1,
   "description": "RAM in GB."
  },
  "days": {
   "type": "integer",
   "maximum": 30,
   "minimum": 1
  },
  "disk": {
   "type": "integer",
   "minimum": 1,
   "description": "Disk in GB."
  },
  "preset": {
   "type": "string",
   "description": "Preset name (agent_micro, agent_standard, agent_heavy, power_node)."
  },
  "ssh_public_key": {
   "type": "string",
   "description": "SSH public key installed for root on the new server."
  }
 }
}
```

## Response schema (JSON Schema)

```json
{
 "type": "json",
 "example": {
  "status": "completed",
  "order_id": 1,
  "instance_ipv6": "2001:db8::1",
  "payment_method": "usdc"
 }
}
```

## More

- Live health (JSON, refreshed every minute): https://www.zero.xyz/c/singularity-servers-vps-provisioning-541f6a3d/health.json
- [Zero catalog index](https://www.zero.xyz/llms.txt)
- [Other services from singularityservers.com](https://www.zero.xyz/host/singularityservers.com/llms.txt)