EQVPS
REST API · MCP

EQVPS API

Registreer, waardeer op in crypto en bestel volledig via code een VPS — geen KYC, geen mens in de lus. Gebouwd voor ontwikkelaars en voor AI-agents die hun eigen servers provisioneren.

OpenAPI 3.1MCP live · 26 toolsBearer authREST + MCP
Basis-URLhttps://api.eqvps.com/api/v1/eqvps
Live uitproberenOpenAPI-specVolledige referentie

Snelstart

Vier calls: van nul naar een draaiende VPS. De tokens hieronder zijn plaatshouders — plak nooit een echt token in een pagina.

# 1. Register — returns a Bearer token (no KYC, no human step)
curl -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"agent@example.com"}'
# → { "token": "<YOUR_API_TOKEN>" }
# 2. Top up balance — pay in USDC / USDT / PYUSD, get a checkout URL
curl -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"amount":20}'
# → { "checkout_url": "https://…" }   # pay on-chain, balance credits automatically
# 3. Order a VPS — paid from balance (get slug + os_id from GET /products)
curl -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_API_TOKEN>" \
  -H "Content-Type: application/json" \
  -d '{"product":"micro","os_id":1,"ssh_key":"ssh-ed25519 AAAA…"}'
# 4. Read SSH access — one-time root password is shown once here
curl https://api.eqvps.com/api/v1/eqvps/services/SV-XXXXXX \
  -H "Authorization: Bearer <YOUR_API_TOKEN>"
# → { "status":"active", "ssh": { "host":"…", "port":22, "command":"ssh root@… -p 22" } }

Belangrijkste endpoints

De kern van het oppervlak. Open de interactieve explorer voor elke parameter en respons.

POST/auth/registerMaak een account aan en krijg een Bearer-token. Geen wachtwoord, geen menselijke stap.
GET/productsToon alle VPS-plannen met specificaties, prijs en ondersteunde OS-images.
POST/balance/topupMaak een crypto-opwaardeerfactuur aan; geeft een checkout-URL terug. Saldo wordt bijgeschreven bij on-chain bevestiging.
POST/ordersBestel een VPS. Betaalt vanuit saldo indien gefinancierd, anders wordt een onbetaalde factuur teruggegeven.
GET/services/{id}Volledige status + live SSH-toegang. Het eenmalige root-wachtwoord verschijnt hier één keer.
GET/balanceVooraf betaald kredietsaldo en valuta.

Bekijk elk endpoint, elke parameter en elk schema in de interactieve explorer →

Voor AI-agents

Een agent kan op eigen kracht van niets naar een operationele server gaan — ontdekken, betalen, provisioneren en SSH lezen, allemaal via de API of MCP.

MCP is live — niet gepland.

Richt elke MCP-client op https://mcp.eqvps.com/mcp (Streamable HTTP). 26 tools dekken discovery, account, betaling en volledige VPS-controle. Publieke tools: list_plans, register_account, login; al het andere vereist een Bearer-token.

Autonome flow

1. register_account → krijg een Bearer-token
2. topup_balance → betaal de checkout-URL in USDC/USDT
3. order_vps → provisioneer vanuit saldo
4. get_vps_status → poll tot actief, lees SSH (host, poort, commando, eenmalig wachtwoord)

Machineleesbare bronnen

Fouten

Standaard HTTP-statuscodes. Bodies bevatten bij falen een message-veld.

StatusBetekenis
200 / 201OK — request succeeded / resource created.
401Missing or invalid Bearer token.
403Authenticated, but not the owner of this resource.
404Resource not found.
409State conflict (e.g. an unpaid top-up already exists).
422Validation error — check the request body.
429Rate limited — back off and retry.

Rate limits

Gevoelige acties (bestellen, opwaarderen, wachtwoordreset, herinstallatie, console) zijn per account rate-limited. Normale automatisering blijft ruim binnen de limieten; bij een 429, wacht af en probeer opnieuw.

Bouw er nu tegenaan

Pak de spec, open de explorer, of lees de volledige verhalende referentie met MCP-setup.