timeweb-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TIMEWEB_TOKEN | Yes | API token for Timeweb Cloud |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| 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 | Создаёт пользователя в кластере базы данных ( |
| create_database_instanceA | Создаёт новый инстанс (БД) внутри кластера ( |
| 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_database_clusterA | Удаляет кластер баз данных ( |
| 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_database_clusterB | Возвращает детальную информацию о конкретном кластере баз данных по его ID ( |
| get_database_instanceB | Возвращает информацию об инстансе базы данных в кластере ( |
| 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
| Name | Description |
|---|---|
| add_vcs_provider_prompt | Помогает пользователю добавить VCS провайдер для подключения Git репозиториев к Timeweb Cloud |
| create_app_prompt | Помогает пользователю создать приложение в Timeweb Cloud с автоматическим определением параметров проекта |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| allowed_presets | Список доступных пресетов для создания приложений в Timeweb Cloud |
| database_presets | Список доступных пресетов конфигураций для создания баз данных |
| deploy_settings | Настройки деплоя по умолчанию для различных фреймворков в Timeweb Cloud |
| get_vpcs | Список виртуальных частных сетей (VPC) пользователя в Timeweb Cloud |
| vcs_providers | Список доступных VCS провайдеров в Timeweb Cloud |
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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