configure_bone_constraint
Configures Pose Mode bone constraints in Blender—IK, Limit Rotation, and Copy Transforms—so you can add, remove, or update rig behavior.
Instructions
Configures Pose Mode constraints on armature bones: Inverse Kinematics (IK), Limit Rotation, Copy Transforms.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"armature_name": "<armature_name>",
"bone_name": "<bone_name>"
},
"name": "configure_bone_constraint"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | No | Action: ADD new constraint, REMOVE existing, or UPDATE properties (defaults to ADD). | ADD |
| task_id | No | Optional task or workflow identifier. | |
| approved | No | DEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted as proof of human consent. | |
| bone_name | Yes | Name of the pose bone to constrain. | |
| influence | No | Constraint influence factor between 0.0 and 1.0. | |
| pole_angle | No | Pole angle in radians for IK constraints. | |
| chain_count | No | IK chain length (number of bones up the hierarchy; 0 solves all ancestor bones). | |
| owner_space | No | Coordinate space of the owner bone. | |
| pole_target | No | Optional pole target object for IK constraints. | |
| target_bone | No | Target subtarget bone name on target armature. | |
| target_space | No | Coordinate space of the target object/bone. | |
| armature_name | Yes | Name of the armature containing the target bone. | |
| target_object | No | Target object name for constraints that track objects. | |
| pole_subtarget | No | Optional pole target bone name for IK constraints. | |
| constraint_name | No | Optional explicit constraint name. | |
| constraint_type | No | Type of bone constraint to configure. | IK |
| expected_snapshot_id | No | Optimistic concurrency state hash of the armature. | |
| limit_rotation_settings | No | Settings for LIMIT_ROTATION: use_limit_x/y/z (bool), min_x/y/z (float), max_x/y/z (float). |