Insert keyframes for an object.

Args: object_name: Target object. frame: Frame number (None = current frame). location: Keyframe location. rotation: Keyframe rotation. scale: Keyframe scale. property_name: Optional custom property to keyframe.

Delete keyframes at a specific frame or all keyframes.

Args: object_name: Target object. frame: Frame to delete (None = all keyframes).

Set keyframe interpolation mode for an object's animation.

Args: object_name: Target object. interpolation: CONSTANT, LINEAR, BEZIER, etc. easing: AUTO, EASE_IN, EASE_OUT, EASE_IN_OUT.

Set the animation playback range.

Args: start_frame: Start frame. end_frame: End frame. frame_step: Step between frames.

Set the scene frame rate.

Args: fps: Frames per second (1-1000).

Jump to a specific frame in the timeline.

Args: frame: Frame number.

Create a simple walk/bounce cycle animation.

Args: object_name: Target object. frames_per_cycle: Frames for one full cycle. amplitude: Bounce height.

Animate a subdivision surface modifier's viewport levels.

Args: object_name: Target object. modifier_name: Name of the subdivision modifier. start_level: Starting subdivision level. end_level: Ending subdivision level. start_frame: Start frame. end_frame: End frame.

Create a new armature object.

Args: name: Armature name. location: [x, y, z] position.

Add a bone to an armature.

Args: armature_name: Target armature. bone_name: Name for the bone. head: [x, y, z] bone head position. tail: [x, y, z] bone tail position. parent_bone: Parent bone name (for hierarchy).

Create a basic humanoid armature with spine, arms, and legs.

Args: armature_name: Name for the armature. location: [x, y, z] position.

Add a constraint to a bone.

Args: armature_name: Target armature. bone_name: Bone to constrain. constraint_type: TRACK_TO, COPY_LOCATION, COPY_ROTATION, IK, etc. target_name: Target object for the constraint.

Set up an IK (Inverse Kinematics) chain.

Args: armature_name: Target armature. chain_bones: List of bone names in the chain. pole_target: Pole target object name.

Parent an object to a bone (for rigging).

Args: armature_name: Target armature. bone_name: Bone to parent to. object_name: Object to parent.

Create multiple objects in one call.

Each object: {"type": "MESH", "name": "Obj", "location": [x,y,z], "scale": [sx,sy,sz]}

Args: objects: List of object definitions.

Delete multiple objects in one call.

Args: names: List of object names to delete.

Apply transforms to multiple objects in one call.

Each entry: {"name": "Obj", "location": [x,y,z], "rotation": [rx,ry,rz], "scale": [sx,sy,sz]} Only provided channels are modified per object.

Args: transforms: List of transform dicts.

Add the same modifier to multiple objects in one call.

Args: object_names: List of object names. modifier_type: Modifier type (SUBSURF, MIRROR, BEVEL, etc.) settings: Optional settings dict to apply to each modifier.

Apply material presets to multiple objects in one call.

Each entry: {"object": "name", "preset": "metal", "color": [r,g,b]}

Args: assignments: List of material preset assignments.

Rename multiple objects in one call.

Each entry: {"old": "OldName", "new": "NewName"}

Args: renames: List of rename dicts.

Set parent-child relationships for multiple pairs in one call.

Each entry: {"child": "name", "parent": "name", "keep_transform": true}

Args: parentings: List of parenting dicts.

Set visibility for multiple objects in one call.

Each entry: {"name": "Obj", "visible": true, "hide_render": false}

Args: visibilities: List of visibility dicts.

Select multiple groups of objects in one call.

Each group: {"replace": true, "names": ["Obj1", "Obj2"]} Useful for material assignment workflows.

Args: groups: List of selection groups.

Set origins for multiple objects in one call.

Each entry: {"name": "Obj", "origin_type": "GEOMETRY"}

Args: origins: List of origin dicts.

Execute a sequence of Blender commands in one call.

Each command: {"type": "create_object", "params": {...}} Commands are executed in order on the Blender main thread. This is the most powerful batch tool — it chains any operations.

Args: commands: List of command dicts with type and params.

Create a camera with optical settings.

Args: name: Camera name. location: [x, y, z] position. rotation: [x, y, z] Euler rotation. lens: Focal length in mm. sensor_width: Sensor width in mm. clip_start: Near clipping distance. clip_end: Far clipping distance.

Configure camera optical properties.

Args: name: Camera object name. lens: Focal length in mm. depth_of_field: Enable depth of field. fstop: Aperture f-stop. focus_distance: Focus distance. clip_start: Near clip. clip_end: Far clip.

Position camera to frame the current viewport or a specific object.

Args: name: Camera name (empty = active camera). target_name: Object to frame (empty = all visible). distance: Distance from target.

Make a camera always point at a target object (Track To constraint).

Args: camera_name: Camera to constrain. target_name: Object to track.

Set up a turntable camera animation (360-degree orbit).

Args: name: Camera name. target: [x, y, z] point to orbit around. distance: Orbit radius. height: Camera height. frames: Number of frames for one revolution.

Execute arbitrary Python code in Blender with full bpy access.

WARNING: This runs unvalidated code. Use structured tools when possible. Code is executed in a sandboxed environment with restricted builtins.

Args: code: Python code to execute. Has access to 'bpy' and 'bmesh'.

Execute a bpy.ops operator by name.

Args: operator_name: Full operator name (e.g., 'mesh.primitive_cube_add'). params: Optional dict of operator parameters (e.g., {'size': 2, 'location': [0,0,0]}).

Create a new collection.

Args: name: Collection name. parent: Parent collection name (empty = root).

Delete a collection.

Args: name: Collection name. keep_objects: If True, move objects to the scene collection first.

Move an object to a different collection.

Args: object_name: Object to move. collection_name: Target collection.

Toggle collection visibility in viewport.

Args: collection_name: Collection name. visible: Show or hide.

List all collections with their objects and hierarchy.

Create a curve object.

Args: name: Curve name. curve_type: BEZIER, NURBS, or POLY. points: List of [x, y, z] control points. location: [x, y, z] position. bevel_depth: Curve bevel depth (thickness). bevel_resolution: Bevel resolution. fill: FULL, HALF, or NONE.

Create a text object with formatting.

Args: name: Object name. text: The text content. location: [x, y, z] position. size: Font size. extrude: Text depth. font_path: Path to a .ttf/.otf font file.

Add or remove curve control points.

Args: curve_name: Curve object name. action: add, remove, or move. points: [x, y, z] for add/move actions. index: Point index for remove/move (-1 = last).

Set curve fill mode.

Args: curve_name: Curve object name. fill: FULL, HALF, or NONE.

Convert a curve object to a mesh.

Args: curve_name: Curve to convert. name: Name for the new mesh. Empty = auto.

Import a 3D model file.

Args: filepath: Path to the file to import. file_type: FBX, OBJ, GLTF, GLB, STL, USD, PLY, ABC, etc. (auto-detected from extension if empty).

Export objects to a 3D model file.

Args: filepath: Output file path. file_type: FBX, OBJ, GLTF, GLB, STL, USD, PLY, ABC, etc. selected_only: Only export selected objects.

Export to FBX format with common settings.

Args: filepath: Output path. selected_only: Only export selected. apply_scale: Apply scale transforms. mesh_smooth_type: OFF, FACE, or EDGE. path_mode: AUTO, ABSOLUTE, RELATIVE, MATCH, STRIP, COPY.

Export to glTF binary (GLB) format.

Args: filepath: Output path. selected_only: Only export selected. export_materials: Include materials.

Export to OBJ format.

Args: filepath: Output path. selected_only: Only export selected. export_materials: Include MTL file.

Add a geometry nodes modifier to an object.

Args: object_name: Target object. node_group_name: Name for the node group.

Add a node to a geometry node tree.

Args: node_group_name: Node group name. node_type: Node type (e.g., 'MeshPrimitiveCube', 'InstanceOnPoints', 'SetPosition'). location: [x, y] position in the node editor.

Connect two nodes in a geometry node tree.

Args: node_group_name: Node group name. from_node: Source node name. from_socket: Source socket name. to_node: Target node name. to_socket: Target socket name.

Set up points-on-faces distribution via geometry nodes.

Args: object_name: Target object to distribute on. instance_object: Object to instance on each point. Empty = just points. count: Number of instances. distribution: RANDOM, POISSON_DISK, or GRID. seed: Random seed.

Create a light source.

Args: name: Light name. light_type: POINT, SUN, SPOT, or AREA. location: [x, y, z] position. energy: Light power in watts. color: [R, G, B] light color. radius: Soft shadow radius.

Configure an existing light's properties.

Args: name: Light object name. energy: Power in watts. color: [R, G, B] light color. radius: Soft shadow radius. spot_angle: Spot cone angle in radians (spot lights only). shadow_soft_size: Shadow soft size.

Set up HDRI environment lighting.

Args: hdri_path: Path to HDRI file. If empty, uses a default gradient. strength: Environment strength. rotation: Rotation in radians.

Set up preset studio lighting configurations.

Args: style: STUDIO, PORTRAIT, PRODUCT, DRAMATIC, or SOFT. key_energy: Key light power.

List all lights in the scene with their types, positions, and energy values.

Create a new Principled BSDF material.

Args: name: Material name. color: [R, G, B, A] base color (0-1). metallic: Metallic value (0-1). roughness: Roughness value (0-1).

Assign a material to an object's material slot.

Args: object_name: Target object. material_name: Material to assign. slot: Material slot index.

Remove material from an object's slot.

Args: object_name: Target object. slot: Material slot index.

Set a property on a material's Principled BSDF node.

Args: material_name: Target material. property_name: Node input name (e.g., 'Base Color', 'Metallic', 'Roughness'). value: The value to set.

Create a complete procedural material with node graph in one call.

Creates coordinate mapping, texture node, color ramp, and Principled BSDF.

Args: name: Material name. pattern: NOISE, VORONOI, MUSGRAVE, WAVY, MAGIC, checker, marble, wood, cloud, gradient, veins, plasma. color1: First color [R, G, B]. color2: Second color [R, G, B]. scale: Texture scale. detail: Texture detail level. roughness: Surface roughness.

Add a shader node to a material's node tree.

Args: material_name: Target material. node_type: Shader node type (e.g., 'TEX_NOISE', 'TEX_VORONOI', 'MIXRGB', 'VALUE'). location: [x, y] position in the node editor. name: Optional node label.

Connect two shader nodes in a material's node tree.

Args: material_name: Target material. from_node: Source node name/label. from_socket: Source socket name. to_node: Target node name/label. to_socket: Target socket name.

Set the value of a shader node input.

Args: material_name: Target material. node_name: Node name/label. value: Value to set.

Apply an image texture to an object.

Args: object_name: Target object. image_path: Path to the image file. material_name: Optional existing material to add texture to.

List all materials in the current blend file with their names and usage counts.

Edit mesh vertices at the element level.

Args: object_name: Target mesh object. action: move, delete, smooth, or collapse. vertices: List of vertex indices to operate on (None = selected). offset: [x, y, z] offset for move action.

Edit mesh edges.

Args: object_name: Target mesh object. action: select, deselect, mark_seam, clear_seam, mark_sharp, crease. edges: List of edge indices (None = selected).

Edit mesh faces.

Args: object_name: Target mesh object. action: select, deselect, delete, fill, grid_fill, triangulate, poke. faces: List of face indices (None = selected).

Create a new vertex group on a mesh object.

Args: object_name: Target object. group_name: Name for the vertex group.

Assign vertices to a vertex group with a specific weight.

Args: object_name: Target object. group_name: Vertex group name. vertices: Vertex indices to assign. weight: Weight value (0.0 - 1.0).

Separate a mesh object into parts by material assignment.

Args: object_name: Object to separate.

Separate a mesh into disconnected parts.

Args: object_name: Object to separate.

Smooth selected vertices.

Args: object_name: Target object. factor: Smoothing factor (0-1). iterations: Number of smoothing iterations.

Convert triangles to quads.

Args: object_name: Target object. angle_limit: Angle limit in radians.

Dissolve geometry based on angle threshold.

Args: object_name: Target object. angle_limit: Angle threshold in radians.

Analyze mesh for defects: non-manifold edges, loose vertices, zero-area faces, duplicate vertices, wire edges, and twisted faces.

Returns a structured defect report with counts and affected element indices.

Get detailed mesh statistics: vertex/edge/face counts, triangle count, ngon count, volume, surface area, bounding box dimensions.

Full production readiness audit: manifold geometry, UV maps, materials, naming conventions, origin alignment. Returns a score 0-100 with detailed breakdown.

Find duplicate vertices within a distance threshold.

Args: object_name: Target object. distance: Distance threshold for duplicate detection.

Automatically fix common mesh defects.

Args: object_name: Target object. fix_manifold: Fix non-manifold geometry. merge_distance: Distance for merging duplicate vertices.

Add a modifier to an object.

Args: object_name: Target object. modifier_type: SUBSURF, MIRROR, SOLIDIFY, BOOLEAN, BEVEL, ARRAY, etc. name: Optional modifier name. params: Optional modifier settings dict (e.g. {'levels': 2, 'render_levels': 3} for SUBSURF, {'width': 0.002, 'segments': 4} for BEVEL).

Configure settings of an existing modifier.

Args: object_name: Target object. modifier_name: Name of the modifier to configure. settings: Dict of setting_name: value pairs.

Apply (bake) a modifier into the mesh.

Args: object_name: Target object. modifier_name: Name of the modifier to apply.

Remove a modifier from an object.

Args: object_name: Target object. modifier_name: Name of the modifier to remove.

Move a modifier to a specific position in the stack.

Args: object_name: Target object. modifier_name: Modifier to move. new_index: Target position (0-based).

Perform a boolean operation between two objects.

Args: object_name: Object to modify. target_name: Object to use as boolean operand. operation: UNION, INTERSECT, or DIFFERENCE.

Extrude selected faces of a mesh object (must be in edit mode).

Args: object_name: Object name. distance: Extrusion distance (0 for manual manipulation).

Inset selected faces of a mesh.

Args: object_name: Object name. thickness: Inset thickness. use_boundary: Also inset boundary edges.

Bevel selected edges of a mesh.

Args: object_name: Object name. width: Bevel width. segments: Number of segments (1 = flat bevel).

Add loop cuts to a mesh.

Args: object_name: Object name. number_cuts: Number of cuts. axis: X, Y, or Z axis.

Subdivide selected mesh geometry.

Args: object_name: Object name. cuts: Number of subdivision cuts. smooth: Smooth factor (0-1).

Merge vertices by distance (remove doubles).

Args: object_name: Object name. distance: Merge distance threshold.

Flip normals of selected faces.

Args: object_name: Object name.

Recalculate normals of a mesh.

Args: object_name: Object name. outside: If True, normals point outward.

List all currently open .blend files and their status.

Open a .blend file.

Args: filepath: Path to the .blend file. use_scripts: Whether to load linked scripts.

Save the current .blend file.

Args: filepath: Save path. If empty, saves to current location. copy: If True, save as copy (don't overwrite original).

Create a new scene within the current .blend file.

Args: name: Scene name. If empty, auto-generates one. copy_settings: Copy settings from current scene.

Switch to a different scene within the current .blend file.

Args: scene_name: Name of the scene to switch to.

Delete a scene from the current .blend file.

Args: scene_name: Name of the scene to delete.

Merge objects from another .blend file into the current scene.

Args: filepath: Path to the .blend file to merge. merge_method: 'append' (linked), 'link', or 'import' (direct copy).

Compare two scenes and list differences.

Args: filepath_a: First .blend file (current if empty). filepath_b: Second .blend file (must be specified).

Create a new object of any type with optional transform.

Args: object_type: MESH, CURVE, SURFACE, META, TEXT, ARMATURE, LATTICE, EMPTY, CAMERA, LIGHT, etc. name: Name for the new object. location: [x, y, z] world position. rotation: [x, y, z] Euler rotation in radians. scale: [x, y, z] scale factors.

Delete an object by name.

Args: name: Name of the object to delete.

Duplicate an object with all its data.

Args: name: Name of the object to duplicate. new_name: Optional name for the duplicate.

Rename an object.

Args: name: Current name of the object. new_name: New name for the object.

Select one or more objects by name.

Args: names: List of object names to select. replace: If True, deselect all others first.

Set object viewport and/or render visibility.

Args: name: Object name. visible: Viewport visibility. hide_render: Render visibility.

Set parent-child relationship between objects.

Args: child: Name of the child object. parent: Name of the parent object. keep_transform: If True, maintain the child's current world transform.

Join multiple objects into a single mesh.

Args: names: List of object names to join. First object becomes the active.

Set the origin of an object.

Args: name: Object name. origin_type: GEOMETRY, CURSOR, CENTER_OF_MASS, or CENTER_OF_VOLUME.

Convert an object to a different type (e.g., curve to mesh).

Args: name: Object name. target_type: Target type (MESH, CURVE, SURFACE, etc.).

Set shading mode for an object.

Args: name: Object name. shading: FLAT or SMOOTH.

Add rigid body physics to an object.

Args: object_name: Target object. body_type: ACTIVE (dynamic) or PASSIVE (static/kinematic). mass: Mass in kg. friction: Surface friction (0-1). restitution: Bounciness (0-1).

Add cloth simulation to an object.

Args: object_name: Target object. quality_steps: Simulation quality (1-20). mass: Cloth mass density. tension: Structural tension. compression: Structural compression.

Add fluid simulation to an object.

Args: object_name: Target object. domain_type: DOMAIN, EFFERENT, FLOW, or COLLISION. fluid_type: LIQUID or GAS.

Add a particle system to an object.

Args: object_name: Target object. particle_type: EMITTER, HAIR, or STATIC_HAIR. count: Number of particles. lifetime: Particle lifetime in frames. frame_start: Start frame. frame_end: End frame.

Add a force field effect.

Args: name: Force field name. field_type: FORCE, WIND, VORTEX, MAGNET, CHARGE, LENARD_JONES, TURBULENCE, etc. location: [x, y, z] position. strength: Field strength. flow: Field flow.

Bake physics simulation for an object.

Args: object_name: Object with physics. frame_start: First frame to bake. frame_end: Last frame to bake.

Remove all physics from an object.

Args: object_name: Target object.

Generate a procedural terrain mesh.

Args: name: Object name. size: Grid size. subdivisions: Number of subdivisions. height: Maximum height. seed: Random seed. noise_scale: Noise scale factor.

Generate a procedural tree with trunk, branches, and leaves.

Args: name: Object name. trunk_height: Height of the trunk. trunk_radius: Radius of the trunk. branch_levels: Number of branching levels. leaves_per_branch: Leaves per branch. seed: Random seed.

Generate a procedural rock.

Args: name: Object name. size: Rock size. detail: Surface detail level (0-1). roughness: Surface roughness. seed: Random seed.

Generate a field of scattered particles/objects.

Args: name: Object name. count: Number of particles. size: Field size. particle_size: Individual particle size. seed: Random seed.

Render the current scene to an image file.

Args: output_path: File path for the rendered image. If empty, uses temp file. resolution_x: Output width. resolution_y: Output height. samples: Render samples. engine: BLENDER_EEVEE, CYCLES, or BLENDER_WORKBENCH.

Render an animation sequence.

Args: output_path: Output directory path. frame_start: First frame. frame_end: Last frame. engine: Render engine.

Quick preview render for visual feedback loops.

Args: quality: LOW (320x240), MEDIUM (800x600), HIGH (1920x1080).

Configure render engine, GPU, samples, resolution, etc.

Args: engine: Render engine (CYCLES, BLENDER_EEVEE, BLENDER_WORKBENCH). samples: Number of samples for Cycles. device: "GPU" or "CPU" for Cycles device. denoising: Enable/disable denoising. max_bounces: Max light bounces for Cycles. resolution_x: Output width. resolution_y: Output height.

Get comprehensive scene information: objects, hierarchy, frame range, render settings.

Returns scene name, active object, object count with type breakdown, full object list with transforms, collection hierarchy, and render config.

List all objects in the scene with their types, locations, and visibility.

Args: object_type: Filter by type: ALL, MESH, CURVE, LIGHT, CAMERA, ARMATURE, EMPTY, etc. include_hidden: If True, include hidden objects. collection: Optional collection name to filter by.

Get detailed information about a specific object: transforms, mesh stats, materials, modifiers, constraints, vertex groups, and shape keys.

Args: name: Name of the object to inspect.

Create a new scene.

Args: name: Name for the new scene. copy_current: If True, copy the current scene's settings.

Set a scene-level property (e.g., frame_start, frame_end, fps, render_engine).

Args: property_name: The property to set (e.g., 'frame_start', 'render_resolution_x'). value: The value to set.

Configure the active sculpt brush.

Args: brush_name: Draw, Clay, Crease, Inflate, Grab, Smooth, etc. size: Brush radius. strength: Brush strength (0-1). auto_masking: Enable auto masking.

Enter sculpt mode on an object.

Args: object_name: Object to sculpt. Empty = active object.

Exit sculpt mode and return to object mode.

Configure sculpt symmetry settings.

Args: axis_x: Mirror on X axis. axis_y: Mirror on Y axis. axis_z: Mirror on Z axis. mirror: Enable mirroring.

Configure dynamic topology (dyntopo) for sculpting.

Args: enabled: Enable/disable dyntopo. detail_size: Detail size (smaller = more detail). resolution: RELATIVE, ABSOLUTE, or BRUSH.

Remesh the active object for sculpting.

Args: mode: VOXEL or SMOOTH. voxel_size: Voxel size for voxel remesh. smooth_iterations: Smooth iterations for smooth remesh.

Set world/local transform of an object. Only provided channels are modified.

Args: name: Object name. location: [x, y, z] position. rotation: [x, y, z] Euler rotation in radians. scale: [x, y, z] scale factors. space: WORLD or LOCAL coordinate space.

Move an object by delta in world or local space.

Args: name: Object name. x, y, z: Translation delta. space: WORLD or LOCAL.

Rotate an object by delta radians in world or local space.

Args: name: Object name. x, y, z: Rotation delta in radians. space: WORLD or LOCAL.

Scale an object by factors, or set absolute scale.

Args: name: Object name. x, y, z: Scale factors (1.0 = no change). Used when scale is not given. scale: Optional [sx, sy, sz] — sets the scale absolutely instead of multiplying.

Apply (bake) transforms — resets values to identity while keeping world position.

Args: name: Object name. location: Apply location. rotation: Apply rotation. scale: Apply scale.

Get the local (parent-relative) transforms of an object.

Args: name: Object name.

Align one object's transform to another.

Args: name: Object to align. target: Reference object. align_location: Match position. align_rotation: Match rotation. align_scale: Match scale.

Snap an object's origin to the 3D cursor or a specific location.

Args: name: Object name. cursor_location: Optional [x, y, z] to set cursor first.

Smart UV project unwrap.

Args: object_name: Target mesh object. angle_limit: Angle limit in degrees. island_margin: Margin between islands.

UV unwrap selected faces.

Args: object_name: Target object. method: ANGLE_BASED or CONFORMAL.

Pack UV islands to fill the UV space efficiently.

Args: object_name: Target object. margin: Margin between islands. rotate: Allow islands to rotate.

Project UVs from the current view or a specific direction.

Args: object_name: Target object. aspect_ratio: [width, height] aspect ratio. direction: VIEW, TOP, FRONT, or SIDE.

Select a UV island by index.

Args: object_name: Target object. island_index: Island index to select.

Get UV mapping information: island count, UV bounds, stretch stats.

Args: object_name: Target object.

Get current viewport state: active camera, shading mode, view matrix, cursor position.

Set viewport shading mode.

Args: mode: WIREFRAME, SOLID, MATERIAL, or RENDERED.

Set the active viewport camera.

Args: camera_name: Camera to use. Empty string = auto.

Toggle viewport overlays (grid, axes, selection outlines).

Args: show: True to show overlays, False to hide.

Take a high-quality viewport screenshot using GPU offscreen rendering.

Args: filepath: Path to save the PNG. If empty, returns base64 only. width: Output width in pixels. height: Output height in pixels. include_overlays: Include viewport overlays (grid, outlines, etc.). camera_view: Render from the active camera's perspective. render_engine: Override render engine ('BLENDER_EEVEE', 'BLENDER_CYCLES', 'BLENDER_WORKBENCH').

Take two viewport screenshots: one from user view, one from camera view.

Useful for verifying scene composition and camera framing.

Returns: user_view: Base64 PNG from the user's current viewport perspective. camera_view: Base64 PNG from the active camera's perspective.

Quick low-sample render preview for fast iteration.

Args: width: Preview width. height: Preview height. samples: Number of render samples (lower = faster, less quality).

Create a complete product photography scene in one call.

Sets up: product object, backdrop, 3-point lighting, camera, materials, render settings, and renders a preview. One tool call = finished shot.

Args: product_type: cube, sphere, cylinder, cone, torus, or a .glb/.obj/.fbx path product_color: [R, G, B] base color (0-1). Default: white. background_color: [R, G, B] backdrop color. Default: light gray. render: Whether to render (CPU-heavy). Keep False for scene building. samples: Render samples if render=True (16-32 for preview). output_path: Where to save the render. Empty = temp file.

Create a complete architectural interior room in one call.

Sets up: walls, floor, ceiling, windows, door, furniture, materials, lighting, camera, and render settings. Fully furnished.

Args: room_width: Room width in meters. room_depth: Room depth in meters. room_height: Ceiling height in meters. wall_color: [R, G, B] wall paint color. floor_color: [R, G, B] floor color (wood tone). style: modern, minimalist, industrial, cozy, or scandinavian. render: Whether to render (CPU-heavy). Keep False for scene building. samples: Render samples if render=True (16-32 for preview). output_path: Where to save the render.

Create a character basemesh with rig in one call.

Full body with correct proportions, edge loops at joints, mirror modifier. Optional humanoid armature with IK.

Args: height: Character height in meters. Default: 1.75m (average human). style: humanoid, creature, robot, or cartoon. gender: male, female, or neutral. subdivisions: Subdivision surface levels (0-3). add_armature: Whether to add a basic humanoid armature. render: Whether to render (CPU-heavy). Keep False for scene building. samples: Render samples if render=True (16-32 for preview). output_path: Optional file to save the .blend.

Create a complete natural environment in one call.

Generates: terrain, vegetation, sky, lighting, and camera.

Args: env_type: forest, desert, ocean, mountain, meadow, or city. time_of_day: day, sunset, night, or dawn. density: Vegetation/object density (0-1). terrain_size: Terrain dimensions in meters. render: Whether to render (CPU-heavy). Keep False for scene building. samples: Render samples if render=True (16-32 for preview). output_path: Optional file to save the .blend.

Create a professional studio render setup in one call.

Complete scene: subject, backdrop, lighting rig, camera, render settings. Multiple style presets available.

Args: subject_type: cube, sphere, cylinder, torus, or a file path (.glb/.obj/.fbx) subject_color: [R, G, B] subject color. preset: studio, portrait, dramatic, soft, or rim. resolution: LOW (800x600), MEDIUM (1920x1080), HIGH (3840x2160). render: Whether to render (CPU-heavy). Keep False for setup only. samples: Render samples if render=True (16-32 for preview). output_path: Where to save the render.

UV unwrap all mesh objects in the scene in one call.

Smart project or lightmap unwrap for every mesh, with island packing.

Args: method: smart or lightmap. margin: UV island margin (0-1). fix_islands: Auto-fix flipped and overlapping islands.

Optimize the entire scene for export or rendering in one call.

Applies modifiers, removes doubles, fixes normals, decimates if needed.

Args: apply_modifiers: Apply all modifiers on all mesh objects. merge_by_distance: Merge distance for doubles removal. 0 = skip. remove_loose: Remove loose vertices/edges. recalculate_normals: Recalculate all normals outward. decimate_ratio: Decimation ratio (0 = skip, 0.5 = halve poly count).

Apply a complete PBR material preset to an object in one call.

Pre-configured recipes for common materials with correct roughness, metallic, and subsurface values.

Args: object_name: Target object. preset: metal, chrome, gold, wood, glass, plastic, concrete, fabric, leather, rubber, ceramic, marble, skin, emissive. color: Override base color [R, G, B]. None = preset default.

Build a scene from a natural language description in one call.

Parses the description and creates objects, materials, lighting, and camera to match. Works best with simple, clear descriptions.

Args: description: Plain English description of the scene. render: Whether to render (CPU-heavy). Keep False for scene building. samples: Render samples if render=True (16-32 for preview). output_path: Where to save the render.

Create a turntable animation around the scene or a specific object.

Sets up camera orbit, lighting, and renders if requested.

Args: target_object: Object to orbit around. Empty = world origin. frames: Number of frames for full rotation. height: Camera height above target. distance: Camera distance from target. render: Whether to render the animation. output_path: Output directory for rendered frames.

Assign materials to multiple objects in one call.

Each assignment: {"object": "name", "material": "mat_name", "color": [r,g,b]} Creates materials if they don't exist.

Args: assignments: List of assignment dicts with object, material, and optional color.

Create a 360-degree turntable rotation animation on an object.

Works for products, characters, environments, anything. Sets keyframes at frame 1 and frame N with full rotation. Applies bezier easing (AUTO_CLAMPED handles) for smooth ease in/out. Optionally adds cyclic modifier for seamless looping.

Args: object_name: Object to animate. frames: Total frames for one full rotation. axis: Rotation axis (X, Y, or Z). cyclic: Whether to make the animation loop.

Make an object's animation loop cyclically.

Args: object_name: Target object. cyclic: True to loop, False to stop.

Set bezier interpolation with auto-clamped handles on all keyframes.

Produces smooth ease-in and ease-out on every keyframe of the object.

Args: object_name: Target object.

Set up camera for studio rendering of any subject.

Positions camera at 3/4 angle (front + side visible), slightly above eye level. Uses 85-100mm focal length for natural proportions. f/8 for full sharpness, f/2.8 for bokeh.

Works for products, characters, environments, portraits, anything.

Args: target_name: Object to point camera at (empty = world origin). camera_name: Name for the camera object. focal_length: Lens focal length in mm (85-100 recommended). fstop: Aperture f-stop (8-11 for full sharpness, 2.8 for bokeh). distance: Camera distance from target in meters. height_offset: Camera height above target (0 = eye level). angle_offset: Horizontal angle (0 = front, 1 = side).

Adjust camera position relative to a target without recreating it.

Useful for re-framing or adjusting composition.

Args: camera_name: Camera to adjust. target_name: Object to frame. distance: New distance from target. height_offset: New height offset. angle_offset: New horizontal angle.

Set up 3-point studio lighting (key, fill, rim).

Works for products, characters, environments, portraits. Removes existing lights and creates optimized area lights.

Args: key_energy: Key light power in watts. fill_energy: Fill light power (typically 1/3 of key). rim_energy: Rim/back light power (typically 1/2 of key). key_color: RGB key light color. fill_color: RGB fill light color. rim_color: RGB rim light color. key_position: [x,y,z] position for key light. fill_position: [x,y,z] position for fill light. rim_position: [x,y,z] position for rim light. remove_existing: Remove existing lights first.

Set world background for studio environment.

Args: strength: Background strength (0.1 = subtle, 1.0 = bright). color: RGB background color.

Create a ground plane for studio scenes.

Works as a floor for products, characters, or any standing object. Dark matte by default, configurable color and roughness.

Args: color: RGB floor color (0-1). Default: near-black. roughness: Surface roughness. 0.3 = subtle reflection. size: Floor size in meters. height: Floor Z position. name: Name for the floor object.

Configure a display/emissive material for any scene.

Sets dark base color, low roughness, and optional emission. Works for phone screens, monitors, TVs, control panels, HUDs, or any emissive surface.

Args: material_name: Name of the material to configure. color: RGB base color (0-1). Default: near-black. roughness: Surface roughness. 0.03 = mirror-like. emission_color: RGB emission color. emission_strength: Emission intensity. 0 = off, 1+ = glowing.

Configure glass/transparent material for EEVEE.

Works for windows, lenses, screens, bottles, or any transparent surface.

Args: material_name: Name of the glass material. transmission: Transmission weight (0-1). 0.95 = fully glass-like. ior: Index of refraction. 1.52 = standard glass. roughness: Surface roughness. 0.0 = perfect mirror.

Configure a solid body/casing material.

Works for product casings, furniture surfaces, architectural elements, or any solid opaque surface.

Args: material_name: Name of the body material. color: RGB base color (0-1). roughness: Surface roughness. metallic: Metallic value. 0.0 = dielectric, 1.0 = metal.

Reassign all faces from one material slot to another.

Useful for replacing one material with another across the entire mesh.

Args: object_name: Target mesh object. from_slot: Source material slot index. to_slot: Destination material slot index.

Add a constraint to an object.

Common types: COPY_LOCATION, COPY_ROTATION, COPY_SCALE, TRACK_TO, FOLLOW_PATH, CHILD_OF, LIMIT_LOCATION, LIMIT_ROTATION, LIMIT_SCALE, TRANSFORM, CLAMP_TO, DAMPED_TRACK_TO, IK, PUSH_PULL,Stretch To.

Args: object_name: Target object. constraint_type: Constraint type (e.g. 'COPY_LOCATION'). name: Custom name for the constraint. target_name: Target object for the constraint. subtarget: Sub-target (bone name for armature targets). settings: Dict of constraint properties to set.

Remove a constraint from an object.

Args: object_name: Target object. constraint_name: Name of the constraint to remove.

Add a shape key (morph target) to a mesh object.

Automatically creates the Basis key if none exists.

Args: object_name: Target mesh object. name: Name for the new shape key. from_mix: Create from current mesh state.

Set the value of a shape key to control morphing.

Args: object_name: Target mesh object. key_name: Name of the shape key. value: Morph value (0.0 = base, 1.0 = full morph).

Remove a shape key from an object.

Args: object_name: Target mesh object. key_name: Name of the shape key to remove.

Add an NLA track to an object for layering animation clips.

Args: object_name: Target object with animation data. name: Name for the new track.

Add an animation clip (strip) to an NLA track.

Args: object_name: Target object. track_name: NLA track to add the strip to. action_name: Action (animation clip) to use. name: Custom name for the strip. start_frame: Frame where the strip starts. scale: Time scale for the strip. repeat: Number of times to repeat. blend_type: REPLACE, ADD, SUBTRACT, MULTIPLY.

Add a timeline marker for animation notes or camera binding.

Args: name: Marker name. frame: Frame number for the marker. camera_name: Camera to bind to this marker (optional).

Remove a timeline marker.

Args: marker_name: Name of the marker to remove.

Add a color attribute (vertex color layer) to a mesh.

Args: object_name: Target mesh object. name: Name for the color attribute. domain: CORNER (per-loop) or POINT (per-vertex). data_type: BYTE_COLOR (0-1 byte) or FLOAT_COLOR (0-1 float).

Set color on vertices/loops of a color attribute.

Args: object_name: Target mesh object. attribute_name: Name of the color attribute. color: RGBA color [R, G, B, A] (0-1). indices: Specific loop/vertex indices to color. None = all.

Set a custom property on an object or bone.

Custom properties store user-defined data — useful for rig controls, material parameters, animation drivers, or any metadata.

Args: object_name: Target object (or empty if using bone). bone_name: Target bone (with armature_name). armature_name: Armature containing the bone. property_name: Name of the custom property. value: Property value. min_value: Minimum allowed value. max_value: Maximum allowed value. description: Property description.

Read a custom property from an object or bone.

Args: object_name: Target object. bone_name: Target bone. armature_name: Armature containing the bone. property_name: Name of the custom property.

Set up a procedural sky texture in the world environment.

Args: sky_type: NISHITA (physical sky), PREETHAM, or HOSEK_WILKIE. strength: Background strength. sun_elevation: Sun angle above horizon in degrees. sun_rotation: Sun rotation around zenith in degrees. air_density: Air density (NISHITA only). dust_density: Dust density (NISHITA only). ozone_density: Ozone density (NISHITA only).

Set up compositing nodes for post-processing.

Creates Render Layers → [custom nodes] → Composite + Viewer.

Args: nodes: List of node dicts: [{"type": "CompositorNodeGlare", "settings": {"glare_type": "FOG_GLOW"}}]

Create a lattice for free-form mesh deformation.

Optionally binds to a target object via Lattice modifier.

Args: name: Name for the lattice. location: [x, y, z] position. points_u: Control points in U direction. points_v: Control points in V direction. points_w: Control points in W direction. target_object: Object to apply lattice modifier to (optional).

Apply lattice modifier to bake deformation into mesh.

Args: object_name: Target object with lattice modifier. modifier_name: Name of the lattice modifier.

Enter weight paint mode for rigging.

Args: object_name: Object to paint (empty = active object).

Enter vertex paint mode.

Args: object_name: Object to paint (empty = active object).

Link or append data from an external .blend file.

Args: filepath: Path to the .blend file. data_type: OBJECT, MESH, MATERIAL, ACTION, or NODE_GROUP. names: List of data block names to link. link: True = linked (updates with source), False = appended (independent copy).

Set custom split normals for precise shading control.

Args: object_name: Target mesh object. normals: List of [x, y, z] normal vectors (one per loop). angle: Auto-smooth angle in radians.

Get an ultra-compact scene summary (~200 tokens) for weak LLMs.

Returns: object count, types, materials, camera, lights, render engine. Designed to fit in small context windows while providing actionable info.

Get scene info tailored to the model's context size.

Args: complexity: compact (~200 tokens for weak models), standard (~500 tokens for most models), detailed (~2000 tokens for large models).

Analyze the current scene and suggest the next logical step.

Returns 1-3 concrete suggestions based on what's in the scene, what's missing, and common 3D workflows. Helps weak models stay on track without requiring them to plan ahead.

Full scene analysis with quality metrics in compact format.

Returns: poly count, material count, lighting setup, camera info, bounding box, and quality issues (non-manifold, ngons, etc.) All in a single compact response.