Skip to main content
Glama
timeweb-mcp-server

timeweb-mcp-server

by ichinya

Timeweb Cloud MCP Server

MCP-сервер для управления инфраструктурой Timeweb Cloud из Cursor, VS Code и других клиентов, поддерживающих Model Context Protocol.

Сервер работает через stdio, принимает вызовы MCP-инструментов и выполняет соответствующие запросы к API Timeweb Cloud.

WARNING

Проект находится в активной экспериментальной разработке и развивается независимо от 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.

NOTE

Официальная 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 start

MCP 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 до их выполнения.

Команда

Назначение

Совместимость

npm run type-check

Проверка TypeScript без генерации файлов

Windows, macOS, Linux

npm run build

Сборка проекта

Windows, macOS, Linux

npm run test:release

Проверка логики определения новой версии и релизного тега

Windows, macOS, Linux

npm run test:openapi

Тесты нормализации OpenAPI, provenance и анализатора маршрутов

Windows, macOS, Linux

npm run test:smoke-start

Сценарии готовности, timeout, вывода и завершения smoke-процесса

Windows, macOS, Linux

npm run test:transport

Проверка типов и offline-тесты ошибок API, отмены и потерянного ответа

Windows, macOS, Linux

npm run smoke

Проверка запуска собранного MCP-сервера и чистоты stdout

Windows, macOS, Linux

npm run smoke:startup-series

Шесть запусков сервера с измерениями первого и последующих стартов

Windows, macOS, Linux

npm run verify

OpenAPI/маршруты, все тесты, TypeScript, сборка и оба smoke-теста

Windows, macOS, Linux

npm run start

Запуск dist/index.js с загрузкой .env

Windows, macOS, Linux

npm run inspect

Запуск MCP Inspector

Windows, macOS, Linux

npm run clean

Удаление dist

Windows, macOS, Linux

npm run normalize:openapi

Нормализация конфликтующих имён схем

Windows, macOS, Linux

npm run validate:openapi

Проверка локальной 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 в репозитории не используется.

  1. Обновите версию одновременно в package.json и package-lock.json:

    npm version patch --no-git-tag-version

    Вместо patch можно использовать minor, major или указать точную версию.

  2. Закоммитьте и отправьте изменения в main.

  3. Workflow .github/workflows/publish.yml сравнит новую версию с версией предыдущего коммита.

  4. Если версия увеличилась, 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:openapi

macOS или 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:

Официальное имя

Локальное имя

meta

CollectionMeta

Meta

RequiredCollectionMeta

location

ServiceLocation

Location

ImageLocation

autoreply-is-enabled

MailV2AutoReplyEnabled

autoreply-is-disabled

MailV2AutoReplyDisabled

auto-reply-is-enabled

MailV1AutoReplyEnabled

auto-reply-is-disabled

MailV1AutoReplyDisabled

Это устраняет коллизии имён файлов и 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.json

API-клиенты в 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.

Ссылки

Лицензия

Проект распространяется по лицензии MIT. Copyright (c) 2026 ichinya.

Available Tools

245 tools
add_balancer_ipsДобавление IP к балансировщикуB
Destructive

Добавляет backend IP-адреса к балансировщику. На эти IP будет распределяться входящий трафик.

Inputs: ips (required), balancer_id (required).

add_balancer_to_projectДобавление балансировщика в проектA
Destructive

Привязывает существующий балансировщик к проекту. Для переноса между проектами используй transfer_project_resource.

Inputs: project_id (required), resource_id (required).

add_bucket_subdomain_certificateВыпуск SSL-сертификата для поддомена S3-хранилищаA
Destructive

Выпускает 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Добавление хранилища в проектC
Destructive

Привязывает существующее S3-хранилище к проекту.

Inputs: project_id (required), resource_id (required).

add_cluster_to_projectДобавление кластера в проектC
Destructive

Привязывает существующий Kubernetes-кластер к проекту.

Inputs: project_id (required), resource_id (required).

add_database_to_projectДобавление БД в проектC
Destructive

Привязывает существующую managed-БД к проекту.

Inputs: project_id (required), resource_id (required).

add_dedicated_to_projectДобавление выделенного сервера в проектC
Destructive

Привязывает существующий выделенный сервер к проекту.

Inputs: project_id (required), resource_id (required).

add_domainДобавление домена на аккаунтA

Добавляет уже зарегистрированный в другом месте домен на аккаунт Timeweb Cloud для управления DNS и name-серверами. Не выполняет регистрацию — для регистрации используй create_domain_request.

Inputs: fqdn (required).

add_server_ipДобавление IP-адреса сервераA
Destructive

Выделяет новый IPv4 или IPv6 адрес для сервера. Опционально можно задать PTR-запись.

Inputs: type (required), server_id (required), ptr.

add_server_to_projectДобавление сервера в проектA
Destructive

Привязывает существующий 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 к сервисуB
Destructive

Привязывает плавающий IP к сервису (server / balancer / database / network) по ID ресурса

Inputs: resource_id (required), resource_type (required), floating_ip_id (required).

check_domainПроверка доступности домена для регистрацииA
Read-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Создание заявки на домен (регистрация/продление/трансфер)B
Destructive

Создаёт заявку на операцию с доменом: регистрация (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-агентаA
Destructive

Удаляет AI-агента по ID. ⚠️ Операция необратима — подтверждай с пользователем.

Inputs: agent_id (required).

delete_api_keyУдаление API-токенаC
Destructive

Удаляет API-токен по его ID

Inputs: token_id (required).

delete_balancerУдаление балансировщикаA
Destructive

Удаляет балансировщик. Действие необратимо. Для аккаунтов с 2FA — первый вызов вернёт hash, повторный вызов с hash и code завершит удаление.

Inputs: balancer_id (required), code, hash.

delete_balancer_ruleУдаление правила балансировщикаB
Destructive

Удаляет правило маршрутизации у балансировщика. Действие необратимо.

Inputs: rule_id (required), balancer_id (required).

delete_bucketУдаление S3-хранилищаA
Destructive

Удаляет S3-хранилище. Действие необратимо. Для аккаунтов с 2FA: первый вызов возвращает hash, второй вызов нужен с hash и code. Все данные в хранилище будут потеряны.

Inputs: bucket_id (required), code, hash.

delete_bucket_subdomainsУдаление поддоменов S3-хранилищаB
Destructive

Удаляет один или несколько поддоменов из S3-хранилища. Возвращает статус удаления по каждому поддомену.

Inputs: bucket_id (required), subdomains (required).

delete_container_registryУдаление реестра контейнеровA
Destructive

Удаляет реестр контейнеров безвозвратно. ⚠️ Все образы в реестре будут потеряны. Перед удалением убедись, что реестр не используется.

Inputs: registry_id (required).

delete_database_adminУдаление пользователя кластераA
Destructive

Удаляет пользователя кластера базы данных (DELETE /api/v1/databases/{db_cluster_id}/admins/{admin_id}). Действие необратимо.

Inputs: admin_id (required), db_cluster_id (required).

delete_database_clusterУдаление кластера базы данныхA
Destructive

Удаляет кластер баз данных (DELETE /api/v1/databases/{db_cluster_id}). Для аккаунтов с 2FA в ответе вернётся hash — повторите запрос с ним и с code из аутентификатора.

Inputs: db_cluster_id (required), code, hash.

delete_dedicated_serverУдаление выделенного сервераA
Destructive

Удаляет выделенный (dedicated) сервер. ⚠️ Все данные на сервере будут потеряны безвозвратно. Подтверди операцию с пользователем перед вызовом.

Inputs: dedicated_id (required).

delete_dns_recordУдаление DNS-записиC
Destructive

Удаляет DNS-запись по ID для указанного домена. Использует API v2.

Inputs: fqdn (required), record_id (required).

delete_domainУдаление доменаB
Destructive

Удаляет домен с аккаунта по FQDN. Операция необратима — отвязывает домен от аккаунта Timeweb Cloud.

Inputs: fqdn (required).

delete_firewall_groupУдаление группы правил firewallA
Destructive

Удаляет группу правил firewall. Действие необратимо. Перед удалением рекомендуется отлинковать все связанные ресурсы через unlink_firewall_resource.

Inputs: group_id (required).

delete_firewall_ruleУдаление правила firewallB
Destructive

Удаляет правило из группы firewall. Действие необратимо.

Inputs: rule_id (required), group_id (required).

delete_floating_ipУдаление плавающего IPC
Destructive

Удаляет плавающий IP по его ID

Inputs: floating_ip_id (required).

delete_imageУдаление образаA
Destructive

⚠️ НЕОБРАТИМО: Удаляет образ по его ID. После удаления восстановить нельзя. Серверы, уже созданные из образа, продолжают работать — удаление влияет только на возможность создания новых серверов из этого образа.

Inputs: image_id (required).

delete_image_downloadУдаление ссылки на скачивание образаA
Destructive

Удаляет ссылку на скачивание образа. Используй для отмены процесса копирования образа во внешнее хранилище.

Inputs: image_id (required), image_url_id (required).

delete_k8s_clusterУдаление Kubernetes-кластераA
Destructive

Удаляет Kubernetes-кластер. Действие необратимо. Для аккаунтов с 2FA: первый вызов возвращает hash, затем повторный вызов с hash и code подтверждает удаление.

Inputs: cluster_id (required), code, hash.

delete_k8s_cluster_nodeУдаление ноды кластераB
Destructive

Удаляет конкретную ноду из кластера. Действие необратимо.

Inputs: node_id (required), cluster_id (required).

delete_k8s_node_groupУдаление группы нодA
Destructive

Удаляет группу нод из кластера. Все ноды группы будут удалены.

Inputs: group_id (required), cluster_id (required).

delete_mailboxУдаление почтового ящикаB
Destructive

Безвозвратно удаляет почтовый ящик. Операция необратима — вся почта будет потеряна.

Inputs: domain (required), mailbox (required).

delete_network_driveУдаление сетевого дискаA
Destructive

Удаляет сетевой диск по ID. Действие необратимо, данные будут потеряны. Перед удалением диск должен быть отключён от всех сервисов (unmount_network_drive).

Inputs: network_drive_id (required).

delete_projectУдаление проектаA
Destructive

Удаляет проект. Проект по умолчанию удалить нельзя. Ресурсы останутся на аккаунте — проверь и перенеси их заранее через transfer_project_resource.

Inputs: project_id (required).

delete_serverУдаление сервераA
Destructive

Удаляет сервер. Для аккаунтов с 2FA первый вызов возвращает hash — повторный вызов с hash и code завершит удаление. Удалённый сервер может быть перемещён в карантин.

Inputs: server_id (required), code, hash.

delete_server_disk_backupУдаление бэкапа дискаA
Destructive

Удаляет бэкап диска сервера. Действие необратимо. Перед удалением стоит убедиться через list_server_disk_backups что это не последний актуальный бэкап.

Inputs: disk_id (required), backup_id (required), server_id (required).

delete_server_ipУдаление IP-адреса сервераB
Destructive

Удаляет конкретный IP-адрес (IPv4 или IPv6) с сервера. Основной IP удалить нельзя.

Inputs: ip (required), server_id (required).

delete_ssh_keyУдаление SSH-ключаA
Destructive

Удаляет SSH-ключ из аккаунта по ID. Действие необратимо. Перед удалением проверь через list_ssh_keys, что ключ не используется на критичных серверах (поле used_by).

Inputs: ssh_key_id (required).

delete_subdomainУдаление поддоменаB
Destructive

Удаляет поддомен по его FQDN из указанного основного домена.

Inputs: fqdn (required), subdomain_fqdn (required).

delete_vpcУдаление VPCC
Destructive

Удаляет виртуальную приватную сеть (VPC) по её ID

Inputs: vpc_id (required).

edit_api_keyИзменение API-токенаA
Destructive

Изменяет имя и/или флаг is_able_to_delete API-токена по его ID

Inputs: token_id (required), name, is_able_to_delete.

edit_k8s_clusterРедактирование Kubernetes-кластераA
Destructive

Редактирует имя, описание или OIDC-провайдера кластера. Другие параметры (версия, ноды) изменяются отдельными инструментами.

Inputs: cluster_id (required), name, description, oidc_provider.

get_account_financesФинансы аккаунтаA
Read-only

Возвращает баланс, абонентскую плату, стоимость услуг, скидку и данные автоплатежа. Используй для ответа на вопросы 'сколько денег осталось', 'сколько тратим в месяц', 'когда кончатся деньги' (hours_left).

Inputs: no named parameters.

get_account_services_costСтоимость сервисов аккаунтаA
Read-only

Возвращает детализацию расходов по всем сервисам (VPS, БД, S3, DNS и пр.). Полезно для ответа 'куда уходят деньги' и поиска самых дорогих ресурсов. Для общего баланса используй get_account_finances.

Inputs: no named parameters.

get_account_statusСтатус аккаунтаA
Read-only

Возвращает статус блокировки аккаунта и настройки уведомлений. Используй для диагностики 'почему API не отвечает' (возможна блокировка при недостатке средств).

Inputs: no named parameters.

get_ai_agentПолучение AI-агентаA
Read-only

Возвращает детальную информацию об AI-агенте по ID: название, статус, доступ, модель, пакет токенов, system prompt, остаток токенов.

Inputs: agent_id (required).

get_ai_agent_statisticСтатистика использования токенов AI-агентаB
Read-only

Возвращает статистику использования токенов агента по временным интервалам. Параметры start_time/end_time в ISO 8601, interval в минутах (60 по умолчанию).

Inputs: agent_id (required), end_time, interval, start_time.

get_allowed_presetsПолучение доступных пресетов для создания приложенияB
Read-only

Получает список доступных пресетов для создания приложения

Inputs: no named parameters.

get_balancerПолучение балансировщикаA
Read-only

Возвращает детальную информацию о балансировщике по ID: статус, протокол, порт, алгоритм, таймауты, сертификаты, правила, IP-адреса.

Inputs: balancer_id (required).

get_bucketПолучение S3-хранилищаA
Read-only

Возвращает детальную информацию об одном S3-хранилище по его ID: название, тип, статус, класс, локация, hostname, ключи доступа, использование диска, настройки веб-сайта.

Inputs: bucket_id (required).

get_bucket_presetsТарифы S3-хранилищA
Read-only

Возвращает список доступных тарифов для S3-хранилищ с id, размером диска, ценой, классом (cold/hot), локацией. Используй перед create_bucket, чтобы получить preset_id.

Inputs: no named parameters.

get_bucket_transfer_statusСтатус переноса S3-хранилищаA
Read-only

Возвращает статус переноса хранилища от стороннего S3-провайдера в Timeweb Cloud: started/suspended/failed, количество и размер объектов, перенесено, попытки, ошибки. Используй после transfer_bucket.

Inputs: bucket_id (required).

get_container_registryПолучение информации о реестре контейнеровA
Read-only

Возвращает детальную информацию о конкретном реестре контейнеров по ID: имя, описание, тариф, использование диска, дата создания и обновления.

Inputs: registry_id (required).

get_database_adminПолучение пользователя кластераC
Read-only

Возвращает информацию о пользователе кластера базы данных (GET /api/v1/databases/{db_cluster_id}/admins/{admin_id}).

Inputs: admin_id (required), db_cluster_id (required).

get_database_clusterПолучение кластера базы данныхB
Read-only

Возвращает детальную информацию о конкретном кластере баз данных по его ID (GET /api/v1/databases/{db_cluster_id}).

Inputs: db_cluster_id (required).

get_database_instanceПолучение инстанса кластераB
Read-only

Возвращает информацию об инстансе базы данных в кластере (GET /api/v1/databases/{db_cluster_id}/instances/{instance_id}).

Inputs: instance_id (required), db_cluster_id (required).

get_database_presetsПолучение пресетов баз данныхA
Read-only

Получает список доступных пресетов конфигураций для создания баз данных

Inputs: no named parameters.

get_dedicated_serverПолучение выделенного сервераA
Read-only

Возвращает детальную информацию по конкретному выделенному (dedicated) серверу: статус, CPU/RAM/HDD, IP-адреса, IPMI-доступ, VNC-пароль, параметры тарифа, цена, комментарий. Используй, когда нужны подробности по одному серверу (например, IPMI-учётка для подключения).

Inputs: dedicated_id (required).

get_deploy_settingsПолучение настроек деплоя по умолчаниюB
Read-only

Получает список настроек деплоя по умолчанию для различных фреймворков

Inputs: no named parameters.

get_domainПолучение информации о доменеA
Read-only

Возвращает подробную информацию о домене по его FQDN: статус, дата окончания, автопродление, whois privacy, поддомены.

Inputs: fqdn (required).

get_domain_name_serversName-серверы доменаA
Read-only

Возвращает список name-серверов домена (host + IP-адреса), статус делегирования и задачи обновления NS.

Inputs: fqdn (required).

get_domain_requestПолучение заявки на доменB
Read-only

Возвращает детали заявки на регистрацию/продление/трансфер по её ID.

Inputs: request_id (required).

get_firewall_groupИнформация о группе правил firewallA
Read-only

Возвращает детали конкретной группы правил firewall по её ID: имя, описание, политика (ACCEPT/DROP), даты создания и обновления.

Inputs: group_id (required).

get_firewall_ruleИнформация о правиле firewallB
Read-only

Возвращает детали конкретного правила firewall: направление, протокол, порт, CIDR, описание, ID группы.

Inputs: rule_id (required), group_id (required).

get_floating_ipПолучение плавающего IPB
Read-only

Возвращает детальную информацию о плавающем IP по его ID

Inputs: floating_ip_id (required).

get_imageИнформация об образеB
Read-only

Возвращает детальную информацию об образе по его ID: статус, прогресс создания, размеры, ОС, локацию, disk_id, флаг custom.

Inputs: image_id (required).

get_image_downloadИнформация о ссылке на скачивание образаA
Read-only

Возвращает детальную информацию о конкретной ссылке на скачивание образа: тип, статус, прогресс, сам URL (если статус finished).

Inputs: image_id (required), image_url_id (required).

get_k8s_clusterИнформация о Kubernetes-кластереB
Read-only

Возвращает детальную информацию о Kubernetes-кластере по его ID: имя, статус, версия, драйвер, ресурсы, зона, ingress.

Inputs: cluster_id (required).

get_k8s_cluster_resourcesРесурсы Kubernetes-кластераA
Read-only

Возвращает агрегированные показатели ресурсов кластера: количество нод, CPU, memory, pods (requested/allocatable/capacity/used).

Inputs: cluster_id (required).

get_k8s_kubeconfigKubeconfig кластераA
Read-only

Возвращает содержимое файла kubeconfig для подключения kubectl к кластеру. Содержит секреты — не публиковать.

Inputs: cluster_id (required).

get_k8s_node_groupИнформация о группе нодC
Read-only

Возвращает детальную информацию о группе нод кластера по её ID.

Inputs: group_id (required), cluster_id (required).

get_mailboxПолучение почтового ящикаA
Read-only

Возвращает подробные данные одного почтового ящика (API v2): владелец, спам-фильтр, пересылки, автоответчик, webmail.

Inputs: domain (required), mailbox (required).

get_mailbox_v1Получение почтового ящика (API v1)A
Read-only

Возвращает данные одного почтового ящика в формате API v1 со структурированными блоками auto_reply/spam_filter/forwarding_*.

Inputs: domain (required), mailbox (required).

get_mail_domain_infoПочтовая информация о доменеB
Read-only

Возвращает почтовую информацию домена: адрес-сборщик для писем на несуществующие ящики и объём используемого места.

Inputs: domain (required).

get_network_driveПолучение сетевого дискаA
Read-only

Возвращает детальную информацию о конкретном сетевом диске по его ID: имя, статус, тип, размер, зона, локация, preset, подключённые сервисы.

Inputs: network_drive_id (required).

get_projectПолучение проектаB
Read-only

Возвращает детальную информацию о проекте по его ID.

Inputs: project_id (required).

get_serverПолучение сервераA
Read-only

Возвращает детальную информацию по конкретному VPS-серверу: статус, конфигурация CPU/RAM, ОС, IP-адреса, preset/configurator ID. Использовать когда нужны подробности по одному серверу (количество ядер для расчёта нагрузки, текущий статус перед операцией).

Inputs: server_id (required).

get_server_logsЛоги событий сервераA
Read-only

Возвращает лог жизненного цикла сервера: install, reboot, shutdown, reinstall и пр. Полезно для диагностики (почему сервер сейчас в off, когда последний reinstall). Это НЕ application logs и НЕ syslog — только события уровня гипервизора.

Inputs: server_id (required), order.

get_ssh_keyПолучение SSH-ключаA
Read-only

Возвращает детальную информацию об SSH-ключе по его ID: имя, тело ключа, дата создания, is_default и список серверов, где он используется.

Inputs: ssh_key_id (required).

get_tldПолучение доменной зоны по IDB
Read-only

Возвращает подробную информацию о доменной зоне (TLD) по её ID: цены, регистратор, льготные периоды, whois privacy.

Inputs: tld_id (required).

get_vcs_provider_by_repository_urlПоиск VCS провайдера по URL репозиторияC
Read-only

Находит VCS провайдер по URL репозитория

Inputs: repository_url (required).

get_vcs_provider_repositoriesПолучение списка репозиториев VCS провайдераC
Read-only

Получает список репозиториев VCS провайдера по ID

Inputs: provider_id (required).

get_vcs_providersПолучение списка VCS провайдеровB
Read-only

Получает список всех добавленных VCS провайдеров

Inputs: no named parameters.

get_vpcПолучение VPCA
Read-only

Возвращает детальную информацию о виртуальной приватной сети (VPC) по её ID

Inputs: vpc_id (required).

get_vpcsПолучение списка VPCA
Read-only

Получает список всех виртуальных частных сетей (VPC) пользователя

Inputs: no named parameters.

hard_reboot_serverПринудительная перезагрузка сервераA
Destructive

Принудительно перезагружает сервер (reset power). Использовать когда мягкий reboot_server не помогает (зависшая ОС). Данные в RAM потеряются.

Inputs: server_id (required).

hard_shutdown_serverПринудительное выключение сервераA
Destructive

Принудительно выключает сервер (reset power). Использовать только если мягкий shutdown_server завис или не реагирует — данные в RAM и незавершённые write-ы будут потеряны.

Inputs: server_id (required).

increase_k8s_node_group_nodesУвеличение количества нод в группеB
Destructive

Добавляет указанное количество воркер-нод в группу. Опционально назначает лейблы новым нодам.

Inputs: count (required), group_id (required), cluster_id (required), labels.

install_k8s_addonУстановка дополнения в кластерB
Destructive

Устанавливает дополнение (addon) в кластер. Нужны тип, версия, config_type (basic/custom) и YAML-конфигурация. Каталог доступных дополнений — list_k8s_addon_configs.

Inputs: type (required), version (required), cluster_id (required), config_type (required), +1 more.

list_ai_agentsСписок AI-агентовA
Read-only

Возвращает список всех AI-агентов аккаунта: ID, название, статус, тип доступа, ID модели, использование токенов. Используй перед операциями над агентом для получения ID.

Inputs: no named parameters.

list_all_project_balancersВсе балансировщики аккаунта (по проектам)A
Read-only

Список всех балансировщиков на аккаунте с привязкой к проекту (project_id). Удобно искать в каком проекте висит ресурс.

Inputs: no named parameters.

list_all_project_bucketsВсе хранилища аккаунта (по проектам)A
Read-only

Список всех S3-хранилищ аккаунта с привязкой к проекту (project_id).

Inputs: no named parameters.

list_all_project_clustersВсе кластеры k8s аккаунта (по проектам)A
Read-only

Список всех Kubernetes-кластеров аккаунта с привязкой к проекту.

Inputs: no named parameters.

list_all_project_databasesВсе БД аккаунта (по проектам)A
Read-only

Список всех managed-БД аккаунта с привязкой к проекту (project_id).

Inputs: no named parameters.

list_all_project_dedicatedВсе выделенные серверы аккаунта (по проектам)B
Read-only

Список всех dedicated-серверов аккаунта с привязкой к проекту.

Inputs: no named parameters.

list_all_project_serversВсе серверы аккаунта (по проектам)A
Read-only

Список всех VPS аккаунта с привязкой к проекту (project_id). В отличие от list_servers — содержит поле project_id для каждого сервера.

Inputs: no named parameters.

list_api_keysСписок API-токеновA
Read-only

Возвращает список всех выпущенных API-токенов аккаунта с их ID, именами и сроком жизни

Inputs: no named parameters.

list_balancer_ipsIP-адреса балансировщикаA
Read-only

Получает список backend IP-адресов, привязанных к балансировщику (на эти IP распределяется трафик).

Inputs: balancer_id (required).

list_balancer_presetsТарифы балансировщиковA
Read-only

Возвращает список доступных тарифов (preset) для балансировщиков. Используй перед create_balancer, чтобы выбрать preset_id.

Inputs: no named parameters.

list_balancer_rulesПравила балансировщикаA
Read-only

Возвращает список правил балансировщика — соответствий между портом балансировщика и портом backend-сервера.

Inputs: balancer_id (required).

list_balancersСписок балансировщиковA
Read-only

Возвращает все балансировщики нагрузки аккаунта с ключевыми параметрами: ID, имя, статус, протокол, порт, алгоритм, IP, локация. Используй перед любыми операциями над балансировщиком, чтобы получить его ID.

Inputs: limit, offset.

list_bucketsСписок S3-хранилищA
Read-only

Возвращает все S3-хранилища аккаунта с id, name, type (private/public), статусом, классом (cold/hot), локацией, hostname, использованием диска. Используй перед любой операцией над хранилищем, чтобы получить его ID.

Inputs: no named parameters.

list_bucket_subdomainsСписок поддоменов S3-хранилищаA
Read-only

Возвращает все поддомены, привязанные к S3-хранилищу: id, subdomain, статус SSL (ssl_released, ssl_not_requested, ssl_re_release_error), когда выдан сертификат, количество попыток перевыпуска.

Inputs: bucket_id (required).

list_bucket_usersСписок пользователей S3-хранилищA
Read-only

Возвращает всех пользователей-администраторов S3-хранилищ аккаунта: id и access_key. secret_key может быть в ответе, но на практике его безопаснее обновлять через update_bucket_user.

Inputs: no named parameters.

list_container_registriesСписок реестров контейнеровA
Read-only

Возвращает список всех реестров контейнеров (Container Registry) аккаунта: ID, имя, описание, тариф, использование диска, дата создания. Используй перед операциями над реестром, чтобы получить его ID.

Inputs: no named parameters.

list_container_registry_presetsСписок тарифов реестров контейнеровA
Read-only

Возвращает список доступных тарифов для реестров контейнеров (Container Registry): ID, описание, размер диска, цена, локация. Используй перед create_container_registry, чтобы выбрать preset_id.

Inputs: no named parameters.

list_container_registry_repositoriesСписок репозиториев реестра контейнеровA
Read-only

Возвращает список репозиториев (образов) внутри конкретного реестра контейнеров: имя репозитория, тег, digest, размер. Используй чтобы посмотреть, какие образы уже загружены в реестр.

Inputs: registry_id (required).

list_database_adminsСписок пользователей кластера базы данныхC
Read-only

Возвращает список пользователей (admins) кластера базы данных (GET /api/v1/databases/{db_cluster_id}/admins).

Inputs: db_cluster_id (required).

list_database_clustersСписок кластеров баз данныхA
Read-only

Возвращает список кластеров баз данных аккаунта (GET /api/v1/databases). Используй перед операциями над кластером, чтобы получить его ID.

Inputs: limit, offset.

list_database_instancesСписок инстансов кластераB
Read-only

Возвращает список инстансов (баз данных внутри кластера) (GET /api/v1/databases/{db_cluster_id}/instances).

Inputs: db_cluster_id (required).

list_dedicated_server_additional_servicesДополнительные услуги выделенного сервераC
Read-only

Возвращает список дополнительных услуг для конкретного тарифа выделенного сервера (plan_id): ID, имя, цена, период, описание. Используй, чтобы узнать plan_id для передачи в create_dedicated_server.

Inputs: preset_id (required).

list_dedicated_server_presetsСписок тарифов выделенных серверовA
Read-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Список выделенных серверовA
Read-only

Возвращает список всех выделенных (dedicated) серверов аккаунта: ID, имя, статус (installing/installed/on/off), локация, CPU/RAM/HDD описания, IPv4/IPv6, цена. Используй перед операциями над выделенным сервером, чтобы получить его ID.

Inputs: no named parameters.

list_default_dns_recordsDNS-записи домена по умолчаниюA
Read-only

Возвращает список DNS-записей по умолчанию для домена или поддомена (системные записи Timeweb).

Inputs: fqdn (required).

list_dns_recordsСписок DNS-записей доменаA
Read-only

Возвращает все пользовательские DNS-записи домена: ID, тип (A/AAAA/CNAME/MX/TXT/SRV), значение, TTL, поддомен, priority.

Inputs: fqdn (required).

list_domain_requestsСписок заявок на регистрацию/продление/трансфер доменовA
Read-only

Возвращает все заявки пользователя на операции с доменами: регистрация, продление, трансфер. Включает ID, FQDN, тип, статус, источник оплаты.

Inputs: no named parameters.

list_domainsСписок доменовA
Read-only

Возвращает одну страницу доменов: ID, FQDN, статус, дата окончания регистрации, автопродление, общее количество и следующее смещение. limit: 1–100 (по умолчанию 100), offset: от 0 (по умолчанию 0). Для продолжения используй указанный offset; список может меняться между запросами. Используй перед операцией над доменом.

Inputs: limit, offset.

list_firewall_group_resourcesСписок ресурсов группы firewallB
Read-only

Возвращает список ресурсов (сейчас только серверы), привязанных к указанной группе правил firewall.

Inputs: group_id (required).

list_firewall_groupsСписок групп правил firewallA
Read-only

Возвращает все группы правил firewall аккаунта: ID, имя, описание, политика (ACCEPT/DROP), даты создания и обновления. Используй перед любой операцией над группой, чтобы получить её ID.

Inputs: no named parameters.

list_firewall_groups_by_resourceГруппы firewall для ресурсаA
Read-only

Возвращает список групп правил firewall, привязанных к конкретному ресурсу (например, серверу). Используй, чтобы узнать какие группы защищают сервер.

Inputs: resource_id (required), resource_type (required).

list_firewall_rulesСписок правил firewall в группеB
Read-only

Возвращает список правил firewall в указанной группе: ID, направление (ingress/egress), протокол (tcp/udp/icmp), порт, CIDR, описание.

Inputs: group_id (required).

list_floating_ipsСписок плавающих IPB
Read-only

Возвращает список всех плавающих IP пользователя с их ID, адресами, зонами и привязкой к сервисам

Inputs: no named parameters.

list_image_downloadsСписок ссылок на скачивание образаA
Read-only

Возвращает список всех ссылок на скачивание конкретного образа. Используется при миграции образа во внешние хранилища (Timeweb, Google Drive, Яндекс.Диск).

Inputs: image_id (required), limit, offset.

list_imagesСписок образовA
Read-only

Возвращает список всех образов (custom images, snapshots) аккаунта с id, name, статусом, ОС, локацией, размером. Образы — это снимки дисков/загруженные qcow2 или iso, которые можно использовать для создания серверов.

Inputs: limit, offset.

list_k8s_addon_configsКаталог дополнений кластераA
Read-only

Возвращает доступные для установки в кластер дополнения (аддоны): тип, версию, зависимости и базовый YAML-шаблон.

Inputs: cluster_id (required).

list_k8s_addonsУстановленные дополнения кластераA
Read-only

Возвращает список установленных в кластере дополнений (addons) с их ID, типом, версией и статусом.

Inputs: cluster_id (required).

list_k8s_cluster_nodesСписок всех нод кластераB
Read-only

Возвращает список всех нод (мастер и воркер) в кластере с их ID, типом, группой, статусом и характеристиками.

Inputs: cluster_id (required).

list_k8s_clustersСписок Kubernetes-кластеровA
Read-only

Возвращает список всех Kubernetes-кластеров аккаунта с ID, именем, статусом, версией k8s, сетевым драйвером, зоной доступности и агрегированными CPU/RAM/Disk. Используй перед операциями над кластером, чтобы получить его ID.

Inputs: limit, offset.

list_k8s_network_driversСписок сетевых драйверов KubernetesA
Read-only

Возвращает список доступных сетевых драйверов для создания кластера (kuberouter, calico, flannel, cilium).

Inputs: no named parameters.

list_k8s_node_group_nodesСписок нод группыB
Read-only

Возвращает список нод, принадлежащих конкретной группе кластера. Поддерживает пагинацию через limit/offset.

Inputs: group_id (required), cluster_id (required), limit, offset.

list_k8s_node_groupsСписок групп нод кластераB
Read-only

Возвращает список всех групп нод (node groups) в кластере с ID, именем, preset_id и количеством нод.

Inputs: cluster_id (required).

list_k8s_presetsСписок тарифов KubernetesA
Read-only

Возвращает тарифы для мастер- и воркер-нод: ID, тип (master/worker), CPU, RAM, Disk, Network, цену. Используй перед созданием кластера или группы нод.

Inputs: no named parameters.

list_k8s_versionsСписок доступных версий KubernetesA
Read-only

Возвращает все доступные для создания/обновления версии Kubernetes. Используй перед create_k8s_cluster или update_k8s_cluster_version.

Inputs: no named parameters.

list_locationsСписок локацийA
Read-only

Возвращает список доступных локаций и зон доступности: код локации, ISO-код, список availability_zones. Нужен для выбора location/availability_zone при создании VPS.

Inputs: no named parameters.

list_mailboxesСписок всех почтовых ящиков аккаунтаA
Read-only

Возвращает все почтовые ящики аккаунта (API v2). Для каждого ящика: адрес, статусы спам-фильтра, webmail, пересылки, комментарий.

Inputs: no named parameters.

list_mailboxes_by_domainСписок почтовых ящиков доменаA
Read-only

Возвращает список почтовых ящиков указанного домена (API v1). Используй, когда нужны только ящики конкретного домена.

Inputs: domain (required).

list_mailboxes_v1Список почтовых ящиков аккаунта (API v1)A
Read-only

Возвращает все почтовые ящики аккаунта в формате API v1 (с полной детализацией auto_reply/spam_filter/forwarding). Предпочитай list_mailboxes (v2), этот нужен только если требуются v1-поля.

Inputs: no named parameters.

list_network_drive_available_resourcesСписок сервисов для подключения сетевого дискаA
Read-only

Возвращает список сервисов (серверов), к которым можно подключить сетевой диск. Используй перед mount_network_drive, чтобы узнать допустимые resource_id.

Inputs: no named parameters.

list_network_drive_presetsСписок тарифов сетевых дисковA
Read-only

Возвращает список доступных тарифов (preset) для сетевых дисков с ценой за ГБ, допустимым диапазоном размеров и IOPS. Используй перед create_network_drive для выбора preset_id.

Inputs: no named parameters.

list_network_drivesСписок сетевых дисковA
Read-only

Возвращает список всех сетевых дисков аккаунта с ключевыми параметрами: ID, имя, статус, тип (nvme/hdd), размер, зона доступности, локация, preset_id, подключённые сервисы. Используй перед любой операцией над диском, чтобы получить его ID.

Inputs: no named parameters.

list_project_balancersБалансировщики проектаC
Read-only

Список балансировщиков в указанном проекте.

Inputs: project_id (required).

list_project_bucketsХранилища проектаC
Read-only

Список S3-хранилищ в указанном проекте.

Inputs: project_id (required).

list_project_clustersKubernetes-кластеры проектаB
Read-only

Список k8s-кластеров в указанном проекте.

Inputs: project_id (required).

list_project_databasesБазы данных проектаC
Read-only

Список managed-БД в указанном проекте.

Inputs: project_id (required).

list_project_dedicatedВыделенные серверы проектаC
Read-only

Список dedicated-серверов в указанном проекте.

Inputs: project_id (required).

list_project_resourcesВсе ресурсы проектаA
Read-only

Возвращает сводку по всем ресурсам проекта: серверы, балансировщики, хранилища, кластеры, БД, выделенные серверы.

Inputs: project_id (required).

list_projectsСписок проектовA
Read-only

Возвращает список всех проектов аккаунта с id, именем, описанием и флагом по умолчанию. Используй перед работой с ресурсами проекта, чтобы получить project_id.

Inputs: no named parameters.

list_project_serversСерверы проектаB
Read-only

Список VPS-серверов в указанном проекте.

Inputs: project_id (required).

list_server_configuratorsСписок конфигураторов VPSA
Read-only

Возвращает конфигураторы серверов с диапазонами CPU/RAM/Disk/Bandwidth/GPU и шагами изменения. Используй, если нужно создать VPS с произвольной конфигурацией (не тарифом).

Inputs: no named parameters.

list_server_disk_backupsСписок бэкапов диска сервераA
Read-only

Возвращает список бэкапов (manual + auto) конкретного диска VPS-сервера. Бэкапы в Timeweb Cloud — это снапшоты на уровне диска, а не всего сервера. Для получения disk_id сначала запроси список дисков сервера через API.

Inputs: disk_id (required), server_id (required).

list_server_disksСписок дисков сервераA
Read-only

Возвращает список дисков сервера с ID, размером, загрузкой и статусом. Используй перед операциями с бэкапами — disk_id нужен для list_server_disk_backups и create_server_disk_backup.

Inputs: server_id (required).

list_server_ipsСписок IP-адресов сервераB
Read-only

Возвращает все IPv4 и IPv6 адреса, назначенные серверу, включая PTR-записи и признак основного IP.

Inputs: server_id (required).

list_server_osСписок ОС для VPSA
Read-only

Возвращает список операционных систем, доступных для установки на VPS-сервер: ID, семейство, имя, версия, codename, минимальные требования. Используй перед созданием VPS, чтобы выбрать os_id.

Inputs: no named parameters.

list_server_presetsСписок тарифов VPS-серверовA
Read-only

Возвращает все доступные тарифы (пресеты) для VPS-серверов: ID, цена, локация, CPU, RAM, диск, тип диска, пропускная способность. Используй перед созданием VPS, чтобы выбрать preset_id. Это справочник VPS-тарифов (НЕ пресеты для приложений — для них есть get_allowed_presets).

Inputs: no named parameters.

list_serversСписок серверовA
Read-only

Возвращает одну страницу VPS-серверов: ID, имя, статус, локация, CPU, RAM, IPv4, ОС, общее количество и следующее смещение. limit: 1–100 (по умолчанию 100), offset: от 0 (по умолчанию 0). Для продолжения используй указанный offset; список может меняться между запросами. Используй перед операцией над сервером, чтобы получить его ID.

Inputs: limit, offset.

list_server_softwareСписок ПО из маркетплейсаA
Read-only

Возвращает список ПО из маркетплейса, доступного для установки на VPS при создании: ID, название, совместимые os_ids, требования. Используй, чтобы выбрать software_id.

Inputs: no named parameters.

list_ssh_keysСписок SSH-ключейA
Read-only

Возвращает список всех SSH-ключей аккаунта: ID, имя, дата создания, флаг is_default и список серверов, на которых ключ используется. Используй перед операциями с SSH-ключами чтобы получить их ID.

Inputs: no named parameters.

list_tldsСписок доменных зон (TLD)A
Read-only

Возвращает список всех доступных доменных зон с ценами регистрации и продления. Используй перед созданием заявки на регистрацию.

Inputs: no named parameters.

list_vpc_portsСписок портов VPCB
Read-only

Возвращает список портов VPC с MAC-адресами, IPv4 и сервисами

Inputs: vpc_id (required).

list_vpc_servicesСервисы в VPCB
Read-only

Возвращает список сервисов (server / balancer / dbaas), привязанных к VPC

Inputs: vpc_id (required).

mount_network_driveПодключение сетевого диска к сервисуA
Destructive

Подключает сетевой диск к сервису (серверу). Сервис и диск должны быть в одной зоне доступности. Доступные для подключения сервисы можно получить через list_network_drive_available_resources.

Inputs: resource_id (required), resource_type (required), network_drive_id (required).

reboot_serverПерезагрузка сервераA
Destructive

Мягко перезагружает сервер через ACPI reboot. ОС корректно завершает процессы перед рестартом. Используй для применения обновлений ядра или сброса подвисшего состояния.

Inputs: server_id (required).

reduce_k8s_node_group_nodesУменьшение количества нод в группеB
Destructive

Удаляет указанное количество воркер-нод из группы. Действие необратимо — удалённые ноды нельзя восстановить.

Inputs: count (required), group_id (required), cluster_id (required).

refresh_api_keyПеревыпуск API-токенаB
Destructive

Перевыпускает существующий API-токен. Возвращает новое значение токена (один раз)

Inputs: token_id (required), expire.

remove_balancer_ipsУдаление IP у балансировщикаB
Destructive

Удаляет backend IP-адреса у балансировщика (снимает их из распределения трафика).

Inputs: ips (required), balancer_id (required).

remove_ssh_key_from_serverСнятие SSH-ключа с сервераA
Destructive

Удаляет конкретный SSH-ключ с сервера. Сам ключ в аккаунте остаётся — удаляется только привязка к серверу. Для полного удаления ключа используй delete_ssh_key.

Inputs: server_id (required), ssh_key_id (required).

reset_server_passwordСброс пароля root сервераA
Destructive

Инициирует сброс root-пароля сервера. Новый пароль отправляется на email владельца аккаунта.

Inputs: server_id (required).

resize_serverИзменение конфигурации сервераA
Destructive

Меняет тариф (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Установка типа загрузки ОС сервераA
Destructive

Меняет boot_mode сервера: default (штатный), single (однопользовательский — для восстановления root), recovery_disk (загрузка с диска восстановления). Сервер перезагружается.

Inputs: boot_mode (required), server_id (required).

set_server_nat_modeУстановка NAT-режима сервера в локальной сетиC
Destructive

Меняет правила маршрутизации трафика: dnat_and_snat (полный доступ), snat (только исходящий), no_nat (изоляция в локальной сети).

Inputs: nat_mode (required), server_id (required).

shutdown_serverВыключение сервераA
Destructive

Мягко выключает сервер через ACPI shutdown (аналог нажатия кнопки питания). ОС корректно завершает процессы. Для принудительного выключения используй hard-shutdown через /action API (не покрыто этим tool-ом).

Inputs: server_id (required).

start_serverЗапуск сервераB
Destructive

Запускает выключенный VPS. Идемпотентен: на уже работающем сервере вернёт ошибку. Проверь статус через get_server перед вызовом.

Inputs: server_id (required).

transfer_bucketПеренос S3-хранилища от стороннего провайдераA
Destructive

Запускает перенос 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Перенос ресурса в другой проектC
Destructive

Переносит сервер/БД/балансировщик/хранилище/кластер/dedicated из одного проекта в другой. resource_type обязателен.

Inputs: resource_id (required), resource_type (required), to_project_id (required), from_project_id (required).

unbind_floating_ipОтвязка плавающего IP от сервисаC
Destructive

Отвязывает плавающий IP от текущего сервиса

Inputs: floating_ip_id (required).

uninstall_k8s_addonУдаление дополнения из кластераA
Destructive

Удаляет установленное ранее дополнение из кластера. Действие необратимо.

Inputs: addon_id (required), cluster_id (required).

unmount_network_driveОтключение сетевого диска от сервисаA
Destructive

Отключает сетевой диск от сервиса (сервера), к которому он был подключён. Перед удалением диска его нужно отключить.

Inputs: network_drive_id (required).

unmount_server_imageОтмонтирование ISO-образа сервераA
Destructive

Отмонтирует примонтированный ISO-образ и перезагружает сервер в штатном режиме.

Inputs: server_id (required).

update_ai_agentОбновление AI-агентаA
Destructive

Обновляет параметры AI-агента: имя, описание, статус, access_type, пакет токенов, system prompt и настройки модели. Передавай только поля, которые нужно изменить.

Inputs: agent_id (required), name, top_p, status, +10 more.

update_balancerОбновление балансировщикаA
Destructive

Обновляет параметры существующего балансировщика. Все поля кроме balancer_id — опциональные; передавай только то, что меняется.

Inputs: balancer_id (required), algo, fall, name, +20 more.

update_balancer_ruleОбновление правила балансировщикаA
Destructive

Обновляет правило маршрутизации балансировщика. Все поля (кроме id) обязательны — API ожидает полное описание правила.

Inputs: rule_id (required), balancer_id (required), server_port (required), server_proto (required), +2 more.

update_bucketИзменение S3-хранилищаB
Destructive

Изменяет параметры 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-хранилищаA
Destructive

Меняет secret_key пользователя-администратора S3-хранилища. После смены пароля нужно обновить конфигурацию всех клиентов, подключающихся к хранилищу.

Inputs: user_id (required), secret_key (required).

update_container_registryОбновление реестра контейнеровA
Destructive

Изменяет параметры реестра контейнеров: описание, тариф (preset_id) или кастомную конфигурацию (configurator_id + disk). Имя реестра изменить нельзя.

Inputs: registry_id (required), disk, preset_id, description, +1 more.

update_database_adminИзменение пользователя кластераB
Destructive

Изменяет параметры пользователя кластера: пароль, привилегии, описание (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Изменение кластера базы данныхB
Destructive

Изменяет параметры кластера базы данных: название, тариф, описание, публичную сеть (PATCH /api/v1/databases/{db_cluster_id}).

Inputs: db_cluster_id (required), name, preset_id, description, +1 more.

update_database_instanceИзменение инстанса кластераC
Destructive

Изменяет параметры инстанса базы данных в кластере (PATCH /api/v1/databases/{db_cluster_id}/instances/{instance_id}).

Inputs: instance_id (required), db_cluster_id (required), name, description.

update_dedicated_serverОбновление выделенного сервераA
Destructive

Изменяет параметры выделенного сервера: имя и/или комментарий. Оба поля опциональны, но хотя бы одно должно быть передано.

Inputs: dedicated_id (required), name, comment.

update_dns_recordОбновление DNS-записиC
Destructive

Обновляет существующую DNS-запись по ID. Использует API v2. Нужно передать тип записи и новые поля.

Inputs: fqdn (required), type (required), record_id (required), ttl, +8 more.

update_domainОбновление параметров доменаB
Destructive

Включает/выключает автопродление домена и/или меняет привязанный IP-адрес. FQDN обязателен.

Inputs: fqdn (required), linked_ip, is_autoprolong_enabled.

update_domain_name_serversОбновление name-серверов доменаA
Destructive

Заменяет список name-серверов у домена. Принимает массив объектов {host, ips?}.

Inputs: fqdn (required), name_servers (required).

update_domain_requestОплата/обновление заявки на доменA
Destructive

Обновляет заявку на регистрацию/продление/трансфер, указывая источник оплаты: use (с баланса), invoice (платёжка), free (бесплатный трансфер), bonus.

Inputs: request_id (required), money_source (required), bonus_id, payer_id, +3 more.

update_firewall_groupОбновление группы правил firewallB
Destructive

Обновляет имя и/или описание группы правил firewall. Политика группы через этот эндпоинт не меняется.

Inputs: name (required), group_id (required), description.

update_firewall_ruleОбновление правила firewallB
Destructive

Полностью обновляет правило firewall. Передаются direction, protocol (обязательно) и опциональные port, cidr, description — эти поля перезаписывают текущие значения правила.

Inputs: rule_id (required), group_id (required), protocol (required), direction (required), +3 more.

update_floating_ipИзменение плавающего IPC
Destructive

Изменяет комментарий и/или PTR-запись плавающего IP по его ID

Inputs: floating_ip_id (required), ptr, comment.

update_imageОбновление образаA
Destructive

Обновляет имя и/или описание образа. Другие атрибуты (ОС, локация, disk_id) изменить нельзя.

Inputs: image_id (required), name, description.

update_k8s_addonИзменение конфигурации дополненияB
Destructive

Изменяет конфигурацию или версию ранее установленного дополнения. Нужны type, config_type, yaml_config, version.

Inputs: type (required), version (required), addon_id (required), cluster_id (required), +2 more.

update_k8s_cluster_versionОбновление версии Kubernetes-кластераA
Destructive

Обновляет версию Kubernetes в кластере. Версию можно не передавать — тогда будет выбрана следующая доступная.

Inputs: cluster_id (required), k8s_version.

update_mailboxИзменение почтового ящикаA
Destructive

Обновляет почтовый ящик (API v2): пароль, комментарий, ФИО, спам-фильтр, автоответчик, пересылки. Передавай только изменяемые поля. Сложные блоки (spam/forward/autoreply/outgoing) принимают объект с is_enabled и дополнительными полями при включении.

Inputs: domain (required), mailbox (required), comment, password, +5 more.

update_mailbox_v1Изменение почтового ящика (API v1)A
Destructive

Обновляет почтовый ящик через 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Изменение почтовой информации о доменеB
Destructive

Меняет адрес-сборщик для писем, приходящих на несуществующие ящики домена.

Inputs: email (required), domain (required).

update_network_driveИзменение сетевого дискаA
Destructive

Изменяет параметры сетевого диска (name, comment, size). Размер можно только увеличивать. Нужно указать хотя бы одно из полей.

Inputs: network_drive_id (required), name, size, comment.

update_projectИзменение проектаA
Destructive

Обновляет имя, описание или аватар существующего проекта. Минимум одно поле.

Inputs: project_id (required), name, avatar_id, description.

update_serverИзменение метаданных сервераA
Destructive

Обновляет имя, комментарий, avatar_id или cloud_init у сервера. Для ресайза (preset/configurator) используй resize_server.

Inputs: server_id (required), name, comment, avatar_id, +1 more.

update_server_ipИзменение PTR-записи IP-адресаB
Destructive

Меняет PTR-запись (обратное DNS) для конкретного IP-адреса сервера.

Inputs: ip (required), ptr (required), server_id (required).

update_ssh_keyИзменение SSH-ключаA
Destructive

Изменяет параметры SSH-ключа по ID. Можно обновить имя, тело ключа и/или флаг is_default. Передавай только те поля, которые нужно изменить.

Inputs: ssh_key_id (required), body, name, is_default.

update_vpcИзменение VPCA
Destructive

Изменяет имя и/или описание 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

    C2.9/5.0

    Scored across 245 tools

    Disambiguation2/5

    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.

    Naming Consistency3/5

    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.

    Tool Count1/5

    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.

    Completeness5/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers