Нужен ли 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.