sculpt_mesh
Apply snapshot-bound sculpting controls to a Blender mesh: enter or exit sculpt mode, set brushes and settings, draw strokes, voxel remesh, and toggle dynamic topology.
Instructions
Finite snapshot-bound sculpt controls: mode lifecycle, existing sculpt brush/settings, normalized View3D brush stroke, voxel remesh and dynamic topology. Main-thread only; mutations require normal human approval and independent mesh readback.
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": {
"object_name": "<object_name>",
"action": "<action>",
"expected_snapshot_id": "<expected_snapshot_id>"
},
"name": "sculpt_mesh"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| action | Yes | ||
| points | No | ||
| radius | No | ||
| enabled | No | ||
| task_id | No | ||
| settings | No | ||
| strength | No | ||
| brush_name | No | ||
| brush_type | No | ||
| iterations | No | ||
| request_id | No | ||
| voxel_size | No | ||
| detail_mode | No | ||
| detail_size | No | ||
| object_name | Yes | ||
| approval_token | No | ||
| dynamic_topology | No | ||
| max_displacement | No | ||
| preserve_topology | No | ||
| expected_snapshot_id | Yes |