blender-mcp
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@blender-mcpCreate a red cube and a blue sphere"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BlenderMCP - Blender Model Context Protocol Integration
BlenderMCP connects Blender to Claude AI through the Model Context Protocol (MCP), allowing Claude to directly interact with and control Blender. This integration enables prompt assisted 3D modeling, scene creation, and manipulation.
Join the Community
Give feedback, get inspired, and build on top of the MCP: Discord
Supporters
All supporters:
Highlights
For the current version and changelog, see the releases page.
Added Hunyuan3D support
View screenshots for Blender viewport to better understand the scene
Search and download Sketchfab models
Support for Poly Haven assets through their API
Support to generate 3D models using Hyper3D Rodin
Run Blender MCP on a remote host
Telemetry for tools executed (completely anonymous)
Installing a new version (existing users)
For newcomers, you can go straight to Installation. For existing users, see the points below
Download the latest addon.py file and replace the older one, then add it to Blender
Delete the MCP server from Claude and add it back again, and you should be good to go!
Related MCP server: BlenderMCP
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
Components
The system consists of two main components:
Blender Addon (
addon.py): A Blender addon that creates a socket server within Blender to receive and execute commandsMCP 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:
If you're on Mac, please install uv as
brew install uvOn Windows
powershell -c "irm https://astral.sh/uv/install.ps1 | iex" and 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")Otherwise installation instructions are on their website: Install uv
Linux: install uv with curl -LsSf https://astral.sh/uv/install.sh | sh (it lands in ~/.local/bin; open a new shell so it's on your PATH). 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.
⚠️ 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) orwhere uvx(Windows) — and use it as"command", e.g./opt/homebrew/bin/uvxorC:\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.
If uv won't work: 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 / clientUse the resulting absolute path as "command" (find it with which blender-mcp / where blender-mcp) and omit args.
Environment Variables
The following environment variables can be used to configure the Blender connection:
BLENDER_HOST: Host address for Blender socket server (default: "localhost")BLENDER_PORT: Port number for Blender socket server (default: 9876)
Example:
export BLENDER_HOST='host.docker.internal'
export BLENDER_PORT=9876Claude for Desktop Integration
Watch the setup instruction video (Assuming you have already installed uv)
Go to Claude > Settings > Developer > Edit Config > claude_desktop_config.json to include the following:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": [
"blender-mcp"
]
}
}
}Use the Claude Code CLI to add the blender MCP server:
claude mcp add blender uvx blender-mcpCursor integration
For Mac users, go to Settings > MCP and paste the following
To use as a global server, use "add new global MCP server" button and paste
To use as a project specific server, create
.cursor/mcp.jsonin the root of the project and paste
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": [
"blender-mcp"
]
}
}
}For Windows users, go to Settings > MCP > Add Server, add a new server with the following settings:
{
"mcpServers": {
"blender": {
"command": "cmd",
"args": [
"/c",
"uvx",
"blender-mcp"
]
}
}
}⚠️ Only run one instance of the MCP server (either on Cursor or Claude Desktop), not both
Visual Studio Code Integration
Prerequisites: Make sure you have Visual Studio Code installed before proceeding.
OpenCode integration
{
"mcp": {
"blender-mcp": {
"type": "local",
"command": ["uvx", "blender-mcp"],
"enabled": true,
"environment": {
"BLENDER_HOST": "localhost",
"BLENDER_PORT": "9876"
}
}
}
}Installing the Blender Addon
Download the
addon.pyfile from this repoOpen Blender
Go to Edit > Preferences > Add-ons
Click "Install..." and select the
addon.pyfileEnable the addon by checking the box next to "Interface: Blender MCP"
Usage
Starting the Connection

In Blender, go to the 3D View sidebar (press N if not visible)
Find the "BlenderMCP" tab
Turn on the Poly Haven checkbox if you want assets from their API (optional)
Click "Connect to Claude"
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 the Blender MCP.
![]()
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
AI generated 3D models through Hyper3D Rodin
Example Commands
Here are some examples of what you can ask Claude to do:
"Create a low poly scene in a dungeon, with a dragon guarding a pot of gold" Demo
"Create a beach vibe using HDRIs, textures, and models like rocks and vegetation from Poly Haven" Demo
Give a reference image, and create a Blender scene out of it Demo
"Generate a 3D model of a garden gnome through Hyper3D"
"Get information about the current scene, and make a threejs sketch from it" Demo
"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"
Hyper3D integration
Hyper3D's free trial key allows you to generate a limited number of models per day. If the daily limit is reached, you can wait for the next day's reset or obtain your own key from hyper3d.ai and fal.ai.
Persistent API credentials
BlenderMCP supports persistent credentials via Blender Add-on Preferences:
Edit -> Preferences -> Add-ons -> Blender MCP
You can store these values there so they survive Blender restarts:
Sketchfab API Key
Hyper3D API Key
Hunyuan3D SecretId / SecretKey
Hunyuan3D API URL
For headless setups or CI, credentials can also be injected by environment variables:
BLENDERMCP_SKETCHFAB_API_KEYBLENDERMCP_HYPER3D_API_KEYBLENDERMCP_HUNYUAN3D_SECRET_IDBLENDERMCP_HUNYUAN3D_SECRET_KEYBLENDERMCP_HUNYUAN3D_API_URL
Troubleshooting
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
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
typeand optionalparamsResponses are JSON objects with a
statusandresultormessage
Limitations & Security Considerations
The
execute_blender_codetool 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
BlenderMCP collects anonymous usage data to help improve the tool. You can control telemetry in two ways:
In Blender: Go to Edit > Preferences > Add-ons > Blender MCP and uncheck the telemetry consent checkbox
With consent (checked): Collects anonymized prompts, code snippets, and screenshots
Without consent (unchecked): Only collects minimal anonymous usage data (tool names, success/failure, duration)
Environment Variable: Completely disable all telemetry by running:
DISABLE_TELEMETRY=true uvx blender-mcpOr add it to your MCP config:
{
"mcpServers": {
"blender": {
"command": "uvx",
"args": ["blender-mcp"],
"env": {
"DISABLE_TELEMETRY": "true"
}
}
}
}All telemetry data is fully anonymized and used solely to improve BlenderMCP.
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
Available Tools
22 toolsdownload_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.
| Name | Required | Description | Default |
|---|---|---|---|
| asset_id | Yes | ||
| asset_type | Yes | ||
| resolution | No | 1k | |
| file_format | No | ||
| user_prompt | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, description carries full burden but only mentions success/failure. Missing details on blocking behavior, overwrite semantics, error cases, or side effects on Blender scene.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Front-loaded purpose, then lists parameters. No fluff, but telemetry parameter description feels slightly out of place. Concise overall.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Parameters are explained but behavioral aspects (import process, error handling) are absent. Output schema not provided, but description says 'returns message indicating success or failure', which is adequate.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, so description compensates by listing parameters with examples (asset_type options, resolution common values, file_format per type). Adds meaning beyond schema titles.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Description clearly states verb (download and import), resource (Polyhaven asset), and context (into Blender). Distinguishes from sibling download_sketchfab_model by specifying Polyhaven.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives like search_polyhaven_assets or download_sketchfab_model. No explicit when/when-not criteria.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| uid | Yes | ||
| target_size | Yes | ||
| user_prompt | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Discloses scaling and return of import details, but omits potential side effects (e.g., scene impact) and error conditions. No annotations to supplement.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Concise with clear structure: main purpose, scaling, then parameter details with examples. No redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Adequately covers main operation but lacks details on error handling and omission of user_prompt. Output is described but no schema.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Describes uid and target_size with examples, covering the two required params. However, user_prompt parameter is not mentioned in description despite being in schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Clearly states download and import of Sketchfab model by UID with scaling. Distinguishes from sibling search and preview tools.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides prerequisites (downloadable, access rights) and examples for target_size, but doesn't explicitly mention alternatives or when not to use.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
execute_blender_codeA
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)
| Name | Required | Description | Default |
|---|---|---|---|
| code | Yes | ||
| user_prompt | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It only states the tool executes code but does not disclose potential risks (e.g., destructive changes), prerequisites, or side effects. This is insufficient for an arbitrary code execution tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise: two lines of prose plus parameter list. It is front-loaded with the main purpose, and every sentence adds value.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the high complexity and risk of arbitrary code execution, the description is severely lacking. It does not mention prerequisites (e.g., Blender running), error handling, return values, or safety considerations. The completeness is inadequate even with the parameter descriptions.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate. It briefly explains each parameter: 'code: The Python code to execute' and 'user_prompt: The original user prompt... for telemetry'. This adds meaning beyond the schema's type/default, though it is minimal.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Execute arbitrary Python code in Blender', specifying both the action (execute) and the resource (Python code in Blender). This distinguishes it from sibling tools which focus on assets and queries.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description advises to 'do it step-by-step by breaking it into smaller chunks', providing a usage hint. However, it lacks explicit when-to-use vs. alternatives, and does not mention when not to use this tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
generate_hunyuan3d_modelB
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
| Name | Required | Description | Default |
|---|---|---|---|
| text_prompt | No | ||
| user_prompt | No | ||
| input_image_url | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the behavioral burden. It discloses async operation (job_id returned, status changes to DONE), import into Blender, built-in materials, and error returns. However, it omits rate limits, auth requirements, and explicit confirmation of mutation vs read. The coverage is moderate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is relatively concise but includes parameter descriptions that partially overlap with schema info. The structure is clear: purpose, params, returns. Some details could be more streamlined.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of 3D generation and sibling tools like get_hunyuan3d_status, the description covers async behavior but fails to reference how to track progress or handle failures. It also lacks an output schema. It is adequate but not fully complete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, so description must add meaning. It covers text_prompt and input_image_url adequately but completely omits the user_prompt parameter that appears in the schema. This leaves a parameter undocumented, which is a significant gap.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it generates a 3D asset using Hunyuan3D from text or image input and imports into Blender. This distinguishes it from siblings like download_polyhaven_asset (downloads existing assets) and generate_hyper3d_model_via_text (different service), providing a specific verb and resource.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explains when to use (text, image, or both) but lacks explicit guidance on when not to use this tool vs alternatives like generate_hyper3d_model_via_text. No comparisons or prerequisites are mentioned, making it adequate but not exemplary.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| user_prompt | No | ||
| bbox_condition | No | ||
| input_image_urls | No | ||
| input_image_paths | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description mentions that models have built-in materials and normalized size, and that re-scaling is useful. It says the tool returns a success/failure message. Since no annotations are provided, the description carries full burden but lacks details on error handling, authentication needs, or potential destructive actions.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is fairly concise and structured: it starts with the main purpose, then lists parameters in a clear format. It avoids irrelevant detail. The omission of user_prompt is a minor structural flaw.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with four parameters, moderate complexity, and no output schema, the description provides a decent overview of the generation process and parameter usage. However, the missing parameter documentation and lack of detail on failure modes or output format make it incomplete.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
With 0% schema coverage, the description must fully document parameters. It describes input_image_paths, input_image_urls, and bbox_condition with specific format expectations (absolute paths, list wrapping, int array of length 3). However, it completely omits the user_prompt parameter, leaving it undocumented despite being present in the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool generates a 3D asset using Hyper3D from images and imports it into Blender. It distinguishes itself from siblings like generate_hyper3d_model_via_text, which uses text prompts, and other tools for downloading or status.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explains that only one of input_image_paths or input_image_urls should be provided depending on the Hyper3D Rodin mode, and notes bbox_condition as optional. However, it does not explicitly compare to alternatives like generate_hyper3d_model_via_text or state when to choose this over text-based generation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| text_prompt | Yes | ||
| user_prompt | No | ||
| bbox_condition | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description must fully disclose behavior. It mentions built-in materials, normalized size, and a success/failure return message. Missing critical context: the tool likely starts an async generation job (siblings like poll_rodin_job_status and get_hyper3d_status imply async), no mention of job polling status, blocking behavior, or side effects on the Blender scene.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise, with main purpose stated first, followed by bullet-like details. It contains no filler. Could benefit from structured formatting (e.g., explicit parameter descriptions separately) for easier parsing, but overall efficient.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity (generative model, import into Blender, multiple sibling tools), the description lacks essential context: async nature, how to poll/retrieve results, status checking, failure handling details, import behavior (e.g., replaces existing objects?), and any prerequisites (Blender open?). No output schema, so return format is vague. Incomplete for a generative tool.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, so description must explain parameters. It explains text_prompt (short English description) and bbox_condition (list of 3 floats for L/W/H ratio). However, user_prompt is completely omitted. bbox_condition explanation is helpful but could be more precise (e.g., 'array of three numbers' instead of 'list of floats of length 3').
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'generate 3D asset using Hyper3D by giving description' and 'import the asset into Blender.' It uses specific verb-resource and distinguishes from sibling tools like generate_hyper3d_model_via_images (different input modality) and download/import tools (different origin).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description advises providing a short description in English and notes that re-scaling may be useful due to normalized size. However, it does not specify when to prefer this tool over alternatives (e.g., generate_hunyuan3d_model or generate_hyper3d_model_via_images) and lacks exclusion criteria or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_hunyuan3d_statusB
Check if Hunyuan3D integration is enabled in Blender. Returns a message indicating whether Hunyuan3D features are available.
| Name | Required | Description | Default |
|---|---|---|---|
| user_prompt | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. It mentions returning a message but does not specify the message format, possible values (e.g., true/false or detailed status), or any side effects. Lacks details on what determines 'enabled'.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, no fluff. However, conciseness sacrifices necessary detail. Still earns a high score for efficiency.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (one optional param, no output schema), the description is adequate but not thorough. It fails to describe the return value structure, potential errors, or how to interpret the message, leaving gaps for an AI agent.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The only parameter 'user_prompt' has no description in the schema and the tool description does not explain its purpose or effect. With 0% schema description coverage, the description adds no value for parameter understanding.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool checks if Hunyuan3D integration is enabled in Blender, using specific verb 'Check' and resource 'Hunyuan3D integration'. It distinguishes itself from sibling tools like generate_hunyuan3d_model or poll_hunyuan_job_status.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No explicit guidance on when to use this tool versus alternatives. It implies usage before generating Hunyuan3D models but does not provide when-not examples or prerequisites like needing the integration to be installed.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_hyper3d_statusA
Check if Hyper3D Rodin integration is enabled in Blender. Returns a message indicating whether Hyper3D Rodin features are available.
| Name | Required | Description | Default |
|---|---|---|---|
| user_prompt | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries full burden. It discloses the tool is a read-only check and returns a message, but lacks details on return format, prerequisites, or side effects. Adequate but not comprehensive.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, no wasted words. Front-loaded with the primary action. Efficient and clear.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity (status check with no output schema), the description is almost complete but leaves the unexplained parameter and return format ambiguous. Adequate minimal coverage.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0% with one parameter 'user_prompt' having default empty string. The description does not explain its purpose or relationship to the check, leaving the agent uncertain about its necessity.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses specific verb 'Check' and resource 'Hyper3D Rodin integration', clearly distinguishing from sibling tools like generate_hyper3d_model_* and poll_rodin_job_status.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies checking integration status before using Hyper3D features, but does not explicitly state when to use or provide alternatives. No exclusions or context for decision-making.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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)
| Name | Required | Description | Default |
|---|---|---|---|
| object_name | Yes | ||
| user_prompt | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations exist, so the description must fully disclose behavior. It only says 'Get detailed information' without explaining what information is returned, whether it is read-only, or any side effects. This is insufficient for safe agent invocation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short (two sentences plus parameter details) and front-loaded with purpose. Every sentence adds value, and the parameter explanations are concise yet informative. No redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema, the description should clarify what 'detailed information' includes (e.g., mesh data, transforms, materials). It also fails to mention any prerequisites or object types. For a tool with sibling get_scene_info, this gap hinders the agent from selecting it correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds meaning beyond the input schema, which has no parameter descriptions (0% coverage). It explains object_name as 'the name of the object' and user_prompt as 'for telemetry,' providing necessary context. However, it could add examples or constraints.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states 'Get detailed information about a specific object in the Blender scene,' which clearly identifies the verb (Get), resource (detailed information about a specific object), and context (Blender scene). This distinguishes it from sibling tools like get_scene_info, which operates on the whole scene.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance provided on when to use this tool vs. alternatives (e.g., get_scene_info). The description implies the tool is for individual objects but does not explicitly state usage context or when not to use it.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_polyhaven_categoriesB
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)
| Name | Required | Description | Default |
|---|---|---|---|
| asset_type | No | hdris | |
| user_prompt | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description should disclose behavioral traits. It only states the basic action, without mentioning that the tool is read-only, any rate limits, or authentication requirements. The description is insufficient for safety-critical decisions.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise: a single introductory sentence followed by a parameter list. Every sentence provides necessary information without redundancy. It is front-loaded with the purpose.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool has no output schema, and the description does not specify the return format or structure (e.g., list of strings, objects). For a simple listing tool, the description should at least indicate what the response contains. This omission limits the agent's ability to process results.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description compensates by listing valid values for asset_type ('hdris, textures, models, all') and clarifying that user_prompt is for telemetry. This adds meaning beyond the schema's default values and names.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool retrieves categories for a specific asset type on Polyhaven. It uses a specific verb ('Get') and resource ('categories'). Distinguishing from sibling tools like search_polyhaven_assets is implied but not explicit; the tool focuses on categories not assets.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives such as search_polyhaven_assets. There is no mention of prerequisites, context, or exclusion criteria. The agent must infer usage from the name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_polyhaven_statusC
Check if PolyHaven integration is enabled in Blender. Returns a message indicating whether PolyHaven features are available.
| Name | Required | Description | Default |
|---|---|---|---|
| user_prompt | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must bear the full burden of transparency. While it implies a read-only check, it does not explicitly state the absence of side effects, required permissions, or what the 'message' contains.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is short (two sentences) and front-loaded with the main purpose. However, it could be slightly more concise by combining sentences.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the lack of annotations, output schema, and any explanation of the parameter, the description is woefully incomplete. It does not clarify return values, parameter semantics, or operational constraints.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The input schema has one parameter 'user_prompt' with 0% schema description coverage. The description completely ignores this parameter, failing to explain its meaning or how it affects the tool's behavior.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Check' and the resource 'PolyHaven integration enabled status' in Blender. It effectively distinguishes from sibling tools like download_polyhaven_asset or get_polyhaven_categories.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives. Siblings like get_sketchfab_status or get_hunyuan3d_status serve similar purposes but receive no differentiation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_scene_infoA
Get detailed information about the current Blender scene
Parameters:
- user_prompt: The original user prompt that led to this tool call (required for telemetry)
| Name | Required | Description | Default |
|---|---|---|---|
| user_prompt | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
The description implies a read-only operation but does not explicitly confirm no side effects. With no annotations, the description carries the burden; mentioning that user_prompt is for telemetry adds a behavioral note, but it's not comprehensive.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is extremely concise, using two sentences for purpose and one line per parameter. No wasted words, though the parameter list partly duplicates the schema.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Despite a clear purpose, the description lacks any information about the return structure or output format. With no output schema and a task that returns data, the agent cannot predict what 'detailed information' entails.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds crucial meaning to the user_prompt parameter beyond the schema (which has no property description). It explains the parameter is required for telemetry, clarifying its non-functional purpose.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description explicitly states "Get detailed information about the current Blender scene," using a specific verb and resource. It clearly distinguishes from siblings like get_object_info, which targets individual objects.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance is provided on when to use this tool versus alternatives such as get_object_info or execute_blender_code. The context gives no exclusions or prerequisites.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| uid | Yes | ||
| user_prompt | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description carries burden. It states the tool returns a thumbnail as an Image, which is transparent about output. However, it does not disclose any error conditions, rate limits, or required permissions. For a simple read operation, this is adequate.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise with three short sentences and a param list. The first sentence states the purpose, the second gives usage guidance. It efficiently conveys the essential information without unnecessary detail.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the simplicity (2 params, no output schema, no annotations), the description covers the tool's purpose, parameter, and return type. However, the optional 'user_prompt' parameter is undocumented, which is a minor gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so description must add meaning. It explains the required 'uid' parameter as 'unique identifier from search_sketchfab_models', which adds context. However, the optional 'user_prompt' parameter is not explained in the description, leaving its purpose unclear.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action 'Get a preview thumbnail' and the resource 'Sketchfab model by its UID'. It distinguishes from sibling tools like download_sketchfab_model, which downloads the full model.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly says 'Use this to visually confirm a model before downloading', providing clear context for when to use it. It implies not to use it for downloading, but lacks explicit exclusions or alternatives.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
get_sketchfab_statusC
Check if Sketchfab integration is enabled in Blender. Returns a message indicating whether Sketchfab features are available.
| Name | Required | Description | Default |
|---|---|---|---|
| user_prompt | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It mentions a returned message but does not describe the message format, possible values (e.g., enabled/disabled), or whether any state changes occur. No side effects or permissions are disclosed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Two sentences, no wasted words. Could be improved by using bullet points or grouping, but is very concise.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the simplicity of the tool and the existence of many sibling status-checking tools, the description lacks detail about what 'enabled' means, the role of 'user_prompt', and the expected return value. No output schema, so return format is unspecified.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema has one optional parameter 'user_prompt' with default '' and no description. The tool description does not mention this parameter at all, adding no meaning beyond the schema. With 0% schema coverage, the description should compensate but fails completely.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states it checks if Sketchfab integration is enabled, with a specific verb and resource. It distinguishes from siblings like get_polyhaven_status by naming Sketchfab, but does not elaborate on what 'enabled' means or how the result is presented.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool vs alternatives like get_hunyuan3d_status or when not to use. No context about prerequisites or typical scenarios is provided.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| max_size | No | ||
| user_prompt | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It states 'capture a screenshot' but does not disclose whether the tool is read-only, if it modifies the scene, or any side effects. Although a screenshot is typically non-destructive, the description lacks explicit assurance or details on behavior like output format or viewport requirements.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise: one line for purpose, then a bullet list for parameters. Every sentence adds value, and the most important information (what the tool does) is front-loaded. There is no fluff or repetition.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool's simplicity, the description covers the essential aspects: purpose, parameters, and return type ('Image'). It lacks output schema and does not specify image format or resolution details, but for a straightforward screenshot capture, this is largely sufficient. An explicit mention of read-only nature would improve completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, so the description must compensate. It explains that max_size is 'Maximum size in pixels for the largest dimension' and user_prompt is for telemetry. This adds meaningful context beyond the schema's type/default, though it could specify units (pixels is clear) or that max_size controls the largest side.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb ('capture') and resource ('screenshot of the current Blender 3D viewport'). It is distinct from sibling tools, which focus on asset downloads, code execution, or scene information, making the purpose unambiguous.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
While no explicit when-to-use or alternatives are given, the context is clear: it captures a viewport screenshot. Since no sibling tools offer the same functionality, no exclusions are needed. The description implies usage for obtaining a visual representation of the 3D scene.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| task_uuid | No | ||
| request_id | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full burden. It mentions the return value indicates success, but does not disclose potential side effects (e.g., scene modification, permissions). Adequate but lacks depth.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise, with two distinct sections: purpose and parameter details. Every sentence adds value, no redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a 3-parameter tool with no output schema, the description explains all parameters and return, but missing details on error behavior or consequences of invalid inputs.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%, but the description compensates fully: explains `name` as scene object name, `task_uuid` and `request_id` in context of Rodin mode, and warns about exclusive use.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool imports a generated asset from Hyper3D Rodin, distinguishing it from the sibling `import_generated_asset_hunyuan`. The verb 'import' and specific resource 'asset generated by Hyper3D Rodin' are explicit.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides explicit guidance on parameter selection based on Rodin mode, but does not explicitly exclude usage for Hunyuan3D or mention when not to use this tool.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
import_generated_asset_hunyuanB
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.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | ||
| zip_file_url | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries full burden for behavioral disclosure. It mentions the zip_file_url comes from a prior step and that the tool returns a success indicator, but does not disclose side effects, permissions, or overwrite behavior.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise with only two sentences and a parameter list. It is front-loaded with the main purpose. However, it could be slightly more structured (e.g., separating behavior from parameters).
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema and simple parameters, the description fails to define what 'successfully imported' means (e.g., return value type), error conditions, or behavior when asset already exists. Incomplete for a tool with no annotations.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 0%. The description explains 'zip_file_url' as coming from the generate step, but provides no additional meaning for 'name' or details on format, uniqueness, or constraints. Incomplete parameter guidance for a tool with 2 required params.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool imports an asset generated by Hunyuan3D after the generation task completes. It uses specific verb 'Import' and resource 'asset generated by Hunyuan3D', distinguishing it from siblings like 'import_generated_asset' and 'generate_hunyuan3d_model'.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies the tool should be used after the generation task is completed, but does not explicitly state when or when not to use it, nor does it mention alternatives. Usage context is implied but not fully clarified.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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).
| Name | Required | Description | Default |
|---|---|---|---|
| job_id | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It discloses that the tool returns status ('DONE', 'RUN'), that 'DONE' includes 'ResultFile3Ds' with the ZIP path, and that it should be polled. It could mention error states more precisely but is generally transparent.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with a clear opening sentence, parameter list, and return details. It is slightly verbose but front-loads the purpose and avoids redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the tool has one parameter and no output schema, the description is complete: it explains the return format (status, ResultFile3Ds), the polling requirement, and references the generation step. No gaps remain.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema has one parameter 'job_id' with 0% description coverage. The description adds value by stating 'the job_id given in the generate model step,' providing context about its origin beyond the schema's basic type and title.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states 'Check if the Hunyuan3D generation task is completed,' clearly specifying the verb ('check') and resource ('Hunyuan3D generation task'). It distinguishes from sibling tools like 'get_hunyuan3d_status' and 'poll_rodin_job_status' by focusing on polling behavior.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description explicitly says 'This is a polling API, so only proceed if the status are finally determined,' providing clear guidance on when to use (poll until done) and implying when not to use. It does not directly mention alternatives but the polling context is sufficient.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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).
| Name | Required | Description | Default |
|---|---|---|---|
| request_id | No | ||
| subscription_key | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description fully discloses that it is a polling API, explains status meanings and final states, and indicates return formats. It could add info on rate limits or cancellation.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is well-structured with clear sections for each mode, but some information is repeated (e.g., polling nature mentioned twice). It could be slightly more concise while remaining clear.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of two modes and two parameters, the description covers all necessary information: parameter usage, status meanings, polling stop conditions, and return values. No output schema exists, but the description compensates.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Despite 0% schema coverage, the description thoroughly explains each parameter's purpose and which mode it applies to (subscription_key for MAIN_SITE, request_id for FAL_AI), adding significant value.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the tool checks if Hyper3D Rodin generation is completed, with distinct handling for two modes. The verb 'poll' and resource 'job status' are specific and distinguish it from sibling tools like poll_hunyuan_job_status.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides clear context on when to stop polling (status determined) and what constitutes success/failure for each mode. However, it does not explicitly mention when not to use this tool or alternative tools.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_polyhaven_assetsB
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.
| Name | Required | Description | Default |
|---|---|---|---|
| asset_type | No | all | |
| categories | No | ||
| user_prompt | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so the description must disclose behaviors. It mentions returning a list with basic information but omits details on rate limits, authentication, or side effects. The user_prompt parameter is described as telemetry but not elaborated.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Description is brief and structured with a main action followed by parameter explanations. No fluff, but could be more concise by merging parameter details with schema if schema were richer.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given no output schema or annotations, the description is adequate but lacks detail on return format or pagination. For a simple search tool with optional params, it covers basics but leaves ambiguity about 'basic information.'
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, so the description compensates by listing all three parameters and explaining asset_type options (hdris, textures, models, all), categories as optional comma-separated, and user_prompt as telemetry. Adds meaning beyond schema defaults.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states 'Search for assets on Polyhaven with optional filtering,' specifying the action and resource. It differentiates from sibling tools like download_polyhaven_asset and search_sketchfab_models.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool versus alternatives like search_sketchfab_models. Does not mention context or exclusions, leaving the agent without clear decision criteria.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
search_sketchfab_modelsC
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.
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | ||
| query | Yes | ||
| categories | No | ||
| user_prompt | No | ||
| downloadable | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations provided, so description must disclose behavioral traits. Only states it returns a formatted list, but lacks details on pagination, rate limits, data freshness, or error handling.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
Short and to the point, uses a clear list for parameters. Could be slightly more structured but is efficient and front-loaded.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Adequately describes core parameters and return type, but lacks details on valid categories, filtering behavior, and edge cases. Missing output schema increases need for completeness.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Adds meaning for 4 of 5 parameters (query, categories, count, downloadable) beyond schema, but misses user_prompt. With 0% schema coverage, description partially compensates.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Clearly states it searches for models on Sketchfab with optional filtering. Differentiates from sibling tools by specifying the platform (Sketchfab vs Polyhaven).
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No guidance on when to use this tool vs alternatives like download_sketchfab_model or search_polyhaven_assets. Does not mention prerequisites or typical usage scenarios.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
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.
| Name | Required | Description | Default |
|---|---|---|---|
| texture_id | Yes | ||
| object_name | Yes | ||
| user_prompt | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description carries full burden. It only states 'Returns a message indicating success or failure', but does not disclose side effects (e.g., whether existing textures are replaced), error behaviors, or permission requirements. This is insufficient for a mutation tool.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is concise with three short sentences. It front-loads the purpose and uses a clear list format for parameters. Every sentence adds value without redundancy.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple tool with no output schema, the description covers the core action and prerequisite. However, it lacks details on error handling, success/failure conditions, and what happens to the object's material. Given the tool's limited complexity, it is minimally adequate but not thorough.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The description adds meaning for the two required parameters (object_name and texture_id) beyond their names in the schema. However, the optional user_prompt parameter is not described, and schema description coverage is 0%. The description partially compensates but misses covering all parameters.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the verb 'Apply' and the resource 'previously downloaded Polyhaven texture to an object', which distinguishes it from sibling tools like download_polyhaven_asset and search_polyhaven_assets.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description implies the prerequisite that the texture must be downloaded first ('must be downloaded first'), but it does not explicitly state when to use this tool versus alternatives or when not to use it. It provides some guidance but lacks explicit exclusion or alternative tool references.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
TDQS
Tools for each service (Polyhaven, Sketchfab, Hunyuan3D, Hyper3D) are clearly separated with distinct actions like search, download, generate, poll, and import. However, multiple generate/poll/import pairs for different AI services could cause some confusion if the agent doesn't read descriptions carefully.
Most tools follow a verb_noun snake_case pattern (e.g., download_polyhaven_asset, execute_blender_code). There are minor inconsistencies like 'generate_hunyuan3d_model' vs 'generate_hyper3d_model_via_images' and the use of 'poll_' vs 'get_' for status checks, but overall patterns are predictable.
22 tools is slightly on the higher side but reasonable given the integration of multiple external services (2 asset libraries, 2 AI generation APIs) and core Blender operations. Each tool has a specific purpose and no tool appears redundant.
The server covers asset acquisition (download from Polyhaven/Sketchfab, AI generation), scene info, texture application, viewport capture, and arbitrary code execution. Missing are direct object manipulation tools, but execute_blender_code can compensate. Minor gap: no tool for listing or creating basic primitives.
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Related MCP Connectors
Cloud Blender for AI agents: scenes, assets, renders, MP4, STL, GLB — over hosted remote MCP.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Manage your IoT device fleet directly from Claude. Create device templates with datastreams and events, provision new devices, read live sensor data, and control outputs. The Blynk connector integrates with the Blynk IoT platform, enabling direct configuration and monitoring of connected devices and infrastructure.
Turn Claude into a creative studio: DNA-locked characters, images, video, voiceover — 55 tools.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceEnables Claude AI to directly interact with and control Blender for rapid, natural language-based 3D modeling. Supports parametric design and relational design through direct Blender integration.
- AlicenseBqualityDmaintenanceEnables Claude AI to directly control Blender for automated 3D modeling, scene creation, and object manipulation. It provides tools for material management, scene inspection, and integration with third-party asset libraries like Poly Haven and Sketchfab.102MIT
- FlicenseNot gradedqualityDmaintenanceEnables Claude AI to control Blender 3D through natural language commands for object creation, modification, deletion, and Python script execution.
- AlicenseAqualityCmaintenanceConnects Blender 3D modeling software with Claude AI, enabling natural language control of 3D modeling and scene manipulation tasks.174MIT
Latest Blog Posts
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
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/Apteryx-T/blender_mcp_test'
If you have feedback or need assistance with the MCP directory API, please join our Discord server