forge-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| JADX_HOME | No | Path to the jadx installation, used for Dex decompilation. | |
| GHIDRA_HOME | No | Path to your Ghidra installation folder containing support/analyzeHeadless. | |
| APKTOOL_HOME | No | Path to the apktool installation, used for APK unpack/repack. | |
| FORGE_WORKSPACE_ROOT | No | Absolute path to the Forge workspace root directory. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| open_gameA | Open (or create) a per-game workspace. Use this first before any other tool. Imports source_path into the workspace as a read-only original + working copy. Optionally load a game profile dir. Args: game_name: Short identifier for the game (e.g. "mygame_v1"). source_path: Path to the game file to import (exe/apk/save). Optional. profile_dir: Path to a profile/adaptor folder. Optional. |
| inspectB | Inspect files/structures. Dispatches by module+action. Modules: pe, apk, unity, unreal, tables, archives, format, hex. Actions: pe: pe_info (path), find_function (path, name|string_ref) apk: apk_manifest (apk_path), native_lib_info (so_path), resource_extract (apk_path, out_dir, pattern) unity: unity_assets (path, action=list|extract) unreal: unreal_pak (pak_path, action=list|extract) tables: list_entries (path, schema) archives: unpack (archive_path, out_dir) format: entropy_map (path, block_size) hex: hex_view (path, offset, limit) Large outputs are paginated via offset/limit inside params. |
| searchB | Search in files. Dispatches by module+action. Modules/actions: hex: hex_search (path, query, mode, offset, limit), diff_files (path_a, path_b), value_scan (before_path, after_path, value_type) pe: find_function (path, name|string_ref) apk: smali_search (src_dir, query, limit) format: guess_fields (path, max_fields) |
| editA | Edit files/structures. Dispatches by module+action. Supports dry_run. Modules/actions: hex: hex_patch (path, offset, bytes_hex, dry_run) apk: smali_patch (src_dir, file_rel, old, new, dry_run) tables: clone_entry, edit_fields, rebuild_offsets, checksum_fix format: write_template Every write snapshots first and logs to job_log. |
| patch_codeC | Code patching helpers. Dispatches by module+action. Modules/actions: pe: make_signature (path, address, length, wildcard_offsets), verify_signature (path, signature), emulate_function (code_hex, entry_offset, arch, args) apk: il2cpp_dump dynamic: frida_script |
| rebuildA | Rebuild/repack helpers. Dispatches by module+action. Modules/actions: tables: rebuild_offsets (path, schema), validate (path, schema) archives: repack (src_dir, out_path, format) apk: apk_repack unreal: unreal_pak pack format: validate_template |
| validateA | Validate artifacts. Dispatches by module+action. Modules/actions: pe: verify_signature (path, signature) tables: validate (path, schema) format: validate_template (template_path, sample_files) |
| exportB | Export patches/tables. Dispatches by module+action. Modules/actions: patch: export_patch (original_path, modified_path, out_path, fmt=ips|xdelta) patch: make_trainer_table (addresses, out_path) diagnose: changelog joblog: list |
| diagnoseB | Diagnosis helpers. Dispatches by module+action. Modules/actions: diagnose: parse_crash_log (path), check_dependencies (game_dir), find_conflicts (mods), bisect_plan (items), suggest_load_order (mods) dynamic: trace_diff (trace_a, trace_b) external: check_dependencies (tool list) |
| undoB | Restore the last (or specified) snapshot. Verifies hash after restore. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 10 tools
Multiple actions are duplicated across tools: find_function lives in both inspect and search (pe), verify_signature appears in patch_code, validate, and rebuild, rebuild_offsets in both edit and rebuild, and validate in both rebuild and validate. check_dependencies even appears twice within diagnose under different modules. The module dispatch layers are coherent internally, but the cross-tool duplication means an agent can plausibly pick the wrong tool for the same operation.
All names are snake_case, verb-first, and readable (inspect, search, edit, rebuild, validate, export, diagnose, undo). Minor deviation: open_game and patch_code use verb_noun while the rest are bare verbs, though this actually helps signal they are the entry-point/utility tools.
Ten top-level tools is a sensible count for a game-modding forge. However, each tool is a mega-dispatcher bundling 2-9 actions, so the effective surface is much larger than 10 and some tools (inspect, edit) carry heavy action loads.
The surface covers a full modding lifecycle: open workspace, inspect formats (PE/APK/Unity/Unreal/tables/archives), search/diff, edit with snapshots, patch code, rebuild/repack, validate, export patch tables, diagnose, and undo. Minor gaps: no way to list/close workspaces or manage snapshots directly, and job log access only via export.