MCP-сервер EQVPS надає 16 інструментів, якими AI-агент знаходить тарифи, відкриває акаунт, платить криптою й повністю керує VPS. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). Див. гайд із підключення, щоб прив'язати до клієнта.
Модель авторизації: list_plans, register_account і login — публічні. Усім іншим потрібен Bearer-токен — отримай його миттєво через register_account і надсилай як Authorization: Bearer <token>.
Discovery та авторизація
| Інструмент | Auth | Параметри | Що робить |
|---|---|---|---|
list_plans | public | — | Список усіх тарифів VPS: ціни, характеристики та ОС-образи, які вантажить кожен. Виклич першим, щоб обрати product (slug) і os_id. |
register_account | public | first_name, last_name, email | Створити акаунт без пароля й без участі людини. Повертає Bearer token. |
login | public | email, password | Вхід за email + паролем; повертає Bearer token. |
whoami | Bearer | — | Профіль авторизованого акаунта (id, ім'я, email). Перевіряє токен. |
Баланс і замовлення
| Інструмент | Auth | Параметри | Що робить |
|---|---|---|---|
get_balance | Bearer | — | Передплачений баланс і валюта. order_vps витрачає з нього автоматично. |
topup_balance | Bearer | amount (USD, додатн.) | Створити інвойс поповнення; повертає PayRam checkout_url. Баланс зараховується після підтвердження on-chain оплати USDC/USDT. Один неоплачений топап за раз. |
order_vps | Bearer | product (slug тарифу), os_id (int), hostname?, ssh_key? | Замовити VPS. Передай ssh_key (публічний ключ) для входу root за ключем. Платить з балансу, якщо вистачає, інакше повертає інвойс. |
pay_invoice | Bearer | invoice_id (int) | Ініціювати оплату свого неоплаченого інвойса. Повертає PayRam checkout_url; VPS провіжиниться автоматично після оплати. |
Керування VPS
| Інструмент | Auth | Параметри | Що робить |
|---|---|---|---|
list_vps | Bearer | — | Список VPS-сервісів акаунта (id, статус, тариф). Використовуй id як service_id нижче. |
get_vps_status | Bearer | service_id (int) | Повна інформація: статус, характеристики, live-стан/uptime VM і SSH-доступ (host, port, готова command). На першому виклику для keyless-сервера повертає одноразовий root-password. Опитуй після order_vps, доки не active. |
power_vps | Bearer | service_id, action = start | stop | reboot | Керування живленням VPS. |
set_hostname | Bearer | service_id, hostname | Задати hostname VPS (валідний DNS-label; застосовується при наступному перезавантаженні/перезбірці). |
get_vps_metrics | Bearer | service_id, timeframe? = hour | day | week | month | Часові ряди CPU, пам'яті, мережі та диска (за замовч. hour). |
Деструктивні — потребують confirm
Стирають дані або доступ. confirm має дорівнювати точному hostname (з get_vps_status) або літералу DELETE. Спершу підтверди з людиною.
| Інструмент | Auth | Параметри | Що робить |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Ротація root-пароля. Старий пароль перестає працювати одразу. Новий читається один раз через get_vps_status (також надсилається листом). |
reinstall_vps | Bearer | service_id, os_id (int), confirm | Стерти й перевстановити із зазначеним ОС-образом — усі дані втрачаються. Провіжинінг асинхронний; опитуй get_vps_status. |
cancel_service | Bearer | service_id, type? = end_of_period | immediate, confirm? | За замовчуванням end_of_period: працює до кінця оплаченого періоду, потім не продовжується — без втрати даних. immediate знищує VM і всі дані зараз (потребує confirm = hostname); невикористана оплачена частина повертається на баланс (refund_amount). |
Приклад: замовити й підняти VPS
list_plans() // pick product "nano", note an os_id
register_account({ first_name, last_name, email }) // → Bearer token
topup_balance({ amount: 10 }) // pay the returned checkout_url in USDC/USDT
order_vps({ product: "nano", os_id: <os_id from list_plans>, ssh_key: "ssh-ed25519 AAAA..." })
get_vps_status({ service_id: <your-service-id> }) // poll → active, read SSH host/port/command
power_vps({ service_id: <your-service-id>, action: "reboot" })
Нотатки для агентів
- Надсилай
Authorization: Bearer <token>на кожен непублічний виклик. - Платежі в USDC/USDT (Base, Ethereum, Tron) — без картки. Віддавай перевагу передплаченому балансу, тоді замовлення = один виклик.
- Завжди читай доступ через
get_vps_status; вважайreinstall_vps,reset_passwordі негайнийcancel_serviceнезворотними.
Тільки починаєш? Спершу гайд із підключення або Docs по REST API.