Timeweb MCP Server

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

!npm
!License

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

$3

``bash
npx timeweb-mcp-server
`

$3

`bash
npm install -g timeweb-mcp-server
timeweb-mcp-server
`

Configuration

$3

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

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

$3

Add to your .mcp.json:

`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

$3


- 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

$3

- timeweb_list_databases - List database clusters
- timeweb_get_database - Get database details
- timeweb_create_database - Create database cluster
- timeweb_delete_database - Delete database cluster

$3

- 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

$3

- timeweb_list_s3_storages - List S3 buckets
- timeweb_create_s3_storage - Create S3 bucket
- timeweb_delete_s3_storage - Delete S3 bucket

$3

- 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

$3

- 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

$3

- 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

$3

- timeweb_get_account_status - Account info
- timeweb_get_finances - Balance and costs
- timeweb_get_service_prices - Pricing info

$3

- 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

`bash


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)