Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| BLENDER_HOST | No | Host address for Blender socket server (default: "localhost") | localhost |
| BLENDER_PORT | No | Port number for Blender socket server (default: 9876) | 9876 |
| BLENDER_AUTH_TOKEN | No | Optional shared secret. If set in Blender (Addon Preferences) the MCP server must send the same token. | |
| BLENDER_MCP_TOOL_PROFILE | No | Controls how many MCP tools are exposed (default: "standard"). Profiles: minimal, standard, full. | standard |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| assign_material | Assign a material to a mesh object slot. |
| create_primitive | Create a primitive mesh object. |
| execute_blender_code | Execute arbitrary Python code in Blender. Make sure to do it step-by-step by breaking it into smaller chunks. Parameters:
|
| execute_ops | Execute a validated allowlisted ops request (DSL v1) in Blender. Parameters:
|
| get_capabilities | Return server/addon capabilities: DSL version, enabled integrations, supported ops/formats. |
| get_scene_info | Get detailed information about the current Blender scene |
| get_viewport_screenshot | Capture a screenshot of the current Blender 3D viewport. Parameters:
Returns the screenshot as an Image. |
| render_still | Render a still image to output_path (or temp). |
| select_objects | Select objects by name.
|
| set_transform | Set object transform values. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| asset_creation_strategy | Defines the preferred strategy for creating assets in Blender |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| help_index | Start here: how to set up and use BlenderMCP. |
| help_quickstart | Minimal steps to connect Blender + MCP client and run a first command. |
| help_tools | High-signal tips for using BlenderMCP tools effectively. |
| help_troubleshooting | Common setup and runtime issues and what to try next. |
| help_security | Key safety considerations when using BlenderMCP. |
| example_ops_basic | Create a cube, make a material, assign it (DSL v1). |
| example_ops_modifiers | Add and apply a bevel modifier (DSL v1). |
| example_workflow_asset_strategy | Recommended step-by-step workflow when creating assets/scenes. |