Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault

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):

  1. Inspect the scene before changing user content.

  2. Prefer creating a dedicated collection for new work.

  3. Perform modeling/material/lighting/camera operations with meaningful names.

  4. Capture a viewport or camera screenshot.

  5. Inspect the image, fix issues, and capture again.

  6. 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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.

    Warning: this is not a secure sandbox. It can access files, network, and
    system capabilities available to the Blender process.
    
blender_mcp_versionA

Return Blender MCP server version and bridge configuration (no secrets).

Prompts

Interactive templates invoked by user choice

NameDescription
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

NameDescription
scene_summaryCurrent Blender scene summary.
scene_objectsObjects in the current scene.
scene_hierarchyScene collection hierarchy.
scene_materialsMaterials in the blend file.
scene_camerasCameras in the scene.
scene_lightsLights in the scene.
render_settingsCurrent render settings.
blender_versionBlender and addon version information.
connection_statusBridge connection status.
bpy_docsHigh-level bpy usage notes for AI operators.

TDQS

C2.2/5.0

Scored across 156 tools

Disambiguation2/5

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.

Naming Consistency3/5

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.

Tool Count1/5

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.

Completeness5/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues