Czy potrzebuję klienta MCP?

Nie. To zwykły REST przez HTTPS — użyteczny z curl, dowolnego języka lub agenta, który mówi w HTTP. Jeśli używasz MCP, te same akcje są udostępnione jako narzędzia (zobacz przewodnik podłączenia).

Jak działa uwierzytelnianie?

Wywołaj /auth/register, by uzyskać token Bearer (bez hasła). Wyślij go jako nagłówek Authorization: Bearer przy każdym uwierzytelnionym wywołaniu. /products jest publiczne.

Zasil przedpłacone saldo przez /balance/topup (zwraca URL kasy krypto; płać w USDC/USDT). order wtedy obciąża saldo. Jeśli niezasilone, order zwraca fakturę, którą płacisz przez /invoices/{id}/pay.

Co zawiera odpowiedź zamówienia?

Albo paid_from_balance z id usługi (przygotowanie rozpoczęte), albo fakturę do zapłaty. Odpytuj GET /services/{id}, aż status będzie active, potem odczytaj host SSH, port i jednorazowe hasło root.

Zamów VPS w 4 wywołaniach API (szybki start REST dla agentów)

Nie potrzebujesz klienta MCP, by sterować EQVPS — REST API robi wszystko, czego agent potrzebuje. Bazowy URL: https://api.eqvps.com/api/v1/eqvps. Oto cały przepływ w czterech wywołaniach.

0. (raz) Zasil przedpłacone saldo

By zamawianie było pojedynczym wywołaniem, najpierw zasil saldo. Zapłać zwróconą kasę w 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/..." }  ← zapłać w USDC/USDT

1. Rejestracja → token Bearer

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": {...} }

Bez hasła, bez kroku człowieka. Zapisz token; wysyłaj go jako Authorization: Bearer <YOUR_BEARER> poniżej.

2. Wylistuj plany → wybierz product + os_id (publiczne)

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

Wybierz slug planu i os_id z available_os tego planu.

3. Zamów 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 z list_plans>,"ssh_key":"ssh-ed25519 AAAA..."}'
# → opłacone z salda: { "paid_from_balance": true, "service_id": <id> }
#   lub niezasilone:  { "invoice": { "id": <id> } }  → zapłać: POST /invoices/{id}/pay → checkout_url

Przekaż ssh_key (klucz publiczny) dla logowania root opartego na kluczu. Przy zasilonym saldzie zamówienie jest opłacone natychmiast i przygotowanie się zaczyna.

4. Odczytaj dostęp

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": "<pokazane raz dla serwerów bez klucza>" , ... }

Odpytuj, aż status będzie active. Blok access ma host SSH, port i gotowe do wklejenia command; dla zamówienia bez klucza jednorazowe hasło root password jest zwracane przy pierwszym odczycie.

Uwagi dla agentów

Wysyłaj Authorization: Bearer <YOUR_BEARER> przy każdym wywołaniu oprócz /products.
Płać w USDC/USDT (Base, Ethereum, Polygon) — bez karty. Preferuj przedpłacone saldo, by krok 3 był jednym wywołaniem.
Wrażliwe akcje (zamówienie, reset-hasła, przeinstalowanie, anulowanie) są ograniczane; normalne użycie mieści się dobrze w limitach.
Wolisz narzędzia od surowego HTTP? Te same akcje to narzędzia MCP — zobacz przewodnik podłączenia i referencję narzędzi. Pełna dokumentacja: /docs.