Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
BLENDER_MCP_EXECUTABLENoPath to the Blender executable. If not set, the server searches PATH and standard installation folders for the newest version.
BLENDER_MCP_LLM_API_KEYNoAPI key for the multimodal LLM agent used by the local web UI. Supports OpenAI-compatible or Anthropic endpoints.
BLENDER_MCP_LLM_PROVIDERNoLLM provider for the agent. Use 'openai' (default) or 'anthropic'. Only used when BLENDER_MCP_LLM_API_KEY is set.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

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
blender_statusC

Report the Blender install, output folder, live-bridge state, templates and materials.

list_referencesA

List reference guide images under output/refs (optionally one group folder).

view_referenceB

Look at a reference/guide image so you can match it while modeling.

Args: path: Path relative to output/refs, or absolute.

add_referenceA

Copy an image file into the reference library under output/refs.

Args: source_path: Existing image on disk (absolute or under the output folder). name: Optional destination filename. group: Optional subfolder name for organising guides.

create_blendA

Create a new .blend file from a starter template and save it.

Args: path: Destination, relative to the output folder unless absolute. A ".blend" suffix is added when missing. template: empty, default, studio, or product. script: Optional extra bpy code run after the template. compress: Write a compressed .blend.

run_scriptA

Run Python against Blender's bpy API.

bpy, mathutils, math, D and C are pre-bound. Assign to result or call emit(value) to send data back; print() output is captured too.

Args: code: The Python to execute. blend_file: Open this .blend first. Supplying it forces a headless run. save_as: Save the file here when the script finishes. target: "auto", "live" or "headless".

apply_materialA

Apply a procedural material preset (metal, plastic, rubber, glass, wood) to a mesh.

Args: object_name: Mesh object name in the scene. preset: One of the presets from blender_status.materials. color: Optional RGB or RGBA floats 0-1. blend_file: Open this file first (forces headless). save_as: Save after applying. target: "auto", "live" or "headless".

inspect_blendA

Describe a scene: objects, transforms, materials, cameras, lights and render settings.

Args: blend_file: Inspect this file. Leave empty to inspect the live session instead. include_objects: Include the per-object breakdown, not just the counts. target: Where to look when no file is given.

renderA

Render a still image and write it to disk. Prefer render_and_view so you see it.

Args: output: PNG destination, relative to the output folder unless absolute. blend_file: Render this file rather than the live session. Forces a headless run. engine: "EEVEE", "CYCLES" or "WORKBENCH". EEVEE for iteration; CYCLES for finals. samples: Sample count. Keep it low for previews. width: Output width in pixels. height: Output height in pixels. frame: Frame to render. Defaults to the scene's current frame. transparent: Render the world background as alpha. target: "auto", "live" or "headless".

render_and_viewC

Render a still and return the image so you must look at it.

Args: output: PNG destination under the output folder. blend_file: Optional .blend to open first. engine: Prefer EEVEE while iterating. samples: Sample count. width: Width in pixels. height: Height in pixels. target: "auto", "live" or "headless".

preview_viewsB

Render multi-angle EEVEE previews (front, three_quarter, side, top) for critique.

Args: blend_file: .blend to open and preview. output_dir: Folder under output/ for the PNGs. width: Preview width. height: Preview height. samples: Low sample count for speed. engine: Prefer EEVEE. target: Usually headless.

view_previewB

Look at one preview PNG from preview_views or a render.

Args: path: Image path relative to output or absolute.

viewport_screenshotB

Capture the live Blender window's 3D viewport as it currently looks.

Requires the MCP Bridge addon to be running in an open Blender session.

view_imageC

Load a rendered image so it can actually be looked at.

Args: path: Image path, relative to the output folder unless absolute.

list_outputsC

List the files produced so far in the output folder.

open_in_live_sessionB

Load a .blend into the Blender window the user has open, so they can see it.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/josefgoeller-ship-it/blender-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server