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

Installation

Via npx (recommended)

npx timeweb-mcp-server

Global install

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

Configuration

Environment Variables

| Variable | Description | Required | |----------|-------------|----------| | TIMEWEB_CLOUD_TOKEN | API token from Timeweb Cloud panel | Yes |

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)