Installation#

Requires Node.js 20+. The platform CLI itself requires Node.js 18+.

From npm #

npm install -g tgcloud-mcptgcloud-mcp setup     # client setup wizard

The wizard writes the MCP config. It also asks whether to install the Agent Plugin (agent-plugin/ in this repo): a copy lands in ~/.tgcloud-mcp/agent-plugin. Cursor gets ~/.cursor/plugins/local/tgcloud. VS Code gets a chat.pluginLocations entry. Codex, Copilot, and Kiro load that same directory through their plugin UI.

Claude Code and opencode keep using the MCP config. Add the skill with:

npx skills add sdamarketing/tgcloud_mcp

One command #

curl -fsSL https://raw.githubusercontent.com/sdamarketing/tgcloud_mcp/main/install.sh | bash

Clones to ~/.tgcloud-mcp, builds, runs the wizard. Re-running updates. It asks for a language first (English, Russian, Chinese, Arabic, German, French; Enter is English, or set TGCLOUD_MCP_LANG). Then it prints a boxed banner (blue gradient on a truecolor terminal) and a spinner while it clones, installs, and builds. The wizard uses the same language and reads /dev/tty, so it still asks questions when you pipe the script with curl | bash.

Docker #

docker run -i --rm ghcr.io/sdamarketing/tgcloud-mcp

Client configs #

opencode (~/.config/opencode/opencode.json):

{ "mcp": { "tgcloud": { "type": "local", "command": ["npx", "-y", "tgcloud-mcp"], "enabled": true } } }

Claude Code / Cursor:

{ "mcpServers": { "tgcloud": { "command": "npx", "args": ["-y", "tgcloud-mcp"] } } }

VS Code (mcp.json):

{ "servers": { "tgcloud": { "type": "stdio", "command": "npx", "args": ["-y", "tgcloud-mcp"] } } }

Environment variables#