У 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 тоже подходит.
Аккаунт и токен
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
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 аккаунта. Подходит для проверки токена. |
Баланс и заказ
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
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
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
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, память, сеть и диск во времени. |
Смена тарифа и отмена
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
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. Перед вызовом спросите человека.
| Tool | Auth | Parameters | What it does |
|---|---|---|---|
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.
Комментарии
Пока нет комментариев. Будьте первым.