Skip to main content
Glama

MCP for Blender

Connect Blender to any LLM

Disclaimer: This is a third-party integration and not made by Blender

Prompt-assisted 3D modeling, scene creation, and manipulation — driven by AI.

PyPI Downloads PyPI Version License: MIT Discord

Website · Full Tutorial · Discord · Sponsor · Buy me a coffee · Feedback

Supporters

CodeRabbit Kevin Guanche Darias

All supporters: Support this project


Quickstart

Three steps: install uv, point your MCP client at the server, install the Blender addon.

1. Install uv

# macOS
brew install uv

# Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Warning: Do not proceed before installing uv. Use the official installer — not pip install uv.

2. Add the MCP server to your client

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": ["blender-mcp"]
        }
    }
}
claude mcp add blender uvx blender-mcp
codex mcp add blender -- uvx blender-mcp

See MCP Client Setup below for per-client instructions and one-click install buttons.

3. Install the Blender addon

uvx blender-mcp install-addon

Then in Blender: Edit → Preferences → Add-ons → enable Interface: MCP for Blender.

4. Connect

In Blender's 3D viewport, press N → open the MCP for Blender tab → click Start MCP Server. That's it — ask Claude to build something.

Note: Only run one instance of the MCP server (either Cursor or Claude Desktop), not both.


Related MCP server: blender-mcp

Table of Contents


Features

Two-way communication

Connect Claude AI to Blender through a socket-based server

Object manipulation

Create, modify, and delete 3D objects in Blender

Material control

Apply and modify materials and colors

Scene inspection

Get detailed information about the current Blender scene

Code execution

Run arbitrary Python code in Blender from Claude

Asset & model generation

Poly Haven assets, Sketchfab models, Poly Pizza low-poly models, and AI-generated 3D models via Hyper3D Rodin and Hunyuan3D

Components

The system consists of two main components:

  1. Blender Addon (addon.py) — a Blender addon that creates a socket server within Blender to receive and execute commands

  2. MCP Server (src/blender_mcp/server.py) — a Python server that implements the Model Context Protocol and connects to the Blender addon


Installation

Prerequisites

  • Blender 3.0 or newer

  • Python 3.10 or newer

  • uv package manager

macOS

brew install uv

Windows

powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

Then add uv to the user path in Windows (you may need to restart Claude Desktop after):

$localBin = "$env:USERPROFILE\.local\bin"
$userPath = [Environment]::GetEnvironmentVariable("Path", "User")
[Environment]::SetEnvironmentVariable("Path", "$userPath;$localBin", "User")

Linux

curl -LsSf https://astral.sh/uv/install.sh | sh

It lands in ~/.local/bin — open a new shell so it's on your PATH.

Otherwise, installation instructions are on their website: Install uv

On every OS, use uv's official installer above — not pip install uv, which may not create the uvx command and can hide uv inside an environment your client can't see.

Warning: Do not proceed before installing uv.

Make your client find uvx

MCP clients started from a GUI (Claude Desktop, Cursor, VS Code from the Dock/Start menu) do not inherit your terminal's PATH, so a bare "command": "uvx" can fail with spawn uvx ENOENT even though uvx works in your terminal. If that happens:

  • Find uvx's full path — which uvx (macOS/Linux) or where uvx (Windows) — and use it as "command", e.g. /opt/homebrew/bin/uvx or C:\Users\<you>\.local\bin\uvx.exe.

  • On Windows you can instead wrap it: "command": "cmd", "args": ["/c", "uvx", "blender-mcp"].

  • After any PATH or config change, fully quit and relaunch the client (Windows: quit from the system tray, not just the window; macOS: Cmd+Q).

Pin the Python version

Avoid conda / pyenv / version conflicts.

uv chooses which Python runs the server. On machines with conda (auto-activated base), pyenv, or asdf — or with a newer CPython release that some dependencies do not have wheels for yet — uv can grab an interpreter that makes installation fail. Pin Python 3.11 and prefer uv-managed interpreters to avoid using whatever is on your PATH:

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": ["--python", "3.11", "blender-mcp"],
            "env": { "UV_PYTHON_PREFERENCE": "only-managed" }
        }
    }
}

--python 3.11 still satisfies this package's requires-python >=3.10, and UV_PYTHON_PREFERENCE=only-managed keeps uv from selecting conda, pyenv, asdf, or system Python first. (The repo's .python-version is only a hint for contributors and does not affect uvx.)

If a previous failed attempt keeps replaying after a fix, clear the cache:

uv cache clean blender-mcp && uvx --refresh blender-mcp

Install without uv

On locked-down machines you can skip uvx entirely with pipx, then point your client at the installed command:

pipx install blender-mcp
pipx ensurepath          # then restart your shell / client

Use the resulting absolute path as "command" (find it with which blender-mcp / where blender-mcp) and omit args.

Run with Docker

You can run the MCP server in a container instead of installing it. Blender itself still runs on your machine — the container only hosts the MCP server, which connects out to the Blender addon.

Build the image from the repo root:

docker build -t blender-mcp .

Then point your MCP client at it (the -i flag is required — the server talks to the client over stdin/stdout):

{
    "mcpServers": {
        "blender": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "blender-mcp"]
        }
    }
}

The image defaults to BLENDER_HOST=host.docker.internal, which reaches the host's Blender out of the box with Docker Desktop on macOS and Windows.

On Linux, host.docker.internal doesn't exist and the addon only listens on localhost, so use host networking instead:

{
    "mcpServers": {
        "blender": {
            "command": "docker",
            "args": ["run", "-i", "--rm", "--network=host", "-e", "BLENDER_HOST=localhost", "blender-mcp"]
        }
    }
}

To enable safe mode in the container, add "-e", "BLENDER_MCP_SAFE_MODE=1" to args.

Environment Variables

The following environment variables can be used to configure the Blender connection:

Variable

Default

Description

BLENDER_HOST

localhost

Host address for Blender socket server

BLENDER_PORT

9876

Port number for Blender socket server

BLENDER_MCP_SAFE_MODE

off

Set to 1 to validate scripts before they run in Blender (see below)

Example:

export BLENDER_HOST='host.docker.internal'
export BLENDER_PORT=9876

Safe mode

By default, the AI can run any Python code in Blender. Set BLENDER_MCP_SAFE_MODE=1 to check every script before it runs and block risky code — things like reading or writing files directly, running other programs, accessing the network, or installing code that keeps running after the script ends. Normal Blender work (modeling, materials, rendering, saving, import/export) still works. Blocked scripts are sent back to the AI with the reason, so it can try again with a corrected version.


MCP Client Setup

Claude for Desktop

Watch the setup instruction video (assuming you have already installed uv)

Go to Claude → Settings → Developer → Edit Config → claude_desktop_config.json and include the following:

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "blender-mcp"
            ]
        }
    }
}

Use the Claude Code CLI to add the MCP for Blender server:

claude mcp add blender uvx blender-mcp

Codex

The Codex CLI, desktop app, and IDE extension all share the same config file (~/.codex/config.toml), so setting the server up once covers all three.

Register the server with the Codex CLI:

codex mcp add blender -- uvx blender-mcp

Or add it by hand to ~/.codex/config.toml (or $CODEX_HOME/config.toml):

[mcp_servers.blender]
command = "uvx"
args = ["blender-mcp"]

Or in the Codex desktop app: Settings → MCP servers → Add server → name it blender, pick STDIO, enter uvx blender-mcp as the command, then Save and restart. If the app can't find uvx, use its full path instead — see Make your client find uvx.

Check it registered with codex mcp list — the blender server should show as enabled. The tools become available the next time you start Codex.

To set environment variables (e.g. a non-default Blender host/port), pass --env KEY=VALUE flags to codex mcp add, or add them in the config file:

[mcp_servers.blender]
command = "uvx"
args = ["blender-mcp"]
env = { BLENDER_HOST = "localhost", BLENDER_PORT = "9876" }

Cursor

Install MCP Server

macOS — go to Settings → MCP and paste the following:

  • To use as a global server, use the "add new global MCP server" button and paste

  • To use as a project-specific server, create .cursor/mcp.json in the root of the project and paste

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": [
                "blender-mcp"
            ]
        }
    }
}

Windows — go to Settings → MCP → Add Server, add a new server with the following settings:

{
    "mcpServers": {
        "blender": {
            "command": "cmd",
            "args": [
                "/c",
                "uvx",
                "blender-mcp"
            ]
        }
    }
}

Cursor setup video

Note: Only run one instance of the MCP server (either on Cursor or Claude Desktop), not both.

Visual Studio Code

Prerequisites: Make sure you have Visual Studio Code installed before proceeding.

Install in VS Code

OpenCode

{
  "mcp": {
    "blender-mcp": {
      "type": "local",
      "command": ["uvx", "blender-mcp"],
      "enabled": true,
      "environment": {
        "BLENDER_HOST": "localhost",
        "BLENDER_PORT": "9876"
      }
    }
  }
}

Antigravity

{
  "mcpServers": {
    "blender-mcp": {
      "command": "uvx",
      "args": ["blender-mcp"],
      "env": {
        "BLENDER_HOST": "localhost",
        "BLENDER_PORT": "9876"
      }
    }
  }
}

Installing the Blender Addon

1. Recommended — from a terminal, run:

uvx blender-mcp install-addon

This copies the addon into your Blender addons folder as blender_mcp.py. It prints where it wrote to, and keeps a .bak of any file it replaces.

Optional: uvx blender-mcp addon-paths lists detected Blender addons folders. Override the destination with BLENDERMCP_ADDONS_DIR=/path/to/scripts/addons.

2. Open Blender

3. Go to Edit → Preferences → Add-ons

4. Enable Interface: MCP for Blender (search "MCP for Blender"). If it doesn't appear yet, click Install… and select the copied blender_mcp.py / addon.py, or restart Blender.

5. Manual alternative — if the command above can't find your Blender install, or you prefer doing it by hand: download addon.py from this repo → in Blender, Edit → Preferences → Add-ons → Install… → select the downloaded addon.py → enable it.

Then open the MCP for Blender tab in Blender's sidebar (press N in the 3D viewport) and click Start MCP Server. See Starting the Connection below.

Upgrading (existing users)

For newcomers, go straight to Quickstart. For existing users, see below.

1. Update the addon file by running:

uvx blender-mcp install-addon
uvx blender-mcp addon-paths   # optional: list detected Blender addons folders

2. In Blender: Preferences → Add-ons → disable and re-enable Interface: MCP for Blender (or restart Blender), then click Start MCP Server again.

3. Delete the MCP server from Claude and add it back again if the server package itself needs a refresh.

Note: the MCP server never modifies your Blender addon files on its own. When it starts, it checks whether the installed addon is behind the bundled copy and logs how to update; install-addon is what actually writes, and it keeps a .bak of the file it replaces. Trajectory capture still works on older loaded addons via an execute_code fallback.


Usage

Starting the Connection

MCP for Blender in the sidebar

  1. In Blender, go to the 3D View sidebar (press N if not visible)

  2. Find the MCP for Blender tab

  3. Turn on the checkboxes you'd like to use (see more under Capabilities below)

  4. Click Connect to Claude

  5. Make sure the MCP server is running in your terminal

Using with Claude

Once the config file has been set on Claude, and the addon is running on Blender, you will see a hammer icon with tools for MCP for Blender.

MCP for Blender in the sidebar

Capabilities

  • Get scene and object information

  • Create, delete and modify shapes

  • Apply or create materials for objects

  • Execute any Python code in Blender

  • Download the right models, assets and HDRIs through Poly Haven

  • Search and download models from Sketchfab

  • Search and download low-poly models from Poly Pizza

  • AI generated 3D models through Hyper3D Rodin and Hunyuan3D

Poly Pizza

Poly Pizza hosts roughly 10,600 free low-poly models, including the rescued Google Poly archive. It is the best source for stylised game assets: every model is a single self-contained .glb, and the geometry is far lighter than Sketchfab's.

  1. Get a free API key at poly.pizza/settings/api

  2. In the 3D View sidebar, tick Use assets from Poly Pizza

  3. Paste the key into the API Key field that appears (or store it permanently under Edit → Preferences → Add-ons → MCP for Blender)

Worked example:

"Search Poly Pizza for a low-poly chair under a CC0 licence and import one at 1 metre tall"

Claude calls search_polypizza_models(query="chair", licence="CC0"), which returns each match with its licence and triangle count, then download_polypizza_model(model_id="...", normalize_size=True, target_size=1.0).

You can also filter by category ("Animals", "Furniture & Decor", "Transport", "Nature", "Buildings", "People & Characters", "Food & Drink", "Weapons", "Clutter", "Objects", "Scenes & Levels", "Other") or ask for animated models only.

Attribution: about 69% of the Poly Pizza catalogue is CC-BY, which requires you to credit the creator wherever the model appears. On import, the ready-formatted credit line is written onto each imported root object as the custom property polypizza_attribution (alongside polypizza_id and polypizza_licence), so it is saved into your .blend and survives the session. Filter with licence="CC0" if you would rather use models that need no credit.

Example Commands

Here are some examples of what you can ask Claude to do:

Prompt

Demo

"Create a low poly scene in a dungeon, with a dragon guarding a pot of gold"

Watch

"Create a beach vibe using HDRIs, textures, and models like rocks and vegetation from Poly Haven"

Watch

Give a reference image, and create a Blender scene out of it

Watch

"Get information about the current scene, and make a threejs sketch from it"

Watch

"Generate a 3D model of a garden gnome through Hyper3D"

"Fill this room with low-poly furniture from Poly Pizza"

"Make this car red and metallic"

"Create a sphere and place it above the cube"

"Make the lighting like a studio"

"Point the camera at the scene, and make it isometric"


Persistent API Credentials

MCP for Blender supports persistent credentials via Blender Add-on Preferences:

Edit → Preferences → Add-ons → MCP for Blender

You can store these values there so they survive Blender restarts:

  • Sketchfab API Key

  • Poly Pizza API Key

  • Hyper3D API Key

  • Hunyuan3D SecretId / SecretKey

  • Hunyuan3D API URL

For headless setups or CI, credentials can also be injected by environment variables:

Variable

BLENDERMCP_SKETCHFAB_API_KEY

BLENDERMCP_POLYPIZZA_API_KEY

BLENDERMCP_HYPER3D_API_KEY

BLENDERMCP_HUNYUAN3D_SECRET_ID

BLENDERMCP_HUNYUAN3D_SECRET_KEY

BLENDERMCP_HUNYUAN3D_API_URL


Troubleshooting

Problem

Fix

Connection issues

Make sure the Blender addon server is running, and the MCP server is configured on Claude. Do not run the uvx command in the terminal. Sometimes the first command won't go through, but after that it starts working.

Timeout errors

Try simplifying your requests or breaking them into smaller steps.

Poly Haven integration

Claude is sometimes erratic with its behaviour.

Poly Pizza download fails with a Cloudflare challenge

static.poly.pizza is behind bot protection and blocks datacenter, VPN and cloud IPs. Your API key is fine - the CDN never sees it. Retry from a normal connection, or download the .glb by hand and use File → Import → glTF 2.0.

Have you tried turning it off and on again?

If you're still having connection errors, try restarting both Claude and the Blender server.

Technical Details

Communication Protocol

The system uses a simple JSON-based protocol over TCP sockets:

  • Commands are sent as JSON objects with a type and optional params

  • Responses are JSON objects with a status and result or message

Limitations & Security Considerations

Warning: The execute_blender_code tool allows running arbitrary Python code in Blender, which can be powerful but potentially dangerous. Use with caution in production environments. ALWAYS save your work before using it.

  • Poly Haven requires downloading models, textures, and HDRI images. If you do not want to use it, please turn it off in the checkbox in Blender.

  • Complex operations might need to be broken down into smaller steps.

Telemetry Control

MCP for Blender collects anonymous usage data to help improve the tool. Telemetry consent is on by default, and you can turn it off in two ways:

1. In Blender — go to Edit → Preferences → Add-ons → MCP for Blender and uncheck the telemetry consent checkbox.

  • With consent (checked, the default): view the TnC for more details on data collected.

2. Environment Variable — completely disable all telemetry by running:

DISABLE_TELEMETRY=true uvx blender-mcp

Or add it to your MCP config:

{
    "mcpServers": {
        "blender": {
            "command": "uvx",
            "args": ["blender-mcp"],
            "env": {
                "DISABLE_TELEMETRY": "true"
            }
        }
    }
}

Telemetry data is not linked to your name or account. It may be used to improve MCP for Blender, for research, and to train AI models.

Full detail on what is collected, and the license you grant by leaving telemetry on, is in TERMS_AND_CONDITIONS.md.


Feedback

We are actively looking for feedback on MCP for Blender. If you have thoughts, share them here.

If you have more detailed feedback, you can schedule a call with us here — we will credit you in the project.

Join the Community

Give feedback, get inspired, and build on top of the MCP: Discord

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

Disclaimer

This is a third-party integration and not made by Blender. Made by Siddharth.


Star History

If MCP for Blender is useful to you, consider starring the repo

Available Tools

22 tools
download_polyhaven_assetB
Download and import a Polyhaven asset into Blender.

Parameters:
- asset_id: The ID of the asset to download
- asset_type: The type of asset (hdris, textures, models)
- resolution: The resolution to download (e.g., 1k, 2k, 4k)
- file_format: Optional file format (e.g., hdr, exr for HDRIs; jpg, png for textures; gltf, fbx for models)
- user_prompt: The original user prompt that led to this tool call (for telemetry)

Returns a message indicating success or failure.

Inputs: asset_id (required), asset_type (required), resolution, file_format, +1 more.

download_sketchfab_modelA
Download and import a Sketchfab model by its UID.
The model will be scaled so its largest dimension equals target_size.

Parameters:
- uid: The unique identifier of the Sketchfab model
- target_size: REQUIRED. The target size in Blender units/meters for the largest dimension.
              You must specify the desired size for the model.
              Examples:
              - Chair: target_size=1.0 (1 meter tall)
              - Table: target_size=0.75 (75cm tall)
              - Car: target_size=4.5 (4.5 meters long)
              - Person: target_size=1.7 (1.7 meters tall)
              - Small object (cup, phone): target_size=0.1 to 0.3

Returns a message with import details including object names, dimensions, and bounding box.
The model must be downloadable and you must have proper access rights.

Inputs: uid (required), target_size (required), user_prompt.

execute_blender_codeC
Execute arbitrary Python code in Blender. Make sure to do it step-by-step by breaking it into smaller chunks.

Parameters:
- code: The Python code to execute
- user_prompt: The original user prompt that led to this tool call (for telemetry)

Inputs: code (required), user_prompt.

generate_hunyuan3d_modelA
Generate 3D asset using Hunyuan3D by providing either text description, image reference, 
or both for the desired asset, and import the asset into Blender.
The 3D asset has built-in materials.

Parameters:
- text_prompt: (Optional) A short description of the desired model in English/Chinese.
- input_image_url: (Optional) The local or remote url of the input image. Accepts None if only using text prompt.

Returns: 
- When successful, returns a JSON with job_id (format: "job_xxx") indicating the task is in progress
- When the job completes, the status will change to "DONE" indicating the model has been imported
- Returns error message if the operation fails

Inputs: text_prompt, user_prompt, input_image_url.

generate_hyper3d_model_via_imagesA
Generate 3D asset using Hyper3D by giving images of the wanted asset, and import the generated asset into Blender.
The 3D asset has built-in materials.
The generated model has a normalized size, so re-scaling after generation can be useful.

Parameters:
- input_image_paths: The **absolute** paths of input images. Even if only one image is provided, wrap it into a list. Required if Hyper3D Rodin in MAIN_SITE mode.
- input_image_urls: The URLs of input images. Even if only one image is provided, wrap it into a list. Required if Hyper3D Rodin in FAL_AI mode.
- bbox_condition: Optional. If given, it has to be a list of ints of length 3. Controls the ratio between [Length, Width, Height] of the model.

Only one of {input_image_paths, input_image_urls} should be given at a time, depending on the Hyper3D Rodin's current mode.
Returns a message indicating success or failure.

Inputs: user_prompt, bbox_condition, input_image_urls, input_image_paths.

generate_hyper3d_model_via_textA
Generate 3D asset using Hyper3D by giving description of the desired asset, and import the asset into Blender.
The 3D asset has built-in materials.
The generated model has a normalized size, so re-scaling after generation can be useful.

Parameters:
- text_prompt: A short description of the desired model in **English**.
- bbox_condition: Optional. If given, it has to be a list of floats of length 3. Controls the ratio between [Length, Width, Height] of the model.

Returns a message indicating success or failure.

Inputs: text_prompt (required), user_prompt, bbox_condition.

get_hunyuan3d_statusB

Check if Hunyuan3D integration is enabled in Blender. Returns a message indicating whether Hunyuan3D features are available.

Inputs: user_prompt.

get_hyper3d_statusA

Check if Hyper3D Rodin integration is enabled in Blender. Returns a message indicating whether Hyper3D Rodin features are available.

Inputs: user_prompt.

get_object_infoB
Get detailed information about a specific object in the Blender scene.

Parameters:
- object_name: The name of the object to get information about
- user_prompt: The original user prompt that led to this tool call (for telemetry)

Inputs: object_name (required), user_prompt.

get_polyhaven_categoriesA
Get a list of categories for a specific asset type on Polyhaven.

Parameters:
- asset_type: The type of asset to get categories for (hdris, textures, models, all)
- user_prompt: The original user prompt that led to this tool call (for telemetry)

Inputs: asset_type, user_prompt.

get_polyhaven_statusB

Check if PolyHaven integration is enabled in Blender. Returns a message indicating whether PolyHaven features are available.

Inputs: user_prompt.

get_scene_infoB

Get detailed information about the current Blender scene

Parameters:
- user_prompt: The original user prompt that led to this tool call (required for telemetry)

Inputs: user_prompt (required).

get_sketchfab_model_previewA
Get a preview thumbnail of a Sketchfab model by its UID.
Use this to visually confirm a model before downloading.

Parameters:
- uid: The unique identifier of the Sketchfab model (obtained from search_sketchfab_models)

Returns the model's thumbnail as an Image for visual confirmation.

Inputs: uid (required), user_prompt.

get_sketchfab_statusB

Check if Sketchfab integration is enabled in Blender. Returns a message indicating whether Sketchfab features are available.

Inputs: user_prompt.

get_viewport_screenshotA
Capture a screenshot of the current Blender 3D viewport.

Parameters:
- max_size: Maximum size in pixels for the largest dimension (default: 800)
- user_prompt: The original user prompt that led to this tool call (for telemetry)

Returns the screenshot as an Image.

Inputs: max_size, user_prompt.

import_generated_assetA
Import the asset generated by Hyper3D Rodin after the generation task is completed.

Parameters:
- name: The name of the object in scene
- task_uuid: For Hyper3D Rodin mode MAIN_SITE: The task_uuid given in the generate model step.
- request_id: For Hyper3D Rodin mode FAL_AI: The request_id given in the generate model step.

Only give one of {task_uuid, request_id} based on the Hyper3D Rodin Mode!
Return if the asset has been imported successfully.

Inputs: name (required), task_uuid, request_id.

import_generated_asset_hunyuanA
Import the asset generated by Hunyuan3D after the generation task is completed.

Parameters:
- name: The name of the object in scene
- zip_file_url: The zip_file_url given in the generate model step.

Return if the asset has been imported successfully.

Inputs: name (required), zip_file_url (required).

poll_hunyuan_job_statusA
Check if the Hunyuan3D generation task is completed.

For Hunyuan3D:
    Parameters:
    - job_id: The job_id given in the generate model step.

    Returns the generation task status. The task is done if status is "DONE".
    The task is in progress if status is "RUN".
    If status is "DONE", returns ResultFile3Ds, which is the generated ZIP model path
    When the status is "DONE", the response includes a field named ResultFile3Ds that contains the generated ZIP file path of the 3D model in OBJ format.
    This is a polling API, so only proceed if the status are finally determined ("DONE" or some failed state).

Inputs: job_id.

poll_rodin_job_statusA
Check if the Hyper3D Rodin generation task is completed.

For Hyper3D Rodin mode MAIN_SITE:
    Parameters:
    - subscription_key: The subscription_key given in the generate model step.

    Returns a list of status. The task is done if all status are "Done".
    If "Failed" showed up, the generating process failed.
    This is a polling API, so only proceed if the status are finally determined ("Done" or "Canceled").

For Hyper3D Rodin mode FAL_AI:
    Parameters:
    - request_id: The request_id given in the generate model step.

    Returns the generation task status. The task is done if status is "COMPLETED".
    The task is in progress if status is "IN_PROGRESS".
    If status other than "COMPLETED", "IN_PROGRESS", "IN_QUEUE" showed up, the generating process might be failed.
    This is a polling API, so only proceed if the status are finally determined ("COMPLETED" or some failed state).

Inputs: request_id, subscription_key.

search_polyhaven_assetsA
Search for assets on Polyhaven with optional filtering.

Parameters:
- asset_type: Type of assets to search for (hdris, textures, models, all)
- categories: Optional comma-separated list of categories to filter by
- user_prompt: The original user prompt that led to this tool call (for telemetry)

Returns a list of matching assets with basic information.

Inputs: asset_type, categories, user_prompt.

search_sketchfab_modelsA
Search for models on Sketchfab with optional filtering.

Parameters:
- query: Text to search for
- categories: Optional comma-separated list of categories
- count: Maximum number of results to return (default 20)
- downloadable: Whether to include only downloadable models (default True)

Returns a formatted list of matching models.

Inputs: query (required), count, categories, user_prompt, +1 more.

set_textureA
Apply a previously downloaded Polyhaven texture to an object.

Parameters:
- object_name: Name of the object to apply the texture to
- texture_id: ID of the Polyhaven texture to apply (must be downloaded first)

Returns a message indicating success or failure.

Inputs: texture_id (required), object_name (required), user_prompt.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 22 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action. The integration-specific tools (PolyHaven, Sketchfab, Hyper3D, Hunyuan) are clearly separated by service, and the only potentially similar tools (generate_hunyuan3d_model vs generate_hyper3d_model_via_text/images) are distinguished by their backend and explicit naming.

    Naming Consistency5/5

    All tools follow a consistent verb_noun snake_case pattern (e.g., get_scene_info, download_polyhaven_asset, poll_rodin_job_status). There are no mixed conventions or ambiguous verb styles, making the tool surface highly predictable.

    Tool Count4/5

    At 22 tools, the set is slightly larger than the typical 3-15 range, but the server covers multiple distinct integrations (Blender core, PolyHaven, Sketchfab, Hyper3D, Hunyuan). Each tool contributes to a specific function, so the count is justified despite feeling heavy.

    Completeness4/5

    Core Blender operations (scene info, object info, screenshot, code execution) are well covered. Asset libraries and generation services have search/download/generate/poll/import workflows, but there are minor gaps such as lack of HDRI world application, no listing of downloaded assets, and no ability to edit objects beyond code execution. These are workaroundable via execute_blender_code.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      Connects Blender to Claude AI through the Model Context Protocol (MCP), enabling prompt-assisted 3D modeling, scene creation, and manipulation directly from Claude.
      17
      MIT
    • A
      license
      C
      quality
      B
      maintenance
      Enables AI-powered control of Blender through natural language, allowing users to create, manipulate, and automate 3D scenes, objects, materials, animations, and more via Claude or other MCP clients.
      71
      65
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects Blender to AI assistants through the Model Context Protocol, enabling direct AI control of 3D modeling, scene creation, and manipulation via natural language.
      MIT