mcp-server-ru

Список серверов аккаунта Hostkey с фильтрами. Перед первым вызовом автоматически обновляет инвентарь (eq/update_servers). Возвращает ID серверов и краткие данные; для полной карточки используйте get_server.

Полная информация о сервере по его ID (eq/show): конфигурация, сеть, статус, расположение.

Текущий статус питания сервера (включён/выключен).

Показания аппаратных сенсоров сервера (температуры, напряжения, вентиляторы). Только для bare-metal.

Все теги сервера (tags/list). Теги хранят произвольные пары ключ-значение.

Поиск серверов по имени или значению тега (tags/user_search). Возвращает ID серверов.

Информация о текущем API-токене и аккаунте (auth/info): доступные вызовы, тип и роль аккаунта, ID привязанных серверов. Полезно для проверки подключения.

Завершить текущую API-сессию (auth/logout): сессионный токен удаляется из InvAPI. При следующем вызове клиент автоматически выполнит повторный вход по API-ключу.

Список всех API-ключей аккаунта (api_keys/list).

Список API-ключей, выданных для конкретного сервера (api_keys/list_for_server).

Информация о конкретном API-ключе (api_keys/view).

История использования API-ключа за период (api_keys/history).

Создать новый API-ключ для аккаунта или конкретного сервера (api_keys/add). Значение ключа будет показано один раз в ответе — сохраните его.

Изменить параметры API-ключа (api_keys/edit): имя, IP-белый список, уведомления, активность.

Удалить API-ключ (api_keys/delete). ДЕСТРУКТИВНО: приложения, использующие ключ, потеряют доступ.

Данные клиента из биллинга (whmcs/get_client): контакты, валюта, статус аккаунта.

Полный список инвойсов аккаунта (whmcs/get_invoices).

Данные конкретного инвойса для оплаты (whmcs/get_invoice).

Инвойсы, относящиеся к конкретному серверу (whmcs/get_related_invoices).

Платёжная информация по аренде сервера (whmcs/get_billing_data).

Список транзакций по аккаунту клиента (whmcs/transactions).

Движение средств по лицевому счёту: начисления и списания кредитов (whmcs/getcredits).

Способы оплаты конкретного инвойса (whmcs/getpaymentgw).

Скачать инвойс в PDF (whmcs/download_invoice). Ответ обычно содержит PDF в Base64 — сохраните и декодируйте при необходимости.

Список активных заявок на отмену услуг (whmcs/get_cancellation_requests).

Список дополнительных контактов аккаунта (whmcs/get_contacts).

Изменить данные клиента в биллинге (whmcs/update_client): ФИО, компания, адрес, email, телефон и т.д.

Сбросить пароль аккаунта биллинга (whmcs/reset_password): на указанный email придёт ссылка для сброса. Email должен совпадать с email аккаунта.

Добавить дополнительный контакт в аккаунт (whmcs/add_contact). ВНИМАНИЕ: контакт создаётся со случайным email — его нужно поменять в Invapi.

Изменить дополнительный контакт (whmcs/update_contact): email, пароль, телефон. Указание телефона включает 2FA по SMS.

Удалить дополнительный контакт аккаунта (whmcs/delete_contact). ДЕСТРУКТИВНО.

Создать следующий инвойс для сервера (whmcs/generate_due_invoice).

Создать инвойс на пополнение кредитного баланса (whmcs/create_addfunds). ДЕНЬГИ: создаёт реальный инвойс на указанную сумму.

Оплатить инвойс полностью или частично с кредитного баланса (whmcs/apply_credit). ДЕНЬГИ: списывает средства со счёта.

Создать групповой инвойс для оплаты нескольких инвойсов разом (whmcs/mass_pay). ДЕНЬГИ.

Запросить отмену услуги (whmcs/request_cancellation). ДЕСТРУКТИВНО: cancellation_type=1 — немедленная отмена с частичным возвратом (если возможно), 0 — отмена в конце биллинг-периода. Требует HOSTKEY_ALLOW_DESTRUCTIVE=1.

Отозвать заявку на отмену услуги (whmcs/delete_cancellation_request).

Актуальный список доступных instant-серверов (VM/BM/GPU/vGPU) с ценами в указанной локации. Токен не требуется. Нужен для подбора preset перед заказом.

Поиск подходящих свободных серверов под конкретный пресет по имени (например, vm.pico). Требует авторизации.

Цены на доступные пресеты в указанных валютах (presets/info). Токен не требуется.

Список групп пресетов для категоризации каталога (presets/groups). Токен не требуется.

Информация о конкретном пресете или обо всех пресетах (presets/show). Может требовать авторизации в зависимости от прав.

Список доступных stock-серверов (физические серверы стандартных конфигураций, деплой в течение рабочего дня). Токен не требуется.

Детальная информация о конкретном stock-сервере (stocks/show).

Список операционных систем, доступных для установки на пресет/сервер (os/list). Без instance_id возвращает ОС для всех пресетов. Токен не требуется.

Список ПО (marketplace-приложений), доступного для автоустановки на сервер (software/list). Токен не требуется.

Доступные тарифные планы трафика для пресета в локации (traffic_plans/list). Токен не требуется.

Список всех DNS-зон аккаунта на серверах PowerDNS Hostkey (pdns/list_zones).

Содержимое DNS-зоны: все записи (A, AAAA, CNAME, MX, TXT и т.д.) с авторитетного сервера (pdns/view_zone).

Список всех доменов пользователя из таблицы доменов (pdns/list_domains).

Список сабдоменов по ID сервера (pdns/list_subdomains).

Создать DNS-зону и добавить домен в таблицу доменов (pdns/add_domain). Требует права pdns/edit.

Удалить домен по ID: DNS-зону, сам домен и все его сабдомены (pdns/delete_domain). ДЕСТРУКТИВНО. Требует права pdns/edit.

Добавить сабдомен в таблицу сабдоменов (pdns/add_subdomain). Требует права pdns/edit.

Обновить сабдомен (pdns/edit_subdomain). Требует права pdns/edit.

Удалить сабдомен из таблицы сабдоменов (pdns/delete_subdomain). ДЕСТРУКТИВНО. Требует права pdns/edit.

Создать DNS-зону на авторитетном сервере PowerDNS (pdns/add_zone). Требует права pdns/edit.

Удалить DNS-зону по имени вместе со всеми записями и метаданными (pdns/delete_zone). ДЕСТРУКТИВНО. Требует права pdns/edit.

Удалить DNS-запись из зоны (pdns/delete_dns). ДЕСТРУКТИВНО. Требует права pdns/edit.

Список доступных ISO-образов (iso/list_iso). Для клиентских ключей обязателен server_id — образы подбираются под конкретный сервер.

Список ISO-образов, загруженных клиентом (iso/uploaded).

Загрузить новый ISO-образ по URL (iso/upload). Доступно клиентам.

Добавить новый ISO-образ или обновить существующий по имени (iso/add). Требует специального права 'add'.

Размонтировать ISO-образ с сервера (iso/unmount_iso). Асинхронная операция — вернётся callback-ключ для check_task.

Удалить ISO-образ по ID (iso/delete). ДЕСТРУКТИВНО. По документации доступно только сотрудникам Hostkey — у клиентов, скорее всего, вернёт ошибку прав.

Состояние сетевых интерфейсов сервера (net/get_status): порт, свитч, VLAN, скорость, MAC, статус подключения.

Графики загрузки порта за период (net/show_cacti): день/месяц/год.

Информация о сетевом интерфейсе по IP-адресу (ip/get_ip).

Текущая PTR-запись (reverse DNS) для IP-адреса (ip/get_ptr).

Включить сетевой порт сервера (net/port_on).

Выключить сетевой порт сервера (net/port_off). ДЕСТРУКТИВНО: сервер потеряет сетевую связность по этому интерфейсу.

Заблокировать IP-адрес на сервере на уровне сети Hostkey (net/block_ip). Полезно для abuse-запросов.

Снять блокировку IP-адреса на сервере (net/unblock_ip).

Обновить PTR-запись для IP-адреса (ip/update_ptr). Несколько записей передаются разделителем %0A.

Назначить основной IP-адрес сервера (ip/set_main), когда адресов несколько.

Включить сервер (eq/on). Асинхронная операция: в ответе будет callback-ключ для check_task.

Шаг 1 PXE-переустановки: создать мастер-ключ переустановки ОС (eq/reinstall). Возвращает reinstall_key, по которому check_task отслеживает стадии установки. ДЕСТРУКТИВНО: часть процесса, затирающего диски сервера.

Шаг 2 PXE-переустановки: создать PXE-конфиг для установки ОС (eq/create_pxe). ДЕСТРУКТИВНО.

Установить порядок загрузки сервера (eq/boot_dev): pxe — сетевая загрузка (шаг 3 переустановки), disk — загрузка с диска (шаг 6), cd — смонтированный ISO.

Шаг 7 PXE-переустановки: удалить PXE-конфиг (eq/clear_pxe). ОБЯЗАТЕЛЬНО после завершения — иначе возможна внезапная переустановка при следующей перезагрузке.

Доступ к VNC-консоли сервера (eq/console): возвращает конфиг console.vv в Base64 для virt-viewer.

Запустить NoVNC (HTML5) сессию консоли сервера (eq/novnc): возвращает ссылку для открытия в браузере.

Доступные post-install Ansible-задачи (jenkins/get_tasks) с тегами применимости: gpu, bm, vm, vgpu, default. Без токена — общий список, с токеном — доступные конкретному пользователю.

Выполнить Jenkins/Ansible-задачу на сервере (jenkins/call): ID или имя задачи из list_post_install_tasks + доп. параметры. Например, установка GPU-драйверов после переустановки ОС.

Создать статический DNAT до IPMI сервера (nat/add_static_nat): публичный IP для доступа к IPMI. Асинхронная операция — статус через check_task.

Удалить статический DNAT до IPMI сервера (nat/remove_static_nat).

Удалить застывшие правила статического NAT-проброса по внутреннему IP (nat/clear_static_nat).

Удалить запись о NAT из базы данных (nat/drop_nat). ДЕСТРУКТИВНО, служебная операция.

Создать временного IPMI-пользователя для веб-доступа к IPMI (eq/add_ipmi_user).

Удалить временного IPMI-пользователя (eq/remove_ipmi_user).

Перезагрузить IPMI-модуль сервера (eq/unit_reset). Применять, если IPMI не отвечает.