Timeweb MCP Server

Model Context Protocol (MCP) server for Timeweb Cloud API integration.

Features

• 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: Liara MCP Server

Installation

Via npx (recommended)

npx timeweb-mcp-server

Global install

npm install -g timeweb-mcp-server
timeweb-mcp-server

Configuration

Environment Variables

Get your API token at: https://timeweb.cloud/my/api-keys

Claude Code Integration

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.

Available Tools

Servers

• 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

Databases

• timeweb_list_databases - List database clusters

• timeweb_get_database - Get database details

• timeweb_create_database - Create database cluster

• timeweb_delete_database - Delete database cluster

Kubernetes

• 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

S3 Storage

• timeweb_list_s3_storages - List S3 buckets

• timeweb_create_s3_storage - Create S3 bucket

• timeweb_delete_s3_storage - Delete S3 bucket

Domains & DNS

• 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

SSH Keys

• 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

Floating IPs

• 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

Account

• timeweb_get_account_status - Account info

• timeweb_get_finances - Balance and costs

• timeweb_get_service_prices - Pricing info

Presets & Locations

• 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

Development

# Install dependencies
npm install

# Build
npm run build

# Run in development mode
npm run dev

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

MIT License - see LICENSE file for details.

Author

Minas Sarkisyan (@webkoth)