gmod-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@gmod-mcp take a screenshot of the GMod window"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
GMod MCP Tool
MCP (Model Context Protocol) server for Garry's Mod — RCON, Lua execution, window control, screenshots, and SFTP file management.
Features
RCON — connect to GMod server, execute commands and Lua code
Screenshots — capture GMod window, zoom into specific areas, read console
[Windows]Window Control — focus, send keystrokes, console commands
[Windows]SFTP — read, write, list, delete files on remote server
Related MCP server: ark-asa-mcp
Quick Start
npx gmod-mcpMCP Client Configuration
Claude Desktop / Claude Code / Cursor:
{
"mcpServers": {
"gmod": {
"command": "npx",
"args": ["-y", "gmod-mcp"]
}
}
}With SFTP credentials via environment variables:
{
"mcpServers": {
"gmod": {
"command": "npx",
"args": ["-y", "gmod-mcp"],
"env": {
"SFTP_HOST": "your-server.com",
"SFTP_PORT": "22",
"SFTP_USER": "root",
"SFTP_PASSWORD": "your-password"
}
}
}
}Tools (15)
RCON (4 tools)
Tool | Description |
| Connect to GMod server via RCON |
| Execute RCON command |
| Execute Lua code (auto-splits by statements) |
| Disconnect from server |
gmod_connect
Parameter | Required | Description |
| Yes | Server IP or hostname |
| No | RCON port (default: 27015) |
| Yes | RCON password |
gmod_execute_rcon
Parameter | Required | Description |
| Yes | RCON command ( |
Blocked commands:
quit,exit,rcon_password,_restart
gmod_execute_lua
Parameter | Required | Description |
| Yes | Lua code to execute |
Multi-statement code is automatically split by ; into separate lua_run calls. Local variables are converted to _G.__mcp_ globals for cross-statement persistence.
_G.plys = player.GetAll(); print(#_G.plys .. " players online")Screenshots (3 tools) [Windows only]
Tool | Description |
| Full window screenshot (PNG) |
| Crop + zoom specific area |
| Screenshot of game console |
gmod_zoom
Parameter | Required | Description |
| Yes | X offset (% if 0-100, px if >100) |
| Yes | Y offset |
| Yes | Crop width |
| Yes | Crop height |
Window Control (3 tools) [Windows only]
Tool | Description |
| Bring GMod window to foreground |
| Send keystrokes to GMod |
| Type command in game console |
gmod_send_keys
Parameter | Required | Description |
| Yes | SendKeys format string |
SendKeys format: {ENTER}, {ESCAPE}, {TAB}, {F1}-{F12}, + (Shift), ^ (Ctrl), % (Alt)
gmod_console_command
Parameter | Required | Description |
| Yes | Console command (e.g. |
Experimental: may not work correctly with non-English keyboard layouts.
SFTP (5 tools)
Tool | Description |
| Connect to SFTP server |
| Read remote file |
| Write/upload file |
| List directory contents |
| Delete remote file |
| Disconnect from SFTP |
sftp_connect
Parameter | Required | Description |
| Yes | Server hostname (or |
| No | SSH port, default 22 (or |
| Yes | SSH username (or |
| No | SSH password (or |
| No | SSH private key content |
Requirements
Node.js >= 18
GMod server with RCON enabled (
rcon_passwordin server.cfg)Windows for screenshot and window control tools
SSH access for SFTP tools
Security
Destructive RCON commands (
quit,exit,rcon_password) are blockedDangerous Lua functions (
file.Delete,RunConsoleCommand,CompileString) trigger warningsRCON password is cleared from memory after authentication
SFTP credentials can be passed via environment variables (no hardcoding)
Troubleshooting
Connection failed — check server is running, RCON password is correct, port is not firewalled
Lua code fails — multi-line code must use ; separators. local variables don't persist between lua_run calls (auto-converted to _G.__mcp_*)
Screenshot returns error — GMod must be running and visible (not minimized). Process name must be hl2.exe or gmod.exe
Console command types wrong characters — switch to English keyboard layout before using gmod_console_command
License
MIT
Available Tools
16 toolsgmod_connectC
Подключиться к Garry's Mod серверу через RCON
Inputs: host (required), password (required), port.
gmod_console_commandA
[Windows only] [Experimental] Выполнить команду через консоль Garry's Mod. Фокусирует окно, открывает консоль (~), вводит команду, Enter, закрывает. ВАЖНО: может работать некорректно с русской раскладкой. Для серверных команд лучше использовать gmod_execute_rcon.
Inputs: command (required).
gmod_disconnectB
Отключиться от сервера Garry's Mod
Inputs: no named parameters.
gmod_execute_luaA
Выполнить Lua код на сервере Garry's Mod. Код разбивается по точке с запятой (;) на отдельные lua_run вызовы. ВАЖНО: local переменные НЕ сохраняются между вызовами! Используйте глобальные переменные (_G.var или просто var = ...) для передачи данных между частями. Лимит ~180 символов на statement.
Inputs: code (required).
gmod_execute_rconC
Выполнить RCON команду на сервере Garry's Mod
Inputs: command (required).
gmod_focus_windowA
[Windows only] Развернуть и вывести окно Garry's Mod на передний план. Требуется запущенная игра.
Inputs: no named parameters.
gmod_read_consoleA
[Windows only] Скриншот клиентской консоли Garry's Mod. Автоматически открывает консоль (~), делает скриншот и закрывает. Возвращает PNG изображение с содержимым консоли.
Inputs: no named parameters.
gmod_screenshotA
[Windows only] Сделать скриншот окна Garry's Mod. Возвращает PNG изображение. Окно будет автоматически развёрнуто и выведено на передний план. Требуется запущенная игра.
Inputs: no named parameters.
gmod_send_keysA
[Windows only] Отправить нажатия клавиш в окно Garry's Mod. Формат SendKeys: {ENTER}, {ESCAPE}, {TAB}, + (Shift), ^ (Ctrl), % (Alt). Пример: 'status{ENTER}'
Inputs: keys (required).
gmod_zoomA
[Windows only] Скриншот + зум определённой области окна Garry's Mod. Координаты в процентах (0-100) от размера окна или в пикселях (если >100). Полезно для чтения мелкого текста, UI элементов, консоли.
Inputs: x (required), y (required), width (required), height (required).
sftp_connectC
Подключиться к серверу по SFTP для управления файлами
Inputs: host (required), username (required), port, password, +1 more.
sftp_deleteB
Удалить файл на удалённом сервере через SFTP
Inputs: path (required).
sftp_disconnectB
Отключиться от SFTP сервера
Inputs: no named parameters.
sftp_list_dirC
Список файлов в директории на удалённом сервере через SFTP
Inputs: path (required).
sftp_read_fileC
Прочитать файл с удалённого сервера через SFTP
Inputs: path (required).
sftp_write_fileC
Записать/загрузить файл на удалённый сервер через SFTP
Inputs: path (required), content (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 16 tools
Most tools target clearly distinct actions (connect, execute RCON, execute Lua, screenshot, SFTP read/write). There is some overlap among gmod_execute_rcon, gmod_execute_lua, and gmod_console_command, and among the screenshot/console-reading tools, but descriptions clarify the differences well enough.
All tool names follow a consistent snake_case verb_noun pattern, differentiated only by the gmod_ and sftp_ subsystem prefixes. The convention is predictable across both groups.
16 tools across two distinct subsystems (GMod control and SFTP file management) is reasonable, though a few Windows-only and experimental tools make the set slightly heavy. Each tool appears to earn its place.
Core lifecycle operations are covered for both domains: GMod connect/execute/disconnect/screenshot/input, and SFTP connect/read/write/list/delete/disconnect. Minor gaps exist (SFTP mkdir, rename, move; direct player/server info), but agents can work around them via RCON.
Maintenance
Related MCP Connectors
Manage game servers, configurations, players, and groups through the GameServerApp MCP server.
Screenshots, PDFs, image editing, QR codes, email validation and more through one hosted MCP server.
An MCP server for deep research or task groups
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceMCP server for SSH remote execution, file transfer, and file editing with automatic backup/trash and ~/.ssh/config integration.117 npm1MIT
- AlicenseBqualityCmaintenanceMCP server for Ark: Survival Ascended that enables RCON-based administration commands such as listing players, broadcasting messages, saving the world, and reading the game log.10Apache 2.0
- AlicenseAqualityCmaintenanceAn MCP server for Roblox that provides tools to execute Luau code, inspect and modify game instances, teleport players, fire remote events, and stream client logs in real-time via a web dashboard.122666 npm16MIT
- AlicenseNot gradedqualityDmaintenanceSSH-based MCP server that enables remote execution of SSH commands, file transfers, and secure server management via the MCP protocol.ISC