assign_material
Assign an existing material to an object in the active Blender scene, optionally targeting a specific material slot index or face indices. Use it to apply materials to objects without creating new ones.
Instructions
Assign an existing material to an object in the active scene, optionally targeting a specific material slot index.
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": {
"target_name": "<target_name>",
"material_name": "<material_name>"
},
"name": "assign_material"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| task_id | No | Optional task or workflow identifier for grouping related scene mutation operations. | |
| approved | No | DEPRECATED / UNTRUSTED: Client-supplied approval flags in tool arguments are not trusted as proof of human consent. Mutations must be approved through a trusted approval mechanism. | |
| slot_index | No | Optional material slot index to assign into. If omitted or beyond existing slots, a new slot is appended. | |
| target_name | Yes | Target object name to assign the material to. | |
| face_indices | No | Optional list of polygon/face indices to assign to this material slot. | |
| material_name | Yes | Name of the existing material in the scene. |