SkillFoxx

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

  • 0 ★ on the repository
  • Last commit
MCP server

Broad access

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
All reasons and checks
Russian stack

evgeninho69/timeweb-mcpAuthor:evgeninho69

The official tool for the same service: Timeweb Cloud MCP Server, 26 ★ on the repository

Install

Manual install

pip install -r requirements.txt && pip install -U twc-cli && twc config

Installs dependencies and the official CLI, then authorizes it locally.

Access and checks

How we review

Broad accessThe tool can change data, run commands or handle secrets.

  • 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

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-app

MCP

Transport
stdio
Authentication
API key

Environment variables

TIMEWEB_ENV_FILE required
Path to the .env file with server settings

Limitations

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.

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.

Discussion

No questions or reviews yet.

All Timeweb Cloud tools
Official

Timeweb Cloud's official remote MCP: account servers, databases, Kubernetes, domains, mail, S3 and billing, with mandatory confirmation for changes

MCP serverBroad access26
Official

Official CLI and simple SDK for managing Timeweb Cloud resources from the terminal

CLIBroad access71
Russian stack

An MCP server with full Timeweb Cloud API coverage: servers, databases, Kubernetes, S3, domains and DNS, SSH keys, floating IPs and billing

MCP serverBroad access
Russian stack

A broad Timeweb Cloud MCP server: 245 tools across servers, Kubernetes, databases, S3, domains, mail and billing

MCP serverBroad access
Russian stack

Lightweight MCP for domains and DNS records of classic Timeweb hosting, requires two-factor authentication disabled on the account

MCP serverBroad access

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.

README badge

Report a problem