umodel-mcp
Provides tools for listing, extracting, and exporting Unreal Engine game assets from .pak/.upk files, including mesh, texture, animation, and sound export to formats like glTF, PSK, PNG, and DDS.
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., "@umodel-mcp show me what's inside this encrypted pak file"
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.
Umodel-MCP
English | 简体中文
An MCP server for umodel that lets any MCP client list, extract, and export Unreal Engine game assets through natural language.
Features
Zero-dependency extraction:
pak_list/pak_extractare pure TypeScript implementations that parse the .pak index directly and extract raw.uasset/.uexpfiles — no umodel download requiredEncrypted pak support: AES-256 index/entry encryption, including the standard mode and the bitflip variant; keys are held in session memory only
Full export pipeline: meshes, textures, animations, and sounds are exported to gltf, psk, png, dds, and other formats (requires the umodel executable)
Related MCP server: L2 Modding MCP
Requirements
Node.js 18 or later
Any MCP-capable client (Hermes, Claude Code, Cursor, PI, Codex, etc.)
Only needed for export/conversion: umodel
Installation
Standard config
{
"mcpServers": {
"umodel": {
"command": "npx",
"args": ["-y", "umodel-mcp"]
}
}
}You can also just tell your agent: "Install and register umodel-mcp, reload the MCP connection, and verify it works."
claude mcp add umodel npx -- -y umodel-mcpcodex mcp add umodel npx "-y" "umodel-mcp"git clone git@github.com:CHA1007/Umodel-MCP.git
cd Umodel-MCP
npm install
npm run buildThen register it in your MCP client config:
{
"mcpServers": {
"umodel": {
"command": "node",
"args": ["<absolute path to this repo>/dist/index.js"]
}
}
}Tools
Tool | umodel command | Description |
| — | Show the current in-memory session settings |
| — | Remember session settings (in memory only, nothing written to disk) |
| — | Auto-search for the umodel executable (fallback only, when the user does not know the path) |
|
| Verify the executable (pass |
|
| List supported games and their |
| — | Recursively scan a directory for |
|
| List objects in a package (filtering and pagination supported) |
|
| Show package info (name/export tables) |
|
| Export meshes/textures/animations/sounds (psk, gltf, png, dds…) |
|
| Copy raw package files out as-is (.upk + .uexp/.ubulk) |
| — | Show the exported directory tree (with file sizes) |
| — | Parse the .pak index directly (no umodel), AES-encrypted indexes supported, search asset paths |
| — | Extract raw .uasset/.uexp files from a .pak (encrypted paks supported) |
Command-line arguments follow the official UEViewer source (UmodelTool/Main.cpp);
each tool's parameters can be inspected via its schema in your MCP client.
Disclaimer
This project is intended only for unpacking, viewing, and exporting game assets that the user legally owns, for learning, research, backup, and other lawful purposes
Please comply with the user agreement of the game in question and the laws and regulations of your jurisdiction; the author assumes no responsibility for any copyright or agreement disputes or damages arising from the use of this project
License
MIT © CHA1007
Available Tools
13 toolspak_extractExtract files from UE .pak archivesA
Extract raw .uasset/.uexp files from UE .pak archives by parsing the index directly (AES-encrypted indexes supported, including custom bit-flipped AES). Works without umodel. The extracted loose files can then be converted with umodel_export (point it at the output directory). Output defaults to /pak under the Downloads folder.
Inputs: filters (required), out, json, aesKey, +4 more.
pak_listList files inside UE .pak archivesA
Parse UE .pak index files (AES-encrypted indexes supported, including games using custom bit-flipped AES) and list asset paths matching the filters. Works without umodel. Use this before pak_extract to locate assets (meshes/textures/animations). The pak directory should come from the user — ask which game directory to unpack first.
Inputs: filters (required), json, limit, aesKey, +3 more.
umodel_exportExport assets from a packageA
Run 'umodel -export' to convert assets (meshes, textures, animations, sounds...) to standard formats (psk/gltf/tga/png/...). Without object filters the whole package is exported. Output defaults to the Downloads folder. IMPORTANT: cooked UE4/5 games need a gameTag, otherwise umodel pops a blocking engine-version GUI dialog. ALWAYS call umodel_game_list { tags: true } FIRST and use the official tag if the game is listed (e.g. roco); the server blocks the call and reminds you if gameTag is missing.
Inputs: package (required), out, json, lods, +15 more.
umodel_find_exeAuto-locate umodel executableA
Search common locations (Downloads/Desktop/Documents/Program Files/PATH...) for umodel executables (umodel.exe, umodel_64.exe, or custom builds like umodel_acl_*.exe). ONLY use this as a fallback when the user does not know the umodel path or provided an invalid one — always ask the user for the path first. With verify=true the newest candidate is tested via -version and remembered. IMPORTANT: different umodel builds/versions support different games (e.g. umodel_acl variants). If more than one candidate is found the remembered exe stays UNCONFIRMED and per-game tools refuse to run until you show the candidate list to the user, ask which version to use for the target game, and confirm it via umodel_session_set { umodelExe }. Never pick a version yourself.
Inputs: dirs, json, verify.
umodel_game_listList supported gamesA
List games supported by umodel. With tags=true shows the short tags usable with -game=/gameTag. Check this BEFORE any list/export/save call: if the user's game appears (e.g. Roco Kingdom: World -> roco), remember it via umodel_session_set { gameTag } so later calls don't pop the blocking engine-version GUI dialog.
Inputs: tags.
umodel_list_objectsList contents of a packageC
Run 'umodel -list ' to list objects contained in a package.
Inputs: package (required), json, skip, limit, +4 more.
umodel_list_outputShow exported files directory treeA
List the folder structure and files produced by umodel_export/umodel_save, with sizes. Use this after an export to see what was unpacked.
Inputs: maxDepth, directory, maxEntries.
umodel_list_packagesFind package files in a game directoryA
Recursively scan a directory for Unreal package files (.pak/.upk/.uasset/.ut2/...) so you know what to pass to other tools. The directory should come from the user — ask which game directory to unpack before scanning.
Inputs: json, limit, directory, extensions.
umodel_package_infoShow package infoB
Run 'umodel -pkginfo ' to display package summary (name table, export table).
Inputs: package (required), json, aesKeys, gameTag, +1 more.
umodel_saveSave raw packagesA
Run 'umodel -save' to copy raw package files (.upk/.uasset + .uexp/.ubulk) out of a game directory, e.g. to unpack a cooked game without converting. Output defaults to the Downloads folder.
Inputs: package (required), out, json, aesKeys, +3 more.
umodel_session_getShow current session settingsA
Show the in-memory session settings (umodel exe, game directory, output directory, AES keys). No config file is used; settings live only for this server session.
Inputs: no named parameters.
umodel_session_setRemember session settingsA
Store settings in the in-memory session (nothing is written to disk). NOTE: most values (gamePath/gameTag/aesKeys/pakAesKey/pakAesMode) are auto-remembered whenever you pass them to any tool, so you rarely need this tool — use it only to set values ahead of time, clear them (empty string), or configure pure settings: umodelExe (user-confirmed), outputDir, pakAesMode. IMPORTANT: umodelExe and gamePath must come from the user — ask the user for the umodel executable path and the game/pak directory before setting them; never guess. Only fall back to umodel_find_exe when the user does not know the path or the given path is wrong. Pass an empty string to clear a field. outputDir defaults to the Downloads folder when unset.
Inputs: aesKeys, gameTag, gamePath, outputDir, +3 more.
umodel_versionVerify umodel executableA
Run 'umodel -version' to verify the executable works. Pass exe to test a new path; if it works it is remembered in the session.
Inputs: exe.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 13 tools
Each tool targets a distinct action: session management, exe discovery, directory scanning, pak parsing, export/save, and listing outputs/objects. Even similar list tools are differentiated by input type (directory, pak index, package, output folder). Descriptions clearly specify each tool's unique role.
All tools share a umodel_ or pak_ prefix, providing a clear family relationship, but the verb-noun structure is inconsistent: some are verb-first (umodel_list_objects, umodel_export), some noun-first (umodel_game_list, umodel_package_info), and some use noun-verb pairs (umodel_session_get/set). While readable, there is no uniform naming pattern.
13 tools is well-scoped for an asset extraction workflow. Each tool earns its place, covering exe management, session settings, scanning, listing, exporting, saving, and pak operations without redundancy.
The tool set covers the full pipeline from finding the umodel executable and setting session config to scanning directories, listing packages/paks, exporting/saving assets, and verifying output. Necessary helpers like game tag lookup and version checking are included, leaving no significant gaps for the domain.
Maintenance
Related MCP Connectors
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
An MCP server that provides asset auto generator
Make games with AI: one MCP server that connects your agent to Unity, Unreal and Godot editors.
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server for Unreal Engine that uses Unreal Python Remote Execution20121MIT
- AlicenseAqualityDmaintenanceMCP server for Lineage 2 / Unreal Engine 2.5 asset modding, enabling texture extraction, modification, repackaging, and procedural mesh generation.185MIT
- AlicenseBqualityCmaintenanceAn MCP server that lets an AI agent drive Unreal Engine 5: create projects, import assets, build levels and Blueprints, configure replication, compile C++, run Play In Editor and package the game.100187 PyPI6MIT
- FlicenseAqualityDmaintenanceMCP server that enables AI assistants to inspect and build Fortnite maps by driving a running Unreal Editor for Fortnite instance via Python, exposing tools for spawning actors, browsing content, and executing editor operations.112-