unreal-engine-mcp-server 0.6.0-beta-d → 0.6.0-beta-e

package/dist/tools/catalog/capabilities/generated/capability-cost-index.generated.d.ts

@@ -1,3 +1,3 @@
 export declare const CAPABILITY_COST_INDEX: Readonly<Record<string, string>>;
-export declare const CAPABILITY_COST_INDEX_KEY_COUNT = 1540;
+export declare const CAPABILITY_COST_INDEX_KEY_COUNT = 1543;
 //# sourceMappingURL=capability-cost-index.generated.d.ts.map

package/dist/tools/catalog/capabilities/generated/capability-cost-index.generated.js

@@ -56,6 +56,7 @@ export const CAPABILITY_COST_INDEX = {
     "animation_physics::edit_anim_graph": "interactive|low",
     "animation_physics::edit_animation": "interactive|low",
     "animation_physics::edit_blend_space": "long-running|medium",
+    "animation_physics::edit_control_rig": "interactive|medium",
     "animation_physics::edit_montage": "interactive|low",
     "animation_physics::edit_morph_target": "long-running|high",
     "animation_physics::edit_physics_asset": "interactive|medium",
@@ -64,6 +65,7 @@ export const CAPABILITY_COST_INDEX = {
     "animation_physics::force_rebuild_blend_space": "long-running|medium",
     "animation_physics::get_animation_info": "instant|low",
     "animation_physics::get_bone_transform": "instant|low",
+    "animation_physics::get_control_rig": "instant|low",
     "animation_physics::get_physics_asset_info": "instant|low",
     "animation_physics::get_skeleton_info": "instant|low",
     "animation_physics::import_morph_targets": "long-running|high",
@@ -71,6 +73,7 @@ export const CAPABILITY_COST_INDEX = {
     "animation_physics::list_bones": "instant|low",
     "animation_physics::list_morph_targets": "instant|low",
     "animation_physics::list_physics_bodies": "instant|low",
+    "animation_physics::list_rig_units": "instant|low",
     "animation_physics::list_sockets": "instant|low",
     "animation_physics::list_virtual_bones": "instant|low",
     "animation_physics::mirror_weights": "long-running|high",
@@ -1540,5 +1543,5 @@ export const CAPABILITY_COST_INDEX = {
     "system_control::validate_assets": "interactive|low",
     "system_control::write_snapshot": "interactive|medium"
 };
-export const CAPABILITY_COST_INDEX_KEY_COUNT = 1540;
+export const CAPABILITY_COST_INDEX_KEY_COUNT = 1543;
 //# sourceMappingURL=capability-cost-index.generated.js.map

package/dist/tools/catalog/capabilities/generated/parent-tool-definitions.generated.js

@@ -243,6 +243,17 @@ export const generatedParentToolDefinitions = [
                     "type": "string",
                     "description": "Name of the created physics constraint."
                 },
+                "controlType": {
+                    "type": "string",
+                    "enum": [
+                        "transform",
+                        "float",
+                        "bool",
+                        "position",
+                        "rotator"
+                    ],
+                    "description": "add_control: the value the control drives (default transform)."
+                },
                 "createConstraints": {
                     "type": "boolean",
                     "description": "Create joint constraints between bodies."
@@ -325,6 +336,15 @@ export const generatedParentToolDefinitions = [
                         "set_axis_settings",
                         "set_interpolation_settings",
                         "rebuild",
+                        "add_unit",
+                        "connect",
+                        "disconnect",
+                        "set_pin",
+                        "remove_node",
+                        "import_bones",
+                        "add_null",
+                        "add_control",
+                        "remove_element",
                         "auto",
                         "set",
                         "copy",
@@ -341,7 +361,7 @@ export const generatedParentToolDefinitions = [
                         "set_deltas",
                         "import"
                     ],
-                    "description": "Which configure anim graph node variant to run."
+                    "description": "The edit to make (each step of steps names its own)."
                 },
                 "element": {
                     "type": "string",
@@ -388,6 +408,10 @@ export const generatedParentToolDefinitions = [
                     "type": "number",
                     "description": "Frames per second (default 30)."
                 },
+                "from": {
+                    "type": "string",
+                    "description": "connect, disconnect: the output pin, Node.Pin as get_control_rig lists it; execution runs from the event's execute pin to each unit's (ExecutePin in UE 5.8)."
+                },
                 "fromSection": {
                     "type": "string",
                     "description": "Source montage section."
@@ -400,6 +424,10 @@ export const generatedParentToolDefinitions = [
                     "type": "string",
                     "description": "Body primitive: Sphyl, Box, Sphere, TaperedCapsule, MultiConvexHull or SingleConvexHull."
                 },
+                "global": {
+                    "type": "boolean",
+                    "description": "add_bone, add_null: location, rotation and scale are in rig space, not relative to the parent."
+                },
                 "gridDivisions": {
                     "type": "number",
                     "description": "Number of grid divisions on the axis."
@@ -487,6 +515,10 @@ export const generatedParentToolDefinitions = [
                     "type": "number",
                     "description": "Capsule length between the end caps (default 20)."
                 },
+                "limit": {
+                    "type": "number",
+                    "description": "Most units to list (default 50, up to 500); matched counts them all."
+                },
                 "limits": {
                     "type": "object",
                     "additionalProperties": false,
@@ -523,12 +555,26 @@ export const generatedParentToolDefinitions = [
                     "description": "Linear damping value."
                 },
                 "location": {
-                    "type": "array",
-                    "items": {
-                        "type": "number"
-                    },
-                    "minItems": 3,
-                    "maxItems": 3,
+                    "oneOf": [
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "number"
+                            },
+                            "minItems": 3,
+                            "maxItems": 3,
+                            "description": "World or relative location as [x, y, z]."
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "number"
+                            },
+                            "minItems": 3,
+                            "maxItems": 3,
+                            "description": "add_bone, add_null, add_control: location [x, y, z] in cm (a control's offset), relative to the parent unless global."
+                        }
+                    ],
                     "description": "World or relative location as [x, y, z]."
                 },
                 "lodIndex": {
@@ -594,6 +640,10 @@ export const generatedParentToolDefinitions = [
                     "type": "string",
                     "description": "Replacement bone name."
                 },
+                "node": {
+                    "type": "string",
+                    "description": "One node's name: only that node, with every struct member pin by its full path."
+                },
                 "nodeId": {
                     "type": "string",
                     "description": "The node GUID; an alternative to nodeName."
@@ -622,6 +672,10 @@ export const generatedParentToolDefinitions = [
                     "type": "boolean",
                     "description": "Overwrite an existing asset with the same name."
                 },
+                "parent": {
+                    "type": "string",
+                    "description": "add_bone, add_null, add_control: the parent element's name (a bone, null or control); omitted, the top of the hierarchy."
+                },
                 "parentBoneName": {
                     "type": "string",
                     "description": "Parent bone name."
@@ -642,6 +696,10 @@ export const generatedParentToolDefinitions = [
                     "type": "string",
                     "description": "Canonical /Game PhysicsAsset path."
                 },
+                "pin": {
+                    "type": "string",
+                    "description": "set_pin: the pin, Node.Pin; a struct member has its own pin (SetTransform.Item.Name, SetTransform.Transform.Translation.X)."
+                },
                 "pitch": {
                     "type": "number",
                     "description": "Aim offset pitch in degrees."
@@ -657,6 +715,15 @@ export const generatedParentToolDefinitions = [
                     },
                     "description": "Distinct names for the poses in frame order; frames without a name keep the engine default name."
                 },
+                "position": {
+                    "type": "array",
+                    "items": {
+                        "type": "number"
+                    },
+                    "minItems": 2,
+                    "maxItems": 2,
+                    "description": "add_unit: graph position [x, y] (default right of the last node)."
+                },
                 "positionX": {
                     "type": "number",
                     "description": "Graph X position of the new node (default 0)."
@@ -677,6 +744,10 @@ export const generatedParentToolDefinitions = [
                     "type": "string",
                     "description": "The property: a member of the node's settings struct (Alpha, PlayRate, bLoopAnimation, Sequence) or of the graph node (NodeComment), with dots for a nested one (Node.PlayRate). On an asset player the asset property (Sequence, BlendSpace) is written through the node's own setter and read back, and fails when the node did not take it; any other property is written by reflection and its stored value read back."
                 },
+                "query": {
+                    "type": "string",
+                    "description": "Words to match in the unit's name, display name, category or keywords (spaces ignored), e.g. two bone, aim, set transform."
+                },
                 "radius": {
                     "type": "number",
                     "description": "Sphere or capsule radius (default 10)."
@@ -756,6 +827,15 @@ export const generatedParentToolDefinitions = [
                             "minItems": 3,
                             "maxItems": 3,
                             "description": "Rotation as [pitch, yaw, roll] in degrees."
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "number"
+                            },
+                            "minItems": 3,
+                            "maxItems": 3,
+                            "description": "add_bone, add_null, add_control: rotation [pitch, yaw, roll] in degrees."
                         }
                     ],
                     "description": "Box or capsule rotation relative to the bone as [pitch, yaw, roll]."
@@ -784,6 +864,15 @@ export const generatedParentToolDefinitions = [
                             "minItems": 3,
                             "maxItems": 3,
                             "description": "Bone scale as [x, y, z] (default [1, 1, 1])."
+                        },
+                        {
+                            "type": "array",
+                            "items": {
+                                "type": "number"
+                            },
+                            "minItems": 3,
+                            "maxItems": 3,
+                            "description": "add_bone, add_null, add_control: scale [x, y, z] (default 1)."
                         }
                     ],
                     "description": "Bone scale as [x, y, z] (default [1, 1, 1])."
@@ -895,6 +984,15 @@ export const generatedParentToolDefinitions = [
                     "type": "string",
                     "description": "StaticMesh to skin, e.g. a coat downloaded as a rigid mesh."
                 },
+                "steps": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "additionalProperties": true,
+                        "x-unreal-reflection-boundary": true
+                    },
+                    "description": "Several edits in order, each an object with edit and its own fields as above; the first that fails stops the rest, and those before it stay (failedStep names it)."
+                },
                 "suffix": {
                     "type": "string",
                     "description": "Suffix appended to each retargeted asset name."
@@ -935,6 +1033,10 @@ export const generatedParentToolDefinitions = [
                     "type": "number",
                     "description": "Time in seconds."
                 },
+                "to": {
+                    "type": "string",
+                    "description": "connect, disconnect: the input pin, Node.Pin."
+                },
                 "toSection": {
                     "type": "string",
                     "description": "Target montage section."
@@ -990,6 +1092,10 @@ export const generatedParentToolDefinitions = [
                     "type": "string",
                     "description": "Comment/name for the blend node (alias of name)."
                 },
+                "unit": {
+                    "type": "string",
+                    "description": "add_unit: the unit, as an object path (/Script/ControlRig.RigUnit_SetTransform), its struct name with or without RigUnit_ (SetTransform), or its display name."
+                },
                 "value": {
                     "oneOf": [
                         {
@@ -997,6 +1103,14 @@ export const generatedParentToolDefinitions = [
                         },
                         {
                             "description": "The value: a number, boolean or string, an {x,y,z} or {r,g,b,a} object for a struct, or for an asset property the asset path (/Game/Anims/A_Idle)."
+                        },
+                        {
+                            "type": [
+                                "string",
+                                "number",
+                                "boolean"
+                            ],
+                            "description": "set_pin: the value as text (Bone, foot_l), a number, or true/false."
                         }
                     ],
                     "description": "Property value (any type)."
@@ -1083,6 +1197,9 @@ export const generatedParentToolDefinitions = [
                         "edit_anim_graph",
                         "edit_animation",
                         "create_control_rig",
+                        "edit_control_rig",
+                        "get_control_rig",
+                        "list_rig_units",
                         "setup_ik",
                         "edit_montage",
                         "play_montage",
@@ -1171,6 +1288,10 @@ export const generatedParentToolDefinitions = [
                     },
                     "description": "Requested animation paths that could not be loaded."
                 },
+                "applied": {
+                    "type": "number",
+                    "description": "Edits applied."
+                },
                 "assetPath": {
                     "type": "string",
                     "description": "Canonical /Game asset path."
@@ -1274,6 +1395,17 @@ export const generatedParentToolDefinitions = [
                     "type": "boolean",
                     "description": "Whether any mapping changed."
                 },
+                "compileErrors": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "The compile errors, when there were any."
+                },
+                "compiled": {
+                    "type": "boolean",
+                    "description": "Whether the rig compiled after the edits."
+                },
                 "compiledAnimBlueprints": {
                     "type": "array",
                     "items": {
@@ -1317,10 +1449,27 @@ export const generatedParentToolDefinitions = [
                     "x-unreal-reflection-boundary": true,
                     "description": "Additional handler result fields not named by the contract."
                 },
+                "elementCount": {
+                    "type": "number",
+                    "description": "All hierarchy elements."
+                },
+                "elements": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "additionalProperties": true,
+                        "x-unreal-reflection-boundary": true
+                    },
+                    "description": "Hierarchy elements in order (up to 500): type (Bone, Null, Control, Curve ...), name and parent."
+                },
                 "existingAsset": {
                     "type": "boolean",
                     "description": "Boolean parameter."
                 },
+                "failedStep": {
+                    "type": "number",
+                    "description": "steps: the step that failed (0-based); the ones before it were applied, compiled and saved."
+                },
                 "frameRate": {
                     "type": "number",
                     "description": "Numeric parameter."
@@ -1355,6 +1504,15 @@ export const generatedParentToolDefinitions = [
                     "type": "number",
                     "description": "Numeric parameter."
                 },
+                "links": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "additionalProperties": true,
+                        "x-unreal-reflection-boundary": true
+                    },
+                    "description": "Each link: from (output pin) and to (input pin)."
+                },
                 "location": {
                     "type": "object",
                     "additionalProperties": false,
@@ -1375,6 +1533,15 @@ export const generatedParentToolDefinitions = [
                     "type": "string",
                     "description": "State machine name."
                 },
+                "made": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "additionalProperties": true,
+                        "x-unreal-reflection-boundary": true
+                    },
+                    "description": "What the edits made: {node, unit, pins} for an added unit, {pin, value} for a set pin (the value as stored), {element} for an added element, {importedFrom, bones} for a skeleton's bones imported (bones the rig already had are matched in place)."
+                },
                 "mapping": {
                     "type": "array",
                     "items": {
@@ -1393,6 +1560,10 @@ export const generatedParentToolDefinitions = [
                     },
                     "description": "Every target chain with the source chain now driving it (None when unmapped)."
                 },
+                "matched": {
+                    "type": "number",
+                    "description": "Units that match."
+                },
                 "maxInfluencesAfter": {
                     "type": "number",
                     "description": "Most influences on one vertex after."
@@ -1456,6 +1627,22 @@ export const generatedParentToolDefinitions = [
                     "type": "string",
                     "description": "Object name of the node that was set."
                 },
+                "nodeNames": {
+                    "type": "array",
+                    "items": {
+                        "type": "string"
+                    },
+                    "description": "With a node that is not there: the nodes there are."
+                },
+                "nodes": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "additionalProperties": true,
+                        "x-unreal-reflection-boundary": true
+                    },
+                    "description": "Each node: name, title, unit (struct path), position [x, y] and pins [{pin, direction, type, default, linked}]."
+                },
                 "numBodies": {
                     "type": "number",
                     "description": "Number of physics bodies in the asset."
@@ -1595,6 +1782,15 @@ export const generatedParentToolDefinitions = [
                     "type": "boolean",
                     "description": "Whether the action succeeded."
                 },
+                "units": {
+                    "type": "array",
+                    "items": {
+                        "type": "object",
+                        "additionalProperties": true,
+                        "x-unreal-reflection-boundary": true
+                    },
+                    "description": "Matching units sorted by struct name: unit (the object path add_unit takes), name and category."
+                },
                 "unmappedBones": {
                     "type": "array",
                     "items": {

package/dist/tools/catalog/capabilities/records/aggregate.d.ts

@@ -1,4 +1,4 @@
 import type { CapabilityRecord } from '../model.js';
-export declare const ALL_CAPABILITY_RECORD_COUNT: 402;
+export declare const ALL_CAPABILITY_RECORD_COUNT: 405;
 export declare const ALL_CAPABILITY_RECORDS: readonly CapabilityRecord[];
 //# sourceMappingURL=aggregate.d.ts.map

package/dist/tools/catalog/capabilities/records/aggregate.js

@@ -22,7 +22,7 @@ import { SYSTEM_CONTROL_SOURCES } from './system-control/index.js';
 import { MANAGE_GEOMETRY_SOURCES } from './world/manage-geometry.index.js';
 import { MANAGE_LEVEL_STRUCTURE_SOURCES } from './world/manage-level-structure.index.js';
 import { MANAGE_PCG_SOURCES } from './world/manage-pcg.index.js';
-export const ALL_CAPABILITY_RECORD_COUNT = 402;
+export const ALL_CAPABILITY_RECORD_COUNT = 405;
 const ALL_SOURCES = [
     ...BUILD_ENVIRONMENT_SOURCES,
     ...MANAGE_LEVEL_STRUCTURE_SOURCES,

package/dist/tools/catalog/capabilities/records/folds/manage-blueprint.folds.js

@@ -55,7 +55,7 @@ export const MANAGE_BLUEPRINT_FOLDS = [
     {
         primary: 'inspect_graph', selector: 'info',
         summary: 'Inspect a Blueprint graph: its nodes (every one, or those whose title, pin default, text or object path matches a filter), node details, pin details, or the available node types.',
-        topics: ['graph details', 'node details', 'pin details', 'node types', 'find nodes', 'search graph nodes'],
+        topics: ['graph details', 'node details', 'pin details', 'node types', 'find nodes', 'search graph nodes', 'filter graph nodes'],
         members: { graph: 'get_graph_details', node: 'get_node_details', pins: 'get_pin_details', node_types: 'list_node_types' },
     },
     {

package/dist/tools/catalog/capabilities/records/gameplay/animation-physics/authoring-1.data.js

@@ -1,7 +1,8 @@
 import { buildRecord } from '../helpers.js';
+import { ANY_EDITOR_STATE } from '../../core/builder.js';
 import { P } from '../properties.js';
 import { A } from './animation-properties.js';
-import { bool, num, str } from '../../shared/schema-props.js';
+import { bool, num, str, vec3 } from '../../shared/schema-props.js';
 const T = 'animation_physics';
 const F = 'animation';
 const W = ['An animation asset or graph must be authored.'];
@@ -135,5 +136,89 @@ export const ANIM_AUTHORED_1 = [
         inputProps: { name: P.name, path: P.path, skeletonPath: P.skeletonPath, skeletalMeshPath: str('Skeletal mesh to build the rig from; wins over skeletonPath.'), modularRig: bool('Create a Modular Rig (UE 5.5+; older engines report modularRig false).'), save: A.save }, required: ['name'],
         effect: 'write', latency: 'interactive', resources: 'medium', plugins: ['ControlRig', 'RigVM', 'EditorScriptingUtilities'],
         exampleInput: { action: 'create_control_rig', name: 'CR_Char', skeletonPath: '/Game/SK_Char' } }),
+    buildRecord({ parentTool: T, id: `${T}.edit_control_rig`, action: 'edit_control_rig', family: F,
+        topics: ['control rig graph', 'rig unit', 'add rig node', 'connect rig pins', 'wire control rig pins', 'control rig hierarchy', 'add control', 'rig bones'],
+        summary: 'Edit a Control Rig: add a unit node (list_rig_units finds them), connect or disconnect pins, set a pin value, remove a node, import the skeleton\'s bones, add a bone, null or control, or remove an element; one edit or many steps, then one compile and save. The reply lists what each edit made (a new node with its pins).',
+        whenToUse: ['A Control Rig needs its logic built: units such as Get Transform, Two Bone IK or Set Transform wired from the Forwards Solve event (a new rig may have none: add_unit BeginExecution adds it).', 'A rig needs bones from its skeleton, or controls and nulls to drive them.'],
+        whenNotToUse: ['The rig asset does not exist yet (use create_control_rig).', 'Only reading the rig (use get_control_rig).', 'An IK Rig or retargeter (use create_ik_rig, setup_ik).'],
+        inputProps: {
+            assetPath: str('Control Rig asset path, e.g. /Game/Rigs/CR_Arm.'),
+            edit: { type: 'string', enum: ['add_unit', 'connect', 'disconnect', 'set_pin', 'remove_node', 'import_bones', 'add_bone', 'add_null', 'add_control', 'remove_element'], description: 'The edit to make (each step of steps names its own).' },
+            unit: str('add_unit: the unit, as an object path (/Script/ControlRig.RigUnit_SetTransform), its struct name with or without RigUnit_ (SetTransform), or its display name.'),
+            name: str('add_unit: the new node\'s name (default the unit\'s, made unique); add_bone, add_null, add_control, remove_element: the element\'s name.'),
+            position: { type: 'array', items: { type: 'number' }, minItems: 2, maxItems: 2, description: 'add_unit: graph position [x, y] (default right of the last node).' },
+            from: str('connect, disconnect: the output pin, Node.Pin as get_control_rig lists it; execution runs from the event\'s execute pin to each unit\'s (ExecutePin in UE 5.8).'),
+            to: str('connect, disconnect: the input pin, Node.Pin.'),
+            pin: str('set_pin: the pin, Node.Pin; a struct member has its own pin (SetTransform.Item.Name, SetTransform.Transform.Translation.X).'),
+            value: { type: ['string', 'number', 'boolean'], description: 'set_pin: the value as text (Bone, foot_l), a number, or true/false.' },
+            node: str('remove_node: the node\'s name.'),
+            skeletonPath: str('import_bones: the skeleton whose bones are imported (default the skeleton of the rig\'s preview mesh).'),
+            parent: str('add_bone, add_null, add_control: the parent element\'s name (a bone, null or control); omitted, the top of the hierarchy.'),
+            location: vec3('add_bone, add_null, add_control: location [x, y, z] in cm (a control\'s offset), relative to the parent unless global.'),
+            rotation: vec3('add_bone, add_null, add_control: rotation [pitch, yaw, roll] in degrees.'),
+            scale: vec3('add_bone, add_null, add_control: scale [x, y, z] (default 1).'),
+            global: bool('add_bone, add_null: location, rotation and scale are in rig space, not relative to the parent.'),
+            controlType: { type: 'string', enum: ['transform', 'float', 'bool', 'position', 'rotator'], description: 'add_control: the value the control drives (default transform).' },
+            steps: { type: 'array', items: { type: 'object', additionalProperties: true, 'x-unreal-reflection-boundary': true }, description: 'Several edits in order, each an object with edit and its own fields as above; the first that fails stops the rest, and those before it stay (failedStep names it).' },
+            save: A.save,
+        },
+        required: ['assetPath'],
+        effect: 'write', latency: 'interactive', resources: 'medium', plugins: CR_ESU,
+        exampleInput: { action: 'edit_control_rig', assetPath: '/Game/Rigs/CR_Arm', steps: [{ edit: 'add_unit', unit: 'BeginExecution', name: 'ForwardsSolve' }, { edit: 'add_unit', unit: 'SetTransform', name: 'SetHand' }, { edit: 'set_pin', pin: 'SetHand.Item.Name', value: 'hand_r' }, { edit: 'connect', from: 'ForwardsSolve.ExecutePin', to: 'SetHand.ExecutePin' }] },
+        exampleOutput: { success: true, message: 'Applied 4 edit(s) to CR_Arm.', assetPath: '/Game/Rigs/CR_Arm.CR_Arm', applied: 4, compiled: true, saved: true,
+            made: [{ node: 'SetHand', unit: '/Script/ControlRig.RigUnit_SetTransform', pins: [{ pin: 'SetHand.Item', direction: 'Input', type: 'FRigElementKey' }] }, { pin: 'SetHand.Item.Name', value: 'hand_r' }] },
+        outputProps: {
+            assetPath: str('The rig edited.'),
+            applied: num('Edits applied.'),
+            made: { type: 'array', items: { type: 'object', additionalProperties: true, 'x-unreal-reflection-boundary': true }, description: 'What the edits made: {node, unit, pins} for an added unit, {pin, value} for a set pin (the value as stored), {element} for an added element, {importedFrom, bones} for a skeleton\'s bones imported (bones the rig already had are matched in place).' },
+            compiled: bool('Whether the rig compiled after the edits.'),
+            compileErrors: { type: 'array', items: { type: 'string' }, description: 'The compile errors, when there were any.' },
+            saved: bool('Whether the rig was saved.'),
+            failedStep: num('steps: the step that failed (0-based); the ones before it were applied, compiled and saved.'),
+        },
+        outputRequired: ['assetPath', 'applied'] }),
+    buildRecord({ parentTool: T, id: `${T}.get_control_rig`, action: 'get_control_rig', family: F,
+        topics: ['read control rig', 'control rig nodes', 'rig pins', 'rig hierarchy'],
+        summary: 'Read a Control Rig: each node of its graph with its unit and pins (path, direction, type, default, linked), the links between pins, its hierarchy (bones, nulls, controls with their parents) and whether it compiled; node names one node with every struct member pin.',
+        whenToUse: ['Before editing a rig: the exact pin paths connect and set_pin take, and what is already wired.', 'To check a rig after edits: links, hierarchy, compile state.'],
+        whenNotToUse: ['Finding a unit to add (use list_rig_units).'],
+        inputProps: {
+            assetPath: str('Control Rig asset path, e.g. /Game/Rigs/CR_Arm.'),
+            node: str('One node\'s name: only that node, with every struct member pin by its full path.'),
+        },
+        required: ['assetPath'],
+        effect: 'read', editorStates: ANY_EDITOR_STATE, latency: 'instant', resources: 'low', plugins: CR_ESU,
+        exampleInput: { action: 'get_control_rig', assetPath: '/Game/Rigs/CR_Arm' },
+        exampleOutput: { success: true, message: 'CR_Arm: 2 node(s), 1 link(s), 3 hierarchy element(s).', assetPath: '/Game/Rigs/CR_Arm.CR_Arm',
+            nodes: [{ name: 'ForwardsSolve', title: 'Forwards Solve', unit: '/Script/ControlRig.RigUnit_BeginExecution', position: [0, 0], pins: [{ pin: 'ForwardsSolve.ExecutePin', direction: 'Output', type: 'FRigVMExecuteContext', linked: true }] }],
+            links: [{ from: 'ForwardsSolve.ExecutePin', to: 'SetHand.ExecutePin' }], elements: [{ type: 'Bone', name: 'root' }, { type: 'Bone', name: 'hand_r', parent: 'root' }], elementCount: 3, compiled: true },
+        outputProps: {
+            assetPath: str('The rig read.'),
+            nodes: { type: 'array', items: { type: 'object', additionalProperties: true, 'x-unreal-reflection-boundary': true }, description: 'Each node: name, title, unit (struct path), position [x, y] and pins [{pin, direction, type, default, linked}].' },
+            links: { type: 'array', items: { type: 'object', additionalProperties: true, 'x-unreal-reflection-boundary': true }, description: 'Each link: from (output pin) and to (input pin).' },
+            elements: { type: 'array', items: { type: 'object', additionalProperties: true, 'x-unreal-reflection-boundary': true }, description: 'Hierarchy elements in order (up to 500): type (Bone, Null, Control, Curve ...), name and parent.' },
+            elementCount: num('All hierarchy elements.'),
+            compiled: bool('Whether the rig is compiled and up to date.'),
+            nodeNames: { type: 'array', items: { type: 'string' }, description: 'With a node that is not there: the nodes there are.' },
+        },
+        outputRequired: ['assetPath', 'nodes'] }),
+    buildRecord({ parentTool: T, id: `${T}.list_rig_units`, action: 'list_rig_units', family: F,
+        topics: ['rig units', 'find rig unit', 'control rig node types'],
+        summary: 'Find the units a Control Rig graph can hold (Get Transform, Two Bone IK, Aim, math and more): each unit\'s object path, name and category, for edit_control_rig add_unit.',
+        whenToUse: ['A unit is needed for add_unit and its name is not known.'],
+        whenNotToUse: ['Reading what a rig already holds (use get_control_rig).'],
+        inputProps: {
+            query: str('Words to match in the unit\'s name, display name, category or keywords (spaces ignored), e.g. two bone, aim, set transform.'),
+            limit: num('Most units to list (default 50, up to 500); matched counts them all.'),
+        },
+        required: [],
+        effect: 'read', editorStates: ANY_EDITOR_STATE, latency: 'instant', resources: 'low', plugins: CR_ESU,
+        exampleInput: { action: 'list_rig_units', query: 'two bone' },
+        exampleOutput: { success: true, message: '2 rig unit(s) match.', matched: 2, units: [{ unit: '/Script/ControlRig.RigUnit_TwoBoneIKSimplePerItem', name: 'Basic IK', category: 'Hierarchy' }] },
+        outputProps: {
+            units: { type: 'array', items: { type: 'object', additionalProperties: true, 'x-unreal-reflection-boundary': true }, description: 'Matching units sorted by struct name: unit (the object path add_unit takes), name and category.' },
+            matched: num('Units that match.'),
+        },
+        outputRequired: ['units', 'matched'] }),
 ];
 //# sourceMappingURL=authoring-1.data.js.map

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "unreal-engine-mcp-server",
-  "version": "0.6.0-beta-d",
+  "version": "0.6.0-beta-e",
   "mcpName": "io.github.ChiR24/unreal-engine-mcp",
   "description": "A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal Engine via native automation bridge. Built with TypeScript and designed for game development automation.",
   "type": "module",

package/server.json

@@ -2,13 +2,13 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.ChiR24/unreal-engine-mcp",
   "description": "Automate the Unreal Editor (UE 5.0-5.8): levels, Blueprints, UI, materials, VFX and more.",
-  "version": "0.6.0-beta-d",
+  "version": "0.6.0-beta-e",
   "packages": [
     {
       "registryType": "npm",
       "registryBaseUrl": "https://registry.npmjs.org",
       "identifier": "unreal-engine-mcp-server",
-      "version": "0.6.0-beta-d",
+      "version": "0.6.0-beta-e",
       "transport": {
         "type": "stdio"
       },