Heb ik een MCP-client nodig?

Nee. Dit is gewone REST over HTTPS — bruikbaar vanuit curl, elke taal, of een agent die HTTP spreekt. Als je MCP wel gebruikt, worden dezelfde acties als tools blootgesteld (zie de connect-gids).

Roep /auth/register aan om een Bearer-token te krijgen (geen wachtwoord). Stuur het als de header Authorization: Bearer op elke geauthenticeerde call. /products is publiek.

Financier een vooraf betaald saldo via /balance/topup (geeft een crypto-checkout-URL terug; betaal in USDC/USDT). order debiteert dan het saldo. Indien niet-gefinancierd, geeft order een factuur terug die je betaalt via /invoices/{id}/pay.

Wat bevat de order-respons?

Ofwel paid_from_balance met een service-id (provisioning gestart), of een factuur om te betalen. Poll GET /services/{id} tot status active is, lees dan de SSH-host, poort, en een eenmalig root-wachtwoord.

Bestel een VPS in 4 API-calls (REST-quickstart voor agents)

Je hebt geen MCP-client nodig om EQVPS aan te sturen — de REST API doet alles wat een agent nodig heeft. Base-URL: https://api.eqvps.com/api/v1/eqvps. Hier is de hele flow in vier calls.

0. (eenmalig) Financier een vooraf betaald saldo

Zodat bestellen een enkele call is, financier eerst een saldo. Betaal de teruggegeven checkout in USDC/USDT:

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/balance/topup \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"amount": 25}'
# → { "checkout_url": "https://payram.eqvps.com/..." }  ← pay it in USDC/USDT

1. Registreer → Bearer-token

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/auth/register \
  -H "Content-Type: application/json" \
  -d '{"first_name":"Ada","last_name":"Agent","email":"ada@example.com"}'
# → { "token": "<YOUR_BEARER>", "token_type": "Bearer", "user": {...} }

Geen wachtwoord, geen menselijke stap. Bewaar de token; stuur het als Authorization: Bearer <YOUR_BEARER> hieronder.

2. Som plannen op → kies product + os_id (publiek)

curl -s https://api.eqvps.com/api/v1/eqvps/products
# → { "data": [ { "slug": "<product-slug>", "price": {...},
#       "specs": {...}, "available_os": [ { "id": <os_id>, "name": "Ubuntu 24.04" }, ... ] }, ... ] }

Kies een plan-slug en een os_id uit de available_os van dat plan.

3. Bestel een VPS

curl -s -X POST https://api.eqvps.com/api/v1/eqvps/orders \
  -H "Authorization: Bearer <YOUR_BEARER>" -H "Content-Type: application/json" \
  -d '{"product":"<product-slug>","os_id":<os_id from list_plans>,"ssh_key":"ssh-ed25519 AAAA..."}'
# → paid from balance: { "paid_from_balance": true, "service_id": <id> }
#   or unfunded:       { "invoice": { "id": <id> } }  → pay: POST /invoices/{id}/pay → checkout_url

Geef een ssh_key (public key) mee voor key-gebaseerde root-login. Met een gefinancierd saldo wordt de order direct betaald en start provisioning.

4. Lees toegang

curl -s https://api.eqvps.com/api/v1/eqvps/services/<service-id> \
  -H "Authorization: Bearer <YOUR_BEARER>"
# → { "status": "active", "access": { "host": "...", "port": 22, "command": "ssh root@..." },
#     "password": "<shown once for keyless servers>" , ... }

Poll tot status active is. Het access-blok heeft de SSH-host, poort, en een klaar-om-te-plakken command; voor een keyless order wordt het eenmalige root-password teruggegeven bij de eerste lees.

Noten voor agents

Stuur Authorization: Bearer <YOUR_BEARER> op elke call behalve /products.
Betaal in USDC/USDT (Base, Ethereum, Tron) — geen kaart vereist. Verkies het vooraf betaalde saldo zodat stap 3 één call is.
Gevoelige acties (order, reset-password, reinstall, cancel) zijn rate-limited; normaal gebruik zit ruim binnen de limieten.
Verkies tools boven ruwe HTTP? Dezelfde acties zijn MCP-tools — zie de connect-gids en tools-referentie. Volledige docs: /docs.