MCP-сервер EQVPS (версія 1.9.1) має 47 інструментів для клієнтського токена. Тут описано 23 з них — ті, що орендують VPS і керують ним: кожен параметр, його тип і значення за замовчуванням, а наприкінці ланцюжок викликів, який можна скопіювати. Endpoint: https://mcp.eqvps.com/mcp (Streamable HTTP). Підключаєтеся вперше? Почніть з посібника з підключення.
Остання перевірка 2026-10-20 на MCP-сервері 1.9.1 (tools/list).
Яка сторінка вам потрібна? Параметри викликів для VPS — на цій сторінці. Усі інструменти одним списком, зокрема делегування, підтримка, пісочниці та 30 реселерських, — у повному списку. Що може токен, який витік, і як обмежити агента — у MCP guardrails.
Авторизація. list_plans, get_order_limits, register_account і login публічні. Решті потрібен Authorization: Bearer <token>. У межах однієї MCP-сесії токен запам'ятовується після register_account або login.
service_id — код послуги з order_vps або list_vps, наприклад 68J67T5. Числовий id теж підходить.
Акаунт і токен
| Інструмент | Авторизація | Параметри | Що робить |
|---|---|---|---|
list_plans | public | — | Тарифи з цінами, характеристиками й образами ОС для кожного. У plans[] є місячний і річний plan_id. Викликайте першим. |
register_account | public | first_name, last_name, email, token_ttl_days? (1–1825, за замовчуванням 365) | Створює акаунт без пароля й повертає багаторазовий Bearer token і token_expires_at. Викликайте один раз: повторний виклик створить другий, порожній акаунт. |
login | public | email, password, token_ttl_days? | Повертає новий токен. Працює лише після set_password. |
refresh_token | Bearer | expires_in_days? (1–1825) | Видає новий токен і одразу відкликає поточний. Прострочений токен оновити не можна. |
set_password | Bearer | password (від 8 символів, літери й цифри) | Вмикає вхід через login за email і паролем на випадок втрати токена. Спрацьовує один раз; повторний виклик поверне 409. |
whoami | Bearer | — | id, ім'я та email акаунта. Підходить для перевірки токена. |
Баланс і замовлення
| Інструмент | Авторизація | Параметри | Що робить |
|---|---|---|---|
get_balance | Bearer | — | Передплачений баланс і валюта. order_vps списує з нього. |
topup_balance | Bearer | amount (USD) | Створює поповнення в криптовалюті й повертає checkout_url. Баланс зараховується, коли платіж підтвердиться в блокчейні. Одночасно може бути лише одне неоплачене поповнення. |
order_vps | Bearer | product, os_id, hostname?, ssh_key?, period? (month | year), plan_id?, location? (de | fi), quantity? (1–50), addons? (backups | extra_ipv4), idempotency_key? | Замовляє VPS і оплачує з балансу, якщо його вистачає; інакше повертає рахунок. Без location локацію обираємо ми. Windows-тарифи ігнорують ssh_key. З quantity 2–50 буде один рахунок і стільки ж окремих серверів; під час повтору надсилайте той самий idempotency_key. |
get_order_limits | public | product, period?, plan_id?, location?, addons? | Максимум в одному замовленні (max_quantity = 50, захист від помилки) і які додаткові послуги доступні, з цінами. |
pay_invoice | Bearer | invoice_id | Повертає checkout_url для неоплаченого рахунку. VPS створюється після оплати. |
Керування VPS
| Інструмент | Авторизація | Параметри | Що робить |
|---|---|---|---|
list_vps | Bearer | — | Активні, створювані й призупинені послуги. Видалені до списку не потрапляють. |
get_vps_status | Bearer | service_id | Статус, характеристики, поточний стан і доступ: хост, порт і готова command (SSH для Linux, RDP для Windows). reveal_password після завантаження повертає одноразовий пароль root; password_pending: true означає, що треба повторити за 30–60 с. |
reveal_password | Bearer | service_id | Root-пароль VPS без SSH-ключа, показується один раз. Поки сервер завантажується: password_pending: true, повторіть через 30–60 с. |
power_vps | Bearer | service_id, action (start | stop | reboot) | Керування живленням. |
set_hostname | Bearer | service_id, hostname | Застосовується всередині робочого сервера через гостьовий агент. На Windows набуває чинності після перезавантаження (reboot_required: true). Якщо сервер вимкнено, повернеться 409 agent_unavailable. |
get_vps_metrics | Bearer | service_id, timeframe? (hour | day | week | month, за замовчуванням hour) | CPU, пам'ять, мережа й диск у часі. |
Зміна тарифу та скасування
| Інструмент | Авторизація | Параметри | Що робить |
|---|---|---|---|
get_upgrade_options | Bearer | service_id | Тарифи, на які можна перейти зі збереженням даних: більший тариф, NAT на виділену IPv4 або виділений на NAT. Кожен варіант має prorated_topup, mode і capacity_now. Диск зменшити не можна. |
change_plan | Bearer | service_id, target_plan (product_id), confirm: true | Змінює тариф на місці з одним перезавантаженням приблизно на хвилину. Пропорційна різниця списується з балансу (402, якщо його не вистачає). |
cancel_service | Bearer | service_id, reason (3–500 символів, обов'язково), type? (end_of_period | immediate), confirm? | За замовчуванням end_of_period: сервер працює до кінця оплаченого періоду й не продовжується. immediate знищує сервер одразу, потребує confirm з точним hostname; у відповіді є поле refund_amount. |
undo_cancel | Bearer | service_id | Знімає заплановане скасування end_of_period. Негайне скасування повернути не можна. |
Незворотні: потрібен confirm
confirm — точний hostname з get_vps_status або DELETE. Перед викликом запитайте людину.
| Інструмент | Авторизація | Параметри | Що робить |
|---|---|---|---|
reset_password | Bearer | service_id, confirm | Новий пароль root потрапляє на робочий сервер за 10–30 с, старий перестає працювати. Новий пароль прочитайте один раз через reveal_password. Лише для втраченого пароля, а не для сервера, що ще завантажується. |
reinstall_vps | Bearer | service_id, os_id, confirm | Стирає диск і встановлює os_id. Усі дані втрачаються. Виконується у фоні; опитуйте get_vps_status. |
Приклад: від нуля до робочого сервера
list_plans() // pick a product slug and an os_id
register_account({ first_name: "Ada", last_name: "Agent", email: "you@yourdomain.com" }) // returns a token
topup_balance({ amount: 10 }) // pay the checkout_url in crypto
order_vps({ product: "nano", os_id: <os_id>, ssh_key: "ssh-ed25519 AAAA..." }) // returns a service_id
get_vps_status({ service_id: "<service_id>" }) // poll until active, then read access.command
power_vps({ service_id: "<service_id>", action: "reboot" })
cancel_service({ service_id: "<service_id>", reason: "project finished" }) // end_of_period; undo_cancel keeps it
Нотатки для агентів
- Надсилайте
Authorization: Bearer <token>в усіх викликах, крім трьох публічних. Якщо працюєте через звичайний HTTP, збережіть токен у файл: змінна оболонки не переживає окремих команд. - Беріть дані доступу з
get_vps_status, а не вгадуйте порт. На NAT-тарифах персональний порт; на тарифах з виділеним IPv4 порт 22 для Linux і 3389 для Windows. - Новому серверу потрібна приблизно хвилина на завантаження. Продовжуйте опитувати
get_vps_status; не викликайтеreset_passwordлише тому, що SSH не відповів одразу. topup_balanceіpay_invoiceповертають посилання на оплату, і оплатити його має людина або гаманець. Monero — окреме ручне поповнення в кабінеті: див. оплату в Monero.
Ті самі дії без MCP описано в документації REST API.
Коментарі
Поки немає коментарів. Будьте першим.