Нужен ли ми е MCP клиент?

Не. Това е обикновен REST през HTTPS — използваем от curl, всеки език, или агент, който говори HTTP. Ако използваш MCP, същите действия са изложени като tools (виж ръководството за свързване).

Как работи автентикацията?

Извикай /auth/register, за да получиш Bearer token (без парола). Изпращай го като хедъра Authorization: Bearer на всяко автентикирано извикване. /products е публичен.

Зареди предплатен баланс през /balance/topup (връща crypto checkout URL; плати в USDC/USDT). order после дебитира баланса. Ако е незареден, order връща фактура, която плащаш през /invoices/{id}/pay.

Какво съдържа отговорът на поръчката?

Или paid_from_balance с service id (провижнингът започна), или фактура за плащане. Poll-вай GET /services/{id}, докато status стане active, после прочети SSH host-а, порта, и еднократна root парола.

Поръчай VPS с 4 API извиквания (REST quickstart за агенти)

Не се нуждаеш от MCP клиент, за да караш EQVPS — REST API-то прави всичко, от което агент се нуждае. Base URL: https://api.eqvps.com/api/v1/eqvps. Ето целия поток в четири извиквания.

0. (веднъж) Зареди предплатен баланс

За да е поръчването едно извикване, зареди баланс първо. Плати върнатия checkout в 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 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": {...} }

Без парола, без човешка стъпка. Съхрани token-а; изпращай го като 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>" , ... }

Poll-вай, докато status е active. Блокът access има SSH host-а, порта, и готова-за-поставяне command; за поръчка без ключ еднократната root password се връща при първото четене.

Бележки за агенти

Изпращай Authorization: Bearer <YOUR_BEARER> на всяко извикване освен /products.
Плати в USDC/USDT (Base, Ethereum, Tron) — без нужда от карта. Предпочитай предплатения баланс, така че стъпка 3 да е едно извикване.
Чувствителните действия (order, reset-password, reinstall, cancel) са rate-limited; нормалната употреба е добре в рамките на лимитите.
Предпочиташ tools пред суров HTTP? Същите действия са MCP tools — виж ръководството за свързване и справочника за tools. Пълна документация: /docs.