create_primitive
Creates a validated cube, sphere, cylinder, or plane in the active Blender scene with explicit user approval, preventing name collisions and preserving existing objects.
Instructions
Create a validated basic 3D primitive (cube, sphere, cylinder, plane) in the active Blender scene. Requires explicit user approval through a trusted approval mechanism to authorize scene modification. Client- or model-supplied approval flags in tool arguments are untrusted and cannot authorize mutations. Validates input geometry, prevents name collisions, and preserves existing scene objects.
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": {
"primitive_type": "<primitive_type>",
"name": "<name>"
},
"name": "create_primitive"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Unique name for the new object. Must not collide with any existing object. | |
| size | No | Edge length in Blender units for plane primitive. Must be positive (0.0001 to 10000.0). Applies only to 'plane' (default 1.0). | |
| depth | No | Height/depth in Blender units for cylinder primitive. Must be positive (0.0001 to 10000.0). Applies only to 'cylinder' (default 1.0). | |
| radius | No | Radius in Blender units for sphere or cylinder primitive. Must be positive (0.0001 to 10000.0). Applies to 'sphere' (default 0.5) and 'cylinder' (default 0.5). | |
| 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. | |
| location | No | 3D world coordinates [x, y, z] for object placement. | |
| segments | No | Number of vertical segments for UV sphere. Range: 3 to 500. Applies only to 'sphere' (default 32). | |
| vertices | No | Number of circular vertices for cylinder cross-section. Range: 3 to 500. Applies only to 'cylinder' (default 32). | |
| dimensions | No | Size dimensions [x, y, z] in Blender units. Must be non-negative numbers. Optional; defaults to match primitive geometry. | |
| ring_count | No | Number of horizontal rings for UV sphere. Range: 3 to 500. Applies only to 'sphere' (default 16). | |
| primitive_type | Yes | Type of 3D primitive to create. Supported: 'cube', 'sphere', 'cylinder', 'plane', 'cone', 'torus', 'monkey', 'grid'. |