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.

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.

Set control point positions on a spline. Each entry: {co: [x,y,z], handle_left: [x,y,z], handle_right: [x,y,z]} for Bezier, or {co: [x,y,z,w]} for NURBS/Poly.

Set curve property: bevel_depth, bevel_resolution, extrude, dimensions (2D/3D), resolution_u, fill_mode.

Convert a curve object to a mesh. Loses curve editability.

Add a physics simulation. Types: RIGID_BODY, CLOTH, FLUID, SOFT_BODY, COLLISION.

Remove physics from an object.

Set a physics property. E.g., type=RIGID_BODY, property=mass, value=5.0.

Get physics settings on an object.

Configure the rigid body world and collection.

Template: Set up cloth simulation with optional pinning vertex group.

Template: Set up fluid simulation with domain and optional emitter.

Template: Set up softbody simulation.

Bake physics simulation. Long-running operation.

Free baked physics simulation data. Irreversible.

Get the full shader node tree: nodes, links, input values.

Add a shader node to a material. Common types: ShaderNodeBsdfPrincipled, ShaderNodeTexImage, ShaderNodeTexNoise, ShaderNodeMixRGB, ShaderNodeBump, ShaderNodeNormalMap, ShaderNodeMapping, ShaderNodeTexCoord, ShaderNodeValToRGB, ShaderNodeMath.

Remove a node from a material's node tree.

Connect an output socket to an input socket. Sockets can be specified by name or index.

Disconnect an input socket on a node.

Set a node input's default value (color, float, vector).

Get a node input's current default value.

Set a node's position in the editor.

List available shader node types.

Create a node group from selected nodes.

Add an instance of an existing node group to a material.

Auto-arrange nodes in a material's node tree.

Get the geometry node tree structure: nodes, links, inputs.

Add a geometry nodes modifier. Creates a new tree or uses an existing one.

Add a node to a geometry node tree. Common types: GeometryNodeMeshGrid, GeometryNodeMeshCube, GeometryNodeSetPosition, GeometryNodeTransform, GeometryNodeJoinGeometry, GeometryNodeInstanceOnPoints, GeometryNodeDistributePointsOnFaces.

Remove a node from a geometry node tree.

Connect nodes in a geometry node tree.

Disconnect an input on a geometry node.

Set a geometry node input's default value.

Get a geometry node input's current value.

List available geometry node types for the current Blender version.

Set a modifier-level input (Group Input interface value).

Get the compositor node tree structure.

Enable the compositor (use_nodes=True on scene).

Add a compositor node. Common types: CompositorNodeRLayers, CompositorNodeComposite, CompositorNodeViewer, CompositorNodeMixRGB, CompositorNodeBlur, CompositorNodeGlare, CompositorNodeColorBalance, CompositorNodeBrightContrast, CompositorNodeHueSat.

Remove a compositor node.

Connect compositor nodes.

Set a compositor node input value.

List available compositor node types.

Template: Create Render Layers -> Composite + Viewer setup.

Create an armature with an initial bone.

Get armature info: bone hierarchy, bone count.

Add a bone to an armature. Head and tail are 3D positions.

Set a bone property: roll, envelope_distance, head, tail, use_connect.

Get bone info: head, tail, roll, parent, children, constraints.

Parent a mesh to an armature. Mode: AUTOMATIC (auto weights), EMPTY (no weights).

Assign vertex weights to a bone's vertex group.

Add a constraint to a pose bone. Types: IK, COPY_ROTATION, COPY_LOCATION, LIMIT_ROTATION.

Set a pose bone's transform (location and/or rotation in pose space).

List constraints on a pose bone.

Add a particle system. Types: EMITTER, HAIR.

Remove a particle system by name.

Set a particle system property: count, lifetime, emit_from, physics_type, size.

Get particle system settings.

Template: Set up hair particles with children and physics.

Bake particle simulation.

Switch an object to sculpt mode.

Set the active sculpt brush and settings. Brushes: DRAW, CLAY, CLAY_STRIPS, INFLATE, GRAB, SMOOTH, FLATTEN, PINCH, CREASE, SCRAPE.

Remesh an object. Modes: VOXEL, QUAD (quadriflow).

Convert sculpt mask to a vertex group.

Create a grease pencil object.

Get grease pencil info: layers, frames, stroke count.

Add a layer to a grease pencil object.

Set a GP layer property: color, opacity, thickness, use_lights.

Create a stroke from point list. Each point: {co: [x,y,z], pressure: float, strength: float}.

Add a GP modifier. Types: GP_THICK, GP_NOISE, GP_SMOOTH, GP_SUBDIV, GP_TINT, GP_OPACITY.

List all images in the blend file.

Load an image from file into the blend file.

Get UV maps on a mesh object.

Add a UV map to a mesh object.

Auto UV unwrap using smart project. Angle limit in radians (default ~66 degrees).

Pack all external images into the blend file.