Чи потрібен MCP-клієнт?

Ні. Це звичайний REST по HTTPS — з curl, будь-якої мови або агента, що говорить по HTTP. Якщо використовуєш MCP, ті самі дії доступні як інструменти (див. гайд із підключення).

Як працює авторизація?

Виклич /auth/register щоб отримати Bearer-токен (без пароля). Надсилай його заголовком Authorization: Bearer на кожен авторизований запит. /products публічний.

Поповни передплачений баланс через /balance/topup (поверне крипто-checkout URL; оплати в USDC/USDT). order списує з балансу. Якщо не поповнений — order поверне інвойс, який оплачуєш через /invoices/{id}/pay.

Що у відповіді на order?

Або paid_from_balance з id сервісу (провіжинінг почався), або інвойс до оплати. Опитуй GET /services/{id} поки status не стане active, потім читай SSH host, port і одноразовий root-пароль.

Замовити VPS за 4 API-запити (REST quickstart для агентів)

MCP-клієнт не потрібен, щоб керувати EQVPS — REST API робить усе, що потрібно агенту. Базовий URL: https://api.eqvps.com/api/v1/eqvps. Увесь потік — у чотирьох запитах.

0. (один раз) Поповни передплачений баланс

Щоб замовлення було одним викликом, спершу поповни баланс. Оплати повернутий чекаут у 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. Реєстрація → 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":"[email protected]"}'
# → { "token": "<YOUR_BEARER>", "token_type": "Bearer", "user": {...} }

Без пароля, без участі людини. Збережи токен; надсилай як Authorization: Bearer <YOUR_BEARER> нижче.

2. Список тарифів → обери product + os_id (публічно)

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

Обери slug тарифу та os_id з його available_os.

3. Замовити 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

Передай ssh_key (публічний ключ) для входу root за ключем. З поповненим балансом замовлення оплачується миттєво і починається провіжинінг.

4. Прочитати доступ

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

Опитуй, поки status не стане active. Блок access містить SSH host, port і готову command; для keyless-замовлення одноразовий root-password повертається при першому читанні.

Нотатки для агентів

Надсилай Authorization: Bearer <YOUR_BEARER> на кожен запит крім /products.
Оплата в USDC/USDT (Base, Ethereum, Tron) — без картки. Віддавай перевагу передплаченому балансу, щоб крок 3 був одним викликом.
Чутливі дії (order, reset-password, reinstall, cancel) обмежені за частотою; звичайне використання — у межах лімітів.
Віддаєш перевагу інструментам замість сирого HTTP? Ті самі дії — це MCP-інструменти, див. гайд із підключення та референс інструментів. Повна документація: /docs.