inset_faces
Insets selected, all, or indexed mesh faces in Blender Edit Mode with configurable thickness, depth, boundary, and individual/region controls while verifying the active mesh and updating topology.
Instructions
Inset mesh faces in Blender Edit Mode with configurable thickness, depth, and selection controls. Supports region inset and individual face inset. Enforces active mesh verification, Edit Mode transition, and topology updates.
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": {
"name": "<name>"
},
"name": "inset_faces"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Name of the target mesh object in the active scene. | |
| depth | No | Inset depth displacement (positive extends outward, negative indents inward). Defaults to 0.0. | |
| faces | No | Faces to inset: 'selected' (currently selected in edit mode), 'all' (all faces), or a list of integer face indices [0, 1, 2]. Defaults to 'selected'. | selected |
| 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. | |
| thickness | No | Inset thickness (offset distance inward). Must be non-negative. Defaults to 0.1. | |
| use_outset | No | Outset rather than inset. Defaults to False. | |
| use_boundary | No | Whether to inset open mesh boundary edges. Defaults to True. | |
| use_individual | No | Whether to inset each face individually rather than as an entire region. Defaults to False. | |
| expected_snapshot_id | No | Base-mesh fingerprint. Required when faces is an explicit index list; mismatches fail before editing. |