Get information about the current Blender scene including name, frame range, render engine, resolution, and object count.

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

Get the position, rotation, and scale of a Blender object by name.

Get the parent/child hierarchy of objects. If name is provided, returns the subtree for that object. Otherwise returns the full scene hierarchy.

List all materials in the Blender file.

Create a new mesh object in Blender. Supported types: cube, sphere, cylinder, plane, cone, torus.

Delete an object from the Blender scene by name.

Move an object. Provide either 'location' for absolute positioning or 'offset' for relative movement.

Set the rotation of an object. Provide rotation as [x, y, z] angles. By default angles are in degrees.

Set the scale of an object. Provide scale as [x, y, z].

Duplicate an object in the Blender scene. Optionally provide a new name.

Create a new material. Optionally set an initial base color as [r, g, b] with values 0-1.

Assign an existing material to an object.

Set the base color of a material. Color is [r, g, b] with values 0-1.

Set an image texture as the base color of a material. Provide the file path to the image.

Render the current scene as a still image. Optionally set output path, resolution, and render engine (BLENDER_EEVEE, CYCLES, etc.). Use transport='bridge' for the live Blender add-on session, or transport='headless' with blend_file='/path/to/file.blend' to render in a separate background Blender process.

Render an animation. Optionally set output path, frame range, and render engine. Use transport='bridge' for the live Blender add-on session, or transport='headless' with a blend_file to render in a separate background Blender process.

Export the scene as glTF/GLB. Provide the output file path.

Export the scene as OBJ. Provide the output file path.

Export the scene as FBX. Provide the output file path.

Undo the last operation in Blender.

Redo the last undone operation in Blender.

Execute a Python script in Blender's context synchronously. Provide either 'code' (inline Python string) or 'script_path' (path to a .py file), not both. The script has access to 'bpy', 'mathutils', and an 'args' dict with your supplied arguments. Set 'result' in the script to return a JSON-serializable value. Returns the result, captured stdout/stderr, and execution duration. Use transport='bridge' for the live Blender add-on session, or transport='headless' to run the script in a separate blender -b process. For long-running tasks like baking, use blender_python_exec_async.

Start a long-running Python script in Blender asynchronously. Same parameters as blender_python_exec. Returns a job_id immediately. Use blender_job_status to poll for completion, and blender_job_cancel to abort. The script can check 'cancel_event.is_set()' to detect cancellation. Ideal for fluid baking, rigid body simulation, or heavy scene generation. Use transport='headless' to run the job in a separate background Blender process.

Get the status of an async Blender job. Returns job_id, status (queued/running/succeeded/failed/cancelled), timestamps, result, stdout, stderr, and error. Poll this after starting a job with blender_python_exec_async.

Cancel a running or queued async Blender job. The job's cancel_event is set; scripts that check it will stop gracefully.

List known async Blender jobs with their IDs, statuses, and creation timestamps.