GENTAHAX MCP
Provides an Android adb bridge for deploying and communicating with a Lua bridge on an Android device, enabling live game-data reads, script management, and safe code execution through adb push/pull.
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
🎮 GENTAHAX MCP
AI-powered Lua tooling for Growtopia GENTAHAX v5.61 — Model Context Protocol
Author watermark: mr_berk
45 tools · 6832 real item IDs · 66 Android APIs · 18 Windows APIs · 14 templates · 32 cheat codes · 39 packet types · 22 DLL-verified variant functions
NOT FAKE — BUILT FROM REAL DATA
📚 Documentation:
INSTALL.md — English setup guide
KURULUM.md — Turkish setup guide
AGENTS.md — AI instructions for assistants
AI_TRAINING.md — English training guide
AI_EGITIM.md — Turkish training guide
What this project is
GENTAHAX MCP connects your AI assistant to the Growtopia GENTAHAX v5.61 scripting ecosystem through the Model Context Protocol (MCP).
After setup, your AI can:
answer real Growtopia item ID questions
inspect GENTAHAX Lua APIs and hook signatures
read packet protocols and variant data
generate code safely with ban-risk analysis
check live world data, player info, and inventory information through the in-game bridge
help you write and manage Lua scripts for GENTAHAX
This repo is not a cheat generator by itself. It is an AI toolchain that gives your assistant real knowledge plus safety checks.
Related MCP server: LÖVE2D MCP Server
Quick start
1) Clone and install
git clone https://github.com/BrK08/gentahax-mcp.git
cd gentahax-mcp
pip install -r requirements.txt2) Start the MCP server
python start_mcp.pyThis can automatically detect your Growtopia Script folder, install the bridge script, and expose the MCP endpoint locally and via tunnel if available.
3) Connect your AI client
Use the generated MCP URL in your preferred client, such as:
Claude Desktop
Cursor
VS Code (GitHub Copilot)
Windsurf / other MCP-capable tools
For a direct terminal-based AI flow, see the usage examples in the docs and chat.py.
4) In-game bridge
In Growtopia, open GENTAHAX and run the bridge script, or use this executor command:
load(makeRequest("http://127.0.0.1:8809/bridge.lua","GET",{},"",5000).content)()This is the bridge used for live world and device communication.
Why this project exists
The goal is simple:
give AI assistants access to real GENTAHAX knowledge
expose verified API signatures and item data
help generate safer scripts instead of random guesses
reduce risky behavior through analysis before execution
The project is based on:
official GENTA-HAX documentation and known public reference material
GENTAHAX v5.61 binary analysis
real item database data
verified script patterns and API references
No fake item list, no made-up IDs, and no random function signatures.
Data sources
Source | What it provides |
Official GENTA-HAX docs + community references | Android and Windows Lua API signatures, examples, patterns |
GENTAHAX v5.61 binary analysis | Memory patch names, packet types, real variant-related data |
Official example scripts and shaders | Real-world examples and benchmark references |
items.dat-based real item database | 6832 actual item IDs |
Engine: Lua 5.4.6
Script paths:
Android/media/GENTAHAX/Script/*.luaandScript/*.lua
Included tools
The repo exposes 45 MCP tools organized by category.
Knowledge tools
gh_aboutgh_api_searchgh_api_listgh_api_detailgh_struct_infogh_hooks_listgh_cheats_listgh_packet_typesgh_variant_guidegh_protocol_guidegh_imgui_apigh_examples_list/gh_example_getgh_templates_list/gh_template_getgh_item_lookupgh_item_db_searchgh_item_db_infogh_snippetgh_learn_lua_gentahax
Safety tools
gh_code_analyzegh_ban_riskgh_safety_rulesgh_safe_mode
Live bridge tools
gh_device_statusgh_bridge_deploygh_run_luagh_world_snapshotgh_world_count_itemgh_world_censusgh_farm_script_gengh_script_gengh_auto_testgh_cheat_setgh_cheat_statusgh_compat_checkgh_player_infogh_inventory_dumpgh_stop_scripts
Script management tools
gh_scripts_listgh_script_readgh_script_writegh_script_deletegh_logs_read
Safety and ban-risk system
Safety is a core part of the project.
Before running code, gh_run_lua analyzes the snippet for risky patterns such as:
infinite loops without sleep
packet spam
invalid or abused action chains
rapid world enter/exit loops
HWID tampering patterns
request loops in unsafe contexts
The system returns warnings and blocks high-risk execution in safe mode by default.
This means the toolchain tries to protect the user from obvious dangerous patterns while still helping with legitimate scripting and analysis.
Read-only tools such as world counting and inventory read operations are intended to be safe inspection tools and do not depend on sending hostile packets.
Live world helper example
The project includes a live world counting flow for questions like:
“How many dirt blocks are in my world?”
“How many peppers are around me?”
“What items are common in this world?”
The flow works by identifying the item from the real database, then scanning the live in-game world state and returning the count with context.
This is useful for AI assistants because it avoids guesswork and provides grounded answers from real game state.
Which AI clients can use this?
This works with any MCP-capable client, including:
Claude Desktop
Cursor
VS Code / GitHub Copilot
Windsurf / Zed / Cline / compatible tools
The repo also includes chat.py, which can connect to many model providers, including:
OpenAI
DeepSeek
Gemini
GLM
OpenRouter
Qwen
Mistral
Ollama / LM Studio
custom OpenAI-compatible endpoints
Architecture overview
┌─────────────┐ MCP (stdio) ┌──────────────┐ bridge_in.txt ┌──────────────────┐
│ Claude / │ ◄────────────► │ server.py │ ─────────────────► │ gentahax_bridge │
│ Cursor AI │ 45 tools │ knowledge │ ◄───────────────── │ .lua │
└─────────────┘ │ bridge │ bridge_out.txt │ (in-game thread) │
└──────────────┘ └──────────────────┘Knowledge tools work without a bridge
Live tools use a local Lua bridge to read game state and execute guarded actions
The model can ask for live data when the bridge is active
Setup guides
This repository already contains the different language versions of the setup docs:
INSTALL.md — English installation and usage guide
KURULUM.md — Turkish installation and usage guide
If you are a new visitor, start with the main README here, then continue to the language-specific guide that matches your preference.
Quick install commands
git clone https://github.com/BrK08/gentahax-mcp.git
cd gentahax-mcp
pip install -r requirements.txt
python start_mcp.pyIf you want the full step-by-step flow for Windows, Android, or AI client setup, use the detailed guides linked above.
Repository notes
MIT License: LICENSE
AI instructions: AGENTS.md
English training guide: AI_TRAINING.md
Turkish training guide: AI_EGITIM.md
Benchmark notes: BENCHMARK_V150.md
Responsibility notice
This project is for research, learning, and tooling assistance.
Growtopia's rules can prohibit automation or cheating behavior. This repo includes safety checks, scoring, and warnings, but final responsibility for actual in-game usage remains with the user.
Use responsibly and within the rules of your environment.
👑 mr_berk.
GENTAHAX MCP v1.5.0 — Real data, ban-risk warnings, 45 tools, 6832 real item IDs
Built around real GENTAHAX data and offline knowledge tooling.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
This server cannot be deployed
Maintenance
Related MCP Connectors
Connect AI assistants to your approved computer for files, commands, browser and desktop tasks.
An MCP server that gives your AI access to the source code and docs of all public github repos
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Related MCP Servers
- AlicenseAqualityCmaintenanceEnables AI assistants to develop Desynced mods by providing direct access to the game's Lua API reference, base-game source, live logs, and installed mods, plus live control via a debugger link for evaluating and reloading Lua in the running game.92MIT
- AlicenseAqualityCmaintenanceEnables AI assistants to interact with running games in real time — introspecting game state, simulating keyboard and mouse input to actually play, capturing screenshots, executing Lua code, hot-reloading files, and receiving push notifications when state changes.8MIT
- AlicenseAqualityBmaintenanceEnables AI coding agents to build and audit Garry's Mod GLua addons with source-aware search, static linting, net security vulnerability scanning, performance profiling, and headless testing.920 npmMIT
- AlicenseCqualityBmaintenanceEnables an AI agent to auto-detect a game's engine (Unity, Unreal, Godot, Java, or native) from its files and then inspect, search, and patch the underlying binaries with in-process PE analysis, hex editing, pattern scanning, string extraction, checksums, diffing, and disassembly. Everything runs locally and offline with no cloud dependency or telemetry.10054 npm5MIT