Check if the Blender addon is reachable and return version info.

Get current scene metadata: name, frame range, FPS, render engine, object/material counts.

Load a .blend file. This replaces the current scene — confirm to proceed.

Save the current scene. If filepath is provided, save-as to that path.

Set the current frame.

Set the scene frame range (start and/or end frame).

Get detailed info about an object: type, transforms, modifiers, materials, parent, collections.

List all objects in the scene. Optionally filter by type (MESH, CAMERA, LIGHT, EMPTY, etc.).

Create a new object. Types: CUBE, SPHERE, CYLINDER, CONE, TORUS, PLANE, CIRCLE, GRID, MONKEY, UV_SPHERE, ICO_SPHERE, EMPTY. Returns the actual name assigned (may differ if name already exists).

Delete an object by name. Confirm required.

Set an object's location, rotation (radians), and/or scale.

Apply (freeze) the object's transforms to mesh data. Resets the applied transforms to identity.

Duplicate an object. If linked=True, the copy shares mesh data with the original.

Rename an object. Returns the actual name assigned (may be auto-incremented).

Set parent-child relationship between objects.

Clear an object's parent, keeping its world transform.

Set an object's origin point. Types: ORIGIN_GEOMETRY, ORIGIN_CENTER_OF_MASS, ORIGIN_CENTER_OF_VOLUME, ORIGIN_CURSOR, GEOMETRY_ORIGIN.

Select objects by name list, glob pattern, or type. Deselects others by default.

List all materials in the blend file with user counts.

Get material settings: base color, metallic, roughness, node tree summary.

Create a new Principled BSDF material. base_color is [R, G, B, A] (0-1 range).

Assign a material to an object. If slot is specified, replaces that slot; otherwise appends a new slot.

Remove a material slot from an object by slot index.

Set a Principled BSDF property. Properties: base_color, metallic, roughness, specular, transmission, emission_color, emission_strength, alpha, normal_strength.

Duplicate a material. Returns the new material name.

Delete a material. Confirm required. Removes from all object slots.

Get viewport settings: shading mode, overlays, camera, clip distances.

Capture a screenshot of the 3D viewport to a file. Returns the file path.

Set viewport shading mode: WIREFRAME, SOLID, MATERIAL, RENDERED.

Set the active camera for the viewport. Pass camera object name, or None for default.

Frame the viewport to show selected objects (Numpad .).

Frame the viewport to show all objects (Home key).

List all collections with child counts, object counts, and visibility.

Create a new collection, optionally under a parent collection.

Move an object to a collection (removes from current collections).

Set collection visibility in viewport and/or render.

Delete a collection. Objects in it become orphaned. Confirm required.

Get render settings: engine, resolution, samples, output path, file format.

Configure render settings. Engine: CYCLES, BLENDER_EEVEE_NEXT, BLENDER_WORKBENCH. File format: PNG, JPEG, EXR, TIFF. Color mode: BW, RGB, RGBA.

Render the current frame to an image file. Uses scene output path if filepath not specified.

Render the full animation frame range. This is a long-running operation.

Render the viewport (OpenGL render) to a file.

List available render engines.

Execute Python code inside Blender. Dangerous patterns are blocked by default. Use this only when no dedicated tool exists for the operation. Confirm required.

Evaluate a Python expression inside Blender and return the result. Safe for read-only queries like 'len(bpy.data.objects)' or 'bpy.context.mode'.

Search for objects by name pattern (glob), type, material, or collection.

Set the same property on multiple objects at once.

Delete multiple objects at once. Confirm required.

Find objects with issues: missing textures, broken modifiers, invalid references.

Import a file into the scene. Supported formats: FBX, OBJ, GLTF/GLB, USD, Alembic, STL, PLY, SVG, DAE. Format is auto-detected from extension if not specified.

Export the scene to a file. Format is auto-detected from extension if not specified.

List supported import and export file formats.

Export only selected objects to a file.

List all modifiers on an object with their type and settings.

Add a modifier to an object. Common types: SUBSURF, BOOLEAN, ARRAY, MIRROR, SOLIDIFY, BEVEL, DECIMATE, SMOOTH, SHRINKWRAP, ARMATURE, CURVE, LATTICE.

Remove a modifier from an object by name.

Set a modifier property. Property names are Blender API names (e.g., 'levels' for SUBSURF, 'count' for ARRAY, 'operation' for BOOLEAN).

Apply a modifier, baking it into the mesh. Requires Object Mode. Irreversible.

Move a modifier up or down in the stack. Direction: UP or DOWN.

Toggle modifier visibility in viewport and/or render.

Copy all modifiers from source object to target object.

List all lights in the scene with type and settings.

Create a light. Types: POINT, SUN, SPOT, AREA.

Set a light property: energy, color, shadow_soft_size, spot_size, spot_blend, use_shadow, size (area light).

Set up HDRI environment lighting from an image file.

Set world/environment property: color, strength.

Get current world/environment shader settings.

Create a three-point lighting setup (key, fill, rim). Optionally aimed at a target object.

List all cameras with their settings.

Create a camera with specified focal length.

Set camera property: focal_length, sensor_width, clip_start, clip_end, dof_use, dof_focus_distance, dof_aperture_fstop.

Set the active scene camera.

Point a camera at a target object or world location.

Configure depth of field on a camera. Focus on an object or at a specific distance.

Get keyframes on an object, optionally filtered to a specific data_path (e.g., 'location', 'rotation_euler').

Insert a keyframe on an object property at a specific frame. Use index for individual channels (0=X, 1=Y, 2=Z), or -1 for all channels.

Batch insert multiple keyframes. Each entry: {frame: int, value: float|list}. More efficient than calling set_keyframe repeatedly.

Delete a keyframe at a specific frame.

Remove all animation data (keyframes, actions) from an object. Irreversible.

Get info about an action: frame range, channels, keyframe count.

List all actions in the blend file.

Set keyframe interpolation for all keyframes on a channel. Types: BEZIER, LINEAR, CONSTANT.

Set the preview/playback range.

Control animation playback: PLAY, PAUSE, STOP.

List constraints on an object or pose bone.

Add a constraint. Types: COPY_LOCATION, COPY_ROTATION, COPY_SCALE, TRACK_TO, DAMPED_TRACK, LOCKED_TRACK, LIMIT_LOCATION, LIMIT_ROTATION, LIMIT_SCALE, IK, CHILD_OF, FLOOR, FOLLOW_PATH, CLAMP_TO.

Remove a constraint by name.

Set a constraint property. Common: target, subtarget, influence, axis.

Set constraint influence (0.0 to 1.0).

Move a constraint up or down. Direction: UP or DOWN.

Get mesh info: vertex/edge/face count, UV maps, vertex groups, has_custom_normals.

Get vertex positions. Optionally filter by vertex group. Limited to avoid huge payloads.

Set vertex positions. Each entry: {index: int, co: [x, y, z]}.

Get vertex groups on a mesh with member counts.

Create a vertex group, optionally assigning vertices with a weight.

Set shading mode. smooth=True for smooth shading, False for flat. auto_smooth uses angle threshold (radians).

Separate mesh into multiple objects. Modes: LOOSE (by loose parts), MATERIAL (by material), SELECTED.

Join multiple mesh objects into one. The first object becomes the active/target. Destroys source objects.

Create a curve object. Types: BEZIER, NURBS, POLY (path).

Get curve info: spline count, point count, dimensions, bevel settings.