Skip to main content
Glama
ichinya

timeweb-mcp-server

by ichinya

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
TIMEWEB_TOKENYesAPI token for Timeweb Cloud

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
add_balancer_ipsA

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

add_balancer_to_projectA

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

add_bucket_subdomain_certificateA

Выпускает SSL-сертификат (Let's Encrypt) для поддомена, привязанного к S3-хранилищу. Поддомен должен быть предварительно добавлен через add_bucket_subdomains и иметь корректную CNAME-запись.

add_bucket_subdomainsA

Добавляет один или несколько поддоменов к S3-хранилищу. Для каждого возвращает статус: success, empty_cname (нет CNAME-записи), duplicate или failed. После добавления выпускай SSL через add_bucket_subdomain_certificate.

add_bucket_to_projectA

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

add_cluster_to_projectA

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

add_database_to_projectA

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

add_dedicated_to_projectA

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

add_domainA

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

add_server_ipA

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

add_server_to_projectA

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

add_ssh_keys_to_serverA

Добавляет один или несколько существующих SSH-ключей на сервер по массиву ID. Получить ID ключей можно через list_ssh_keys, ID сервера — через list_servers.

add_subdomainA

Создаёт поддомен у указанного основного домена. Нужны FQDN основного домена и FQDN поддомена.

add_vcs_providerA

Добавляет новый VCS провайдер для подключения Git репозиториев к Timeweb Cloud

batch_create_mailboxesA

Создаёт сразу несколько почтовых ящиков на одном домене (API v2). Возвращает список созданных ящиков и массив ошибок.

batch_create_mailboxes_v1A

Создаёт несколько ящиков на домене через API v1. Предпочитай batch_create_mailboxes (v2).

bind_floating_ipB

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

check_domainA

Проверяет, свободен ли домен и можно ли его зарегистрировать. Возвращает булево значение.

clone_serverA

Создаёт полную копию сервера в отдельный VPS с такой же конфигурацией и данными. Использовать для миграций, blue-green deploy или тестирования рискованных операций на копии.

create_ai_agentA

Создаёт нового AI-агента. Обязательны: name, access_type, model_id, token_package_id, system_prompt. Перед вызовом получи model_id через list_ai_models и token_package_id через list_ai_agent_token_packages.

create_api_keyA

Создает новый API-токен. Значение токена возвращается один раз и должно быть сохранено

create_timeweb_appC

Создает приложение в Timeweb Cloud с автоматическим определением параметров проекта.

create_balancer_ruleA

Создаёт правило маршрутизации для балансировщика: соответствие между парой (протокол, порт) балансировщика и (протокол, порт) backend-сервера.

create_balancerA

Создаёт новый балансировщик нагрузки. Обязательны: 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.

create_bucketA

Создаёт новое S3-хранилище. Нужно указать name, type (private/public) и ЛИБО preset_id, ЛИБО configurator_id + configurator_disk_mb. Возвращает access_key и secret_key для подключения.

create_container_registryA

Создаёт новый реестр контейнеров (Container Registry). Укажи либо preset_id (готовый тариф), либо configurator_id + disk (кастомная конфигурация). Имя должно быть уникальным, 3-48 символов, только [a-z0-9-].

create_database_adminA

Создаёт пользователя в кластере базы данных (POST /api/v1/databases/{db_cluster_id}/admins).

create_database_instanceA

Создаёт новый инстанс (БД) внутри кластера (POST /api/v1/databases/{db_cluster_id}/instances).

create_databaseC

Создает новую базу данных в Timeweb Cloud с указанными параметрами

create_dedicated_serverA

Создаёт новый выделенный (dedicated) физический сервер. Обязательные поля: preset_id (тариф), payment_period (P1M/P3M/P6M/P1Y), name. Опционально: OS, панель управления, доп. услуги, сетевой диск, IP-адрес, проект. Перед вызовом получи preset_id через list_dedicated_server_presets.

create_dns_recordA

Создаёт DNS-запись (A, AAAA, TXT, CNAME, MX, SRV) для домена или поддомена. Использует API v2. Для SRV нужны host/port/service/protocol вместо value.

create_domain_requestA

Создаёт заявку на операцию с доменом: регистрация (register), продление (prolong), перенос (transfer). Для register нужен person_id, для transfer — auth_code.

create_firewall_groupA

Создаёт новую группу правил firewall. Имя обязательно, описание и политика (ACCEPT/DROP) — опциональны. После создания группу можно наполнить правилами через create_firewall_rule и привязать к серверу через link_firewall_resource.

create_firewall_ruleB

Создаёт новое правило в группе firewall. Обязательны direction (ingress/egress) и protocol (tcp/udp/icmp). Для tcp/udp можно указать port и cidr.

create_floating_ipA

Создает новый floating IP адрес в указанной зоне доступности

create_image_downloadA

Создаёт ссылку на скачивание образа. type=timeweb — прямая ссылка на файл (без auth). type=google_drive или yandex — копирование в облако пользователя (нужен access_token). Процесс асинхронный.

create_imageA

Создаёт образ: (а) снапшот существующего диска сервера (disk_id), (б) импорт qcow2/iso по upload_url, либо (в) пустой слот для последующей загрузки (без disk_id и upload_url — тогда заливай файл через HTTP). Процесс асинхронный, отслеживать через get_image.

create_k8s_clusterA

Создаёт новый Kubernetes-кластер. Обязательные параметры: name, k8s_version, network_driver. Для мастер-ноды укажи либо preset_id, либо configuration (взаимоисключающе). Опционально задай worker_groups, OIDC, зону, ingress.

create_k8s_node_groupA

Создаёт новую группу воркер-нод в кластере. Обязательные: name, node_count. Для тарифа — либо preset_id, либо configuration (взаимоисключающе).

create_mailboxA

Создаёт новый почтовый ящик на указанном домене (API v2). Поддерживает задание ФИО владельца и начальных настроек спам-фильтра.

create_mailbox_v1A

Создаёт почтовый ящик через API v1. Предпочитай create_mailbox (v2) — этот нужен только для совместимости.

create_network_driveA

Создаёт новый сетевой диск указанного размера с выбранным тарифом (preset_id). Перед созданием стоит получить список доступных тарифов через list_network_drive_presets.

create_projectB

Создаёт новый проект для группировки ресурсов (серверов, БД, хранилищ и т.д.).

create_server_disk_backupA

Создаёт ручной бэкап диска VPS. Процесс асинхронный: tool возвращается сразу, статус бэкапа переходит create → done в течение нескольких минут. Используй перед рискованными операциями (миграция, обновление ОС).

create_serverA

Создаёт новый облачный сервер. Выбор режима: 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.

create_ssh_keyA

Создаёт новый SSH-ключ в аккаунте. Требуются имя, тело публичного ключа и флаг is_default (будет ли ключ выбираться по умолчанию при создании сервера).

create_vpcB

Создает новую виртуальную приватную сеть в указанной зоне доступности

delete_ai_agentB

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

delete_api_keyB

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

delete_balancer_ruleB

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

delete_balancerA

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

delete_bucket_subdomainsB

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

delete_bucketA

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

delete_container_registryA

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

delete_database_adminB

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

delete_database_clusterA

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

delete_dedicated_serverA

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

delete_dns_recordA

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

delete_domainB

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

delete_firewall_groupA

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

delete_firewall_ruleB

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

delete_floating_ipB

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

delete_image_downloadA

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

delete_imageB

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

delete_k8s_cluster_nodeB

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

delete_k8s_clusterA

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

delete_k8s_node_groupB

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

delete_mailboxB

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

delete_network_driveA

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

delete_projectA

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

delete_server_disk_backupA

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

delete_server_ipA

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

delete_serverA

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

delete_ssh_keyA

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

delete_subdomainB

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

delete_vpcB

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

edit_api_keyA

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

edit_k8s_clusterA

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

get_account_financesA

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

get_account_services_costA

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

get_account_statusA

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

get_ai_agent_statisticA

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

get_ai_agentA

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

get_allowed_presetsA

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

get_balancerB

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

get_bucket_presetsA

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

get_bucketA

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

get_bucket_transfer_statusA

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

get_container_registryA

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

get_database_adminB

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

get_database_clusterB

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

get_database_instanceB

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

get_database_presetsB

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

get_dedicated_serverA

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

get_deploy_settingsA

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

get_domain_name_serversA

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

get_domain_requestA

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

get_domainB

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

get_firewall_groupB

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

get_firewall_ruleA

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

Prompts

Interactive templates invoked by user choice

NameDescription
add_vcs_provider_promptПомогает пользователю добавить VCS провайдер для подключения Git репозиториев к Timeweb Cloud
create_app_promptПомогает пользователю создать приложение в Timeweb Cloud с автоматическим определением параметров проекта

Resources

Contextual data attached and managed by the client

NameDescription
allowed_presetsСписок доступных пресетов для создания приложений в Timeweb Cloud
database_presetsСписок доступных пресетов конфигураций для создания баз данных
deploy_settingsНастройки деплоя по умолчанию для различных фреймворков в Timeweb Cloud
get_vpcsСписок виртуальных частных сетей (VPC) пользователя в Timeweb Cloud
vcs_providersСписок доступных VCS провайдеров в Timeweb Cloud

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ichinya/timeweb-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server