Manage ClickHouse database clusters: create, delete, and retrieve details.
Manage Kubernetes clusters: create, delete, retrieve details, and get kubeconfig.
Manage MongoDB database clusters: create, delete, and retrieve details.
Manage MySQL database clusters: create, delete, and retrieve details.
Manage PostgreSQL database clusters: create, delete, and retrieve details.
Manage Redis database clusters: create, delete, and retrieve details.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@timeweb-mcp-server list my cloud servers"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Model Context Protocol (MCP) server for Timeweb Cloud API integration.
Full Timeweb Cloud API support
Cloud servers management (create, delete, start, stop, reboot)
Database clusters (PostgreSQL, MySQL, MongoDB, Redis, ClickHouse)
Kubernetes clusters
S3-compatible object storage
Domains and DNS management
SSH keys management
Floating IPs
Account and billing info
Related MCP server: mcp-server-digitalocean
npx timeweb-mcp-servernpm install -g timeweb-mcp-server
timeweb-mcp-serverVariable | Description | Required |
| API token from Timeweb Cloud panel | Yes |
Get your API token at: https://timeweb.cloud/my/api-keys
Add to your .mcp.json:
{
"mcpServers": {
"timeweb": {
"command": "npx",
"args": ["-y", "timeweb-mcp-server"],
"env": {
"TIMEWEB_CLOUD_TOKEN": "your-api-token"
}
}
}
}Or use with Claude Code plugin tw-deploy.
timeweb_list_servers - List all cloud servers
timeweb_get_server - Get server details
timeweb_create_server - Create new server
timeweb_delete_server - Delete server
timeweb_server_action - Start/stop/reboot server
timeweb_list_databases - List database clusters
timeweb_get_database - Get database details
timeweb_create_database - Create database cluster
timeweb_delete_database - Delete database cluster
timeweb_list_k8s_clusters - List K8s clusters
timeweb_get_k8s_cluster - Get cluster details
timeweb_create_k8s_cluster - Create K8s cluster
timeweb_delete_k8s_cluster - Delete cluster
timeweb_get_kubeconfig - Get kubeconfig
timeweb_list_s3_storages - List S3 buckets
timeweb_create_s3_storage - Create S3 bucket
timeweb_delete_s3_storage - Delete S3 bucket
timeweb_list_domains - List domains
timeweb_get_domain - Get domain details
timeweb_check_domain - Check domain availability
timeweb_list_dns_records - List DNS records
timeweb_create_dns_record - Create DNS record
timeweb_delete_dns_record - Delete DNS record
timeweb_list_ssh_keys - List SSH keys
timeweb_get_ssh_key - Get SSH key details
timeweb_create_ssh_key - Create SSH key
timeweb_delete_ssh_key - Delete SSH key
timeweb_add_ssh_key_to_server - Add SSH key to server
timeweb_list_floating_ips - List floating IPs
timeweb_get_floating_ip - Get floating IP details
timeweb_create_floating_ip - Create floating IP
timeweb_delete_floating_ip - Delete floating IP
timeweb_bind_floating_ip - Bind IP to resource
timeweb_unbind_floating_ip - Unbind IP
timeweb_get_account_status - Account info
timeweb_get_finances - Balance and costs
timeweb_get_service_prices - Pricing info
timeweb_list_server_presets - Server configurations
timeweb_list_database_presets - Database configurations
timeweb_list_s3_presets - S3 configurations
timeweb_list_os - Available OS images
timeweb_list_locations - Datacenter locations
timeweb_list_k8s_versions - K8s versions
# Install dependencies
npm install
# Build
npm run build
# Run in development mode
npm run devContributions are welcome! Please feel free to submit a Pull Request.
MIT License - see LICENSE file for details.
Minas Sarkisyan (@webkoth)
Add an SSH key to a server for authentication
Inputs: server_id (required), ssh_key_id (required), format.
Perform an action on a PaaS application (start, stop, restart)
Inputs: action (required), app_id (required), format.
Bind a floating IP to a server or other resource
Inputs: resource_id (required), resource_type (required), floating_ip_id (required), format.
Check if a domain is available for registration
Inputs: fqdn (required), format.
Create a new PaaS application from GitHub repository
Inputs: name (required), type (required), preset_id (required), repository_id (required), +5 more.
Create a new load balancer
Inputs: name (required), preset_id (required), algo, fall, +9 more.
Create a new rule for a load balancer
Inputs: balancer_id (required), server_port (required), server_proto (required), balancer_port (required), +2 more.
Create a new database cluster
Inputs: name (required), type (required), preset_id (required), login, +4 more.
Create a new backup for a database cluster
Inputs: db_id (required), format, comment.
Create a new DNS record for a domain
Inputs: fqdn (required), type (required), value (required), ttl, +3 more.
Create a new firewall group
Inputs: name (required), format, description, incoming_traffic_policy, +1 more.
Create a new firewall rule in a group
Inputs: cidr (required), group_id (required), protocol (required), direction (required), +3 more.
Create a new floating IP address
Inputs: format, comment, is_ddos_guard, availability_zone.
Create a custom OS image from a server disk (snapshot)
Inputs: name (required), disk_id (required), format, description.
Create a new Kubernetes cluster
Inputs: name (required), preset_id (required), format, ingress, +4 more.
Create a new project for organizing resources
Inputs: name (required), format, avatar_id, description.
Create a new S3-compatible object storage bucket
Inputs: name (required), preset_id (required), type, format, +1 more.
Create a new cloud server with specified configuration
Inputs: name (required), os_id (required), cpu, ram, +7 more.
Add a new disk to a server
Inputs: size (required), server_id (required), type, format.
Create a new SSH key
Inputs: body (required), name (required), format.
Create a new Virtual Private Cloud (VPC)
Inputs: name (required), format, location, subnet_v4, +1 more.
Delete a PaaS application permanently
Inputs: app_id (required), format.
Delete a load balancer permanently
Inputs: balancer_id (required), format.
Delete a database cluster permanently
Inputs: db_id (required), format.
Delete a database backup permanently
Inputs: db_id (required), backup_id (required), format.
Delete a DNS record
Inputs: fqdn (required), record_id (required), format.
Delete a firewall group permanently
Inputs: group_id (required), format.
Delete a firewall rule from a group
Inputs: rule_id (required), group_id (required), format.
Delete a floating IP address
Inputs: floating_ip_id (required), format.
Delete a custom OS image permanently
Inputs: image_id (required), format.
Delete a Kubernetes cluster permanently
Inputs: cluster_id (required), format.
Delete a project (resources must be moved or deleted first)
Inputs: project_id (required), format.
Delete an S3 storage bucket permanently
Inputs: bucket_id (required), format.
Delete a cloud server permanently
Inputs: server_id (required), format.
Delete a disk from a server (cannot delete system disk)
Inputs: disk_id (required), server_id (required), format.
Delete an SSH key
Inputs: ssh_key_id (required), format.
Delete a VPC permanently (must not have any attached services)
Inputs: vpc_id (required), format.
Trigger a new deployment for a PaaS application
Inputs: app_id (required), format, commit_id.
Get current account status including company info, verification status, and restrictions
Inputs: format.
Get detailed information about a specific PaaS application
Inputs: app_id (required), format.
Get logs from a PaaS application
Inputs: app_id (required), format.
Get resource usage statistics for a PaaS application
Inputs: app_id (required), format.
Get detailed information about a specific load balancer
Inputs: balancer_id (required), format.
Get detailed information about a specific database cluster
Inputs: db_id (required), format.
Get automatic backup settings for a database cluster
Inputs: db_id (required), format.
Get logs for a specific deployment
Inputs: app_id (required), deploy_id (required), format.
Get detailed information about a specific domain
Inputs: fqdn (required), format.
Get account finances including balance, discount, hourly cost, and payment history
Inputs: format.
Get detailed information about a specific firewall group
Inputs: group_id (required), format.
Get detailed information about a specific floating IP
Inputs: floating_ip_id (required), format.
Get detailed information about a specific custom image
Inputs: image_id (required), format.
Get detailed information about a specific Kubernetes cluster
Inputs: cluster_id (required), format.
Get kubeconfig file for a Kubernetes cluster
Inputs: cluster_id (required).
Get detailed information about a specific project
Inputs: project_id (required), format.
Get detailed information about a specific server
Inputs: server_id (required), format.
Get detailed information about a specific server disk
Inputs: disk_id (required), server_id (required), format.
Get logs from a cloud server
Inputs: server_id (required), limit, order, format.
Get resource usage statistics for a cloud server (CPU, RAM, Disk, Network)
Inputs: server_id (required), format, date_to, date_from.
Get pricing for all available services
Inputs: format.
Get detailed information about a specific SSH key
Inputs: ssh_key_id (required), format.
Get detailed information about a specific VPC
Inputs: vpc_id (required), format.
List deployment history for a PaaS application
Inputs: app_id (required), limit, format, offset.
List all PaaS applications in the account
Inputs: limit, format, offset.
List available load balancer configuration presets
Inputs: format.
List all rules for a load balancer
Inputs: balancer_id (required), format.
List all load balancers in the account
Inputs: limit, format, offset.
List all backups for a database cluster
Inputs: db_id (required), limit, format, offset.
List available database configuration presets
Inputs: format.
List all database clusters in the account
Inputs: limit, format, offset.
List DNS records for a domain
Inputs: fqdn (required), limit, format, offset.
List all domains in the account
Inputs: limit, format, offset.
List all firewall groups in the account
Inputs: limit, format, offset.
List all rules in a firewall group
Inputs: group_id (required), limit, format, offset.
List all floating IP addresses in the account
Inputs: limit, format, offset.
List all custom OS images in the account
Inputs: limit, format, offset.
List all Kubernetes clusters in the account
Inputs: limit, format, offset.
List available Kubernetes versions
Inputs: format.
List all available datacenter locations for provisioning resources
Inputs: format.
List available operating system images for server creation
Inputs: format.
List all projects in the account for organizing resources
Inputs: limit, format, offset.
List available S3 storage configuration presets
Inputs: format.
List all S3-compatible object storages in the account
Inputs: limit, format, offset.
List all disks attached to a server
Inputs: server_id (required), format.
List available server configuration presets
Inputs: format.
List all cloud servers in the account with pagination support
Inputs: limit, format, offset.
List all SSH keys in the account
Inputs: limit, format, offset.
List all Virtual Private Clouds (VPCs) in the account
Inputs: limit, format, offset.
List all services (servers, databases, etc.) attached to a VPC
Inputs: vpc_id (required), format.
Perform an action on a server (start, stop, reboot, reinstall, clone, etc.)
Inputs: action (required), server_id (required), format.
Stop a running deployment
Inputs: app_id (required), deploy_id (required), format.
Unbind a floating IP from its current resource
Inputs: floating_ip_id (required), format.
Update a PaaS application settings
Inputs: app_id (required), envs, name, branch, +4 more.
Update an existing load balancer
Inputs: balancer_id (required), algo, fall, name, +9 more.
Update an existing firewall group
Inputs: group_id (required), name, format, description, +2 more.
Update a custom image name or description
Inputs: image_id (required), name, format, description.
Update a server disk (resize)
Inputs: size (required), disk_id (required), server_id (required), format.
Update an existing VPC
Inputs: vpc_id (required), name, format, description.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 97 tools
All 97 tools follow a clear resource+action pattern, with each tool targeting a unique combination of resource and operation. Even within similar resources (e.g., server vs app), the resource name in the tool name eliminates ambiguity. No two tools appear to perform the same function.
All tool names use lowercase snake_case with the standard 'timeweb_' prefix followed by verb_noun structure (e.g., list_servers, create_database, delete_balancer). Verbs are consistently placed at the start of the action. Minor variations like 'check_domain' or 'bind_floating_ip' still follow the same pattern, making the naming highly predictable.
With 97 tools, the server attempts to cover every aspect of the Timeweb cloud platform (servers, databases, K8s, S3, domains, networking, etc.). While each tool maps to a distinct endpoint, the sheer size is overwhelming for an agent to navigate and would likely cause context issues. The tool set would benefit from being split into smaller, focused MCP servers.
The tool set provides CRUD operations for most resources (servers, SSH keys, floating IPs, projects, firewalls, balancers, disks, VPCs, images, apps). However, there are notable gaps: databases lack update/resize and backup restore functionality; Kubernetes clusters have no update/scale operations; S3 storages lack get/update. These are minor but real dead ends.
Manage HepCloud (Turkish cloud) servers and managed PostgreSQL from your AI assistant. OAuth 2.1.
Provides capabilities that let LLM agents perform a range of infrastructure management tasks.
Manage Vozora VPS servers, SSH keys, firewalls, DNS and usage from an AI agent.
Manage VeriTeknik servers, DNS, backups and support tickets from your AI assistant.
