Blender-MCP
BlenderMCP connects Blender to AI agents via the Model Context Protocol, enabling direct 3D object manipulation, material application, asset downloads, and Python code execution with secure token-authenticated local communication.
Caution. Specific findings reduced this grade. They are listed on the page. Grades reflect the full trust pyramid: code, verification depth, and reputation. New projects cap at C until adoption is earned.
How we verified
Verified is a snapshot. Live keeps it current, and builds your track record.
⚡ Connect GitHub → continuous verification on every pushwhy connect →Who stands behind it
soozs1
Source: Glama
Claim it to get a verified publisher badge, a free copy of our full audit findings, and direct contact for any high-priority issues we find. Or connect your repo for our deepest verification, Live Monitored: read-only, revoke anytime. What we access →
Install from
The grade above is for the source repository. Registries can serve a different version, so we mark the ones we were not able to read.
These names and descriptions are the publisher's own, read from the source code. We print them as written. Our assessment is the findings above, not this list.
get_scene_infoGet detailed information about the current Blender scene
get_object_infoGet detailed information about a specific object in the Blender scene.
get_viewport_screenshotCapture a screenshot of the current Blender 3D viewport.
execute_blender_codeExecute arbitrary Python code in Blender. Make sure to do it step-by-step by breaking it into smaller chunks.
get_polyhaven_categoriesGet a list of categories for a specific asset type on Polyhaven.
search_polyhaven_assetsSearch for assets on Polyhaven with optional filtering.
download_polyhaven_assetDownload and import a Polyhaven asset into Blender.
set_textureApply a previously downloaded Polyhaven texture to an object.
get_polyhaven_statusCheck if PolyHaven integration is enabled in Blender. Returns a message indicating whether PolyHaven features are available.
get_hyper3d_statusCheck if Hyper3D Rodin integration is enabled in Blender. Returns a message indicating whether Hyper3D Rodin features are available.
get_sketchfab_statusCheck if Sketchfab integration is enabled in Blender. Returns a message indicating whether Sketchfab features are available.
search_sketchfab_modelsSearch for models on Sketchfab with optional filtering.
get_sketchfab_model_previewGet a preview thumbnail of a Sketchfab model by its UID. Use this to visually confirm a model before downloading.
download_sketchfab_modelDownload and import a Sketchfab model by its UID. The model will be scaled so its largest dimension equals target_size.
generate_hyper3d_model_via_textGenerate 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.
generate_hyper3d_model_via_imagesGenerate 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.
poll_rodin_job_statusCheck if the Hyper3D Rodin generation task is completed.
import_generated_assetImport the asset generated by Hyper3D Rodin after the generation task is completed.
get_hunyuan3d_statusCheck if Hunyuan3D integration is enabled in Blender. Returns a message indicating whether Hunyuan3D features are available.
generate_hunyuan3d_modelGenerate 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.
poll_hunyuan_job_statusCheck if the Hunyuan3D generation task is completed.
import_generated_asset_hunyuanImport the asset generated by Hunyuan3D after the generation task is completed.
BLENDER_HOSTAddress of the Blender socket serverBLENDER_PORTPort of the Blender socket serverBLENDERMCP_CACHE_DIRAfter the first successful authentication the MCP server itself stores the working token in a per-user cache (see BLENDERMCP_CACHE_DIR), so reconnects work without manual copying and without editing settings.json. Token resolution order: BLENDERMCP_TOKEN → BLENDERMCP_TOKEN_FILE → MCP cache → addon token file → loopback pairing. Empty values and unedited placeholders (<input-your-token-here>, "Input your token here") are ignored. Every candidate is tried in turn: on an invalid token response the stale cache is dropped and the client automatically moves on to the next source, down to pairing.XDG_CACHE_HOMEBLENDERMCP_TOKENOn a fresh start (no Custom Token) the client obtains the token either from the temporary file blendermcp_token_<port> or via the pair socket command — loopback connections only, and only while pairing is open. After the first successful authentication the random token is pinned into Custom Token (becomes static across restarts), pairing closes, and the temporary token files are deleted. The MCP client takes the token from BLENDERMCP_TOKEN (highest priority), BLENDERMCP_TOKEN_FILE, the token file, or — failing all of those — via socket pairing (the obtained token is cached on the MCP side — see the MCP-side token cache row). To revoke access or connect a new client — Reset token & re-pair button.BLENDERMCP_TOKEN_FILEOn a fresh start (no Custom Token) the client obtains the token either from the temporary file blendermcp_token_<port> or via the pair socket command — loopback connections only, and only while pairing is open. After the first successful authentication the random token is pinned into Custom Token (becomes static across restarts), pairing closes, and the temporary token files are deleted. The MCP client takes the token from BLENDERMCP_TOKEN (highest priority), BLENDERMCP_TOKEN_FILE, the token file, or — failing all of those — via socket pairing (the obtained token is cached on the MCP side — see the MCP-side token cache row). To revoke access or connect a new client — Reset token & re-pair button.Tool annotations
No tools have read-only/destructive annotations
Add readOnlyHint or destructiveHint annotations to every tool so hosts can warn users before invoking.
All four hints declared on every tool
22/22 tools missing one or more hints — get_scene_info (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_object_info (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint); get_viewport_screenshot (missing: readOnlyHint, destructiveHint, idempotentHint, openWorldHint), +19 more. OpenAI's directory rejects tools where any of the four hints are missing or non-boolean.
For every tool, set all four hints (readOnlyHint, destructiveHint, idempotentHint, openWorldHint) to explicit true/false values that match the handler’s actual behaviour.
Destructive tools are labelled
1 tool perform destructive updates without destructiveHint — get_viewport_screenshot deletes at line 424 (os.remove(temp_path))
Add destructiveHint:true to any tool whose handler calls .delete(), .upsert(), .update(), unlink, rm, DELETE, DROP, REPLACE INTO, or any operation that overwrites existing data.
Tests exist
No test files found
Add tests that exercise each declared tool.
Secrets not logged
2 secret values sent to logger.warning
Redact or omit secret values from log output.
Claim the listing to review these findings one by one and send us a correction where you disagree, straight to the team. Claiming also means we tell you when the grade moves, and reach you first if we find anything urgent.
[](https://m8ven.ai/mcp/soozs1/blender-mcp)?variant=verified from the URL.Vetting this one by hand? Tool Check is an MCP that scores other MCPs. Add it once and ask Claude, ChatGPT, or any MCP client to grade a server, surface CVEs, check the publisher, and suggest safer alternatives — before you install.
https://m8ven.ai/api/mcp/tool-check