Mcp Server Ru

io.github.hostkey-cloud-ruPublished by GitHub account hostkey-cloud-ruv1.0.8Updated Oct 30, 2026

MCP server for Hostkey .ru (InvAPI): servers, power, order, DNS, S3, billing

Overview

AI-generated overview

Hostkey .ru hosting MCP server that lets an assistant inspect, order and manage servers, networking, DNS, S3 and billing through InvAPI.

What you can do
  • List and inspect servers, power status, hardware sensors and tags
  • Browse the catalog: presets, stock servers, OS images, software and traffic plans
  • Power, order, reinstall and PXE-cycle servers, with async jobs checked via check_task
  • Manage network ports, IP blocking, PTR records and main IP
  • Read and edit DNS zones, domains and subdomains
  • Handle snapshots, ISO, S3, Remote Hands tickets, billing and API keys, plus a raw API call
When to use it
Useful when you want an assistant to answer questions about a Hostkey .ru account or carry out hosting operations such as ordering a VPS, rebooting, reinstalling an OS, fixing DNS or checking invoices, without switching to the control panel.
Requirements
Either the hosted endpoint at mcp.hostkey.ru with an Authorization bearer header, or the npm package run locally over stdio with Node.js 22.18 or newer. Needs a Hostkey .ru InvAPI API key (HOSTKEY_API_KEY); DNS writes need pdns/edit rights. Optional HOSTKEY_TOKEN_TTL, HOSTKEY_HTTP_TIMEOUT and HOSTKEY_ALLOW_DESTRUCTIVE.
Before you install
The API key grants access to a real hosting account; a per-server key limits it to one server. Write calls need confirm=true, and OS reinstall, PXE cycle and service cancellation additionally need HOSTKEY_ALLOW_DESTRUCTIVE=1. Ordering, deleting API keys, disabling ports and blocking IPs change or cut off live services, and orders can cost money. Newly created API key values are shown only once.

Installation

In SourceWeft

  1. Open Mcp Server Ru in the dashboard and add it to a workspace.
  2. Connect Authorization token credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.hostkey-cloud-ru%2Fmcp-server-ru/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "ru": {
      "type": "http",
      "url": "https://mcp.hostkey.ru/mcp",
      "headers": {
        "Authorization": "Bearer <YOUR_TOKEN>"
      }
    }
  }
}

README

Hostkey MCP Server (RU)

MCP-сервер для Hostkey (портал .ru, InvAPI invapi.hostkey.ru). Клиент подключается по URL или локально по stdio (Cursor, VS Code и др.). Hosted: https://mcp.hostkey.ru/mcp (для .com — https://mcp.hostkey.com/mcp).

Endpointhttps://invapi.hostkey.ru (зашит в код)
АвторизацияHOSTKEY_API_KEY
Инструменты132 типизированных + call_api_raw

Сервер даёт модели доступ к аккаунту Hostkey: серверы, каталог и заказ, питание, переустановка ОС, сеть, DNS, снапшоты, IPMI/консоль, ISO, S3, Remote Hands, биллинг и API-ключи.

Для портала .com — отдельный пакет hostkey-mcp-server.

1. Получите API-ключ

InvAPI → управление API-ключами → выпустите ключ.

Лучше отдельный ключ для MCP. Ключ на один сервер ограничивает доступ этим сервером. Для записи DNS нужны права pdns/edit.

2. Установка

Cursor (hosted URL — рекомендуется)

В .cursor/mcp.json (один или оба портала):

json
{  "mcpServers": {    "hostkey-com": {      "url": "https://mcp.hostkey.com/mcp",      "headers": {        "Authorization": "Bearer key-from-invapi.hostkey.com"      }    },    "hostkey-ru": {      "url": "https://mcp.hostkey.ru/mcp",      "headers": {        "Authorization": "Bearer key-from-invapi.hostkey.ru"      }    }  }}

Подставь свои InvAPI-ключи. Локальный Node/npx не нужен.

Cursor (локальный npx / stdio)

[Install in Cursor]

json
{  "mcpServers": {    "hostkey-com": {      "command": "npx",      "args": ["-y", "hostkey-mcp-server"],      "env": {        "HOSTKEY_API_KEY": "key-from-invapi.hostkey.com"      }    },    "hostkey-ru": {      "command": "npx",      "args": ["-y", "hostkey-mcp-server-ru"],      "env": {        "HOSTKEY_API_KEY": "key-from-invapi.hostkey.ru"      }    }  }}

VS Code

.vscode/mcp.json — те же варианты (url + headers или command / args / env).

Опционально для stdio: HOSTKEY_TOKEN_TTL, HOSTKEY_HTTP_TIMEOUT, HOSTKEY_ALLOW_DESTRUCTIVE (см. .env.example).

Из исходников (Node.js ≥ 22.18): npm install && npm run build.

3. Подтверждение опасных операций

Все write-вызовы требуют confirm=true. Без него сервер ничего не меняет.

Дополнительно:

  • заказ сервера по умолчанию в dry_run — реальный заказ только после явного согласия;
  • переустановка ОС, PXE и отмена услуг — только при HOSTKEY_ALLOW_DESTRUCTIVE=1;
  • пароли и токены в ответах маскируются.

Долгие операции (деплой, переустановка) возвращают callback-ключ — статус через check_task.

4. Инструменты

Группы (полный список виден клиенту в tools/list):

ГруппаПримеры
Серверыget_servers, get_server, get_power_status
Каталогlist_presets, list_os, list_traffic_plans
Питание и заказpower_on, power_off, order_server, reinstall_server
PXEcreate_reinstall_task → … → clear_pxe_config
Сеть / DNSпорты, PTR, зоны и записи
Снапшоты, ISO, S3ВМ-снапшоты, образы, бакеты
Remote Handsтикеты дежурной смене (request_rh_*, rhr_*)
Биллингсчета, платежи, контакты
Прочееcheck_task, call_api_raw

Промпты

ПромптЗачем
order_server_promptзаказ сервера по шагам
reinstall_server_promptпереустановка ОС
troubleshoot_server_promptдиагностика

Или просто напишите: «покажи мои серверы» / «закажи VPS в NL» — модель выберет нужные инструменты.

Source: README.md at commit 09fdbf9

Tools

132

get_servers

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

Parametersipmacgroupstatuslocation

get_server

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

Parametersidrequired

get_power_status

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

Parametersidrequired

get_server_sensors

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

Parametersidrequired

get_server_tags

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

Parametersidrequired

search_servers_by_tag

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

Parametersvaluerequired

list_presets

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

Parameterslocationrequired

search_presets

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

Parametersnamerequiredscopelocationrequired

get_preset_pricing

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

Parameterscurrencies

list_preset_groups

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

Takes no parameters.

get_preset

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

Parametersid

list_stock_servers

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

Parametersgrouprequiredlocationrequired

get_stock_server

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

Parametersidrequired

list_os

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

Parametersinstance_id

list_software

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

Parameterslocationinstance_id

list_traffic_plans

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

Parameterslocationrequiredinstance_idrequired

get_account_info

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

Takes no parameters.

logout

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

Takes no parameters.

list_api_keys

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

Takes no parameters.

list_server_api_keys

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

Parametersserver_idrequired

get_api_key

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

Parametersidrequired

get_api_key_history

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

Parametersidrequiredperiod_toperiod_from

create_api_key

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

Parametersipnamerequiredactiverequiredconfirmrequiredserver_idlogin_notify_methodrequiredlogin_notify_address

update_api_key

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

Parametersidrequiredipnamerequiredactiverequiredconfirmrequiredlogin_notify_methodrequiredlogin_notify_address

delete_api_key

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

Parametersidrequiredconfirmrequired

get_network_status

Состояние сетевых интерфейсов сервера (net/get_status): порт, свитч, VLAN, скорость, MAC, статус подключения. Опциональный port ограничивает запрос одним интерфейсом (если другой NIC без upstream_id ломает ответ).

Parametersidrequiredport

get_port_graphs

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

Parametersidrequiredportrequiredgraphrequired

get_ip_info

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

Parametersiprequired

get_ptr_record

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

Parametersidrequirediprequired

port_on

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

Parametersidrequiredportrequiredconfirmrequired

port_off

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

Parametersidrequiredportrequiredconfirmrequired

block_ip

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

Parametersidrequirediprequiredconfirmrequiredfour_hoursdescriptionrequired

unblock_ip

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

Parametersidrequirediprequiredconfirmrequired

update_ptr_record

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

Parametersidrequirediprequiredptrrequiredconfirmrequired

set_main_ip

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

Parametersidrequirediprequiredmainrequiredconfirmrequired

list_dns_zones

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

Takes no parameters.

get_dns_zone

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

Parameterszonerequired

list_dns_domains

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

Takes no parameters.

list_dns_subdomains

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

Parametersserver_idrequired

add_dns_domain

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

Parametersnamerequiredconfirmrequired

delete_dns_domain

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

Parametersconfirmrequireddomain_idrequiredserver_idrequired

add_dns_subdomain

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

Parametersnamerequiredconfirmrequireddomain_idrequiredserver_idrequired

edit_dns_subdomain

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

Parametersidrequiredconfirmrequiredserver_id

delete_dns_subdomain

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

Parametersidrequiredconfirmrequiredserver_idrequired

add_dns_zone

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

Parametersdnskindnamerequireddnssecrrsetsconfirmrequiredmastersnameservers

delete_dns_zone

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

Parameterszonerequiredconfirmrequired

add_dns_record

Добавить или изменить DNS-запись в зоне (pdns/add_dns). Требует права pdns/edit. Для SRV-записей заполните proto/priority/weight/port/target. Поля mname/rname в документации отмечены как обязательные для SOA-проверок — при ошибке заполните их.

Parametersttlnameporttyperequiredzonerequiredmnameprotornametargetweightconfirmrequiredcontentrequired+3 more

delete_dns_record

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

Parametersnamerequiredtyperequiredzonerequiredconfirmrequired

get_snapshots

Список снапшотов виртуальной машины (vm/get_snapshot): имя, snapshot_id, дата.

Parametersidrequired

get_vm_engine

Информация о движке виртуализации (vm/get_engine).

Takes no parameters.

get_vm_stats

Статистика виртуальной машины (vm/load_stats).

Parametersidrequired

create_snapshot

Создать снапшот виртуальной машины (vm/create_snapshot). Асинхронная операция — статус через check_task.

Parametersidrequirednamerequiredconfirmrequired

remove_snapshot

Удалить снапшот (vm/remove_snapshot). ДЕСТРУКТИВНО: снапшот удаляется безвозвратно. Удаление возможно только на выключенной ВМ.

Parametersidrequirednamerequiredconfirmrequired

restore_snapshot

Восстановить ВМ из снапшота (vm/restore_snapshot). ДЕСТРУКТИВНО: текущее состояние диска ВМ будет перезаписано состоянием снапшота.

Parametersidrequirednamerequiredconfirmrequired

get_vnc_console

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

Parametersidrequired

start_novnc

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

Parametersidrequiredwhite_ip

list_post_install_tasks

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

Takes no parameters.

run_post_install_task

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

Parametersidrequiredtaskrequiredparamsconfirmrequired

add_static_nat

Создать статический DNAT до IPMI сервера (nat/add_static_nat): публичный IP для классического IPMI. Это не Secure IPMI Proxy в ЛК — Active Proxy сам по себе может не удовлетворять вызов. Асинхронно; статус через check_task. При server_ipmi_acl_required передайте ip_acl.

Parametersidrequiredttlip_aclconfirmrequiredsecured

remove_static_nat

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

Parametersidrequiredconfirmrequired

clear_static_nat

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

Parametersiprequiredconfirmrequired

drop_nat

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

Parametersidipconfirmrequired

add_ipmi_user

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

Parametersidrequiredconfirmrequired

remove_ipmi_user

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

Parametersidrequiredconfirmrequired

reset_ipmi

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

Parametersidrequiredconfirmrequired

request_rh_power_on

Заявка Remote Hands: включить сервер вручную (jira/request_pon). Создаёт тикет Remote Hands для дежурной смены дата-центра; статус и переписка — в тикете (ссылка придёт на email).

Parametersidrequiredconfirmrequired

request_rh_power_off

Заявка Remote Hands: выключить сервер вручную (jira/request_poff). ДЕСТРУКТИВНО для работающих сервисов. Создаёт тикет Remote Hands для дежурной смены дата-центра; статус и переписка — в тикете (ссылка придёт на email).

Parametersidrequiredconfirmrequired

request_rh_reboot

Заявка Remote Hands: перезагрузить сервер вручную (jira/request_reboot). Создаёт тикет Remote Hands для дежурной смены дата-центра; статус и переписка — в тикете (ссылка придёт на email).

Parametersidrequiredconfirmrequired

request_rh_pxe_boot

Заявка Remote Hands: загрузить сервер по PXE (jira/request_PXEboot). Нужна при переустановке ОС на серверах без модуля удалённого управления. Создаёт тикет Remote Hands для дежурной смены дата-центра; статус и переписка — в тикете (ссылка придёт на email).

Parametersidrequiredconfirmrequired

request_rh_kvm

Заявка Remote Hands: подключить IP KVM к серверу (jira/request_kvm). Создаёт тикет Remote Hands для дежурной смены дата-центра; статус и переписка — в тикете (ссылка придёт на email).

Parametersidrequiredconfirmrequired

request_rh_check

Заявка Remote Hands: проверить сервер и загрузить его в ОС (jira/request_check). Создаёт тикет Remote Hands для дежурной смены дата-центра; статус и переписка — в тикете (ссылка придёт на email).

Parametersidrequiredconfirmrequired

request_sales_assistance

Тикет в отдел продаж (jira/request_assistance): отмена или перенос услуги и подобные запросы. Опишите детали в message.

Parametersidconfirmrequiredmessagerequiredsubject

create_reinstall_task

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

Parametersidrequiredconfirmrequired

create_pxe_config

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

Parametersidrequiredos_idrequiredconfirmrequiredssh_keyhostnamerequiredroot_passrequiredreinstall_keypost_install_scriptpost_install_callback

set_boot_device

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

Parametersidrequiredmediarequiredconfirmrequired

clear_pxe_config

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

Parametersidrequiredconfirmrequiredhostnamerequired

list_iso_images

Список доступных ISO-образов (iso/list_iso). InvAPI требует id сервера (для клиентских ключей); образы подбираются под конфигурацию сервера.

Parametersidrequired

get_uploaded_isos

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

Takes no parameters.

upload_iso

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

Parametersurlrequirednameconfirmrequired

add_iso_image

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

Parametersurlnamerequiredconfirmrequired

mount_iso

Смонтировать ISO-образ на сервер (iso/mount_iso). Асинхронная операция — вернётся callback-ключ для check_task. InvAPI ждёт поле `iso` (имя или id). Можно передать iso, либо алиасы name / iso_id.

Parametersidrequiredisonameiso_idconfirmrequired

unmount_iso

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

Parametersidrequiredconfirmrequired

delete_iso_image

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

Parametersidrequiredconfirmrequired

s3_list_plans

List available S3 storage plans (s3/list_plans).

Parameterslocation

s3_get_locations

List available locations for S3 (s3/get_available_locations).

Takes no parameters.

s3_get_buckets

List S3 account buckets and usage (s3/get_buckets_rmq). Pass s3uid or account_id from s3_get_users. May return a task key — then track with check_task.

Parameterss3uidaccount_id

s3_get_buckets_via_queue

Same as s3_get_buckets: list buckets via s3/get_buckets_rmq. Prefer s3_get_buckets.

Parameterss3uidaccount_id

s3_get_files

List files in a bucket with pagination and search (s3/get_files).

Parameterspagelimits3uidbucketrequiredsearchaccount_id

s3_get_users

List S3 users with service, traffic, and storage usage info (s3/get_users). Full filtering is available to administrators. Use returned s3uid/id with s3_get_buckets.

Parameterslocation

s3_show_key

Get a decrypted S3 access key (s3/show_key). SECRET: do not log or share with third parties.

Parameterss3uidkey_typerequiredaccount_id

s3_create_account

Create an S3 account: bind a plan and initial bucket (s3/create_account). Requires authentication.

Parametersbucketconfirmrequiredplan_idlocation

s3_create_bucket

Create a new bucket in an existing S3 account (s3/create_bucket).

Parameterss3uidbucketrequiredconfirmrequiredaccount_id

s3_create_order

Create a paid S3 storage order linked to billing (s3/create_order). MONEY: creates a real order/invoice.

Parametersconfirmrequiredplan_idlocation

s3_delete_file

Delete a file from a bucket (s3/delete_file). DESTRUCTIVE: the file is permanently deleted.

Parametersfilerequireds3uidbucketrequiredconfirmrequiredaccount_id

s3_delete_bucket

Delete a bucket from an S3 account (s3/delete_bucket). DESTRUCTIVE: all files in the bucket will be deleted.

Parameterss3uidbucketrequiredconfirmrequiredaccount_id

s3_delete_account

Fully delete a user's S3 account (s3/delete_account). DESTRUCTIVE: all buckets and data will be deleted. Requires HOSTKEY_ALLOW_DESTRUCTIVE=1.

Parameterss3uidconfirmrequiredaccount_id

s3_delete_payment_account

Initiate S3 account deletion via service cancellation in billing (s3/delete_payment_account). DESTRUCTIVE: an end date will be set on the active service. Requires HOSTKEY_ALLOW_DESTRUCTIVE=1.

Parameterss3uidconfirmrequiredaccount_id

s3_cancel_account_deletion

Cancel S3 service deletion initiated via billing and restore the account to active status (s3/cancel_payment_account_deletion).

Parameterss3uidconfirmrequiredaccount_id

s3_update_traffic_info

Update S3 account traffic information (s3/update_traffic_info). Available to administrators only.

Parameterss3uidconfirmrequiredaccount_id

list_rhr_requests

Список заявок на удалённые работы с фильтрацией по локации и статусу (rhr/list).

Parametersstatuslocation

create_rhr_request

Создать заявку на удалённые работы (rhr/add): работы дежурной смены в дата-центре, которые нельзя выполнить удалённо. Опишите работы максимально подробно в comment. Использовать, только если модуль удалённого управления сервером недоступен/не работает.

Parametersidrequiredcommentrequiredconfirmrequiredrequest_type

add_rhr_comment

Добавить видимое клиенту сообщение в историю заявки (rhr/chat).

Parametersidrequiredconfirmrequiredmessagerequired

discard_rhr_request

Отменить/закрыть заявку на удалённые работы (rhr/discard). ДЕСТРУКТИВНО: заявка будет отменена.

Parametersidrequiredconfirmrequired

get_billing_client

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

Takes no parameters.

get_invoices

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

Takes no parameters.

get_invoice

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

Parametersinvoice_idrequired

get_server_invoices

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

Parametersidrequired

get_server_billing_data

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

Parametersidrequired

get_transactions

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

Parametersinvoice_idtransaction_id

get_credit_history

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

Parametersidrequired

get_payment_gateway

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

Parametersinvoice_idrequired

download_invoice

Скачать инвойс в PDF (whmcs/download_invoice). InvAPI отдаёт бинарный PDF; MCP возвращает JSON с encoding=base64 и data — декодируйте в .pdf.

Parametersinvoice_idrequired

get_cancellation_requests

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

Parametersid

get_contacts

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

Takes no parameters.

update_billing_client

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

Parametersconfirmrequiredbilling_citybilling_emailbilling_statebilling_countrybilling_address1billing_address2billing_lastnamebilling_postcodebilling_firstnamebilling_companynamebilling_phonenumber

reset_billing_password

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

Parametersemailrequiredconfirmrequired

add_contact

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

Parametersconfirmrequired

update_contact

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

Parametersemailrequiredconfirmrequiredpassword2contact_idrequiredphonenumber

delete_contact

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

Parametersconfirmrequiredcontact_idrequired

generate_due_invoice

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

Parametersidrequiredconfirmrequired

create_addfunds_invoice

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

Parametersamountrequiredconfirmrequired

apply_credit

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

Parametersamountrequiredconfirmrequiredinvoice_idrequired

mass_pay

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

Parametersconfirmrequiredinvoicesrequired

request_cancellation

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

Parametersidrequiredconfirmrequiredcancellation_typerequiredterminate_reason_custom

delete_cancellation_request

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

Parametersidrequiredconfirmrequired

check_task

Проверка статуса асинхронной операции по callback-ключу (eq_callback/check). Многие операции InvAPI (вкл/выкл питания, заказ, переустановка, снапшоты) возвращают {"result":"OK","callback":"<ключ>"}. Передайте этот ключ сюда, чтобы узнать статус: result="Not ready" — операция ещё идёт; result="OK" — завершена успешно (после этого ключ сгорает). Деплой сервера может занимать 10–30 минут. Если клиент передал progressToken, шлёт notifications/progress.

Parameterskeyrequired

power_on

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

Parametersidrequiredconfirmrequired

power_off

Выключить сервер (eq/off). ДЕСТРУКТИВНО: прерывает работу всех сервисов на сервере. Требует confirm=true. Асинхронная операция: в ответе будет callback-ключ для check_task.

Parametersidrequiredconfirmrequired

reboot_server

Перезагрузить сервер (eq/reboot). Прерывает работу сервисов на время перезагрузки. Требует confirm=true. Асинхронная операция: в ответе будет callback-ключ для check_task.

Parametersidrequiredconfirmrequired

order_server

Заказ instant- или stock-сервера (eq/order_instance). ВАЖНО: заказ списывает средства с кредитного баланса или выставляет инвойс. По умолчанию работает в режиме dry_run=true — только проверяет доступность пресета и ОС и возвращает сводку без создания заказа. Для реального заказа передайте dry_run=false и confirm=true после явного согласия пользователя на стоимость. Деплой занимает 10–30 минут, статус — через check_task.

Parametersos_idrequiredown_ospresetrequiredconfirmdry_runsoft_idssh_keyhostnamepromocoderoot_passrequiredtraffic_planrequireddeploy_notify+4 more

reinstall_server

Переустановка ОС на существующем сервере (упрощённый путь через eq/order_instance с id). ДЕСТРУКТИВНО: все данные на дисках будут удалены. Требуется HOSTKEY_ALLOW_DESTRUCTIVE=1 в окружении сервера, confirm=true и повторный ввод текущего hostname сервера. Асинхронная операция: статус — через check_task.

Parametersidrequiredos_idrequiredown_osconfirmrequiredsoft_idssh_keyhostnamerequiredroot_passrequireddeploy_notifypost_install_script

call_api_raw

Универсальный прямой вызов InvAPI по ресурсу и action, для ресурсов без типизированных инструментов (например: iso — библиотека ISO-образов, s3 — S3 Object Storage, rhr — Remote Hands новой версии; список действий смотрите в документации: https://hostkey.ru/documentation/apidocs/). ВСЕГДА требует confirm=true; деструктивные/платные действия дополнительно требуют HOSTKEY_ALLOW_DESTRUCTIVE=1. Предпочитайте типизированные инструменты, если они есть для нужной операции.

Parametersauthactionrequiredparamsconfirmrequiredresourcerequired

Version history

6
  1. v1.0.8LatestOct 23, 2026
  2. v1.0.7Oct 21, 2026
  3. v1.0.4Oct 16, 2026
  4. v1.0.3Oct 14, 2026
  5. v1.0.2Sep 23, 2026
  6. v1.0.1Sep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listed15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts