UnrealEngineMCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| UNREAL_ENGINE_MCP_HOST | No | Host address for the Unreal Engine MCP bridge. Defaults to 127.0.0.1. | 127.0.0.1 |
| UNREAL_ENGINE_MCP_PORT | No | Port for the Unreal Engine MCP bridge. Defaults to 55557. | 55557 |
| UNREAL_ENGINE_MCP_SECURITY_MODE | No | Security mode for the MCP server. Defaults to safe; advanced enables restricted script/console execution when explicitly configured. | safe |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
You are connected to Unreal Engine 5 through UnrealEngineMCP.
Required workflow for scene edits:
Inspect the current level and actors before changing content.
Prefer dedicated tools over arbitrary Python/console execution.
Make changes with clear actor/asset names.
Validate results (transforms, compilation, references).
Capture a screenshot when visual verification matters.
Report concrete engine results, never invent success.
Safe mode restricts destructive and script-execution tools. All engine operations run inside the Unreal Editor via the UnrealEngineMCP plugin.
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
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| unreal_pingC | Ping the Unreal Editor bridge. |
| unreal_get_statusC | Get bridge and editor connection status. |
| unreal_get_versionB | Get Unreal Engine and plugin version info. |
| unreal_get_project_infoC | Get current Unreal project information. |
| unreal_get_editor_statusC | Get editor play/pie and selection status. |
| unreal_get_current_levelC | Get the currently loaded level. |
| unreal_get_active_worldC | Get the active editor world. |
| unreal_get_selected_actorsC | List currently selected actors. |
| unreal_list_toolsC | List tools registered in the Unreal plugin. |
| unreal_get_logsC | Get recent UnrealEngineMCP plugin logs. |
| unreal_get_errorsC | Get recent engine/plugin errors. |
| unreal_spawn_actorC | Spawn an actor in the current level. |
| unreal_delete_actorC | Delete an actor by name or path. |
| unreal_duplicate_actorD | Duplicate an actor. |
| unreal_find_actorB | Find actors by name/label/class. |
| unreal_get_actor_detailsD | Get detailed actor information. |
| unreal_get_all_actorsC | List actors in the current world. |
| unreal_set_actor_transformC | Set actor location/rotation/scale. |
| unreal_get_actor_transformD | Get actor transform. |
| unreal_set_actor_locationD | Set actor location. |
| unreal_set_actor_rotationC | Set actor rotation. |
| unreal_set_actor_scaleD | Set actor scale. |
| unreal_rename_actorC | Rename an actor label. |
| unreal_set_actor_visibilityD | Set actor visibility. |
| unreal_set_actor_mobilityD | Set actor mobility. |
| unreal_attach_actorC | Attach an actor to another. |
| unreal_detach_actorC | Detach an actor from its parent. |
| unreal_add_componentD | Add a component to an actor. |
| unreal_remove_componentC | Remove a component from an actor. |
| unreal_get_actor_componentsC | List actor components. |
| unreal_create_levelC | Create a new level asset. |
| unreal_open_levelC | Open a level. |
| unreal_save_levelC | Save the current level. |
| unreal_get_levelsC | List levels in the project. |
| unreal_get_world_infoC | Get world and level info. |
| unreal_set_world_settingsD | Set supported world settings. |
| unreal_create_sublevelC | Create a streaming sublevel. |
| unreal_manage_level_visibilityC | Show/hide a streaming level. |
| unreal_list_level_actorsC | List actors for a level. |
| unreal_create_world_partition_infoC | Inspect world partition info when available. |
| unreal_create_blueprintC | Create a Blueprint asset. |
| unreal_get_blueprintC | Get Blueprint asset details. |
| unreal_compile_blueprintC | Compile a Blueprint and return diagnostics. |
| unreal_save_blueprintC | Save a Blueprint asset. |
| unreal_delete_blueprintC | Delete a Blueprint asset. |
| unreal_add_blueprint_variableD | Add a Blueprint variable. |
| unreal_remove_blueprint_variableC | Remove a Blueprint variable. |
| unreal_get_blueprint_variablesC | List Blueprint variables. |
| unreal_add_blueprint_functionC | Add a Blueprint function graph. |
| unreal_get_blueprint_functionsC | List Blueprint functions. |
| unreal_add_blueprint_eventC | Add a Blueprint event node. |
| unreal_get_blueprint_graphsC | List Blueprint graphs. |
| unreal_get_blueprint_nodesC | List nodes in a Blueprint graph. |
| unreal_create_blueprint_nodeC | Create a Blueprint node. |
| unreal_connect_blueprint_nodesC | Connect two Blueprint node pins. |
| unreal_disconnect_blueprint_nodesC | Disconnect Blueprint node pins. |
| unreal_set_blueprint_node_propertyC | Set a Blueprint node property. |
| unreal_delete_blueprint_nodeC | Delete a Blueprint node. |
| unreal_get_blueprint_node_detailsC | Get Blueprint node/pin details. |
| unreal_create_blueprint_macroC | Create a Blueprint macro graph. |
| unreal_add_blueprint_componentC | Add a component to a Blueprint SCS. |
| unreal_set_blueprint_parent_classD | Set Blueprint parent class. |
| unreal_list_assetsC | List assets under a content path. |
| unreal_search_assetsC | Search assets by name/class. |
| unreal_get_asset_infoC | Get asset metadata. |
| unreal_import_assetC | Import an external asset file. |
| unreal_reimport_assetD | Reimport an asset. |
| unreal_duplicate_assetC | Duplicate an asset. |
| unreal_rename_assetC | Rename an asset. |
| unreal_move_assetD | Move an asset. |
| unreal_delete_assetC | Delete an asset. |
| unreal_save_assetC | Save an asset. |
| unreal_get_asset_referencesD | Get asset referencers. |
| unreal_get_asset_dependenciesC | Get asset dependencies. |
| unreal_get_asset_thumbnailC | Export asset thumbnail path when available. |
| unreal_create_folderC | Create a content browser folder. |
| unreal_create_materialC | Create a material asset. |
| unreal_create_material_instanceC | Create a material instance. |
| unreal_get_materialD | Get material details. |
| unreal_get_material_parametersD | List material parameters. |
| unreal_set_material_parameterC | Set a material instance parameter. |
| unreal_add_material_expressionC | Add a material expression. |
| unreal_connect_material_nodesC | Connect material expressions. |
| unreal_disconnect_material_nodesC | Disconnect material expressions. |
| unreal_delete_material_expressionC | Delete a material expression. |
| unreal_compile_materialD | Compile a material. |
| unreal_save_materialC | Save a material asset. |
| unreal_assign_materialC | Assign a material to a mesh component. |
| unreal_create_directional_lightD | Create a directional light. |
| unreal_create_point_lightD | Create a point light. |
| unreal_create_spot_lightC | Create a spot light. |
| unreal_create_rect_lightC | Create a rect light. |
| unreal_create_sky_lightC | Create a sky light. |
| unreal_create_sky_atmosphereC | Create a sky atmosphere actor. |
| unreal_create_exponential_height_fogC | Create exponential height fog. |
| unreal_set_light_intensityD | Set light intensity. |
| unreal_set_light_colorC | Set light color. |
| unreal_set_light_temperatureC | Set light temperature. |
| unreal_set_shadow_settingsC | Set light shadow settings. |
| unreal_set_environment_settingsD | Set environment/fog/sky settings. |
| unreal_get_lighting_infoC | Get lighting actors info. |
| unreal_get_mesh_infoC | Get static mesh info. |
| unreal_create_static_meshC | Create a basic static mesh asset where supported. |
| unreal_get_mesh_boundsD | Get mesh bounds. |
| unreal_get_mesh_sectionsD | Get mesh sections. |
| unreal_get_mesh_materialsD | Get mesh materials. |
| unreal_set_mesh_materialC | Set a mesh material slot. |
| unreal_generate_collisionD | Generate mesh collision. |
| unreal_get_collision_infoD | Get mesh collision info. |
| unreal_set_mesh_lodC | Configure mesh LOD settings. |
| unreal_get_skeletal_mesh_infoD | Get skeletal mesh info. |
| unreal_get_skeleton_infoD | Get skeleton info. |
| unreal_get_bone_hierarchyD | Get bone hierarchy. |
| unreal_set_mesh_collisionC | Set mesh collision profile/settings. |
| unreal_list_animationsC | List animation sequences. |
| unreal_get_animation_infoC | Get animation sequence info. |
| unreal_create_animation_blueprintD | Create an Animation Blueprint. |
| unreal_get_animation_blueprintC | Get Animation Blueprint info. |
| unreal_create_animation_montageD | Create an animation montage. |
| unreal_set_animation_sequenceD | Set montage/sequence references. |
| unreal_get_animation_notifiesD | Get animation notifies. |
| unreal_add_animation_notifyD | Add an animation notify. |
| unreal_get_skeleton_assetsC | List skeleton assets. |
| unreal_get_animation_graphC | Inspect animation graph nodes. |
| unreal_list_niagara_systemsC | List Niagara systems. |
| unreal_get_niagara_infoD | Get Niagara system info. |
| unreal_create_niagara_systemC | Create a Niagara system asset. |
| unreal_spawn_niagara_systemC | Spawn a Niagara actor. |
| unreal_set_niagara_parameterD | Set a Niagara user parameter. |
| unreal_get_niagara_parametersD | Get Niagara parameters. |
| unreal_save_niagara_systemC | Save a Niagara system. |
| unreal_create_widget_blueprintC | Create a UMG Widget Blueprint. |
| unreal_get_widget_treeC | Get widget tree hierarchy. |
| unreal_add_widgetC | Add a widget to a Widget Blueprint. |
| unreal_remove_widgetD | Remove a widget. |
| unreal_set_widget_propertyD | Set a widget property. |
| unreal_set_widget_positionD | Set widget position. |
| unreal_set_widget_sizeD | Set widget size. |
| unreal_set_widget_textD | Set widget text. |
| unreal_set_widget_colorD | Set widget color. |
| unreal_add_widget_to_viewportC | Add a widget instance to the viewport. |
| unreal_get_widget_detailsD | Get widget details. |
| unreal_create_level_sequenceD | Create a Level Sequence. |
| unreal_get_level_sequencesD | List Level Sequences. |
| unreal_add_sequence_trackD | Add a sequence track. |
| unreal_add_sequence_sectionD | Add a sequence section. |
| unreal_add_cameraC | Add a camera to the level/sequence. |
| unreal_add_camera_cutD | Add a camera cut. |
| unreal_set_sequence_durationD | Set sequence duration. |
| unreal_set_keyframeC | Set a transform/property keyframe. |
| unreal_get_sequence_infoD | Get sequence info. |
| unreal_render_sequenceC | Queue a sequence render/export. |
| unreal_capture_viewportC | Capture the active editor viewport. |
| unreal_capture_screenshotC | Capture a high-quality screenshot. |
| unreal_set_viewport_cameraC | Set viewport camera actor/view. |
| unreal_set_viewport_locationC | Set viewport camera location. |
| unreal_set_viewport_rotationC | Set viewport camera rotation. |
| unreal_set_viewport_modeC | Set viewport mode/show flags where supported. |
| unreal_get_viewport_infoC | Get viewport camera info. |
| unreal_render_imageC | Render an image from the current view. |
| unreal_get_render_settingsC | Get project render settings. |
| unreal_set_render_settingsC | Set supported render settings. |
| unreal_set_physics_enabledC | Enable/disable physics on an actor/component. |
| unreal_set_simulate_physicsC | Toggle simulate physics. |
| unreal_set_gravityC | Set gravity enabled/scale. |
| unreal_set_massD | Set mass override. |
| unreal_set_linear_velocityD | Set linear velocity. |
| unreal_set_angular_velocityD | Set angular velocity. |
| unreal_set_collision_profileD | Set collision profile name. |
| unreal_get_physics_infoC | Get physics info for an actor. |
| unreal_get_collision_channelsC | Get collision channel names. |
| unreal_get_game_modeC | Get project/default game mode. |
| unreal_set_game_modeC | Set default game mode class. |
| unreal_get_game_instanceC | Get game instance class info. |
| unreal_get_game_stateC | Get game state class info. |
| unreal_get_player_controllerC | Get player controller info. |
| unreal_get_character_infoC | Get selected/pawn character info. |
| unreal_get_ai_controllerC | Get AI controller info. |
| unreal_get_behavior_treeC | Get behavior tree asset info. |
| unreal_get_blackboardC | Get blackboard asset info. |
| unreal_get_gameplay_tagsC | List gameplay tags. |
| unreal_get_input_mappingsC | Get input action/axis mappings. |
| unreal_get_project_settingsC | Get selected project settings. |
| unreal_get_engine_settingsD | Get engine settings subset. |
| unreal_get_input_settingsD | Get input settings. |
| unreal_get_rendering_settingsD | Get rendering settings. |
| unreal_get_physics_settingsD | Get physics settings. |
| unreal_get_pluginsC | List enabled plugins. |
| unreal_get_build_configurationC | Get build configuration info. |
| unreal_get_project_modulesC | List project modules. |
| unreal_execute_editor_pythonC | Execute Unreal Editor Python (advanced mode). |
| unreal_execute_console_commandC | Execute an editor console command (advanced). |
| unreal_run_automation_testD | Run an Unreal automation test. |
| unreal_get_automation_resultsC | Get automation test results. |
| unreal_get_output_logC | Get output log lines. |
| unreal_get_compile_errorsC | Get recent compile errors. |
| unreal_get_project_diagnosticsC | Run project diagnostics. |
| unreal_validate_assetsD | Validate assets. |
| unreal_validate_blueprintsD | Validate Blueprints. |
| unreal_save_allC | Save dirty packages. |
| unreal_run_buildC | Trigger a build/cook workflow where supported. |
| unreal_get_scene_hierarchyC | Inspect actor attachment hierarchy. |
| unreal_get_actor_relationshipsC | Inspect actor relationships. |
| unreal_get_component_hierarchyC | Inspect component hierarchy. |
| unreal_analyze_asset_dependenciesD | Analyze asset dependencies. |
| unreal_analyze_blueprint_relationshipsD | Analyze Blueprint relationships. |
| unreal_analyze_material_assignmentsC | Analyze material assignments in level. |
| unreal_analyze_level_compositionD | Analyze level composition. |
| unreal_validate_actor_placementC | Validate actor placement. |
| unreal_find_duplicate_assetsC | Find potentially duplicate assets. |
| unreal_find_missing_referencesD | Find missing references. |
| unreal_find_unused_assetsC | Find unused assets (bounded scan). |
| unreal_get_scene_statisticsD | Get scene statistics. |
| unreal_import_blender_fbxC | Import an FBX exported from Blender with validation. |
| unreal_validate_blender_importC | Validate Blender export conventions for Unreal. |
| unreal_reimport_blender_assetC | Reimport a previously imported Blender asset. |
| unreal_create_roomC | Create a simple room using scaled cube actors. |
| unreal_setup_lightingC | Set up a basic lighting environment. |
| unreal_setup_cameraC | Create and configure a cinematic camera actor. |
| unreal_build_sceneC | Build a scene from a structured specification of actors/lights. |
| unreal_create_gameplay_prototypeC | Create a minimal Blueprint gameplay prototype scaffold. |
| unreal_optimize_sceneC | Analyze scene performance and recommend optimization actions. |
| unreal_validate_projectC | Perform a comprehensive project validation. |
| unreal_engine_mcp_versionA | Return UnrealEngineMCP server version and non-secret configuration. |
| unreal_job_statusC | Get status for an asynchronous Unreal job. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| unreal_scene_builder | |
| unreal_level_designer | |
| unreal_blueprint_developer | |
| unreal_material_artist | |
| unreal_lighting_artist | |
| unreal_environment_artist | |
| unreal_gameplay_developer | |
| unreal_technical_artist | |
| unreal_project_optimizer | |
| unreal_project_debugger |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| project_info | |
| project_settings | |
| world_current | |
| world_actors | |
| assets_index | |
| blueprints_index | |
| materials_index | |
| logs_recent |
TDQS
Scored across 225 tools
The set spans many resources, but boundaries are blurred by numerous overlapping inspection/settings/save operations such as get_render_settings vs get_rendering_settings, get_status vs get_editor_status vs ping, and save_all vs per-asset saves. Actor transform editing is also split across composite and granular tools. With 225 tools, an agent must choose among many similar-sounding tools, increasing misselection risk.
Nearly all tools use the unreal_ prefix and snake_case, usually following a verb_noun pattern like unreal_create_blueprint or unreal_get_asset_info. Minor exceptions such as unreal_engine_mcp_version and unreal_job_status break the verb-first pattern, but overall naming is predictable.
225 tools is far beyond the well-scoped 3-15 range and exceeds the 50+ extreme threshold. While the surface is broad, the monolith size makes reliable tool discovery and selection impractical.
Core CRUD/lifecycle coverage exists for actors, assets, levels, Blueprints, materials, animation, Niagara, widgets, sequences, physics, diagnostics, and project settings. Coverage is broad, though some Unreal domains such as landscape/foliage, audio, and deeper AI/blackboard editing appear absent or read-only, leaving minor gaps.