Behöver jag en MCP-klient?

Nej. Detta är vanlig REST över HTTPS — användbart från curl, vilket språk som helst, eller en agent som talar HTTP. Om du använder MCP exponeras samma åtgärder som verktyg (se connect-guiden).

Anropa /auth/register för att få en Bearer-token (inget lösenord). Skicka den som headern Authorization: Bearer på varje autentiserat anrop. /products är publikt.

Finansiera ett förbetalt saldo via /balance/topup (returnerar en krypto-checkout-URL; betala i USDC/USDT). order debiterar sedan saldot. Om ofinansierat returnerar order en faktura du betalar via /invoices/{id}/pay.

Vad innehåller order-svaret?

Antingen paid_from_balance med ett service-id (provisioning startad), eller en faktura att betala. Polla GET /services/{id} tills status är active, läs sedan SSH-värden, porten, och ett engångs-root-lösenord.

Beställ en VPS i 4 API-anrop (REST-snabbstart för agenter)

Du behöver ingen MCP-klient för att driva EQVPS — REST API:et gör allt en agent behöver. Bas-URL: https://api.eqvps.com/api/v1/eqvps. Här är hela flödet i fyra anrop.

0. (en gång) Finansiera ett förbetalt saldo

Så att beställning är ett enda anrop, finansiera ett saldo först. Betala den returnerade checkouten i 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. Registrera → 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": {...} }

Inget lösenord, inget mänskligt steg. Lagra token; skicka den som Authorization: Bearer <YOUR_BEARER> nedan.

2. Lista planer → välj product + os_id (publikt)

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" }, ... ] }, ... ] }

Välj en plan-slug och ett os_id från det planets available_os.

3. Beställ en 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

Skicka en ssh_key (publik nyckel) för nyckel-baserad root-login. Med ett finansierat saldo betalas ordern omedelbart och provisioning startar.

4. Läs åtkomst

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>" , ... }

Polla tills status är active. access-blocket har SSH-värden, porten, och ett redo-att-klistra command; för en keyless order returneras engångs-root-password vid första läsningen.

Noteringar för agenter

Skicka Authorization: Bearer <YOUR_BEARER> på varje anrop utom /products.
Betala i USDC/USDT (Base, Ethereum, Tron) — inget kort krävs. Föredra det förbetalda saldot så att steg 3 är ett anrop.
Känsliga åtgärder (order, reset-password, reinstall, cancel) är rate-limitade; normal användning är väl inom gränserna.
Föredrar verktyg framför rå HTTP? Samma åtgärder är MCP-verktyg — se connect-guiden och verktygsreferensen. Fullständiga docs: /docs.