Timeweb Cloud MCP over the twc CLI
Timeweb MCP (stdio)
A local MCP server for Timeweb Cloud on top of the official twc CLI: ready commands for servers and apps, plus universal access to any twc command
High risk
We rate an entry high when the tool writes to external systems, handles money, production databases or secrets, or runs arbitrary commands. The CLI installs it only with your consent.
Why this level
- Tools stop and reboot servers, and timeweb_run_cli runs any twc command with no restrictions
- Start with a key or session with minimal necessary rights and review commands before letting the agent run them
Install
Manual install
pip install -r requirements.txt && pip install -U twc-cli && twc configInstalls dependencies and the official CLI, then authorizes it locally.
This is third-party code. Review the repository files before installing.
What it does
A Python server wraps the official Timeweb Cloud CLI, twc, and provides a set of ready tools: account status, who is authenticated, server listing and details, starting, stopping and rebooting servers (with a hard option), app listing and details, and creating an app from a YAML config. Beyond those there is a universal timeweb_run_cli tool that runs any twc command with arbitrary arguments and output format. Authorization is configured locally via twc config, and the server connects to Codex as a stdio process through a .env file with a path to the config.
Who it is for. For those managing Timeweb Cloud servers and apps from Codex who want access to the full twc CLI surface, not just the ready commands.
Good fit when
- You want to manage Timeweb Cloud servers and apps (start, stop, reboot, create) from Codex
- You need access to twc commands with no dedicated tool yet, via timeweb_run_cli
- You already use the official twc CLI and want the same commands available to your agent
Not a fit when
- You need a ready npm package or HTTP transport: the server is local, stdio, installed manually from source
- You need tools for databases, Kubernetes, S3, domains or DNS: this server covers only servers, apps and the account
- You need a predictable command surface: timeweb_run_cli passes through arbitrary CLI arguments with no allowlist of safe operations
Example request
Show my Timeweb Cloud servers and reboot the one named prod-appLimitations
The repository has no license. The timeweb_run_cli tool runs any twc command with no allowlist of safe operations, including potentially destructive ones. The README contains a specific Windows user's paths and login, suggesting a personal project not polished for release. The repo has committed server.err.log, server.out.log and a __pycache__ folder.
How to disable. Remove the mcp_servers.timeweb block from ~/.codex/config.toml and clear the local twc config session.
MCP
- Transport
- stdio
- Authentication
- API key
| Environment variables | |
|---|---|
| TIMEWEB_ENV_FILE required | Path to the .env file with server settings |
Security check
- Tools stop and reboot servers, and timeweb_run_cli runs any twc command with no restrictions
- Start with a key or session with minimal necessary rights and review commands before letting the agent run them
README in short
The English README gives step-by-step installation of dependencies and the twc CLI, twc config setup, copying .env, configuring mcp_servers.timeweb in Codex with startup and tool-call timeouts, a quick health check via timeweb_whoami, a list of the main server and app tools, and two example calls through timeweb_run_cli.
FAQ
Can I run a twc command with no dedicated tool?
Yes, via timeweb_run_cli with arbitrary args and an output_format.
How do I check the server is configured correctly?
Ask the agent to call timeweb_whoami or timeweb_account_status.
Related
An MCP server built into the Netdata agent: metrics, logs, alerts and live process, service and container data for an AI assistant
GitHub's official MCP server: code, issues, pull requests, Actions and security alerts straight from the agent
Agent Skills for Google products
Agent Skills for Google products and technologies
Official Google skill collection for working with Google Cloud, BigQuery, GKE, ads and analytics from an agent
AWS's official MCP server suite: docs, IaC, containers, serverless, databases, cost and monitoring