WolvenKit MCP

Extract files from a Cyberpunk 2077 .archive file. Use the wildcard filter to extract only specific files (e.g., '*.mesh' for meshes). Without a filter, extracts everything (can be very large).

Pack a folder of REDengine files into a .archive file. The folder should contain the game file structure (e.g., base/characters/...).

Display information about an .archive file — lists all files contained in it with sizes. Use this to explore what's inside an archive before extracting.

List all .archive files in the game's content directory. Useful for finding which archive contains specific game files.

Search for files across ALL game archives by pattern. Finds which archive(s) contain files matching your query (e.g., 'katana', 'player', 'johnny'). Much faster than checking archives one by one.

List all installed .archive mods in the game's mod directory, with file sizes.

Detect conflicts between installed mods — shows which mods modify the same game files. Run this before installing new mods to avoid issues.

Export a REDengine file to a raw format (meshes to GLB, textures to PNG/TGA/DDS, etc.). Supports .mesh, .xbm, .mlmask, .wem, and other formats.

Import a raw file back into REDengine format (PNG/TGA → XBM, GLB → mesh, etc.). The file must follow WolvenKit naming conventions.

Extract and export all assets from an archive in one step — unbundles and converts to raw formats (textures to PNG, meshes to GLB, etc.). Use wildcard filter to limit scope.

Convert a REDengine file (.mesh, .ent, .app, .mi, .mt, .inkatlas, etc.) to human-readable JSON. The JSON output is written next to the source file with a .json extension.

Convert a JSON file back to REDengine binary format. The JSON must have been generated by convert_to_json. Recreates the corresponding game file.

Quick inspection of a REDengine file — converts to JSON and returns a summary of its structure (type, chunks, dependencies) without the full content. Faster than convert_to_json for exploring.

One-step shortcut: find a game file by path, extract it from the correct archive, and convert to JSON. No need to know which archive contains it. Example: 'base\gameplay\items\weapons\melee\katana\preset_katana_saburo.ent'.

Convert multiple REDengine files to JSON in a single operation. Provide a directory and file extension filter.

Modify specific fields in a REDengine JSON file without editing the entire file. Provide a JSON path and new value. After patching, use convert_from_json to rebuild the game file.

Check WolvenKit CLI availability, version, and configured paths. Works without the game running — useful for verifying the setup.

Compute a FNV1a64 hash for a game path string. Useful for working with hashed file references in REDengine.

Search for a game file by its FNV1a64 hash value. Useful when you have a hash from crash logs or game data and need to find the corresponding file.

Estimate performance impact of a mod project by analyzing mesh vertex counts, texture memory, and file counts. Helps identify heavy assets.

Search for .reds (REDscript) or .script files in game archives. These contain game logic scripts.

Generate an ArchiveXL resource mapping YAML template. ArchiveXL is used for adding new resources (items, appearances) to the game.

Compare two REDengine files by converting both to JSON and showing the differences. Useful for understanding what a mod changes vs the original game file.

List all files referenced by a REDengine file (materials, meshes, textures, etc). Converts to JSON and extracts all file path references. Essential for knowing what to extract when modifying a file.

Get mesh information without full export: submesh count, material references, bone count, vertex/index counts. Quick way to evaluate a mesh.

Get texture (.xbm) information without exporting: resolution, format, mipmap count, compression type.

List all components of a .ent (entity) file: meshes, effects, animations, appearances, and their types.

Search for .app (appearance) files related to an entity or keyword. Searches across all game archives.

Given a mesh file, list all materials it uses (.mi material instances and .mt material templates). Extracts from the mesh JSON.

List all texture slots in a .inkatlas file (UI texture atlases). Shows slot names and texture references.

List available animations in a .anims or .rig file. Shows animation names, durations, and bone counts.

Search for game files by extension and name pattern within a specific archive. More targeted than search_archives — filters by file type.

Create a backup of a game archive or mod archive before modifying it. Copies to a .bak file alongside the original.

Restore a game archive from its .bak backup file.

Compare a mod archive against the original game archive. Shows which files are added, removed, or modified.

Merge multiple archive source directories into a single .archive file.

Download and install a mod archive from a direct URL. Downloads to the game's mod directory. Only supports direct download links (not Nexus pages).

Create a WolvenKit mod project directory structure. Sets up the standard folder layout for a Cyberpunk 2077 mod.

Build a mod by packing the source/archive directory into a .archive file and optionally installing it to the game's mod directory.

List files in a WolvenKit mod project, organized by directory.

Extract a game file directly into a mod project's source/archive directory. One-step shortcut for unbundle + copy. Maintains the game path structure.

Validate a mod project: check directory structure, verify files exist, report potential issues.

Analyze a mod project and identify files that are not referenced by any other file. Helps reduce mod size by finding orphaned assets.

Estimate the final packed size of a mod project by measuring the source/archive directory.

Generate a TweakXL YAML template for creating or modifying a TweakDB record. Provides a starting template you can customize.