Summary
Bridges Claude to Unreal Engine 5 through a native C++ plugin that exposes 17 automation tools over a local GraphQL endpoint. You get asset operations (import, duplicate, rename), actor spawning and transforms, PIE session control, Sequencer timeline manipulation, and Niagara particle authoring. The plugin runs inside UE's editor process on port 8091 by default, handling Blueprint graphs, animation state machines, level streaming, and console command execution with safety blocks. Ships as an npm package that talks to the C++ bridge you drop into your project's Plugins folder. Aimed at developers automating repetitive editor tasks or prototyping game logic conversationally instead of clicking through menus. Supports UE 5.0 through 5.7 with graceful degradation when the editor isn't running.
Install to Claude Code
verifiedclaude mcp add unreal-engine-mcp --env LOG_LEVEL=YOUR_LOG_LEVEL --env MCP_ROUTE_STDOUT_LOGS=YOUR_MCP_ROUTE_STDOUT_LOGS --env UE_PROJECT_PATH=YOUR_UE_PROJECT_PATH --env UE_EDITOR_EXE=YOUR_UE_EDITOR_EXE --env UE_SCREENSHOT_DIR=YOUR_UE_SCREENSHOT_DIR --env MCP_AUTOMATION_PORT=YOUR_MCP_AUTOMATION_PORT --env MCP_AUTOMATION_HOST=YOUR_MCP_AUTOMATION_HOST --env MCP_AUTOMATION_ALLOW_NON_LOOPBACK=YOUR_MCP_AUTOMATION_ALLOW_NON_LOOPBACK --env MCP_AUTOMATION_CLIENT_MODE=YOUR_MCP_AUTOMATION_CLIENT_MODE --env MCP_AUTOMATION_USE_TLS=YOUR_MCP_AUTOMATION_USE_TLS --env MCP_CONNECTION_TIMEOUT_MS=YOUR_MCP_CONNECTION_TIMEOUT_MS --env MCP_REQUEST_TIMEOUT_MS=YOUR_MCP_REQUEST_TIMEOUT_MS --env MCP_AUTOMATION_MAX_MESSAGES_PER_MINUTE=YOUR_MCP_AUTOMATION_MAX_MESSAGES_PER_MINUTE --env MCP_AUTOMATION_MAX_AUTOMATION_REQUESTS_PER_MINUTE=YOUR_MCP_AUTOMATION_MAX_AUTOMATION_REQUESTS_PER_MINUTE -- npx -y unreal-engine-mcp-serverRun in your terminal. Replace YOUR_* placeholders with real values; add --scope user to install for every project.
Review the command, arguments, and environment values before installing — MCP servers run with your local permissions.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Tools
Verified live against the running server on Jun 10, 2026.
verified live23 tools
manage_toolsDynamic MCP tool management. List canonical tools, view category counts, and enable/disable tools or categories at runtime. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: tools, category, params.4 params
Dynamic MCP tool management. List canonical tools, view category counts, and enable/disable tools or categories at runtime. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: tools, category, params.
Parameters* required
action*stringlist_tools: show canonical tools with status. list_categories: show category counts. enable/disable_tools: toggle specific tools. enable/disable_category: toggle category. get_status: current state...one of
list_tools · list_categories · enable_tools · disable_tools · enable_category · disable_categorycategorystringCategory name to enable/disable (core, world, gameplay, utility, all)
paramsobjectOptional action-specific parameters. These are merged with top-level arguments before routing for clients that cannot send arbitrary top-level fields.
toolsarrayTool names to enable/disable
manage_assetCreate/import/manage assets, material graphs, material instances, procedural textures, render targets, and dependency analysis. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: assetPath, directory, classNames, pa...123 params
Create/import/manage assets, material graphs, material instances, procedural textures, render targets, and dependency analysis. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: assetPath, directory, classNames, pa...
Parameters* required
action*stringAction to performone of
list · import · duplicate · duplicate_asset · rename · rename_assetadditionalOutputsarrayamountnumberassetPathstringAsset path (e.g., /Game/Path/Asset).
assetPathsarraybaseTexturestringTexture asset path.
blendModestringblendTexturestringTexture asset path.
blendTypestringblueTexturestringTexture asset path.
channelstringcheckoutFilesbooleanclassNamesarraycodestringcompressionSettingsstringconstAnumberconstBnumbercoordinateIndexnumbercurvePointsarraydefaultValuevalueGeneric value (any type).
+103 more parameters. See the server's own documentation for the full schema.
manage_blueprintCreate Blueprints and UMG widgets, add SCS/UI components, set defaults, and manipulate Blueprint graphs, bindings, and widget layouts. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, blueprintPath, blueprin...147 params
Create Blueprints and UMG widgets, add SCS/UI components, set defaults, and manipulate Blueprint graphs, bindings, and widget layouts. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, blueprintPath, blueprin...
Parameters* required
action*stringBlueprint actionone of
create · create_blueprint · get_blueprint · get · compile · add_componentactionPathstringAsset path (e.g., /Game/Path/Asset).
alignmentobjectWidget alignment (0-1).
alwaysShowScrollbarbooleanAlways show scrollbar.
anchorMaxobjectMaximum anchor point (0-1).
anchorMinobjectMinimum anchor point (0-1).
anglenumberAngle in degrees.
animationNamestringAnimation name.
applyAndSavebooleanattachTostringautoWrapbooleanEnable text auto-wrap.
bindingSourcestringVariable or function name to bind to.
blueprintPathstringBlueprint asset path.
blueprintTypestringPath or name of the parent class.
brushColorobjectBorder brush color.
brushSizeobjectBrush/image size.
categorystringclippingstringWidget clipping mode.one of
Inherit · ClipToBounds · ClipToBoundsWithoutIntersecting · ClipToBoundsAlways · OnDemandcolorAndOpacityobjectColor and opacity (0-1 values).
columnCountnumberNumber of columns.
+127 more parameters. See the server's own documentation for the full schema.
control_actorSpawn actors, set transforms, enable physics, add components, manage tags, and attach actors. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: actorName, childActor, parentActor, classPath, meshPath, materialPath,...36 params
Spawn actors, set transforms, enable physics, add components, manage tags, and attach actors. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: actorName, childActor, parentActor, classPath, meshPath, materialPath,...
Parameters* required
action*stringActionone of
spawn · spawn_actor · spawn_blueprint · delete · destroy_actor · delete_by_tagactorClassstringactorNamestringName of the actor.
actorNamesarrayallComponentsbooleanargumentsvalueGeneric value (any type).
blueprintPathstringBlueprint asset path.
childActorstringName of the child actor (for attach/detach operations).
classNamestringclassPathstringAsset path (e.g., /Game/Path/Asset).
collisionEnabledbooleancomponentNamestringName of the component.
componentTypestringfilterstringforceobject3D vector.
functionNamestringName of the function.
limitnumberlocationobject3D location (x, y, z).
materialIndexintegermaterialPathstringMaterial asset path.
+16 more parameters. See the server's own documentation for the full schema.
control_editorStart/stop PIE, control viewport camera, run console commands, take screenshots, simulate input. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: location, rotation, viewMode, enabled, speed, filename, fov, width,...39 params
Start/stop PIE, control viewport camera, run console commands, take screenshots, simulate input. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: location, rotation, viewMode, enabled, speed, filename, fov, width,...
Parameters* required
action*stringEditor actionone of
play · stop · stop_pie · pause · resume · ejectactorNamestringName of the actor.
assetPathstringAsset path (e.g., /Game/Path/Asset).
blendTimenumberbookmarkNamestringbuttonstringcategorystringcommandstringdeltaTimenumberenabledbooleanWhether the item/feature is enabled.
filenamestringfovnumberheightnumberidstringincludeMetadatabooleaninputActionstringinputTypestringkeystringlevelPathstringLevel asset path.
locationobject3D location (x, y, z).
+19 more parameters. See the server's own documentation for the full schema.
manage_levelLoad/save levels, configure streaming, and build lighting. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: levelPath, assetPath, levelPaths, levelName, path, savePath, destinationPath, overwrite, targetPath, expo...35 params
Load/save levels, configure streaming, and build lighting. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: levelPath, assetPath, levelPaths, levelName, path, savePath, destinationPath, overwrite, targetPath, expo...
Parameters* required
action*stringActionone of
load · load_level · save · save_level · save_as · save_level_asassetPathstringAsset path (e.g., /Game/Path/Asset).
colorarrayRGBA color as an array [r, g, b, a].
destinationPathstringDestination path for move/copy.
exportPathstringExport file path.
intensitynumberlevelNamestringlevelPathstringLevel asset path.
levelPathsarraylightTypestringLight type. Accepts short names (Point), class names (PointLight), or lowercase (point).one of
Directional · Point · Spot · Rect · DirectionalLight · PointLightlocationobject3D location (x, y, z).
metadataobjectnamestringName identifier.
newNamestringoverwritebooleanOverwrite if the asset/file already exists.
packagePathstringPath to a directory.
paramsobjectOptional action-specific parameters. These are merged with top-level arguments before routing for clients that cannot send arbitrary top-level fields.
parentLevelstringParent level path.
parentPathstringPath to a directory.
pathstringDirectory path for asset creation.
+15 more parameters. See the server's own documentation for the full schema.
build_environmentBuild environments: landscapes, foliage, procedural terrain/biomes, lighting setups, spline roads/rivers/fences, and world decoration. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, landscapeName, heightDa...118 params
Build environments: landscapes, foliage, procedural terrain/biomes, lighting setups, spline roads/rivers/fences, and world decoration. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, landscapeName, heightDa...
Parameters* required
action*stringActionone of
create_landscape · sculpt · sculpt_landscape · add_foliage · paint_foliage · create_procedural_terrainactorNamestringName of the actor.
actorPathstringalignToNormalbooleanalignToSplinebooleanamplitudenumberarriveTangentobject3D location (x, y, z).
assetPathsarrayassetsarrayazimuthnumberbClosedLoopbooleanblueprintPathstringBlueprint asset path.
boundsobjectcollisionEnabledbooleancompensationValuenumbercomponentCountobject2D vector.
componentNamestringName of the component.
countnumbercubemapPathstringAsset path (e.g., /Game/Path/Asset).
cullDistancenumber+98 more parameters. See the server's own documentation for the full schema.
animation_physicsAuthor animation and physics assets: Animation Blueprints, blend spaces, montages, Control Rig/IK, skeletons, sockets, physics assets, cloth, ragdolls, and vehicles. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action...112 params
Author animation and physics assets: Animation Blueprints, blend spaces, montages, Control Rig/IK, skeletons, sockets, physics assets, cloth, ragdolls, and vehicles. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action...
Parameters* required
action*stringActionone of
create_animation_blueprint · create_animation_bp · create_anim_blueprint · create_blend_space · create_blend_space_1d · create_blend_space_2dactorNamestringName of the actor.
additiveAnimTypestringangularDampingnumberanimationPathstringAsset path (e.g., /Game/Path/Asset).
artifactsarrayassetPathstringAsset path (e.g., /Game/Path/Asset).
assetsarrayassignToMeshbooleanattachBoneNamestringName of the bone.
axisstringaxisNamestringbasePoseFramenumberbasePoseTypestringblendTimenumberblendTypestringblueprintPathstringBlueprint asset path.
bodyAstringbodyBstringbodyTypestring+92 more parameters. See the server's own documentation for the full schema.
system_controlControl the project runtime: profiling, benchmarks, scalability/LOD/Nanite settings, CVars, console commands, Python scripts, UBT, tests, logs, and widgets. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: profile...59 params
Control the project runtime: profiling, benchmarks, scalability/LOD/Nanite settings, CVars, console commands, Python scripts, UBT, tests, logs, and widgets. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: profile...
Parameters* required
action*stringActionone of
profile · show_fps · set_quality · screenshot · set_resolution · set_fullscreenactorsarrayargumentsstringassetPathstringAsset path (e.g., /Game/Path/Asset).
boostPlayerLocationbooleancategorystringcategoryNamestringcellSizenumberchannelsstringchildClassstringcodestringPython code to execute inline
commandstringconfigurationstringdetailedbooleandurationnumberenableBatchingbooleanenableInstancingbooleanenabledbooleanWhether the item/feature is enabled.
filestringPath to .py file to execute
filenamestring+39 more parameters. See the server's own documentation for the full schema.
manage_sequenceEdit Level Sequences: add tracks, bind actors, set keyframes, control playback, and record camera. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, path, actorName, actorNames, frame, value, property, destin...31 params
Edit Level Sequences: add tracks, bind actors, set keyframes, control playback, and record camera. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, path, actorName, actorNames, frame, value, property, destin...
Parameters* required
action*stringActionone of
create · open · add_camera · add_actor · add_actors · remove_actorsactorNamestringName of the actor.
actorNamesarrayclassNamestringdestinationPathstringDestination path for move/copy.
endnumberendFramenumberframenumberframeRatestringlengthInFramesnumberlockedbooleanloopModestringmetadataobjectmutedbooleannamestringName identifier.
newNamestringNew name for renaming.
paramsobjectOptional action-specific parameters. These are merged with top-level arguments before routing for clients that cannot send arbitrary top-level fields.
pathstringAsset path (e.g., /Game/Path/Asset).
playbackEndnumberplaybackStartnumber+11 more parameters. See the server's own documentation for the full schema.
inspectInspect any UObject: read/write properties, list components, export snapshots, and query class info. Actions: inspect_cdo (Blueprint CDO properties + all components without spawning an actor; use blueprintPath, optional detailed/componentName/propertyNames), inspect_class (cla...18 params
Inspect any UObject: read/write properties, list components, export snapshots, and query class info. Actions: inspect_cdo (Blueprint CDO properties + all components without spawning an actor; use blueprintPath, optional detailed/componentName/propertyNames), inspect_class (cla...
Parameters* required
action*stringActionone of
inspect_object · get_actor_details · get_blueprint_details · get_mesh_details · get_texture_details · get_material_detailsactorNamestringName of the actor.
blueprintPathstringBlueprint asset path.
classNamestringclassPathstringAsset path (e.g., /Game/Path/Asset).
componentNamestringName of the component.
componentNamesarraydetailedbooleanfilterstringnamestringName identifier.
objectPathstringAsset path (e.g., /Game/Path/Asset).
paramsobjectOptional action-specific parameters. These are merged with top-level arguments before routing for clients that cannot send arbitrary top-level fields.
propertyNamestringName of the property.
propertyNamesarraypropertyPathstringsnapshotNamestringtagstringName of the tag.
valuevalueGeneric value (any type).
manage_audioPlay/stop sounds, add audio components, configure mixes, attenuation, spatial audio, and author Sound Cues/MetaSounds. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, soundPath, location, rotation, volume,...69 params
Play/stop sounds, add audio components, configure mixes, attenuation, spatial audio, and author Sound Cues/MetaSounds. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, soundPath, location, rotation, volume,...
Parameters* required
action*stringActionone of
create_sound_cue · play_sound_at_location · play_sound_2d · create_audio_component · create_sound_mix · push_sound_mixactorNamestringName of the actor.
analysisTypestringassetPathstringAsset path (e.g., /Game/Path/Asset).
attachPointNamestringName of the socket.
attenuationPathstringAsset path (e.g., /Game/Path/Asset).
attenuationShapestringcomponentNamestringName of the component.
concurrencyPathstringAsset path (e.g., /Game/Path/Asset).
defaultValuevalueGeneric value (any type).
dopplerIntensitynumbereffectTypestringenablebooleanenableReverbSendbooleanenabledbooleanWhether the item/feature is enabled.
fadeInTimenumberfadeOutTimenumberfadeTimenumberfadeTypestringfalloffDistancenumber+49 more parameters. See the server's own documentation for the full schema.
manage_geometryCreate procedural meshes using Geometry Script: booleans, deformers, UVs, collision, and LOD generation. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: outputPath, assetPath, name, path, actorName, width, height...74 params
Create procedural meshes using Geometry Script: booleans, deformers, UVs, collision, and LOD generation. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: outputPath, assetPath, name, path, actorName, width, height...
Parameters* required
action*stringGeometry action to performone of
create_box · create_sphere · create_cylinder · create_cone · create_capsule · create_torusactorNamestringName of the actor.
amountnumberGeneric amount for operations (bevel size, inset distance, etc.).
anglenumberAngle in degrees.
assetPathstringAsset path (e.g., /Game/Path/Asset).
axisstringAxis for deformation operations.one of
X · Y · Zcapbooleancenterobject3D location (x, y, z).
collisionTypestringCollision complexity type.one of
Default · Simple · Complex · UseComplexAsSimple · UseSimpleAsComplexcomputeWeightedNormalsbooleanUse area-weighted normals.
countnumberdepthnumberDepth value.
depthSegmentsnumberSegments along depth.
dimensionsobject3D dimensions (width, height, depth).
distancenumberDistance value.
hardEdgeAnglenumberAngle threshold for hard edges (degrees).
heightnumberHeight value.
heightScalenumberTexture displacement height scale.
heightSegmentsnumberSegments along height.
hullCountnumberNumber of convex hulls for decomposition.
+54 more parameters. See the server's own documentation for the full schema.
manage_pcgCreate, edit, execute, and configure PCG graphs: graph assets, input/sampler/filter/spawner nodes, pin connections, node settings, and partition grid size. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: graphPat...39 params
Create, edit, execute, and configure PCG graphs: graph assets, input/sampler/filter/spawner nodes, pin connections, node settings, and partition grid size. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: graphPat...
Parameters* required
action*stringPCG graph action to performone of
create_pcg_graph · create_pcg_subgraph · add_pcg_node · connect_pcg_pins · set_pcg_node_settings · add_landscape_data_nodeactorClassstringactorNamestringName of the actor.
assetPathstringAsset path (e.g., /Game/Path/Asset).
classPathstringcomponentNamestringName of the component.
componentPathstringComponent path/name for PCG execution.
createComponentbooleanforcebooleangraphPathstringPCG graph asset path (e.g., /Game/PCG/PCG_MyGraph).
gridSizenumberinputNamestringName of the pin.
meshPathstringMesh asset path.
namestringName identifier.
nodeIdstringID of the node.
nodeNamestringName of the node.
nodeTypestringPCG node type alias or UPCGSettings class path/name.
outputNamestringName of the pin.
overwritebooleanOverwrite if the asset/file already exists.
paramsobjectOptional action-specific parameters. These are merged with top-level arguments before routing for clients that cannot send arbitrary top-level fields.
+19 more parameters. See the server's own documentation for the full schema.
manage_effectNiagara particle systems, VFX, debug shapes, and GPU simulations. Create systems, emitters, modules, and control particle effects. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, path, savePath, assetPath,...77 params
Niagara particle systems, VFX, debug shapes, and GPU simulations. Create systems, emitters, modules, and control particle effects. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, path, savePath, assetPath,...
Parameters* required
accelerationobject3D location (x, y, z).
action*stringEffect/Niagara action to perform.one of
particle · niagara · debug_shape · spawn_niagara · create_dynamic_light · create_niagara_systemactorNamestringName of the actor.
alignmentstringassetPathstringAsset path (e.g., /Game/Path/Asset).
attachToActorstringName of the actor.
autoConnectbooleanburstCountnumberburstTimenumbercameraOffsetnumbercollisionModestringcolorvalueRGBA color as an array [r,g,b,a] or object {r,g,b,a} depending on action.
colorModestringdeltaTimenumberdensitynumberdeterministicEnabledbooleandieOnCollisionbooleandurationnumberemitterstringemitterNamestring+57 more parameters. See the server's own documentation for the full schema.
manage_gasCreate Gameplay Abilities, Effects, Attribute Sets, and Gameplay Cues for ability systems. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, path, assetPath, blueprintPath, replicationMode, attributeSetPath,...59 params
Create Gameplay Abilities, Effects, Attribute Sets, and Gameplay Cues for ability systems. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, path, assetPath, blueprintPath, replicationMode, attributeSetPath,...
Parameters* required
abilityPathstringPath to ability asset.
abilityTagsarrayGameplay tags for this ability.
action*stringGAS action to perform.one of
add_ability_system_component · configure_asc · create_attribute_set · add_attribute · set_attribute_base_value · set_attribute_clampingactivationBlockedTagsarrayTags that block activation of this ability.
activationPolicystringWhen the ability activates.one of
OnInputPressed · WhileInputActive · OnSpawn · OnGivenactivationRequiredTagsarrayTags required to activate this ability.
aoeRadiusnumberArea of effect radius.
applicationRequiredTagsarrayTags required to apply this effect.
assetPathstringAsset path (e.g., /Game/Path/Asset).
attributeNamestringName of the attribute.
attributeSetPathstringPath to Attribute Set asset.
attributeTypestringPredefined attribute type or Custom.one of
Health · MaxHealth · Mana · MaxMana · Stamina · MaxStaminabaseValuenumberBase value for attribute.
blockAbilitiesWithTagarrayTags of abilities blocked while this is active.
blueprintPathstringBlueprint asset path.
calculationClassstringUGameplayEffectExecutionCalculation class path.
cameraShakePathstringPath to camera shake asset.
cancelAbilitiesWithTagarrayTags of abilities to cancel when this activates.
clampModestringAttribute clamping mode.one of
None · Min · Max · MinMaxcomponentNamestringName of the component.
+39 more parameters. See the server's own documentation for the full schema.
manage_characterCreate Character Blueprints with movement, locomotion, and animation state machines. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, path, blueprintPath, parentClass, skeletalMeshPath, animBlueprintPath, ca...67 params
Create Character Blueprints with movement, locomotion, and animation state machines. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, path, blueprintPath, parentClass, skeletalMeshPath, animBlueprintPath, ca...
Parameters* required
accelerationnumberaction*stringCharacter action to perform.one of
create_character_blueprint · configure_capsule_component · configure_mesh_component · configure_camera_component · configure_movement_speeds · configure_jumpairControlnumberanimBlueprintPathstringPath to animation blueprint.
avoidanceEnabledbooleanEnable AI avoidance.
blueprintPathstringBlueprint asset path.
brakingDecelerationnumbercameraUsePawnControlRotationbooleanCamera follows controller rotation.
canCrouchbooleancapsuleHalfHeightnumbercapsuleRadiusnumberclimbSpeednumberclimbableTagstringTag for climbable surfaces.
crouchSpeednumbercrouchedHalfHeightnumbercustomSpeednumberdecelerationnumberfallingLateralFrictionnumberAir friction.
flySpeednumberfootstepEnabledbooleanEnable footstep system.
+47 more parameters. See the server's own documentation for the full schema.
manage_combatCreate weapons with hitscan/projectile firing, configure damage types, hitboxes, reload, and melee combat (combos, parry, block). Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: blueprintPath, name, path, weaponM...96 params
Create weapons with hitscan/projectile firing, configure damage types, hitboxes, reload, and melee combat (combos, parry, block). Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: blueprintPath, name, path, weaponM...
Parameters* required
action*stringCombat action to performone of
create_weapon_blueprint · configure_weapon_mesh · configure_weapon_sockets · set_weapon_stats · configure_hitscan · configure_projectileadsEnabledbooleanEnable aim down sights.
adsFovnumberFOV when aiming.
adsSpeednumberTime to aim down sights.
adsSpreadMultipliernumberSpread multiplier when aiming.
ammoPerShotnumberammoTypestringAmmo type identifier.
armorValuenumberattachmentSlotsarrayAttachment slot definitions.
baseDamagenumberblockDamageReductionnumberDamage reduction when blocking (0-1).
blockStaminaCostnumberStamina cost per blocked hit.
blueprintPathstringBlueprint asset path.
bounceEnabledbooleanEnable projectile bouncing.
bounceVelocityRationumberVelocity retained on bounce (0-1).
collisionRadiusnumbercomboWindowTimenumberTime window for combo input.
criticalMultipliernumberCritical hit damage multiplier.
damageAmountnumberdamageImpulsenumberImpulse applied on hit.
+76 more parameters. See the server's own documentation for the full schema.
manage_aiBuild AI systems: AI controllers, Behavior Trees, Blackboards, EQS, perception, State Trees, Smart Objects, NavMesh settings, nav modifiers, links, and pathfinding. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action:...94 params
Build AI systems: AI controllers, Behavior Trees, Blackboards, EQS, perception, State Trees, Smart Objects, NavMesh settings, nav modifiers, links, and pathfinding. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action:...
Parameters* required
action*stringAI action to performone of
create_ai_controller · assign_behavior_tree · assign_blackboard · create_blackboard_asset · add_blackboard_key · set_key_instance_syncedactorNamestringName of the actor.
agentHeightnumberNavigation agent height (default: 144).
agentMaxSlopenumberMaximum slope angle in degrees (default: 44).
agentRadiusnumberNavigation agent radius (default: 35).
agentStepHeightnumberMaximum step height agent can climb (default: 35).
areaClassstringNavigation area class path.
areaCostnumberPathfinding cost multiplier for area (1.0 = normal).
assetPathstringAsset path (e.g., /Game/Path/Asset).
bCreateBoxObstaclebooleanAdd box obstacle during nav generation.
baseObjectClassstringbehaviorTreePathstringPath to behavior tree asset.
blackboardPathstringPath to blackboard asset.
blueprintPathstringBlueprint asset path.
broadcastIntervalnumberInterval for state change broadcast (0 = single).
broadcastRadiusnumberRadius for state change broadcast.
cellHeightnumberNavMesh cell height (default: 10).
cellSizenumberNavMesh cell size (default: 19).
childNodeIdstringID of the node.
commentstring+74 more parameters. See the server's own documentation for the full schema.
manage_inventoryCreate item data assets, inventory components, world pickups, loot tables, and crafting recipes. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, path, save, blueprintPath, itemPath, iconPath, maxStackSize,...57 params
Create item data assets, inventory components, world pickups, loot tables, and crafting recipes. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, path, save, blueprintPath, itemPath, iconPath, maxStackSize,...
Parameters* required
abilityGrantsbooleanEnable ability grant support when equipped.
action*stringInventory action to perform.one of
create_item_data_asset · set_item_properties · create_item_category · assign_item_category · create_inventory_component · configure_inventory_slotsactorPathstringPath to actor Blueprint for loot drop.
attachToSocketbooleanAttach mesh to socket when equipped.
blueprintPathstringBlueprint asset path.
bobbingbooleanEnable bobbing animation.
categoryPathstringPath to item category asset.
componentNamestringName of the component.
craftTimenumberTime in seconds to craft.
craftingSpeedMultipliernumberdefaultSocketstringName of the socket.
dropCountnumberNumber of drops to roll.
dropOnDeathbooleandropRadiusnumberRadius for scattered drops.
enableWeightbooleanencumberanceSystembooleanencumberanceThresholdnumberentryIndexnumberglowEffectbooleanEnable glow effect.
iconPathstringPath to icon texture.
+37 more parameters. See the server's own documentation for the full schema.
manage_interactionCreate interactive objects: doors, switches, chests, levers. Set up destructible meshes and trigger volumes. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, folder, blueprintPath, actorName, componentName,...29 params
Create interactive objects: doors, switches, chests, levers. Set up destructible meshes and trigger volumes. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by action: name, folder, blueprintPath, actorName, componentName,...
Parameters* required
action*stringThe interaction action to perform.one of
create_interaction_component · configure_interaction_trace · configure_interaction_widget · add_interaction_events · create_interactable_interface · create_door_actoractorNamestringName of the actor.
autoClosebooleanAutomatically close after opening.
autoCloseDelaynumberDelay before auto-close in seconds.
blueprintPathstringBlueprint asset path.
canTogglebooleanchestPathstringPath to chest actor blueprint.
componentNamestringName of the component.
doorPathstringPath to door actor blueprint.
folderstringPath to a directory.
lockedbooleanWhether the item is locked.
lootTablePathstringPath to loot table asset.
namestringName identifier.
openAnglenumberDoor open rotation angle in degrees.
openTimenumberTime to open/close door in seconds.
paramsobjectOptional action-specific parameters. These are merged with top-level arguments before routing for clients that cannot send arbitrary top-level fields.
promptTextFormatstringFormat string for prompt (e.g., "Press {Key} to {Action}").
requiresKeybooleanWhether interaction requires a key item.
resetTimenumberTime to reset switch in seconds.
showOnHoverbooleanShow widget when hovering.
+9 more parameters. See the server's own documentation for the full schema.
manage_networkingConfigure multiplayer and player flow: replication, RPCs, authority/relevancy, network prediction, sessions, split-screen, LAN/voice chat, game framework classes, match rules, and input mappings. Required: action. Select one enum value, then provide only parameters relevant to...127 params
Configure multiplayer and player flow: replication, RPCs, authority/relevancy, network prediction, sessions, split-screen, LAN/voice chat, game framework classes, match rules, and input mappings. Required: action. Select one enum value, then provide only parameters relevant to...
Parameters* required
action*stringNetworking action to performone of
set_property_replicated · set_replication_condition · configure_net_update_frequency · configure_net_priority · set_net_dormancy · configure_replication_graphactionNamestringLegacy input action mapping name.
actionPathstringAsset path (e.g., /Game/Path/Asset).
actorNamestringName of the actor.
allowSpectatingbooleanAllow spectator mode.
altbooleanRequire Alt for a legacy action mapping.
alwaysRelevantbooleanAlways relevant to all clients.
assetPathstringAsset path (e.g., /Game/Path/Asset).
attenuationFalloffnumberFalloff rate for voice attenuation.
attenuationRadiusnumberRadius for voice attenuation (Proximity chat). REQUIRED for set_voice_attenuation.
autoBalancebooleanEnable automatic team balancing.
axisNamestringLegacy input axis mapping name.
bAllowInvitesbooleanAllow player invites.
bAllowJoinInProgressbooleanAllow joining games in progress.
bDelayedStartbooleanWhether to delay match start.
bIsLANMatchbooleanWhether this is a LAN match.
bShouldAdvertisebooleanAdvertise session publicly.
bUseLobbiesIfAvailablebooleanUse lobby system if available.
bUsesPresencebooleanUse presence for session discovery.
blueprintPathstringBlueprint asset path.
+107 more parameters. See the server's own documentation for the full schema.
manage_level_structureStructure worlds: levels, sublevels, World Partition, streaming, data layers, HLOD, level instances, trigger/blocking/physics/audio/post-process volumes, and nav bounds. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by ac...79 params
Structure worlds: levels, sublevels, World Partition, streaming, data layers, HLOD, level instances, trigger/blocking/physics/audio/post-process volumes, and nav bounds. Required: action. Select one enum value, then provide only parameters relevant to that action. Params by ac...
Parameters* required
action*stringLevel structure action to perform.one of
create_level · create_sublevel · configure_level_streaming · set_streaming_distance · configure_level_bounds · enable_world_partitionactorNamestringName of the actor.
actorPathstringPath to actor.
bAutoCalculateBoundsbooleanAuto-calculate bounds from content.
bBlockOnSlowStreamingbooleanbCreateWorldPartitionbooleanCreate with World Partition enabled.
bDisableDistanceStreamingbooleanDisable distance-based streaming.
bEnableWorldPartitionbooleanEnable World Partition for level.
bEnabledbooleanWhether the audio volume is enabled.
bIsInitiallyLoadedbooleanData layer initially loaded.
bIsInitiallyVisiblebooleanData layer initially visible.
bIsSpatiallyLoadedbooleanHLOD is spatially loaded.
bPackBlueprintsbooleanInclude blueprints in packed level.
bPackStaticMeshesbooleanInclude static meshes in packed level.
bPainCausingbooleanWhether the volume causes pain/damage.
bShouldBeVisiblebooleanLevel should be visible when loaded.
bShouldBlockOnLoadbooleanBlock game until level is loaded.
bUnboundbooleanWhether post process volume affects entire world.
bUseExternalActorsbooleanEnable One File Per Actor (OFPA/External Actors) for Data Layer compatibility. Automatically enabled when bCreateWorldPartition is true.
bWaterVolumebooleanWhether this is a water volume.
+59 more parameters. See the server's own documentation for the full schema.
Unreal Engine MCP Server
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal Engine through a native C++ Automation Bridge plugin. Built with TypeScript and C++.
Table of Contents
- Features
- Getting Started
- Configuration
- Available Tools
- Docker
- Documentation
- Community
- Development
- Contributing
Features
| Category | Capabilities |
|---|---|
| Asset Management | Browse, import, duplicate, rename, delete assets; create materials |
| Actor Control | Spawn, delete, transform, physics, tags, components |
| Editor Control | PIE sessions, camera, viewport, screenshots, bookmarks |
| Level Management | Load/save levels, streaming, lighting |
| Animation & Physics | Animation BPs, state machines, ragdolls, vehicles, constraints |
| Visual Effects | Niagara particles, GPU simulations, procedural effects, debug shapes |
| Sequencer | Cinematics, timeline control, Movie Render Queue, media, Take Recorder, replay |
| Graph Editing | Blueprint, Niagara, Material, and Behavior Tree graph manipulation |
| Audio | Sound cues, audio components, sound mixes, ambient sounds |
| System | Console commands, UBT, tests, logs, project settings, CVars |
Architecture
- Native C++ Automation — All operations route through the MCP Automation Bridge plugin
- Dual Transport — Native HTTP/SSE (no bridge needed) or WebSocket via TypeScript bridge
- Dynamic Type Discovery — Runtime introspection for lights, debug shapes, and sequencer tracks
- Graceful Degradation — Server starts even without an active Unreal connection
- On-Demand Connection — Retries automation handshakes with exponential backoff
- Command Safety — Blocks dangerous console commands with pattern-based validation
- Capability Token Auth — On-by-default token authentication (auto-generated 32-byte secret at
<Project>/Saved/MCP/capability-token) for both WS and HTTP transports; manualCapabilityTokenin Project Settings overrides the file - Asset Caching — 10-second TTL for improved performance
- Metrics Rate Limiting — Per-IP rate limiting (60 req/min) on Prometheus endpoint
- Centralized Configuration — Unified class aliases and type definitions
Getting Started
Prerequisites
- Node.js 20.19 or later (Node.js 18 is not supported) — required for the TypeScript stdio bridge. Not needed for the native MCP transport.
Step 1: Install MCP Server (Option B only — skip for Native MCP)
Skip this step if using Option A: Native MCP Transport (Step 4A below).
NPX (Recommended):
npx unreal-engine-mcp-server
Clone & Build:
git clone https://github.com/ChiR24/Unreal_mcp.git
cd Unreal_mcp
npm install
npm run build
node dist/cli.js
Step 2: Install Unreal Plugin
The MCP Automation Bridge plugin is included at Unreal_mcp/plugins/McpAutomationBridge.
From source (requires a project with code target)
Your project must have a code target (.sln or .xcworkspace).
Blueprint-only projects cannot compile native plugins — to convert, add any class via Tools > New C++ Class in the editor.
Method 1: Copy Folder
Copy: Unreal_mcp/plugins/McpAutomationBridge/
To: YourUnrealProject/Plugins/McpAutomationBridge/
Method 2: External Plugin Directory (no copy needed)
- Open Unreal Editor → Edit → Plugins
- Click Plugin Directories (bottom-left)
- In Additional Plugin Directories, add the path to
Unreal_mcp/plugins/ - Restart the editor — the plugin will be picked up from the external location
This saves the path in your .uproject file so the plugin stays linked without copying.
The plugin compiles automatically when you open the project — UE detects the .uplugin + Source/ and runs UnrealBuildTool.
Video Guide:
https://github.com/user-attachments/assets/d8b86ebc-4364-48c9-9781-de854bf3ef7d
⚠️ First-Time Project Open: UE may prompt "Would you like to rebuild them now?" — click Yes. If instead you see "Missing Modules — McpAutomationBridge. Engine modules cannot be compiled at runtime. Please build through your IDE." — open your project in Visual Studio (Win) or Xcode (Mac) and build from there. After that, the editor will open normally with the plugin loaded.
Pre-built (works with any project, including Blueprint-only)
Build the plugin once, then distribute the compiled binaries — no IDE or compilation needed on the target machine.
1. Build:
# macOS / Linux
./scripts/package-plugin.sh /path/to/UE_5.6
# Windows
scripts\package-plugin.bat C:\Path\To\UE_5.6
This produces a zip like McpAutomationBridge-v0.5.30-UE5.7-Linux.zip.
2. Install: unzip into YourProject/Plugins/ and open the project. That's it — no compilation step.
Note: pre-built binaries are tied to a specific UE version. A build for 5.6 won't work with 5.5, 5.7, or 5.8.
Step 3: Enable Required Plugins
Enable via Edit → Plugins, then restart the editor.
Core Plugins (Required)
| Plugin | Required For |
|---|---|
| MCP Automation Bridge | All automation operations |
| Python Editor Script Plugin | Python-backed editor automation helpers |
| Editor Scripting Utilities | Asset/Actor subsystem operations |
| Niagara | Visual effects and particle systems |
| Gameplay Abilities | manage_gas operations |
| Smart Objects | AI smart object operations |
Optional Plugins (Auto-enabled)
| Plugin | Required For |
|---|---|
| Level Sequence Editor | manage_sequence operations |
| Movie Render Pipeline | manage_sequence Movie Render Queue operations |
| Movie Pipeline Mask Render Pass | Object-ID render pass |
| Takes | manage_sequence Take Recorder operations |
| Electra Player | manage_sequence file-backed media playback |
| Control Rig | animation_physics operations |
| GeometryScripting | manage_geometry operations |
| Behavior Tree Editor | manage_ai Behavior Tree operations |
| Niagara Editor | Niagara authoring |
| Environment Query Editor | AI/EQS operations |
| MetaSound | manage_audio MetaSound authoring |
| StateTree | manage_ai State Tree operations |
| Enhanced Input | manage_networking input mapping operations |
| Chaos Cloth | Cloth simulation |
| Interchange | Asset import/export |
| Data Validation | Data validation |
| PCG | manage_pcg graph authoring and execution when enabled for the build |
| Procedural Mesh Component | Procedural geometry |
| OnlineSubsystem | Session/networking operations |
| OnlineSubsystemUtils | Session/networking operations |
💡 Optional plugins are auto-enabled by the MCP Automation Bridge plugin when needed. PCG support is compiled for source projects when the project explicitly enables PCG. Versioned release packages for UE 5.2+ include PCG support. All Unreal Engine versions from 5.0 to 5.8 are supported and working.
Step 4: Configure MCP Client
Option A: Native MCP Transport (Direct HTTP — no bridge needed)
The plugin includes a built-in MCP Streamable HTTP server. AI clients connect directly to the plugin over HTTP — no TypeScript bridge, no Node.js, no npm.
Note: the bAllowNonLoopback setting now applies to both the WebSocket bridge and the native MCP transport. Enabling it binds both surfaces to non-loopback addresses. If you only need LAN access for the WebSocket bridge, do not enable bAllowNonLoopback and instead expose the bridge via a reverse proxy. Capability token auth is on by default (0.5.30+) — both transports require authentication automatically. A manually configured CapabilityToken in Project Settings or the auto-generated token at <Project>/Saved/MCP/capability-token is used automatically.
Enable in Unreal:
- Edit > Project Settings > Plugins > MCP Automation Bridge
- Check Enable Native MCP
- Set port (default:
3000) - Optionally set Native MCP Instructions for project-specific guidance
- Restart the editor
Configure your MCP client to use Streamable HTTP transport at:
http://localhost:3000/mcp
Claude Code:
claude mcp add unreal-engine --transport http http://localhost:3000/mcp
Or manually in ~/.claude/settings.json or project .mcp.json:
{
"mcpServers": {
"unreal-engine": {
"type": "url",
"url": "http://localhost:3000/mcp"
}
}
}
Cursor (.cursor/mcp.json):
{
"mcpServers": {
"unreal-engine": {
"url": "http://localhost:3000/mcp"
}
}
}
Verify it works:
- Status bar — look for
● MCP :3000 (2)in the bottom-right of the editor. Green dot = server running, number in parens = active sessions. Click it to open settings. - Output Log — filter by
LogMcpNativeTransportto see connections, tool calls, and session activity:LogMcpNativeTransport: Native MCP server started on http://localhost:3000/mcp LogMcpNativeTransport: MCP session initialized: ... (client: claude-code 2.1.92, active sessions: 1) LogMcpNativeTransport: tools/call: inspect (RequestId=...) LogMcpNativeTransport: tools/call completed: ... (tool=inspect, success=true)
Features:
- SSE streaming for real-time progress during long operations
- Multiple concurrent sessions (Cursor + Claude Code + others simultaneously)
- Dynamic tool management — core tools load by default, enable more via
manage_tools - Python execution via
execute_pythonaction (inline code or .py files) - Capability token authentication — on by default (auto-generated secret at
<Project>/Saved/MCP/capability-token; manualCapabilityTokenin Project Settings overrides)
Option B: TypeScript Bridge (stdio — classic setup)
Add to your Claude Desktop / Cursor config file:
Using Clone/Build:
{
"mcpServers": {
"unreal-engine": {
"command": "node",
"args": ["path/to/Unreal_mcp/dist/cli.js"],
"env": {
"UE_PROJECT_PATH": "C:/Path/To/YourProject",
"MCP_AUTOMATION_PORT": "8091"
}
}
}
}
Using NPX:
{
"mcpServers": {
"unreal-engine": {
"command": "npx",
"args": ["unreal-engine-mcp-server"],
"env": {
"UE_PROJECT_PATH": "C:/Path/To/YourProject"
}
}
}
}
Configuration
Environment Variables
# Required
UE_PROJECT_PATH="C:/Path/To/YourProject"
# Automation Bridge
MCP_AUTOMATION_HOST=127.0.0.1
MCP_AUTOMATION_PORT=8091
# LAN Access (optional)
# SECURITY: Set to true to allow binding to non-loopback addresses (e.g., 0.0.0.0)
# Only enable if you understand the security implications.
MCP_AUTOMATION_ALLOW_NON_LOOPBACK=false
# Logging
LOG_LEVEL=info # debug | info | warn | error
# Optional
MCP_CONNECTION_TIMEOUT_MS=5000
MCP_REQUEST_TIMEOUT_MS=120000
ASSET_LIST_TTL_MS=10000
# Optional Prometheus metrics endpoint
# Loopback-only by default. Non-loopback metrics requires both explicit opt-in and a token.
# MCP_METRICS_PORT=9100
# MCP_METRICS_HOST=127.0.0.1
# MCP_METRICS_ALLOW_NON_LOOPBACK=false
# MCP_METRICS_TOKEN=change-me
# Custom content mount points (comma-separated)
# Plugins with CanContainContent register mount points beyond /Game/.
# MCP_ADDITIONAL_PATH_PREFIXES=/ProjectObject/,/ProjectAnimation/
LAN Access Configuration
By default, the automation bridge only binds to loopback addresses (127.0.0.1) for security. To enable access from other machines on your network:
TypeScript (MCP Server):
MCP_AUTOMATION_ALLOW_NON_LOOPBACK=true
MCP_AUTOMATION_HOST=0.0.0.0
Unreal Engine Plugin:
- Go to Edit → Project Settings → Plugins → MCP Automation Bridge
- Under Security, enable "Allow Non Loopback"
- Under Connection, set "Listen Host" to
0.0.0.0 - Restart the editor
⚠️ Security Warning: Enabling LAN access exposes the automation bridge to your local network. Only use on trusted networks with appropriate firewall rules. Enable capability token authentication (Require Capability Token in project settings) to prevent unauthorized access when using LAN mode.
Available Tools
The MCP server exposes a single unreal gateway tool. The 23 canonical parent tools are internal and reachable exclusively through the gateway's four operations: search, describe, execute, and configure.
Gateway Workflow
search— discover available tools by keyword, category, or action namedescribe— get the exact contract (actions, parameters, schema) for a specific toolexecute— run one validated action on a canonical toolconfigure— manage internal tool enable/disable state (wrapsmanage_tools)
Example call:
{
"operation": "search",
"query": "asset"
}
Then:
{
"operation": "describe",
"tool": "manage_asset",
"action": "import_asset"
}
Then:
{
"operation": "execute",
"tool": "manage_asset",
"action": "import_asset",
"params": { "sourcePath": "/path/to/asset.fbx", "destinationPath": "/Game/Imported/asset" }
}
Migration from direct tool calls
The single unreal gateway is permanent on both transports; there is no opt-out and no legacy 23-tool listing to restore. A client that still calls a canonical tool name directly (tools/call with name: "manage_asset", name: "control_actor", etc.) receives a bounded, copy-paste-executable DIRECT_TOOL_CALL_REMOVED receipt instead of a routed call. The receipt carries a nextCall that drills exactly one level: { "operation": "search" } for an unknown name, { "operation": "describe", "tool": "<tool>" } when no action was supplied, or { "operation": "execute", "tool": "<tool>", "action": "<action>", "params": { ... } } when the direct call already named an action. Run that nextCall through the unreal tool to finish the migration.
Gateway Protocol & Transport
Both transports expose the same unreal gateway contract, but they are separate lifecycles. Do not route around their boundaries.
- TypeScript stdio transport —
node dist/cli.jstalks to the Unreal plugin over a WebSocket bridge. It permanently exposes the singleunrealgateway tool; there is no gateway-mode toggle. - Native MCP transport — the plugin's built-in Streamable HTTP/SSE server at
/mcp(no Node.js, no bridge). The native MCP surface permanently exposes the same singleunrealgateway tool; there is no gateway-mode toggle.
Both surfaces negotiate the MCP protocol version at initialize; the supported set is intentionally asymmetric. The native /mcp transport supports exactly the three modern versions 2025-11-25, 2025-06-18, and 2025-03-26, and deliberately does not implement the later 2026-07-28 RC. The TypeScript stdio server also accepts the two legacy versions 2024-11-05 and 2024-10-07, so the native surface is intentionally stricter. Both negotiate down to the highest mutually supported version (2025-11-25 is the latest). See docs/protocol.md for the full negotiation and transport contract, including the MCP-Protocol-Version header guard (HTTP 400 on invalid), cancellation semantics, and progressToken handling.
Internal Canonical Tools (23)
The gateway hides these 23 canonical parent tools. They are listed here for reference:
Core Tools
| Tool | Description |
|---|---|
manage_asset | Assets, Materials, Render Targets, Behavior Trees, Blueprint Struct (UserDefinedStruct) authoring |
manage_blueprint | Blueprints, SCS components, graph editing, UMG widgets, layout, bindings, animations |
control_actor | Spawn, delete, transform, physics, tags |
control_editor | PIE, Camera, viewport, screenshots |
manage_level | Load/save, streaming, lighting |
system_control | UBT, Tests, Logs, Project Settings, CVars, Python Execution |
inspect | Object Introspection |
manage_tools | Dynamic tool management (enable/disable at runtime) |
World Building
| Tool | Description |
|---|---|
build_environment | Landscapes, foliage, procedural terrain, lighting, spline roads/rivers/fences |
manage_level_structure | Levels, sublevels, World Partition, streaming, data layers, HLOD, volumes |
manage_geometry | Procedural mesh creation and editing with Geometry Script |
manage_pcg | PCG graph assets, subgraphs, input/sampler/filter/spawner nodes, pin connections, execution, partition grid size, and node settings |
Gameplay Systems
| Tool | Description |
|---|---|
animation_physics | Animation BPs, skeletons, sockets, physics assets, cloth, vehicles, ragdolls, Control Rig, IK |
manage_effect | Niagara, particles, debug shapes, GPU simulations |
manage_gas | Gameplay Ability System: abilities, effects, attributes |
manage_character | Character creation, movement, advanced locomotion |
manage_combat | Weapons, projectiles, damage, melee combat |
manage_ai | AI controllers, Behavior Trees, EQS, perception, State Trees, Smart Objects, NavMesh/pathfinding |
manage_inventory | Items, equipment, loot tables, crafting |
manage_interaction | Interactables, destructibles, triggers |
Utility
| Tool | Description |
|---|---|
manage_audio | Audio Assets, Components, Sound Cues, MetaSounds, Attenuation |
manage_sequence | Sequencer, cinematics, Movie Render Queue, media playback, Take Recorder, and replay controls |
manage_networking | Replication, RPCs, network prediction, sessions, split-screen, LAN/voice, game framework, input mappings |
Blueprints • Materials • Textures • Static Meshes • Skeletal Meshes • Levels • Sounds • Particles • Niagara Systems • Behavior Trees
Docker
docker build -t unreal-mcp .
docker run -it --rm -e UE_PROJECT_PATH=/project unreal-mcp
Documentation
| Document | Description |
|---|---|
| Handler Mappings | TypeScript to C++ routing |
| Plugin Extension | C++ plugin architecture |
| Testing Guide | How to run and write tests |
| Roadmap | Development roadmap |
Development
npm run build # Clean + compile TypeScript to dist/
npm run lint # Run ESLint 9 (fail on any warning)
npm run type-check # tsc --noEmit
npm run test:unit # Vitest unit tests (no Unreal required)
npm run test:smoke # Offline mock in-memory MCP check (needs built dist/)
npm run manifest:check # Fail if generated gateway manifest artifacts drift
npm run test:native-parity # TS vs native canonical tool/action equality
npm run test:params # Parity + strict parameter audit
npm run version:check # Assert all version sources agree
npm test # Integration suite (needs a live Unreal Editor + bridge)
Gateway manifest generation
The neutral gateway manifest is generated from src/tools/catalog/consolidated-tool-definitions.ts into three artifacts (runtime .ts/.json plus the native .h). Never hand-edit the generated files.
node --loader ts-node/esm scripts/generate-gateway-manifest.ts # regenerate
node --loader ts-node/esm scripts/generate-gateway-manifest.ts --check # CI gate: fail on drift
CI gates
CI runs, in order: ESLint 9 (npx eslint . --max-warnings=0), TypeScript type-check, unit tests, registry:check, normalization:check, manifest:check, policy:check, native parity + parameter audit (test:params), migration:check, primitives:check, security:check, eval:check, version:check, workflow:check, then a blocking runtime-only dependency audit (npm audit --omit=dev --audit-level=high) followed by an informational full-tree npm audit --audit-level=moderate. A plugin packaging job runs scripts/package-plugin.sh only when an Unreal Engine source root secret is provided (opt-in), because CI runners do not ship an engine. Release archives exclude Binaries/, Intermediate/, and Saved/ so generated build dirs never leak.
Community
| Resource | Description |
|---|---|
| Project Roadmap | Track roadmap progress and priorities |
| Discussions | Ask questions, share ideas, get help |
| Issues | Report bugs and request features |
Contributing
Contributions welcome! Please:
- Include reproduction steps for bugs
- Keep PRs focused and small
- Follow existing code style
License
MIT — See LICENSE
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Configuration
LOG_LEVELLogging level: debug, info, warn, error (default: info)
MCP_ROUTE_STDOUT_LOGSRoute standard output to standard error to avoid protocol corruption (default: true)
UE_PROJECT_PATHAbsolute path to your Unreal .uproject file
UE_EDITOR_EXEPath to UnrealEditor-Cmd.exe (optional)
UE_SCREENSHOT_DIRDirectory to save screenshots (optional)
MCP_AUTOMATION_PORTAutomation bridge WebSocket port (default: 8091)
MCP_AUTOMATION_HOSTAutomation bridge WebSocket host (default: 127.0.0.1). Set to 0.0.0.0 for LAN access (requires MCP_AUTOMATION_ALLOW_NON_LOOPBACK=true)
MCP_AUTOMATION_ALLOW_NON_LOOPBACKSECURITY: Allow binding to non-loopback addresses (e.g., 0.0.0.0) for LAN access. Only enable if you understand the security implications. (default: false)
MCP_AUTOMATION_CLIENT_MODERun as client connecting to UE (false) or server listening for UE (true) (default: false)
MCP_AUTOMATION_USE_TLSUse wss:// for the automation bridge client connection (default: false)
MCP_CONNECTION_TIMEOUT_MSConnection timeout in milliseconds (default: 5000)
MCP_REQUEST_TIMEOUT_MSRequest timeout in milliseconds (default: 30000)
MCP_AUTOMATION_MAX_MESSAGES_PER_MINUTEMax inbound automation bridge messages per minute before disconnect (default: 600)
MCP_AUTOMATION_MAX_AUTOMATION_REQUESTS_PER_MINUTEMax inbound automation request messages per minute before disconnect (default: 120)
Categories
Registryactive
Packageunreal-engine-mcp-server
TransportSTDIO
Resources6
Tools verifiedJun 10, 2026
UpdatedJun 5, 2026
