blender_mesh
Create and manipulate mesh objects in Blender with operations for generating primitives, duplicating, deleting, extruding, beveling, subdividing, and merging.
Instructions
PORTMANTEAU PATTERN RATIONALE: Consolidates 9 related mesh operations into single interface. Prevents tool explosion while maintaining full primitive creation and object management functionality. Follows FastMCP 2.14.3 best practices.
Create and manipulate mesh objects in Blender with comprehensive primitive support.
Core Operations:
create_cube: Generate cube primitive with customizable dimensions
create_sphere: Generate sphere primitive with vertex control
create_cylinder: Generate cylinder primitive with radius/depth control
create_cone: Generate cone primitive with radius/depth control
create_plane: Generate plane primitive for ground/floor surfaces
create_torus: Generate torus primitive with ring/tube radius control
create_monkey: Generate Suzanne (monkey) primitive for testing
duplicate_object: Create copies of existing objects with transforms
delete_object: Remove objects from scene by name
extrude: Extrude mesh region along +Z in edit mode
inset: Inset selected faces
bevel_modifier: Add bevel modifier to mesh object
subdivide: Subdivide mesh edges
merge_vertices: Merge by distance (remove doubles)
delete_faces: Delete selected faces in edit mode
join: Join multiple mesh objects into one
separate_loose: Separate loose parts to new objects
triangulate: Convert quads to triangles
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Name for the new object or object to delete. Must be unique in scene. | Object |
| depth | No | Height/depth parameter for 3D primitives (cylinder, cone). Default: 2.0. Range: 0.01 to 100.0. | |
| scale | No | Scale factors along each axis (x, y, z). Default: (1, 1, 1). Applied after object creation. | |
| radius | No | Radius parameter for curved primitives (sphere, cylinder, cone, torus). Default: 1.0. Range: 0.01 to 100.0. | |
| distance | No | ||
| location | No | World-space coordinates (x, y, z) for object placement. Default: (0, 0, 0). Used for all create operations. | |
| vertices | No | Vertex count for curved surfaces (sphere, cylinder). Default: 32. Range: 3 to 256. Higher values = smoother surfaces. | |
| operation | No | The mesh operation to perform. Must be one of: "create_cube", "create_sphere", "create_cylinder", "create_cone", "create_plane", "create_torus", "create_monkey", "duplicate_object", "delete_object". - "create_*": Create new primitive objects (require: name, may use: location, scale, radius, depth, vertices) - "duplicate_object": Copy existing object (requires: source_name, name) - "delete_object": Remove object from scene (requires: name) | create_cube |
| thickness | No | ||
| join_names | No | ||
| bevel_width | No | ||
| inset_depth | No | ||
| source_name | No | Name of source object for duplication operations. Required for "duplicate_object" operation. | |
| bevel_segments | No | ||
| merge_distance | No | ||
| prefer_session | No | ||
| primitive_type | No | Type of primitive for create operations. One of: "cube", "sphere", "cylinder", "cone", "plane", "torus", "monkey". Auto-detected from operation if not specified. | cube |
| subdivide_cuts | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |