bind_armature_mesh
Binds a target mesh to an armature using an ARMATURE modifier and vertex groups; choose automatic, envelope, name-only, or manual weighting to skin characters or props.
Instructions
Binds a target mesh to an armature via ARMATURE modifier and vertex groups (AUTOMATIC, ENVELOPE, NAME_ONLY, MANUAL).
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": {
"mesh_object_name": "<mesh_object_name>",
"armature_name": "<armature_name>"
},
"name": "bind_armature_mesh"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| 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. | |
| bind_mode | No | Binding method: AUTOMATIC (heat weighting), ENVELOPE, NAME_ONLY (vertex groups only), MANUAL (explicit weights). | AUTOMATIC |
| armature_name | Yes | Name of the source armature object. | |
| vertex_weights | No | Optional dictionary of bone vertex weights: {bone_name: {vertex_index: weight}}. | |
| use_deform_only | No | Whether to create vertex groups only for bones with use_deform=True (defaults to True). | |
| mesh_object_name | Yes | Name of the target mesh object to skin. | |
| expected_snapshot_id | No | Optimistic concurrency state hash of the armature. |