Blender MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
You are connected to Blender through Blender MCP.
Visual verification workflow (required when screenshots are available):
Inspect the scene before changing user content.
Prefer creating a dedicated collection for new work.
Perform modeling/material/lighting/camera operations with meaningful names.
Capture a viewport or camera screenshot.
Inspect the image, fix issues, and capture again.
Only then report completion.
Do not delete existing user objects unless explicitly asked. Prefer dedicated tools over execute_blender_code. execute_blender_code is powerful and not a secure sandbox.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_scene_infoC | Return detailed information about the current Blender scene. |
| get_scene_summaryC | Return a compact summary of the current scene. |
| get_scene_hierarchyB | Return the scene collection hierarchy. |
| get_objectsC | List objects with optional filtering and pagination. |
| get_object_infoB | Get detailed info for a single object by name. |
| get_selected_objectsB | List currently selected objects. |
| get_active_objectA | Return the active object, if any. |
| get_collectionsB | List collections in the scene. |
| get_object_transformC | Get location/rotation/scale for an object. |
| get_mesh_statisticsB | Get mesh statistics for an object or the whole scene. |
| get_scene_settingsB | Get unit/frame/gravity and related scene settings. |
| get_camera_infoC | Get camera information. |
| get_materialsB | List materials in the blend file. |
| get_lightsA | List lights in the scene. |
| get_modifiersC | List modifiers on an object. |
| get_animation_infoC | Summarize animation data and timeline. |
| get_current_frameA | Get the current frame number. |
| diagnose_blender_connectionB | Diagnose MCP-to-Blender connectivity and capabilities. |
| create_objectD | Create a generic object by type. |
| create_meshC | Create an empty mesh object. |
| create_primitiveC | Create a mesh primitive (cube, uv_sphere, cylinder, ...). |
| create_cubeC | Create a cube. |
| create_sphereD | Create a UV sphere. |
| create_uv_sphereC | Create a UV sphere with segment/ring control. |
| create_ico_sphereD | Create an icosphere. |
| create_cylinderD | Create a cylinder. |
| create_coneD | Create a cone. |
| create_torusD | Create a torus. |
| create_planeD | Create a plane. |
| create_circleD | Create a circle. |
| create_curveC | Create a Bezier curve. |
| create_textC | Create a text object. |
| create_emptyD | Create an empty. |
| duplicate_objectD | Duplicate an object. |
| create_array_of_objectsC | Duplicate an object into an array along an offset. |
| modify_objectC | Modify common object properties. |
| move_objectD | Move an object. |
| rotate_objectC | Rotate an object (Euler radians). |
| scale_objectD | Scale an object. |
| set_object_transformC | Set full object transform. |
| rename_objectC | Rename an object. |
| set_object_originC | Set object origin. |
| set_object_visibilityC | Set object visibility flags. |
| set_object_shadingC | Set smooth or flat shading. |
| set_object_parentD | Parent an object. |
| unparent_objectC | Unparent an object. |
| join_objectsC | Join multiple mesh objects. |
| separate_objectsC | Separate a mesh object. |
| delete_objectB | Delete a single object (requires confirmed=true when confirm_destructive is on). |
| delete_objectsC | Delete multiple objects by explicit names. |
| apply_transformD | Apply object transform. |
| reset_transformC | Reset object transform channels. |
| edit_meshC | Run a structured mesh edit operation on an object. |
| extrude_meshC | Extrude selected mesh geometry (object-mode helper). |
| inset_facesC | Inset faces on a mesh object. |
| bevel_meshC | Bevel mesh edges. |
| subdivide_meshC | Subdivide mesh faces. |
| merge_verticesC | Merge vertices by distance. |
| delete_geometryC | Delete mesh geometry components. |
| fill_facesC | Fill selected boundary with faces where possible. |
| triangulate_meshD | Triangulate a mesh. |
| remesh_meshC | Apply remesh via modifier and apply it. |
| decimate_meshD | Decimate a mesh. |
| smooth_meshC | Smooth mesh vertices. |
| recalculate_normalsC | Recalculate mesh normals. |
| mesh_cleanupD | Run common mesh cleanup operations. |
| add_modifierC | Add a modifier to an object. |
| remove_modifierC | Remove a modifier from an object. |
| modify_modifierD | Update modifier settings. |
| apply_modifierD | Apply a modifier. |
| list_modifiersC | List modifiers on an object with settings. |
| create_materialC | Create a Principled BSDF material. |
| assign_materialC | Assign a material to an object. |
| remove_materialC | Remove a material slot from an object. |
| modify_materialC | Modify Principled BSDF inputs on a material. |
| get_material_infoC | Inspect a material and its nodes. |
| list_materialsC | List all materials. |
| set_material_colorC | Set material base color. |
| set_material_propertiesC | Set common Principled BSDF properties. |
| create_basic_shaderC | Create a basic Principled material. |
| create_emission_materialC | Create an emission material. |
| create_metallic_materialD | Create a metallic material. |
| create_glass_materialD | Create a glass material. |
| create_transparent_materialC | Create a transparent material. |
| get_material_nodesC | List nodes in a material node tree. |
| set_material_nodesC | Apply structured node operations to a material. |
| assign_textureC | Assign an image texture to a material input. |
| create_geometry_nodes_modifierC | Add a Geometry Nodes modifier. |
| create_node_groupC | Create a geometry node group. |
| add_geometry_nodeC | Add a node to a geometry node group. |
| connect_geometry_nodesC | Connect two geometry nodes. |
| set_geometry_node_inputC | Set a geometry node input value. |
| inspect_node_groupC | Inspect a node group structure. |
| list_geometry_node_typesA | List available geometry node type identifiers. |
| get_node_socket_infoC | Get socket schema for a node. |
| create_cameraD | Create a camera. |
| modify_cameraD | Modify camera settings. |
| set_active_cameraC | Set the active scene camera. |
| focus_camera_on_objectC | Point/focus a camera at an object. |
| frame_objectsC | Frame objects in a camera view. |
| configure_camera_lensC | Configure camera lens settings. |
| configure_camera_depth_of_fieldD | Configure camera depth of field. |
| camera_viewC | Return camera framing metadata for visual verification. |
| create_lightD | Create a light. |
| modify_lightD | Modify light settings. |
| delete_lightC | Delete a light object. |
| get_light_infoD | Get light information. |
| create_lighting_setupC | Create a lighting preset (three_point, studio, product, outdoor, interior, cinematic). |
| render_sceneD | Render the current frame. |
| render_previewC | Render a fast preview image. |
| render_finalC | Render a higher-quality still. |
| render_animationC | Render an animation range. |
| get_render_settingsC | Get render settings. |
| set_render_settingsC | Update render settings with configured limits enforced. |
| set_output_pathC | Set render output path. |
| get_render_resultA | Return the last render result path/metadata. |
| create_keyframeC | Insert a keyframe on an object. |
| set_keyframeC | Set a property value and keyframe it. |
| remove_keyframeC | Remove a keyframe. |
| animate_locationC | Keyframe object location. |
| animate_rotationC | Keyframe object rotation. |
| animate_scaleD | Keyframe object scale. |
| set_animation_rangeC | Set scene animation range. |
| set_current_frameC | Set the current frame. |
| inspect_animationD | Inspect animation data. |
| create_animation_previewC | Capture frames for an animation preview strip. |
| search_assetsC | Search external asset providers (polyhaven, sketchfab, polypizza). |
| import_external_assetC | Download metadata/URLs then ask Blender to import when a local path is available. |
| list_asset_providersA | List configured asset providers and credential status (no secrets). |
| import_polyhaven_via_blenderB | Ask Blender to import a Poly Haven asset by id (addon-side download). |
| import_assetC | Import a 3D asset (FBX/OBJ/STL/GLTF/GLB/USD/BLEND). |
| export_assetC | Export selected or named objects. |
| export_selected_objectsC | Export currently selected objects. |
| export_sceneC | Export the full scene. |
| save_blend_fileC | Save the current .blend file. |
| save_asC | Save the blend file to a new path. |
| open_blend_fileD | Open a .blend file. |
| get_project_pathB | Get the current blend file path. |
| create_collectionD | Create a collection. |
| delete_collectionD | Delete a collection. |
| rename_collectionD | Rename a collection. |
| move_object_to_collectionC | Move an object into a collection. |
| get_collection_infoC | Get collection details. |
| organize_sceneC | Organize objects into logical collections. |
| create_hierarchyC | Create nested collections by path names. |
| get_viewport_screenshotC | Capture the 3D viewport as an image for visual verification. |
| capture_viewportC | Capture the viewport with optional view/shading overrides. |
| capture_camera_viewC | Capture from the active or named camera. |
| capture_scene_previewC | Capture a scene preview image. |
| capture_multiple_anglesC | Capture multiple orthographic/perspective angles. |
| capture_wireframeC | Capture a wireframe viewport image. |
| capture_material_previewC | Capture a material preview viewport image. |
| capture_renderC | Capture or return the latest render preview. |
| inspect_renderA | Return metadata about the latest captured/rendered image. |
| execute_blender_codeC | Execute Python code inside Blender when script permissions allow it. |
| blender_mcp_versionA | Return Blender MCP server version and bridge configuration (no secrets). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| create_product_model | |
| create_environment | |
| create_low_poly_scene | |
| create_character | |
| improve_scene | |
| optimize_scene | |
| lighting_artist | |
| material_artist | |
| scene_inspector | |
| render_preparation |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| scene_summary | Current Blender scene summary. |
| scene_objects | Objects in the current scene. |
| scene_hierarchy | Scene collection hierarchy. |
| scene_materials | Materials in the blend file. |
| scene_cameras | Cameras in the scene. |
| scene_lights | Lights in the scene. |
| render_settings | Current render settings. |
| blender_version | Blender and addon version information. |
| connection_status | Bridge connection status. |
| bpy_docs | High-level bpy usage notes for AI operators. |
TDQS
Scored across 156 tools
Many tools overlap heavily: get_materials vs list_materials, get_modifiers vs list_modifiers, get_scene_info vs get_scene_summary, and create_primitive vs dozens of primitive-specific creators. Render/capture tools also blur together (render_scene, render_preview, render_final; capture_viewport, get_viewport_screenshot, capture_scene_preview). An agent can still pick a reasonable tool in many cases, but several boundaries are genuinely unclear.
The surface is overwhelmingly snake_case, but verb conventions are inconsistent: get_ and list_ are used interchangeably for the same resource (materials/modifiers), some tools are noun-only (camera_view, mesh_cleanup, organize_scene), and capture_ vs render_ vs get_ overlap conceptually. It remains readable, but the naming does not reliably encode resource+action.
156 tools is far beyond a well-scoped surface, even for a broad Blender domain. The set contains many convenience wrappers and near-duplicates (create_sphere, create_uv_sphere, create_primitive, create_cube, etc.) that inflate the count without adding distinct capability.
Coverage is extremely broad: scene/object inspection, mesh editing, materials and nodes, cameras, lights, rendering, animation, assets, file operations, collections, viewport capture, and Python execution. Almost every core Blender workflow appears represented, with no obvious lifecycle dead ends.