timeweb-mcp-server
Manage Timeweb Cloud infrastructure from MCP clients via 245 tools plus 6 resources and 2 prompts, using a local stdio server and TIMEWEB_TOKEN.
Create, inspect, configure, and delete cloud/dedicated servers, disks, backups, images, IPs, and SSH keys.
Manage App Platform applications and VCS providers/repositories.
Organize resources with projects; manage VPCs, floating IPs, network drives, and firewall groups/rules.
Operate Kubernetes clusters, node groups, load balancers, balancing rules, and backend IPs.
Create and manage container registries.
Manage managed databases: clusters, instances, users, privileges, and presets.
Manage S3 buckets: presets, subdomains, SSL certificates, and transfer status.
Manage domains, DNS records, subdomains, name servers, domain requests, and mailboxes.
Manage AI agents and view token-usage statistics.
Create/edit/delete API keys and inspect account status, finances, service costs, presets, and locations.
Use MCP resources for allowed presets, VCS providers/repositories, deploy settings, database presets, and VPCs; use prompts for app/VCS workflows.
Caution: tools act on real infrastructure and may create paid resources or delete data; use a least-privilege token and confirm destructive actions.
Provides tools for managing Kubernetes clusters, load balancers, and container registries within the Timeweb Cloud infrastructure.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@timeweb-mcp-server Deploy my React app to Timeweb Cloud"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Timeweb Cloud MCP Server
MCP-сервер для управления инфраструктурой Timeweb Cloud из Cursor, VS Code и других клиентов, поддерживающих Model Context Protocol.
Сервер работает через stdio, принимает вызовы MCP-инструментов и выполняет соответствующие запросы к API Timeweb Cloud.
Проект находится в активной экспериментальной разработке и развивается независимо от Timeweb Cloud. Некоторые возможности API могут быть реализованы не полностью или меняться между версиями.
Возможности
Текущая сборка регистрирует:
Возможность MCP | Количество |
Инструменты | 245 |
Ресурсы | 6 |
Промпты | 2 |
Инструменты охватывают основные операции со следующими сервисами:
приложения App Platform и VCS-провайдеры;
облачные и выделенные серверы, диски, резервные копии и образы;
проекты, VPC, плавающие IP, сетевые диски и Firewall;
Kubernetes, балансировщики и реестры контейнеров;
базы данных;
S3-хранилища;
домены, DNS и почта;
SSH-ключи и API-ключи;
AI-агенты;
аккаунт, платежная информация, тарифы и локации.
Доступные MCP-ресурсы:
allowed_presets;vcs_providers;vcs_provider_repositories;deploy_settings;database_presets;get_vpcs.
Доступные промпты:
create_app_prompt;add_vcs_provider_prompt.
Полный список фактически зарегистрированных инструментов находится в src/tools/index.ts.
Официальная OpenAPI-спецификация содержит 514 операций в 31 группе. Это не означает, что каждая операция уже представлена отдельным MCP-инструментом.
Related MCP server: PlugLayer MCP Server
Требования
Node.js 20 или новее;
npm;
MCP-клиент с поддержкой локальных
stdio-серверов;API-токен Timeweb Cloud.
Получение API-токена
Создайте токен в панели Timeweb Cloud в разделе «API и Terraform». Официальная инструкция: Токены API и Terraform.
Проект ожидает токен в переменной окружения:
TIMEWEB_TOKENНе путайте её с TIMEWEB_CLOUD_TOKEN, которая используется в некоторых других инструментах Timeweb Cloud.
По возможности выпускайте токен с ограниченными правами и сроком действия. Не сохраняйте настоящий токен в Git.
Быстрый старт
Пакет не требует глобальной установки:
npx -y timeweb-mcpОбычно сервер запускает MCP-клиент, передавая TIMEWEB_TOKEN через свою конфигурацию.
Подключение MCP-клиента
Cursor
Добавьте сервер в .cursor/mcp.json:
{
"mcpServers": {
"timeweb-cloud": {
"command": "npx",
"args": ["-y", "timeweb-mcp"],
"env": {
"TIMEWEB_TOKEN": "your-timeweb-token"
}
}
}
}Не добавляйте конфигурацию с настоящим токеном в публичный репозиторий.
VS Code
VS Code хранит конфигурацию рабочего пространства в .vscode/mcp.json. Токен можно запрашивать через защищённое поле ввода:
{
"inputs": [
{
"type": "promptString",
"id": "timeweb-token",
"description": "Timeweb Cloud API token",
"password": true
}
],
"servers": {
"timeweb-cloud": {
"type": "stdio",
"command": "npx",
"args": ["-y", "timeweb-mcp"],
"env": {
"TIMEWEB_TOKEN": "${input:timeweb-token}"
}
}
}
}Управлять сервером можно через команды MCP: List Servers и MCP: Open Workspace Folder MCP Configuration.
Другие MCP-клиенты
Для клиентов, использующих формат mcpServers, базовая конфигурация выглядит так:
{
"mcpServers": {
"timeweb-cloud": {
"command": "npx",
"args": ["-y", "timeweb-mcp"],
"env": {
"TIMEWEB_TOKEN": "your-timeweb-token"
}
}
}
}Название корневого поля и способ безопасного хранения секретов зависят от конкретного MCP-клиента.
Локальная разработка
Клонируйте репозиторий и установите зависимости:
git clone https://github.com/ichinya/timeweb-mcp.git
cd timeweb-mcp
npm ciСоздайте локальный файл .env:
TIMEWEB_TOKEN=your-timeweb-tokenПроверьте типы и соберите сервер:
npm run type-check
npm run buildЗапустите локальную сборку:
npm run startMCP Inspector
MCP Inspector позволяет просматривать инструменты, ресурсы и промпты, а также выполнять тестовые вызовы:
npm run inspectПеред запуском добавьте TIMEWEB_TOKEN в .env.
Команды разработки
Для установки dev-зависимостей, сборки и проверок используйте Node.js 22.18+,
24.11+ или 26+ (чётные ветки): это требование tsdown. Готовый пакет по-прежнему
собирается с target Node.js 20. Обновлённый TypeScript 7 запускается через CLI;
типы offline-тестов проверяются по tsconfig.tests.json до их выполнения.
Команда | Назначение | Совместимость |
| Проверка TypeScript без генерации файлов | Windows, macOS, Linux |
| Сборка проекта | Windows, macOS, Linux |
| Проверка логики определения новой версии и релизного тега | Windows, macOS, Linux |
| Тесты нормализации OpenAPI, provenance и анализатора маршрутов | Windows, macOS, Linux |
| Сценарии готовности, timeout, вывода и завершения smoke-процесса | Windows, macOS, Linux |
| Проверка типов и offline-тесты ошибок API, отмены и потерянного ответа | Windows, macOS, Linux |
| Проверка запуска собранного MCP-сервера и чистоты | Windows, macOS, Linux |
| Шесть запусков сервера с измерениями первого и последующих стартов | Windows, macOS, Linux |
| OpenAPI/маршруты, все тесты, TypeScript, сборка и оба smoke-теста | Windows, macOS, Linux |
| Запуск | Windows, macOS, Linux |
| Запуск MCP Inspector | Windows, macOS, Linux |
| Удаление | Windows, macOS, Linux |
| Нормализация конфликтующих имён схем | Windows, macOS, Linux |
| Проверка локальной OpenAPI-спецификации | Windows, macOS, Linux |
Обработка ошибок, неизвестный результат изменения ресурса и правила повторов описаны в
docs/transport-errors.md. Автоматические повторы API-запросов
не выполняются. При потере ответа изменение могло завершиться: перед повтором проверьте
состояние ресурса. Транспортные тесты не используют настоящий токен или cloud-ресурсы.
Startup smoke по умолчанию ждёт готовность 5000 мс и проверяет пустой stdout сервера.
Единственный итог содержит status, readyMs/elapsedMs, PID, exit code/signal,
счётчики вывода и результат cleanup без содержимого stdout/stderr.
spawn_error с EPERM означает отказ запуска процесса; timeout — отсутствие
готовности в срок. После остановки предусмотрены два интервала cleanup по 1000 мс.
Измерения и ограничения расследования #31: docs/smoke-startup.md.
Для медленного окружения startup smoke и startup-series принимают
TIMEWEB_SMOKE_START_TIMEOUT_MS: целое количество миллисекунд от 1000 до 30000,
записанное только ASCII-цифрами. Если переменная отсутствует, используется 5000;
пустая строка, пробелы, знаки, дроби, экспоненциальная запись и значения вне диапазона
дают один configuration_error и ненулевой exit до запуска сервера.
Исходное ошибочное значение не выводится. Выбранный timeoutMs виден в результате
и metadata серии. Настройка не меняет API timeout, MCP handshake и сроки cleanup;
увеличенный срок автоматически в CI не задаётся.
Пример PowerShell с восстановлением прежнего окружения:
$previousTimeout = [Environment]::GetEnvironmentVariable('TIMEWEB_SMOKE_START_TIMEOUT_MS', 'Process')
try {
$env:TIMEWEB_SMOKE_START_TIMEOUT_MS = '10000'
npm run smoke
} finally {
[Environment]::SetEnvironmentVariable('TIMEWEB_SMOKE_START_TIMEOUT_MS', $previousTimeout, 'Process')
}Проверки pull requests и main
Workflow Verify запускается для всех pull requests
и каждого push в main, включая обычные изменения кода без повышения версии.
Фильтров по путям нет: изменения tests, scripts, specs и самих workflows также проверяются.
На Ubuntu и Windows с Node.js 24 выполняются npm ci --ignore-scripts по lockfile,
сборка, npm run smoke:startup-series и затем npm run verify.
Серия фиксирует первый и пять последующих запусков свежих процессов Node,
время готовности/завершения и хеш сборки; холодный файловый кеш не предполагается.
Обе платформы проверяются независимо: отказ одной не отменяет другую.
Единая команда verify включает проверку OpenAPI и маршрутов, test:openapi,
release- и smoke-start-тесты, проверку типов, offline transport/API/MCP-тесты, сборку и оба smoke-теста.
В CI TIMEWEB_TOKEN явно пустой; cloud-токены и repository secrets не требуются.
Это offline-проверки: они не подтверждают production-совместимость Timeweb API.
После успешного verify на обеих платформах запускается информационный аудит
метаданных MCP через mcpunit 1.5.0 (GitHub Action закреплён на commit SHA).
Он проверяет опубликованные схемы, описания инструментов и промптов без токена Timeweb.
Отчёт появляется в job summary; JSON, SARIF и Markdown сохраняются в артефакте
mcpunit-ubuntu-latest или mcpunit-windows-latest. Загрузка SARIF в Code Scanning отключена.
Оценка и сбои аудита пока не блокируют PR; обязательные проверки verify сохраняются.
Аудит дополняет существующие тесты API и обработчиков.
В MCP-инструментах create_balancer и update_balancer HTTP-путь проверки
состояния backend передаётся аргументом health_check_path (ранее path).
Обновите сохранённые MCP-вызовы этих инструментов и перечитайте их схемы в клиенте.
При создании аргумент обязателен; при обновлении его можно не передавать,
чтобы сохранить текущее значение. В запросах к Timeweb API поле по-прежнему
называется path: преобразование выполняется обработчиками MCP.
Отчёты mcpunit публикуются без фильтрации или исключений.
Verify имеет только contents: read, не публикует пакет и не создаёт теги/releases.
Новые запуски отменяют устаревшие проверки того же PR/ref, не затрагивая релизный workflow.
Проверка сама по себе не делает status check обязательным для merge:
branch protection/rulesets настраиваются отдельно. Настройки GitHub этим workflow не меняются.
Выпуск новой версии
Пакет публикуется автоматически из GitHub Actions через npm Trusted Publishing. Постоянный NPM_TOKEN в репозитории не используется.
Обновите версию одновременно в
package.jsonиpackage-lock.json:npm version patch --no-git-tag-versionВместо
patchможно использоватьminor,majorили указать точную версию.Закоммитьте и отправьте изменения в
main.Workflow
.github/workflows/publish.ymlсравнит новую версию с версией предыдущего коммита.Если версия увеличилась, workflow проверит проект, создаст тег
vX.Y.Z, опубликует пакет с той же версией в npm и создаст GitHub Release.
Создавать тег или GitHub Release вручную не нужно. Изменение других полей package.json без повышения версии не запускает выпуск. Понижение версии считается ошибкой.
Trusted Publisher в настройках npm должен быть связан со следующими значениями:
GitHub user:
ichinya;repository:
timeweb-mcp;workflow filename:
publish.yml;allowed action:
npm publish;environment: не задан.
Публикация выполняется на GitHub-hosted runner через OIDC и автоматически получает npm provenance.
OpenAPI-спецификация
Официальные источники:
Локальная копия находится в specs/openapi.json.
Canonical API host: https://api.timeweb.cloud. Источник, дата UTC и SHA-256 загрузки
и нормализованного файла записаны в specs/openapi-source.json.
Матрица legacy-исключений и ограничения проверки описаны в
docs/api-compatibility.md; новые сервисы — в
docs/api-services-backlog.md.
Текущая спецификация содержит:
OpenAPI
3.0.0;336 путей;
514 операций;
31 группу;
466 схем компонентов.
Обновление спецификации
PowerShell:
Invoke-WebRequest `
-Uri "https://timeweb.cloud/api-docs-data/bundle.json" `
-OutFile "specs/openapi.json"
npm run normalize:openapi
npm run validate:openapimacOS или Linux:
curl -fsSL \
https://timeweb.cloud/api-docs-data/bundle.json \
-o specs/openapi.json
npm run normalize:openapi
npm run validate:openapiНормализация переименовывает только конфликтующие ключи в components.schemas и соответствующие внутренние $ref:
Официальное имя | Локальное имя |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Это устраняет коллизии имён файлов и TypeScript-моделей на файловых системах без учёта регистра. Названия полей запросов и ответов, пути API и wire-формат данных не изменяются.
Скрипт проверки контролирует:
версию OpenAPI;
наличие и уникальность
operationId;разрешение внутренних
$ref;отсутствие коллизий генерируемых TypeScript-имён моделей.
Структура проекта
src/
actions/ вызовы API и прикладные операции
api/ клиенты сервисов Timeweb Cloud
prompts/ MCP-промпты
resources/ MCP-ресурсы
tools/ определения и схемы MCP-инструментов
types/ типы и DTO
scripts/
normalize-openapi.mjs
validate-openapi.mjs
specs/
openapi.jsonAPI-клиенты в src/api поддерживаются вручную. Код сервера пока не генерируется автоматически из specs/openapi.json.
npm run validate:openapi также проверяет маршруты клиентов. Полная матрица доступна
через node scripts/check-api-routes.mjs; тесты нормализации и provenance — через
node --test scripts/openapi.test.mjs. После обновления и нормализации спецификации
обновляйте дату и hashes в provenance-файле. Наличие маршрута в OpenAPI не подтверждает
совместимость всех полей или фактическую доступность legacy API.
Безопасность
Инструменты выполняют операции над реальной инфраструктурой и могут создавать платные ресурсы, менять конфигурацию или удалять данные.
Проверяйте имя инструмента и все аргументы перед подтверждением вызова.
Используйте отдельный API-токен с минимально необходимыми правами.
Не передавайте токен в сообщения модели и не сохраняйте его в Git.
Сначала проверяйте опасные сценарии на тестовых ресурсах.
Не полагайтесь только на MCP-аннотации: сейчас инструменты регистрируются с одинаковыми подсказками и не всегда корректно обозначают операции удаления или изменения данных.
Локальные MCP-серверы выполняются на машине пользователя с правами запустившего их процесса. Подключайте только доверенный код и проверяйте изменения перед обновлением.
Известные ограничения
Проект находится в экспериментальном состоянии.
MCP-покрытие не равно полному покрытию официальной OpenAPI-спецификации.
API-клиенты и DTO поддерживаются вручную и могут отставать от API.
Автоматические тесты и отдельный CI-workflow пока не настроены; GitHub Actions используется только для публикации релизов в npm.
Ссылки
Репозиторий: ichinya/timeweb-mcp
npm: timeweb-mcp
Официальная документация Timeweb Cloud: timeweb.cloud/docs
Официальная документация API: timeweb.cloud/api-docs
Лицензия
Проект распространяется по лицензии MIT. Copyright (c) 2026 ichinya.
Available Tools
245 toolsadd_balancer_ipsДобавление IP к балансировщикуBDestructive
Добавляет backend IP-адреса к балансировщику. На эти IP будет распределяться входящий трафик.
Inputs: ips (required), balancer_id (required).
add_balancer_to_projectДобавление балансировщика в проектADestructive
Привязывает существующий балансировщик к проекту. Для переноса между проектами используй transfer_project_resource.
Inputs: project_id (required), resource_id (required).
add_bucket_subdomain_certificateВыпуск SSL-сертификата для поддомена S3-хранилищаADestructive
Выпускает SSL-сертификат (Let's Encrypt) для поддомена, привязанного к S3-хранилищу. Поддомен должен быть предварительно добавлен через add_bucket_subdomains и иметь корректную CNAME-запись.
Inputs: subdomain (required).
add_bucket_subdomainsДобавление поддоменов к S3-хранилищуA
Добавляет один или несколько поддоменов к S3-хранилищу. Для каждого возвращает статус: success, empty_cname (нет CNAME-записи), duplicate или failed. После добавления выпускай SSL через add_bucket_subdomain_certificate.
Inputs: bucket_id (required), subdomains (required).
add_bucket_to_projectДобавление хранилища в проектCDestructive
Привязывает существующее S3-хранилище к проекту.
Inputs: project_id (required), resource_id (required).
add_cluster_to_projectДобавление кластера в проектCDestructive
Привязывает существующий Kubernetes-кластер к проекту.
Inputs: project_id (required), resource_id (required).
add_database_to_projectДобавление БД в проектCDestructive
Привязывает существующую managed-БД к проекту.
Inputs: project_id (required), resource_id (required).
add_dedicated_to_projectДобавление выделенного сервера в проектCDestructive
Привязывает существующий выделенный сервер к проекту.
Inputs: project_id (required), resource_id (required).
add_domainДобавление домена на аккаунтA
Добавляет уже зарегистрированный в другом месте домен на аккаунт Timeweb Cloud для управления DNS и name-серверами. Не выполняет регистрацию — для регистрации используй create_domain_request.
Inputs: fqdn (required).
add_server_ipДобавление IP-адреса сервераADestructive
Выделяет новый IPv4 или IPv6 адрес для сервера. Опционально можно задать PTR-запись.
Inputs: type (required), server_id (required), ptr.
add_server_to_projectДобавление сервера в проектADestructive
Привязывает существующий VPS-сервер к проекту. Для переноса между проектами — transfer_project_resource.
Inputs: project_id (required), resource_id (required).
add_ssh_keys_to_serverДобавление SSH-ключей на серверA
Добавляет один или несколько существующих SSH-ключей на сервер по массиву ID. Получить ID ключей можно через list_ssh_keys, ID сервера — через list_servers.
Inputs: server_id (required), ssh_key_ids (required).
add_subdomainДобавление поддоменаC
Создаёт поддомен у указанного основного домена. Нужны FQDN основного домена и FQDN поддомена.
Inputs: fqdn (required), subdomain_fqdn (required).
add_vcs_providerДобавление VCS провайдераB
Добавляет новый VCS провайдер для подключения Git репозиториев к Timeweb Cloud
Inputs: url (required), provider_type (required), login, password.
batch_create_mailboxesМассовое создание почтовых ящиковA
Создаёт сразу несколько почтовых ящиков на одном домене (API v2). Возвращает список созданных ящиков и массив ошибок.
Inputs: domain (required), mailboxes (required).
batch_create_mailboxes_v1Массовое создание почтовых ящиков (API v1)A
Создаёт несколько ящиков на домене через API v1. Предпочитай batch_create_mailboxes (v2).
Inputs: domain (required), mailboxes (required).
bind_floating_ipПривязка плавающего IP к сервисуBDestructive
Привязывает плавающий IP к сервису (server / balancer / database / network) по ID ресурса
Inputs: resource_id (required), resource_type (required), floating_ip_id (required).
check_domainПроверка доступности домена для регистрацииARead-only
Проверяет, свободен ли домен и можно ли его зарегистрировать. Возвращает булево значение.
Inputs: fqdn (required).
clone_serverКлонирование сервераA
Создаёт полную копию сервера в отдельный VPS с такой же конфигурацией и данными. Использовать для миграций, blue-green deploy или тестирования рискованных операций на копии.
Inputs: server_id (required).
create_ai_agentСоздание AI-агентаA
Создаёт нового AI-агента. Обязательны: name, access_type, model_id, token_package_id, system_prompt. Перед вызовом получи model_id через list_ai_models и token_package_id через list_ai_agent_token_packages.
Inputs: name (required), model_id (required), access_type (required), system_prompt (required), +9 more.
create_api_keyСоздание API-токенаA
Создает новый API-токен. Значение токена возвращается один раз и должно быть сохранено
Inputs: name (required), expire, projects, is_able_to_delete.
create_balancerСоздание балансировщикаA
Создаёт новый балансировщик нагрузки. Обязательны: name, algo, is_sticky, is_use_proxy, is_ssl, is_keepalive, proto, path, inter, timeout, fall, rise, preset_id. preset_id получай через list_balancer_presets. Для приватной сети задай network_id. Для SSL — certificate_type.
Inputs: algo (required), fall (required), name (required), path (required), +24 more.
create_balancer_ruleСоздание правила балансировщикаB
Создаёт правило маршрутизации для балансировщика: соответствие между парой (протокол, порт) балансировщика и (протокол, порт) backend-сервера.
Inputs: balancer_id (required), server_port (required), server_proto (required), balancer_port (required), +1 more.
create_bucketСоздание S3-хранилищаA
Создаёт новое S3-хранилище. Нужно указать name, type (private/public) и ЛИБО preset_id, ЛИБО configurator_id + configurator_disk_mb. Возвращает access_key и secret_key для подключения.
Inputs: name (required), type (required), preset_id, project_id, +3 more.
create_container_registryСоздание реестра контейнеровA
Создаёт новый реестр контейнеров (Container Registry). Укажи либо preset_id (готовый тариф), либо configurator_id + disk (кастомная конфигурация). Имя должно быть уникальным, 3-48 символов, только [a-z0-9-].
Inputs: name (required), disk, preset_id, project_id, +2 more.
create_databaseСоздание базы данныхC
Создает новую базу данных в Timeweb Cloud с указанными параметрами
Inputs: name (required), type (required), vpc_id (required), preset_id (required), +5 more.
create_database_adminСоздание пользователя кластераB
Создаёт пользователя в кластере базы данных (POST /api/v1/databases/{db_cluster_id}/admins).
Inputs: login (required), password (required), privileges (required), db_cluster_id (required), +3 more.
create_database_instanceСоздание инстанса в кластереC
Создаёт новый инстанс (БД) внутри кластера (POST /api/v1/databases/{db_cluster_id}/instances).
Inputs: name (required), db_cluster_id (required), description.
create_dedicated_serverСоздание выделенного сервераA
Создаёт новый выделенный (dedicated) физический сервер. Обязательные поля: preset_id (тариф), payment_period (P1M/P3M/P6M/P1Y), name. Опционально: OS, панель управления, доп. услуги, сетевой диск, IP-адрес, проект. Перед вызовом получи preset_id через list_dedicated_server_presets.
Inputs: name (required), preset_id (required), payment_period (required), cp_id, +7 more.
create_dns_recordСоздание DNS-записиB
Создаёт DNS-запись (A, AAAA, TXT, CNAME, MX, SRV) для домена или поддомена. Использует API v2. Для SRV нужны host/port/service/protocol вместо value.
Inputs: fqdn (required), type (required), ttl, host, +7 more.
create_domain_requestСоздание заявки на домен (регистрация/продление/трансфер)BDestructive
Создаёт заявку на операцию с доменом: регистрация (register), продление (prolong), перенос (transfer). Для register нужен person_id, для transfer — auth_code.
Inputs: fqdn (required), action (required), prime, period, +5 more.
create_firewall_groupСоздание группы правил firewallA
Создаёт новую группу правил firewall. Имя обязательно, описание и политика (ACCEPT/DROP) — опциональны. После создания группу можно наполнить правилами через create_firewall_rule и привязать к серверу через link_firewall_resource.
Inputs: name (required), policy, description.
create_firewall_ruleСоздание правила firewallB
Создаёт новое правило в группе firewall. Обязательны direction (ingress/egress) и protocol (tcp/udp/icmp). Для tcp/udp можно указать port и cidr.
Inputs: group_id (required), protocol (required), direction (required), cidr, +2 more.
create_floating_ipСоздание Floating IPC
Создает новый floating IP адрес в указанной зоне доступности
Inputs: availability_zone (required), is_ddos_guard.
create_imageСоздание образаA
Создаёт образ: (а) снапшот существующего диска сервера (disk_id), (б) импорт qcow2/iso по upload_url, либо (в) пустой слот для последующей загрузки (без disk_id и upload_url — тогда заливай файл через HTTP). Процесс асинхронный, отслеживать через get_image.
Inputs: os (required), location (required), name, disk_id, +2 more.
create_image_downloadСоздание ссылки на скачивание образаA
Создаёт ссылку на скачивание образа. type=timeweb — прямая ссылка на файл (без auth). type=google_drive или yandex — копирование в облако пользователя (нужен access_token). Процесс асинхронный.
Inputs: image_id (required), type, expiry, filename, +3 more.
create_k8s_clusterСоздание Kubernetes-кластераB
Создаёт новый Kubernetes-кластер. Обязательные параметры: name, k8s_version, network_driver. Для мастер-ноды укажи либо preset_id, либо configuration (взаимоисключающе). Опционально задай worker_groups, OIDC, зону, ingress.
Inputs: name (required), k8s_version (required), network_driver (required), preset_id, +9 more.
create_k8s_node_groupСоздание группы нодB
Создаёт новую группу воркер-нод в кластере. Обязательные: name, node_count. Для тарифа — либо preset_id, либо configuration (взаимоисключающе).
Inputs: name (required), cluster_id (required), node_count (required), labels, +6 more.
create_mailboxСоздание почтового ящикаB
Создаёт новый почтовый ящик на указанном домене (API v2). Поддерживает задание ФИО владельца и начальных настроек спам-фильтра.
Inputs: domain (required), mailbox (required), password (required), comment, +3 more.
create_mailbox_v1Создание почтового ящика (API v1)A
Создаёт почтовый ящик через API v1. Предпочитай create_mailbox (v2) — этот нужен только для совместимости.
Inputs: domain (required), mailbox (required), password (required), comment.
create_network_driveСоздание сетевого дискаA
Создаёт новый сетевой диск указанного размера с выбранным тарифом (preset_id). Перед созданием стоит получить список доступных тарифов через list_network_drive_presets.
Inputs: name (required), size (required), preset_id (required), comment.
create_projectСоздание проектаC
Создаёт новый проект для группировки ресурсов (серверов, БД, хранилищ и т.д.).
Inputs: name (required), avatar_id, description.
create_serverСоздание сервераB
Создаёт новый облачный сервер. Выбор режима: preset_id XOR configurator_id (+cpu/ram/disk/[gpu]). Выбор ОС: os_id XOR image_id. Поддерживает ssh_keys_ids, is_ddos_guard, bandwidth, availability_zone, project_id, hostname, cloud_init.
Inputs: name (required), cpu, gpu, ram, +15 more.
create_server_disk_backupСоздание бэкапа дискаA
Создаёт ручной бэкап диска VPS. Процесс асинхронный: tool возвращается сразу, статус бэкапа переходит create → done в течение нескольких минут. Используй перед рискованными операциями (миграция, обновление ОС).
Inputs: disk_id (required), server_id (required), comment.
create_ssh_keyСоздание SSH-ключаB
Создаёт новый SSH-ключ в аккаунте. Требуются имя, тело публичного ключа и флаг is_default (будет ли ключ выбираться по умолчанию при создании сервера).
Inputs: body (required), name (required), is_default (required).
create_timeweb_appСоздание приложения в Timeweb CloudC
Создает приложение в Timeweb Cloud с автоматическим определением параметров проекта.
Inputs: name (required), type (required), build_cmd (required), framework (required), +12 more.
create_vpcСоздание виртуальной приватной сети (VPC)C
Создает новую виртуальную приватную сеть в указанной зоне доступности
Inputs: subnet_v4 (required), availability_zone (required), name.
delete_ai_agentУдаление AI-агентаADestructive
Удаляет AI-агента по ID. ⚠️ Операция необратима — подтверждай с пользователем.
Inputs: agent_id (required).
delete_api_keyУдаление API-токенаCDestructive
Удаляет API-токен по его ID
Inputs: token_id (required).
delete_balancerУдаление балансировщикаADestructive
Удаляет балансировщик. Действие необратимо. Для аккаунтов с 2FA — первый вызов вернёт hash, повторный вызов с hash и code завершит удаление.
Inputs: balancer_id (required), code, hash.
delete_balancer_ruleУдаление правила балансировщикаBDestructive
Удаляет правило маршрутизации у балансировщика. Действие необратимо.
Inputs: rule_id (required), balancer_id (required).
delete_bucketУдаление S3-хранилищаADestructive
Удаляет S3-хранилище. Действие необратимо. Для аккаунтов с 2FA: первый вызов возвращает hash, второй вызов нужен с hash и code. Все данные в хранилище будут потеряны.
Inputs: bucket_id (required), code, hash.
delete_bucket_subdomainsУдаление поддоменов S3-хранилищаBDestructive
Удаляет один или несколько поддоменов из S3-хранилища. Возвращает статус удаления по каждому поддомену.
Inputs: bucket_id (required), subdomains (required).
delete_container_registryУдаление реестра контейнеровADestructive
Удаляет реестр контейнеров безвозвратно. ⚠️ Все образы в реестре будут потеряны. Перед удалением убедись, что реестр не используется.
Inputs: registry_id (required).
delete_database_adminУдаление пользователя кластераADestructive
Удаляет пользователя кластера базы данных (DELETE /api/v1/databases/{db_cluster_id}/admins/{admin_id}). Действие необратимо.
Inputs: admin_id (required), db_cluster_id (required).
delete_database_clusterУдаление кластера базы данныхADestructive
Удаляет кластер баз данных (DELETE /api/v1/databases/{db_cluster_id}). Для аккаунтов с 2FA в ответе вернётся hash — повторите запрос с ним и с code из аутентификатора.
Inputs: db_cluster_id (required), code, hash.
delete_dedicated_serverУдаление выделенного сервераADestructive
Удаляет выделенный (dedicated) сервер. ⚠️ Все данные на сервере будут потеряны безвозвратно. Подтверди операцию с пользователем перед вызовом.
Inputs: dedicated_id (required).
delete_dns_recordУдаление DNS-записиCDestructive
Удаляет DNS-запись по ID для указанного домена. Использует API v2.
Inputs: fqdn (required), record_id (required).
delete_domainУдаление доменаBDestructive
Удаляет домен с аккаунта по FQDN. Операция необратима — отвязывает домен от аккаунта Timeweb Cloud.
Inputs: fqdn (required).
delete_firewall_groupУдаление группы правил firewallADestructive
Удаляет группу правил firewall. Действие необратимо. Перед удалением рекомендуется отлинковать все связанные ресурсы через unlink_firewall_resource.
Inputs: group_id (required).
delete_firewall_ruleУдаление правила firewallBDestructive
Удаляет правило из группы firewall. Действие необратимо.
Inputs: rule_id (required), group_id (required).
delete_floating_ipУдаление плавающего IPCDestructive
Удаляет плавающий IP по его ID
Inputs: floating_ip_id (required).
delete_imageУдаление образаADestructive
⚠️ НЕОБРАТИМО: Удаляет образ по его ID. После удаления восстановить нельзя. Серверы, уже созданные из образа, продолжают работать — удаление влияет только на возможность создания новых серверов из этого образа.
Inputs: image_id (required).
delete_image_downloadУдаление ссылки на скачивание образаADestructive
Удаляет ссылку на скачивание образа. Используй для отмены процесса копирования образа во внешнее хранилище.
Inputs: image_id (required), image_url_id (required).
delete_k8s_clusterУдаление Kubernetes-кластераADestructive
Удаляет Kubernetes-кластер. Действие необратимо. Для аккаунтов с 2FA: первый вызов возвращает hash, затем повторный вызов с hash и code подтверждает удаление.
Inputs: cluster_id (required), code, hash.
delete_k8s_cluster_nodeУдаление ноды кластераBDestructive
Удаляет конкретную ноду из кластера. Действие необратимо.
Inputs: node_id (required), cluster_id (required).
delete_k8s_node_groupУдаление группы нодADestructive
Удаляет группу нод из кластера. Все ноды группы будут удалены.
Inputs: group_id (required), cluster_id (required).
delete_mailboxУдаление почтового ящикаBDestructive
Безвозвратно удаляет почтовый ящик. Операция необратима — вся почта будет потеряна.
Inputs: domain (required), mailbox (required).
delete_network_driveУдаление сетевого дискаADestructive
Удаляет сетевой диск по ID. Действие необратимо, данные будут потеряны. Перед удалением диск должен быть отключён от всех сервисов (unmount_network_drive).
Inputs: network_drive_id (required).
delete_projectУдаление проектаADestructive
Удаляет проект. Проект по умолчанию удалить нельзя. Ресурсы останутся на аккаунте — проверь и перенеси их заранее через transfer_project_resource.
Inputs: project_id (required).
delete_serverУдаление сервераADestructive
Удаляет сервер. Для аккаунтов с 2FA первый вызов возвращает hash — повторный вызов с hash и code завершит удаление. Удалённый сервер может быть перемещён в карантин.
Inputs: server_id (required), code, hash.
delete_server_disk_backupУдаление бэкапа дискаADestructive
Удаляет бэкап диска сервера. Действие необратимо. Перед удалением стоит убедиться через list_server_disk_backups что это не последний актуальный бэкап.
Inputs: disk_id (required), backup_id (required), server_id (required).
delete_server_ipУдаление IP-адреса сервераBDestructive
Удаляет конкретный IP-адрес (IPv4 или IPv6) с сервера. Основной IP удалить нельзя.
Inputs: ip (required), server_id (required).
delete_ssh_keyУдаление SSH-ключаADestructive
Удаляет SSH-ключ из аккаунта по ID. Действие необратимо. Перед удалением проверь через list_ssh_keys, что ключ не используется на критичных серверах (поле used_by).
Inputs: ssh_key_id (required).
delete_subdomainУдаление поддоменаBDestructive
Удаляет поддомен по его FQDN из указанного основного домена.
Inputs: fqdn (required), subdomain_fqdn (required).
delete_vpcУдаление VPCCDestructive
Удаляет виртуальную приватную сеть (VPC) по её ID
Inputs: vpc_id (required).
edit_api_keyИзменение API-токенаADestructive
Изменяет имя и/или флаг is_able_to_delete API-токена по его ID
Inputs: token_id (required), name, is_able_to_delete.
edit_k8s_clusterРедактирование Kubernetes-кластераADestructive
Редактирует имя, описание или OIDC-провайдера кластера. Другие параметры (версия, ноды) изменяются отдельными инструментами.
Inputs: cluster_id (required), name, description, oidc_provider.
get_account_financesФинансы аккаунтаARead-only
Возвращает баланс, абонентскую плату, стоимость услуг, скидку и данные автоплатежа. Используй для ответа на вопросы 'сколько денег осталось', 'сколько тратим в месяц', 'когда кончатся деньги' (hours_left).
Inputs: no named parameters.
get_account_services_costСтоимость сервисов аккаунтаARead-only
Возвращает детализацию расходов по всем сервисам (VPS, БД, S3, DNS и пр.). Полезно для ответа 'куда уходят деньги' и поиска самых дорогих ресурсов. Для общего баланса используй get_account_finances.
Inputs: no named parameters.
get_account_statusСтатус аккаунтаARead-only
Возвращает статус блокировки аккаунта и настройки уведомлений. Используй для диагностики 'почему API не отвечает' (возможна блокировка при недостатке средств).
Inputs: no named parameters.
get_ai_agentПолучение AI-агентаARead-only
Возвращает детальную информацию об AI-агенте по ID: название, статус, доступ, модель, пакет токенов, system prompt, остаток токенов.
Inputs: agent_id (required).
get_ai_agent_statisticСтатистика использования токенов AI-агентаBRead-only
Возвращает статистику использования токенов агента по временным интервалам. Параметры start_time/end_time в ISO 8601, interval в минутах (60 по умолчанию).
Inputs: agent_id (required), end_time, interval, start_time.
get_allowed_presetsПолучение доступных пресетов для создания приложенияBRead-only
Получает список доступных пресетов для создания приложения
Inputs: no named parameters.
get_balancerПолучение балансировщикаARead-only
Возвращает детальную информацию о балансировщике по ID: статус, протокол, порт, алгоритм, таймауты, сертификаты, правила, IP-адреса.
Inputs: balancer_id (required).
get_bucketПолучение S3-хранилищаARead-only
Возвращает детальную информацию об одном S3-хранилище по его ID: название, тип, статус, класс, локация, hostname, ключи доступа, использование диска, настройки веб-сайта.
Inputs: bucket_id (required).
get_bucket_presetsТарифы S3-хранилищARead-only
Возвращает список доступных тарифов для S3-хранилищ с id, размером диска, ценой, классом (cold/hot), локацией. Используй перед create_bucket, чтобы получить preset_id.
Inputs: no named parameters.
get_bucket_transfer_statusСтатус переноса S3-хранилищаARead-only
Возвращает статус переноса хранилища от стороннего S3-провайдера в Timeweb Cloud: started/suspended/failed, количество и размер объектов, перенесено, попытки, ошибки. Используй после transfer_bucket.
Inputs: bucket_id (required).
get_container_registryПолучение информации о реестре контейнеровARead-only
Возвращает детальную информацию о конкретном реестре контейнеров по ID: имя, описание, тариф, использование диска, дата создания и обновления.
Inputs: registry_id (required).
get_database_adminПолучение пользователя кластераCRead-only
Возвращает информацию о пользователе кластера базы данных (GET /api/v1/databases/{db_cluster_id}/admins/{admin_id}).
Inputs: admin_id (required), db_cluster_id (required).
get_database_clusterПолучение кластера базы данныхBRead-only
Возвращает детальную информацию о конкретном кластере баз данных по его ID (GET /api/v1/databases/{db_cluster_id}).
Inputs: db_cluster_id (required).
get_database_instanceПолучение инстанса кластераBRead-only
Возвращает информацию об инстансе базы данных в кластере (GET /api/v1/databases/{db_cluster_id}/instances/{instance_id}).
Inputs: instance_id (required), db_cluster_id (required).
get_database_presetsПолучение пресетов баз данныхARead-only
Получает список доступных пресетов конфигураций для создания баз данных
Inputs: no named parameters.
get_dedicated_serverПолучение выделенного сервераARead-only
Возвращает детальную информацию по конкретному выделенному (dedicated) серверу: статус, CPU/RAM/HDD, IP-адреса, IPMI-доступ, VNC-пароль, параметры тарифа, цена, комментарий. Используй, когда нужны подробности по одному серверу (например, IPMI-учётка для подключения).
Inputs: dedicated_id (required).
get_deploy_settingsПолучение настроек деплоя по умолчаниюBRead-only
Получает список настроек деплоя по умолчанию для различных фреймворков
Inputs: no named parameters.
get_domainПолучение информации о доменеARead-only
Возвращает подробную информацию о домене по его FQDN: статус, дата окончания, автопродление, whois privacy, поддомены.
Inputs: fqdn (required).
get_domain_name_serversName-серверы доменаARead-only
Возвращает список name-серверов домена (host + IP-адреса), статус делегирования и задачи обновления NS.
Inputs: fqdn (required).
get_domain_requestПолучение заявки на доменBRead-only
Возвращает детали заявки на регистрацию/продление/трансфер по её ID.
Inputs: request_id (required).
get_firewall_groupИнформация о группе правил firewallARead-only
Возвращает детали конкретной группы правил firewall по её ID: имя, описание, политика (ACCEPT/DROP), даты создания и обновления.
Inputs: group_id (required).
get_firewall_ruleИнформация о правиле firewallBRead-only
Возвращает детали конкретного правила firewall: направление, протокол, порт, CIDR, описание, ID группы.
Inputs: rule_id (required), group_id (required).
get_floating_ipПолучение плавающего IPBRead-only
Возвращает детальную информацию о плавающем IP по его ID
Inputs: floating_ip_id (required).
get_imageИнформация об образеBRead-only
Возвращает детальную информацию об образе по его ID: статус, прогресс создания, размеры, ОС, локацию, disk_id, флаг custom.
Inputs: image_id (required).
get_image_downloadИнформация о ссылке на скачивание образаARead-only
Возвращает детальную информацию о конкретной ссылке на скачивание образа: тип, статус, прогресс, сам URL (если статус finished).
Inputs: image_id (required), image_url_id (required).
get_k8s_clusterИнформация о Kubernetes-кластереBRead-only
Возвращает детальную информацию о Kubernetes-кластере по его ID: имя, статус, версия, драйвер, ресурсы, зона, ingress.
Inputs: cluster_id (required).
get_k8s_cluster_resourcesРесурсы Kubernetes-кластераARead-only
Возвращает агрегированные показатели ресурсов кластера: количество нод, CPU, memory, pods (requested/allocatable/capacity/used).
Inputs: cluster_id (required).
get_k8s_kubeconfigKubeconfig кластераARead-only
Возвращает содержимое файла kubeconfig для подключения kubectl к кластеру. Содержит секреты — не публиковать.
Inputs: cluster_id (required).
get_k8s_node_groupИнформация о группе нодCRead-only
Возвращает детальную информацию о группе нод кластера по её ID.
Inputs: group_id (required), cluster_id (required).
get_mailboxПолучение почтового ящикаARead-only
Возвращает подробные данные одного почтового ящика (API v2): владелец, спам-фильтр, пересылки, автоответчик, webmail.
Inputs: domain (required), mailbox (required).
get_mailbox_v1Получение почтового ящика (API v1)ARead-only
Возвращает данные одного почтового ящика в формате API v1 со структурированными блоками auto_reply/spam_filter/forwarding_*.
Inputs: domain (required), mailbox (required).
get_mail_domain_infoПочтовая информация о доменеBRead-only
Возвращает почтовую информацию домена: адрес-сборщик для писем на несуществующие ящики и объём используемого места.
Inputs: domain (required).
get_network_driveПолучение сетевого дискаARead-only
Возвращает детальную информацию о конкретном сетевом диске по его ID: имя, статус, тип, размер, зона, локация, preset, подключённые сервисы.
Inputs: network_drive_id (required).
get_projectПолучение проектаBRead-only
Возвращает детальную информацию о проекте по его ID.
Inputs: project_id (required).
get_serverПолучение сервераARead-only
Возвращает детальную информацию по конкретному VPS-серверу: статус, конфигурация CPU/RAM, ОС, IP-адреса, preset/configurator ID. Использовать когда нужны подробности по одному серверу (количество ядер для расчёта нагрузки, текущий статус перед операцией).
Inputs: server_id (required).
get_server_logsЛоги событий сервераARead-only
Возвращает лог жизненного цикла сервера: install, reboot, shutdown, reinstall и пр. Полезно для диагностики (почему сервер сейчас в off, когда последний reinstall). Это НЕ application logs и НЕ syslog — только события уровня гипервизора.
Inputs: server_id (required), order.
get_ssh_keyПолучение SSH-ключаARead-only
Возвращает детальную информацию об SSH-ключе по его ID: имя, тело ключа, дата создания, is_default и список серверов, где он используется.
Inputs: ssh_key_id (required).
get_tldПолучение доменной зоны по IDBRead-only
Возвращает подробную информацию о доменной зоне (TLD) по её ID: цены, регистратор, льготные периоды, whois privacy.
Inputs: tld_id (required).
get_vcs_provider_by_repository_urlПоиск VCS провайдера по URL репозиторияCRead-only
Находит VCS провайдер по URL репозитория
Inputs: repository_url (required).
get_vcs_provider_repositoriesПолучение списка репозиториев VCS провайдераCRead-only
Получает список репозиториев VCS провайдера по ID
Inputs: provider_id (required).
get_vcs_providersПолучение списка VCS провайдеровBRead-only
Получает список всех добавленных VCS провайдеров
Inputs: no named parameters.
get_vpcПолучение VPCARead-only
Возвращает детальную информацию о виртуальной приватной сети (VPC) по её ID
Inputs: vpc_id (required).
get_vpcsПолучение списка VPCARead-only
Получает список всех виртуальных частных сетей (VPC) пользователя
Inputs: no named parameters.
hard_reboot_serverПринудительная перезагрузка сервераADestructive
Принудительно перезагружает сервер (reset power). Использовать когда мягкий reboot_server не помогает (зависшая ОС). Данные в RAM потеряются.
Inputs: server_id (required).
hard_shutdown_serverПринудительное выключение сервераADestructive
Принудительно выключает сервер (reset power). Использовать только если мягкий shutdown_server завис или не реагирует — данные в RAM и незавершённые write-ы будут потеряны.
Inputs: server_id (required).
increase_k8s_node_group_nodesУвеличение количества нод в группеBDestructive
Добавляет указанное количество воркер-нод в группу. Опционально назначает лейблы новым нодам.
Inputs: count (required), group_id (required), cluster_id (required), labels.
install_k8s_addonУстановка дополнения в кластерBDestructive
Устанавливает дополнение (addon) в кластер. Нужны тип, версия, config_type (basic/custom) и YAML-конфигурация. Каталог доступных дополнений — list_k8s_addon_configs.
Inputs: type (required), version (required), cluster_id (required), config_type (required), +1 more.
link_firewall_resourceПривязка ресурса к группе firewallADestructive
Привязывает ресурс (сейчас только сервер) к группе правил firewall. После привязки правила группы начинают действовать на ресурс.
Inputs: group_id (required), resource_id (required), resource_type.
list_ai_agentsСписок AI-агентовARead-only
Возвращает список всех AI-агентов аккаунта: ID, название, статус, тип доступа, ID модели, использование токенов. Используй перед операциями над агентом для получения ID.
Inputs: no named parameters.
list_all_project_balancersВсе балансировщики аккаунта (по проектам)ARead-only
Список всех балансировщиков на аккаунте с привязкой к проекту (project_id). Удобно искать в каком проекте висит ресурс.
Inputs: no named parameters.
list_all_project_bucketsВсе хранилища аккаунта (по проектам)ARead-only
Список всех S3-хранилищ аккаунта с привязкой к проекту (project_id).
Inputs: no named parameters.
list_all_project_clustersВсе кластеры k8s аккаунта (по проектам)ARead-only
Список всех Kubernetes-кластеров аккаунта с привязкой к проекту.
Inputs: no named parameters.
list_all_project_databasesВсе БД аккаунта (по проектам)ARead-only
Список всех managed-БД аккаунта с привязкой к проекту (project_id).
Inputs: no named parameters.
list_all_project_dedicatedВсе выделенные серверы аккаунта (по проектам)BRead-only
Список всех dedicated-серверов аккаунта с привязкой к проекту.
Inputs: no named parameters.
list_all_project_serversВсе серверы аккаунта (по проектам)ARead-only
Список всех VPS аккаунта с привязкой к проекту (project_id). В отличие от list_servers — содержит поле project_id для каждого сервера.
Inputs: no named parameters.
list_api_keysСписок API-токеновARead-only
Возвращает список всех выпущенных API-токенов аккаунта с их ID, именами и сроком жизни
Inputs: no named parameters.
list_balancer_ipsIP-адреса балансировщикаARead-only
Получает список backend IP-адресов, привязанных к балансировщику (на эти IP распределяется трафик).
Inputs: balancer_id (required).
list_balancer_presetsТарифы балансировщиковARead-only
Возвращает список доступных тарифов (preset) для балансировщиков. Используй перед create_balancer, чтобы выбрать preset_id.
Inputs: no named parameters.
list_balancer_rulesПравила балансировщикаARead-only
Возвращает список правил балансировщика — соответствий между портом балансировщика и портом backend-сервера.
Inputs: balancer_id (required).
list_balancersСписок балансировщиковARead-only
Возвращает все балансировщики нагрузки аккаунта с ключевыми параметрами: ID, имя, статус, протокол, порт, алгоритм, IP, локация. Используй перед любыми операциями над балансировщиком, чтобы получить его ID.
Inputs: limit, offset.
list_bucketsСписок S3-хранилищARead-only
Возвращает все S3-хранилища аккаунта с id, name, type (private/public), статусом, классом (cold/hot), локацией, hostname, использованием диска. Используй перед любой операцией над хранилищем, чтобы получить его ID.
Inputs: no named parameters.
list_bucket_subdomainsСписок поддоменов S3-хранилищаARead-only
Возвращает все поддомены, привязанные к S3-хранилищу: id, subdomain, статус SSL (ssl_released, ssl_not_requested, ssl_re_release_error), когда выдан сертификат, количество попыток перевыпуска.
Inputs: bucket_id (required).
list_bucket_usersСписок пользователей S3-хранилищARead-only
Возвращает всех пользователей-администраторов S3-хранилищ аккаунта: id и access_key. secret_key может быть в ответе, но на практике его безопаснее обновлять через update_bucket_user.
Inputs: no named parameters.
list_container_registriesСписок реестров контейнеровARead-only
Возвращает список всех реестров контейнеров (Container Registry) аккаунта: ID, имя, описание, тариф, использование диска, дата создания. Используй перед операциями над реестром, чтобы получить его ID.
Inputs: no named parameters.
list_container_registry_presetsСписок тарифов реестров контейнеровARead-only
Возвращает список доступных тарифов для реестров контейнеров (Container Registry): ID, описание, размер диска, цена, локация. Используй перед create_container_registry, чтобы выбрать preset_id.
Inputs: no named parameters.
list_container_registry_repositoriesСписок репозиториев реестра контейнеровARead-only
Возвращает список репозиториев (образов) внутри конкретного реестра контейнеров: имя репозитория, тег, digest, размер. Используй чтобы посмотреть, какие образы уже загружены в реестр.
Inputs: registry_id (required).
list_database_adminsСписок пользователей кластера базы данныхCRead-only
Возвращает список пользователей (admins) кластера базы данных (GET /api/v1/databases/{db_cluster_id}/admins).
Inputs: db_cluster_id (required).
list_database_clustersСписок кластеров баз данныхARead-only
Возвращает список кластеров баз данных аккаунта (GET /api/v1/databases). Используй перед операциями над кластером, чтобы получить его ID.
Inputs: limit, offset.
list_database_instancesСписок инстансов кластераBRead-only
Возвращает список инстансов (баз данных внутри кластера) (GET /api/v1/databases/{db_cluster_id}/instances).
Inputs: db_cluster_id (required).
list_dedicated_server_additional_servicesДополнительные услуги выделенного сервераCRead-only
Возвращает список дополнительных услуг для конкретного тарифа выделенного сервера (plan_id): ID, имя, цена, период, описание. Используй, чтобы узнать plan_id для передачи в create_dedicated_server.
Inputs: preset_id (required).
list_dedicated_server_presetsСписок тарифов выделенных серверовARead-only
Возвращает список доступных тарифов (presets) для выделенных серверов: ID, описание, CPU, IPMI-поддержка, pre-installed. Опциональный фильтр по локации (ru-1/ru-2/kz-1/pl-1). Используй перед create_dedicated_server, чтобы выбрать preset_id.
Inputs: location.
list_dedicated_serversСписок выделенных серверовARead-only
Возвращает список всех выделенных (dedicated) серверов аккаунта: ID, имя, статус (installing/installed/on/off), локация, CPU/RAM/HDD описания, IPv4/IPv6, цена. Используй перед операциями над выделенным сервером, чтобы получить его ID.
Inputs: no named parameters.
list_default_dns_recordsDNS-записи домена по умолчаниюARead-only
Возвращает список DNS-записей по умолчанию для домена или поддомена (системные записи Timeweb).
Inputs: fqdn (required).
list_dns_recordsСписок DNS-записей доменаARead-only
Возвращает все пользовательские DNS-записи домена: ID, тип (A/AAAA/CNAME/MX/TXT/SRV), значение, TTL, поддомен, priority.
Inputs: fqdn (required).
list_domain_requestsСписок заявок на регистрацию/продление/трансфер доменовARead-only
Возвращает все заявки пользователя на операции с доменами: регистрация, продление, трансфер. Включает ID, FQDN, тип, статус, источник оплаты.
Inputs: no named parameters.
list_domainsСписок доменовARead-only
Возвращает одну страницу доменов: ID, FQDN, статус, дата окончания регистрации, автопродление, общее количество и следующее смещение. limit: 1–100 (по умолчанию 100), offset: от 0 (по умолчанию 0). Для продолжения используй указанный offset; список может меняться между запросами. Используй перед операцией над доменом.
Inputs: limit, offset.
list_firewall_group_resourcesСписок ресурсов группы firewallBRead-only
Возвращает список ресурсов (сейчас только серверы), привязанных к указанной группе правил firewall.
Inputs: group_id (required).
list_firewall_groupsСписок групп правил firewallARead-only
Возвращает все группы правил firewall аккаунта: ID, имя, описание, политика (ACCEPT/DROP), даты создания и обновления. Используй перед любой операцией над группой, чтобы получить её ID.
Inputs: no named parameters.
list_firewall_groups_by_resourceГруппы firewall для ресурсаARead-only
Возвращает список групп правил firewall, привязанных к конкретному ресурсу (например, серверу). Используй, чтобы узнать какие группы защищают сервер.
Inputs: resource_id (required), resource_type (required).
list_firewall_rulesСписок правил firewall в группеBRead-only
Возвращает список правил firewall в указанной группе: ID, направление (ingress/egress), протокол (tcp/udp/icmp), порт, CIDR, описание.
Inputs: group_id (required).
list_floating_ipsСписок плавающих IPBRead-only
Возвращает список всех плавающих IP пользователя с их ID, адресами, зонами и привязкой к сервисам
Inputs: no named parameters.
list_image_downloadsСписок ссылок на скачивание образаARead-only
Возвращает список всех ссылок на скачивание конкретного образа. Используется при миграции образа во внешние хранилища (Timeweb, Google Drive, Яндекс.Диск).
Inputs: image_id (required), limit, offset.
list_imagesСписок образовARead-only
Возвращает список всех образов (custom images, snapshots) аккаунта с id, name, статусом, ОС, локацией, размером. Образы — это снимки дисков/загруженные qcow2 или iso, которые можно использовать для создания серверов.
Inputs: limit, offset.
list_k8s_addon_configsКаталог дополнений кластераARead-only
Возвращает доступные для установки в кластер дополнения (аддоны): тип, версию, зависимости и базовый YAML-шаблон.
Inputs: cluster_id (required).
list_k8s_addonsУстановленные дополнения кластераARead-only
Возвращает список установленных в кластере дополнений (addons) с их ID, типом, версией и статусом.
Inputs: cluster_id (required).
list_k8s_cluster_nodesСписок всех нод кластераBRead-only
Возвращает список всех нод (мастер и воркер) в кластере с их ID, типом, группой, статусом и характеристиками.
Inputs: cluster_id (required).
list_k8s_clustersСписок Kubernetes-кластеровARead-only
Возвращает список всех Kubernetes-кластеров аккаунта с ID, именем, статусом, версией k8s, сетевым драйвером, зоной доступности и агрегированными CPU/RAM/Disk. Используй перед операциями над кластером, чтобы получить его ID.
Inputs: limit, offset.
list_k8s_network_driversСписок сетевых драйверов KubernetesARead-only
Возвращает список доступных сетевых драйверов для создания кластера (kuberouter, calico, flannel, cilium).
Inputs: no named parameters.
list_k8s_node_group_nodesСписок нод группыBRead-only
Возвращает список нод, принадлежащих конкретной группе кластера. Поддерживает пагинацию через limit/offset.
Inputs: group_id (required), cluster_id (required), limit, offset.
list_k8s_node_groupsСписок групп нод кластераBRead-only
Возвращает список всех групп нод (node groups) в кластере с ID, именем, preset_id и количеством нод.
Inputs: cluster_id (required).
list_k8s_presetsСписок тарифов KubernetesARead-only
Возвращает тарифы для мастер- и воркер-нод: ID, тип (master/worker), CPU, RAM, Disk, Network, цену. Используй перед созданием кластера или группы нод.
Inputs: no named parameters.
list_k8s_versionsСписок доступных версий KubernetesARead-only
Возвращает все доступные для создания/обновления версии Kubernetes. Используй перед create_k8s_cluster или update_k8s_cluster_version.
Inputs: no named parameters.
list_locationsСписок локацийARead-only
Возвращает список доступных локаций и зон доступности: код локации, ISO-код, список availability_zones. Нужен для выбора location/availability_zone при создании VPS.
Inputs: no named parameters.
list_mailboxesСписок всех почтовых ящиков аккаунтаARead-only
Возвращает все почтовые ящики аккаунта (API v2). Для каждого ящика: адрес, статусы спам-фильтра, webmail, пересылки, комментарий.
Inputs: no named parameters.
list_mailboxes_by_domainСписок почтовых ящиков доменаARead-only
Возвращает список почтовых ящиков указанного домена (API v1). Используй, когда нужны только ящики конкретного домена.
Inputs: domain (required).
list_mailboxes_v1Список почтовых ящиков аккаунта (API v1)ARead-only
Возвращает все почтовые ящики аккаунта в формате API v1 (с полной детализацией auto_reply/spam_filter/forwarding). Предпочитай list_mailboxes (v2), этот нужен только если требуются v1-поля.
Inputs: no named parameters.
list_network_drive_available_resourcesСписок сервисов для подключения сетевого дискаARead-only
Возвращает список сервисов (серверов), к которым можно подключить сетевой диск. Используй перед mount_network_drive, чтобы узнать допустимые resource_id.
Inputs: no named parameters.
list_network_drive_presetsСписок тарифов сетевых дисковARead-only
Возвращает список доступных тарифов (preset) для сетевых дисков с ценой за ГБ, допустимым диапазоном размеров и IOPS. Используй перед create_network_drive для выбора preset_id.
Inputs: no named parameters.
list_network_drivesСписок сетевых дисковARead-only
Возвращает список всех сетевых дисков аккаунта с ключевыми параметрами: ID, имя, статус, тип (nvme/hdd), размер, зона доступности, локация, preset_id, подключённые сервисы. Используй перед любой операцией над диском, чтобы получить его ID.
Inputs: no named parameters.
list_project_balancersБалансировщики проектаCRead-only
Список балансировщиков в указанном проекте.
Inputs: project_id (required).
list_project_bucketsХранилища проектаCRead-only
Список S3-хранилищ в указанном проекте.
Inputs: project_id (required).
list_project_clustersKubernetes-кластеры проектаBRead-only
Список k8s-кластеров в указанном проекте.
Inputs: project_id (required).
list_project_databasesБазы данных проектаCRead-only
Список managed-БД в указанном проекте.
Inputs: project_id (required).
list_project_dedicatedВыделенные серверы проектаCRead-only
Список dedicated-серверов в указанном проекте.
Inputs: project_id (required).
list_project_resourcesВсе ресурсы проектаARead-only
Возвращает сводку по всем ресурсам проекта: серверы, балансировщики, хранилища, кластеры, БД, выделенные серверы.
Inputs: project_id (required).
list_projectsСписок проектовARead-only
Возвращает список всех проектов аккаунта с id, именем, описанием и флагом по умолчанию. Используй перед работой с ресурсами проекта, чтобы получить project_id.
Inputs: no named parameters.
list_project_serversСерверы проектаBRead-only
Список VPS-серверов в указанном проекте.
Inputs: project_id (required).
list_server_configuratorsСписок конфигураторов VPSARead-only
Возвращает конфигураторы серверов с диапазонами CPU/RAM/Disk/Bandwidth/GPU и шагами изменения. Используй, если нужно создать VPS с произвольной конфигурацией (не тарифом).
Inputs: no named parameters.
list_server_disk_backupsСписок бэкапов диска сервераARead-only
Возвращает список бэкапов (manual + auto) конкретного диска VPS-сервера. Бэкапы в Timeweb Cloud — это снапшоты на уровне диска, а не всего сервера. Для получения disk_id сначала запроси список дисков сервера через API.
Inputs: disk_id (required), server_id (required).
list_server_disksСписок дисков сервераARead-only
Возвращает список дисков сервера с ID, размером, загрузкой и статусом. Используй перед операциями с бэкапами — disk_id нужен для list_server_disk_backups и create_server_disk_backup.
Inputs: server_id (required).
list_server_ipsСписок IP-адресов сервераBRead-only
Возвращает все IPv4 и IPv6 адреса, назначенные серверу, включая PTR-записи и признак основного IP.
Inputs: server_id (required).
list_server_osСписок ОС для VPSARead-only
Возвращает список операционных систем, доступных для установки на VPS-сервер: ID, семейство, имя, версия, codename, минимальные требования. Используй перед созданием VPS, чтобы выбрать os_id.
Inputs: no named parameters.
list_server_presetsСписок тарифов VPS-серверовARead-only
Возвращает все доступные тарифы (пресеты) для VPS-серверов: ID, цена, локация, CPU, RAM, диск, тип диска, пропускная способность. Используй перед созданием VPS, чтобы выбрать preset_id. Это справочник VPS-тарифов (НЕ пресеты для приложений — для них есть get_allowed_presets).
Inputs: no named parameters.
list_serversСписок серверовARead-only
Возвращает одну страницу VPS-серверов: ID, имя, статус, локация, CPU, RAM, IPv4, ОС, общее количество и следующее смещение. limit: 1–100 (по умолчанию 100), offset: от 0 (по умолчанию 0). Для продолжения используй указанный offset; список может меняться между запросами. Используй перед операцией над сервером, чтобы получить его ID.
Inputs: limit, offset.
list_server_softwareСписок ПО из маркетплейсаARead-only
Возвращает список ПО из маркетплейса, доступного для установки на VPS при создании: ID, название, совместимые os_ids, требования. Используй, чтобы выбрать software_id.
Inputs: no named parameters.
list_ssh_keysСписок SSH-ключейARead-only
Возвращает список всех SSH-ключей аккаунта: ID, имя, дата создания, флаг is_default и список серверов, на которых ключ используется. Используй перед операциями с SSH-ключами чтобы получить их ID.
Inputs: no named parameters.
list_tldsСписок доменных зон (TLD)ARead-only
Возвращает список всех доступных доменных зон с ценами регистрации и продления. Используй перед созданием заявки на регистрацию.
Inputs: no named parameters.
list_vpc_portsСписок портов VPCBRead-only
Возвращает список портов VPC с MAC-адресами, IPv4 и сервисами
Inputs: vpc_id (required).
list_vpc_servicesСервисы в VPCBRead-only
Возвращает список сервисов (server / balancer / dbaas), привязанных к VPC
Inputs: vpc_id (required).
mount_network_driveПодключение сетевого диска к сервисуADestructive
Подключает сетевой диск к сервису (серверу). Сервис и диск должны быть в одной зоне доступности. Доступные для подключения сервисы можно получить через list_network_drive_available_resources.
Inputs: resource_id (required), resource_type (required), network_drive_id (required).
reboot_serverПерезагрузка сервераADestructive
Мягко перезагружает сервер через ACPI reboot. ОС корректно завершает процессы перед рестартом. Используй для применения обновлений ядра или сброса подвисшего состояния.
Inputs: server_id (required).
reduce_k8s_node_group_nodesУменьшение количества нод в группеBDestructive
Удаляет указанное количество воркер-нод из группы. Действие необратимо — удалённые ноды нельзя восстановить.
Inputs: count (required), group_id (required), cluster_id (required).
refresh_api_keyПеревыпуск API-токенаBDestructive
Перевыпускает существующий API-токен. Возвращает новое значение токена (один раз)
Inputs: token_id (required), expire.
remove_balancer_ipsУдаление IP у балансировщикаBDestructive
Удаляет backend IP-адреса у балансировщика (снимает их из распределения трафика).
Inputs: ips (required), balancer_id (required).
remove_ssh_key_from_serverСнятие SSH-ключа с сервераADestructive
Удаляет конкретный SSH-ключ с сервера. Сам ключ в аккаунте остаётся — удаляется только привязка к серверу. Для полного удаления ключа используй delete_ssh_key.
Inputs: server_id (required), ssh_key_id (required).
reset_server_passwordСброс пароля root сервераADestructive
Инициирует сброс root-пароля сервера. Новый пароль отправляется на email владельца аккаунта.
Inputs: server_id (required).
resize_serverИзменение конфигурации сервераADestructive
Меняет тариф (preset_id) или кастомную конфигурацию (configurator_id + cpu/ram/disk/gpu). Применяется к существующему серверу — потребуется downtime. Для получения списка presets используй get_allowed_presets.
Inputs: server_id (required), cpu, gpu, ram, +3 more.
set_server_boot_modeУстановка типа загрузки ОС сервераADestructive
Меняет boot_mode сервера: default (штатный), single (однопользовательский — для восстановления root), recovery_disk (загрузка с диска восстановления). Сервер перезагружается.
Inputs: boot_mode (required), server_id (required).
set_server_nat_modeУстановка NAT-режима сервера в локальной сетиCDestructive
Меняет правила маршрутизации трафика: dnat_and_snat (полный доступ), snat (только исходящий), no_nat (изоляция в локальной сети).
Inputs: nat_mode (required), server_id (required).
shutdown_serverВыключение сервераADestructive
Мягко выключает сервер через ACPI shutdown (аналог нажатия кнопки питания). ОС корректно завершает процессы. Для принудительного выключения используй hard-shutdown через /action API (не покрыто этим tool-ом).
Inputs: server_id (required).
start_serverЗапуск сервераBDestructive
Запускает выключенный VPS. Идемпотентен: на уже работающем сервере вернёт ошибку. Проверь статус через get_server перед вызовом.
Inputs: server_id (required).
transfer_bucketПеренос S3-хранилища от стороннего провайдераADestructive
Запускает перенос S3-хранилища от стороннего провайдера (указывается endpoint, access_key, secret_key, имя bucket) в Timeweb Cloud под именем new_bucket_name. Мониторь прогресс через get_bucket_transfer_status.
Inputs: endpoint (required), location (required), access_key (required), secret_key (required), +3 more.
transfer_project_resourceПеренос ресурса в другой проектCDestructive
Переносит сервер/БД/балансировщик/хранилище/кластер/dedicated из одного проекта в другой. resource_type обязателен.
Inputs: resource_id (required), resource_type (required), to_project_id (required), from_project_id (required).
unbind_floating_ipОтвязка плавающего IP от сервисаCDestructive
Отвязывает плавающий IP от текущего сервиса
Inputs: floating_ip_id (required).
uninstall_k8s_addonУдаление дополнения из кластераADestructive
Удаляет установленное ранее дополнение из кластера. Действие необратимо.
Inputs: addon_id (required), cluster_id (required).
unlink_firewall_resourceОтвязка ресурса от группы firewallADestructive
Отвязывает ресурс от группы правил firewall. После отвязки правила группы перестают действовать на этот ресурс.
Inputs: group_id (required), resource_id (required), resource_type.
unmount_network_driveОтключение сетевого диска от сервисаADestructive
Отключает сетевой диск от сервиса (сервера), к которому он был подключён. Перед удалением диска его нужно отключить.
Inputs: network_drive_id (required).
unmount_server_imageОтмонтирование ISO-образа сервераADestructive
Отмонтирует примонтированный ISO-образ и перезагружает сервер в штатном режиме.
Inputs: server_id (required).
update_ai_agentОбновление AI-агентаADestructive
Обновляет параметры AI-агента: имя, описание, статус, access_type, пакет токенов, system prompt и настройки модели. Передавай только поля, которые нужно изменить.
Inputs: agent_id (required), name, top_p, status, +10 more.
update_balancerОбновление балансировщикаADestructive
Обновляет параметры существующего балансировщика. Все поля кроме balancer_id — опциональные; передавай только то, что меняется.
Inputs: balancer_id (required), algo, fall, name, +20 more.
update_balancer_ruleОбновление правила балансировщикаADestructive
Обновляет правило маршрутизации балансировщика. Все поля (кроме id) обязательны — API ожидает полное описание правила.
Inputs: rule_id (required), balancer_id (required), server_port (required), server_proto (required), +2 more.
update_bucketИзменение S3-хранилищаBDestructive
Изменяет параметры S3-хранилища: preset_id ИЛИ configurator (disk, configurator_id), bucket_type (private/public), описание. Нельзя передавать одновременно preset_id и configurator.
Inputs: bucket_id (required), preset_id, bucket_type, description, +2 more.
update_bucket_userИзменение пароля пользователя S3-хранилищаADestructive
Меняет secret_key пользователя-администратора S3-хранилища. После смены пароля нужно обновить конфигурацию всех клиентов, подключающихся к хранилищу.
Inputs: user_id (required), secret_key (required).
update_container_registryОбновление реестра контейнеровADestructive
Изменяет параметры реестра контейнеров: описание, тариф (preset_id) или кастомную конфигурацию (configurator_id + disk). Имя реестра изменить нельзя.
Inputs: registry_id (required), disk, preset_id, description, +1 more.
update_database_adminИзменение пользователя кластераBDestructive
Изменяет параметры пользователя кластера: пароль, привилегии, описание (PATCH /api/v1/databases/{db_cluster_id}/admins/{admin_id}).
Inputs: admin_id (required), db_cluster_id (required), password, privileges, +2 more.
update_database_clusterИзменение кластера базы данныхBDestructive
Изменяет параметры кластера базы данных: название, тариф, описание, публичную сеть (PATCH /api/v1/databases/{db_cluster_id}).
Inputs: db_cluster_id (required), name, preset_id, description, +1 more.
update_database_instanceИзменение инстанса кластераCDestructive
Изменяет параметры инстанса базы данных в кластере (PATCH /api/v1/databases/{db_cluster_id}/instances/{instance_id}).
Inputs: instance_id (required), db_cluster_id (required), name, description.
update_dedicated_serverОбновление выделенного сервераADestructive
Изменяет параметры выделенного сервера: имя и/или комментарий. Оба поля опциональны, но хотя бы одно должно быть передано.
Inputs: dedicated_id (required), name, comment.
update_dns_recordОбновление DNS-записиCDestructive
Обновляет существующую DNS-запись по ID. Использует API v2. Нужно передать тип записи и новые поля.
Inputs: fqdn (required), type (required), record_id (required), ttl, +8 more.
update_domainОбновление параметров доменаBDestructive
Включает/выключает автопродление домена и/или меняет привязанный IP-адрес. FQDN обязателен.
Inputs: fqdn (required), linked_ip, is_autoprolong_enabled.
update_domain_name_serversОбновление name-серверов доменаADestructive
Заменяет список name-серверов у домена. Принимает массив объектов {host, ips?}.
Inputs: fqdn (required), name_servers (required).
update_domain_requestОплата/обновление заявки на доменADestructive
Обновляет заявку на регистрацию/продление/трансфер, указывая источник оплаты: use (с баланса), invoice (платёжка), free (бесплатный трансфер), bonus.
Inputs: request_id (required), money_source (required), bonus_id, payer_id, +3 more.
update_firewall_groupОбновление группы правил firewallBDestructive
Обновляет имя и/или описание группы правил firewall. Политика группы через этот эндпоинт не меняется.
Inputs: name (required), group_id (required), description.
update_firewall_ruleОбновление правила firewallBDestructive
Полностью обновляет правило firewall. Передаются direction, protocol (обязательно) и опциональные port, cidr, description — эти поля перезаписывают текущие значения правила.
Inputs: rule_id (required), group_id (required), protocol (required), direction (required), +3 more.
update_floating_ipИзменение плавающего IPCDestructive
Изменяет комментарий и/или PTR-запись плавающего IP по его ID
Inputs: floating_ip_id (required), ptr, comment.
update_imageОбновление образаADestructive
Обновляет имя и/или описание образа. Другие атрибуты (ОС, локация, disk_id) изменить нельзя.
Inputs: image_id (required), name, description.
update_k8s_addonИзменение конфигурации дополненияBDestructive
Изменяет конфигурацию или версию ранее установленного дополнения. Нужны type, config_type, yaml_config, version.
Inputs: type (required), version (required), addon_id (required), cluster_id (required), +2 more.
update_k8s_cluster_versionОбновление версии Kubernetes-кластераADestructive
Обновляет версию Kubernetes в кластере. Версию можно не передавать — тогда будет выбрана следующая доступная.
Inputs: cluster_id (required), k8s_version.
update_mailboxИзменение почтового ящикаADestructive
Обновляет почтовый ящик (API v2): пароль, комментарий, ФИО, спам-фильтр, автоответчик, пересылки. Передавай только изменяемые поля. Сложные блоки (spam/forward/autoreply/outgoing) принимают объект с is_enabled и дополнительными полями при включении.
Inputs: domain (required), mailbox (required), comment, password, +5 more.
update_mailbox_v1Изменение почтового ящика (API v1)ADestructive
Обновляет почтовый ящик через API v1. Предпочитай update_mailbox (v2). Использует структурированные блоки auto_reply/spam_filter/forwarding_incoming/forwarding_outgoing.
Inputs: domain (required), mailbox (required), comment, password, +4 more.
update_mail_domain_infoИзменение почтовой информации о доменеBDestructive
Меняет адрес-сборщик для писем, приходящих на несуществующие ящики домена.
Inputs: email (required), domain (required).
update_network_driveИзменение сетевого дискаADestructive
Изменяет параметры сетевого диска (name, comment, size). Размер можно только увеличивать. Нужно указать хотя бы одно из полей.
Inputs: network_drive_id (required), name, size, comment.
update_projectИзменение проектаADestructive
Обновляет имя, описание или аватар существующего проекта. Минимум одно поле.
Inputs: project_id (required), name, avatar_id, description.
update_serverИзменение метаданных сервераADestructive
Обновляет имя, комментарий, avatar_id или cloud_init у сервера. Для ресайза (preset/configurator) используй resize_server.
Inputs: server_id (required), name, comment, avatar_id, +1 more.
update_server_ipИзменение PTR-записи IP-адресаBDestructive
Меняет PTR-запись (обратное DNS) для конкретного IP-адреса сервера.
Inputs: ip (required), ptr (required), server_id (required).
update_ssh_keyИзменение SSH-ключаADestructive
Изменяет параметры SSH-ключа по ID. Можно обновить имя, тело ключа и/или флаг is_default. Передавай только те поля, которые нужно изменить.
Inputs: ssh_key_id (required), body, name, is_default.
update_vpcИзменение VPCADestructive
Изменяет имя и/или описание VPC по её ID
Inputs: vpc_id (required), name, description.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 245 tools
Many tools overlap heavily: list_servers vs list_all_project_servers vs list_project_servers (and the same pattern for balancers, buckets, clusters, databases, dedicated servers) are near-duplicates. The v1/v2 mailbox tools (create_mailbox vs create_mailbox_v1, list_mailboxes vs list_mailboxes_v1, etc.) add another layer of confusion, forcing an agent to pick among functionally similar tools.
Most tools follow snake_case verb_noun, but collection retrieval mixes get_ and list_ (e.g., get_vpcs, get_vcs_providers, get_domain_name_servers vs list_* tools). The verbs edit_ and update_ are used interchangeably (edit_api_key, edit_k8s_cluster vs update_* tools), and _v1 suffixes deviate from the clean naming pattern.
245 tools is far beyond a reasonable MCP server scope. Even for a broad cloud platform, this volume makes tool selection prohibitive and suggests many tools could be consolidated or grouped into fewer, more generic operations.
The surface covers an extensive cloud lifecycle: VPS, Kubernetes, databases, S3, domains/DNS, mail, firewall, balancers, network drives, container registries, projects, AI agents, SSH keys, finances, VPC, and floating IPs. Almost every resource has create/get/list/update/delete plus relevant actions, leaving few obvious gaps for the stated domain.
Maintenance
Related MCP Connectors
Deploy, monitor, and manage your OpenClaw AI assistants via natural language.
Deploy and run your apps by asking your AI: services, Postgres, logs, traces, rollbacks, costs.
Deploy and operate apps with AI agents · Деплой и поддержка приложений через AI
Deploy and manage your apps, databases, storage, and scheduled jobs from your AI agent
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI assistants to deploy and manage applications, databases, object storage, VMs, DNS, and infrastructure on the Liara cloud platform through natural language commands.10061 npm7MIT

PlugLayer MCP Serverofficial
AlicenseCqualityBmaintenanceEnables deploying and managing infrastructure via natural language, including project/domain management, compute nodes, image deployment, and CI/CD integration.70MIT
hostman-mcp-serverofficial
AlicenseAqualityDmaintenanceEnables deploying applications to Hostman, creating VPCs, databases, and floating IPs, and managing VCS providers through natural language prompts.1214 npmMIT- AlicenseBqualityDmaintenanceEnables management of Timeweb Cloud resources including servers, databases, Kubernetes clusters, S3 storage, DNS, SSH keys, and floating IPs through natural language.9711 npmMIT