# Blender MCP > Use PHATT Blender confidently: free commercial assets, safe project loading, verified previews and GPU renders. - Skill: `phattbeats/blender-mcp` (Agent Skill, multi-file: 6 files) - Install (CLI): `npx skillmds@latest add phattbeats/blender-mcp` - Raw SKILL.md: https://api.skillmd.com/api/skills/phattbeats/blender-mcp/raw - Safety review: pending - Works with: Claude Code, Claude.ai, OpenAI Codex - Category: AI & ML - Author: phattbeats (https://skillmd.com/u/phattbeats) - Updated: 2026-09-22 - Page: https://skillmd.com/skills/phattbeats/blender-mcp --- # Blender MCP PHATT's headless `blender-mcp-veles` server: `10.0.0.100:9876`, raw TCP JSON-RPC; **not stock ahujasid/blender-mcp**. No local Blender, GUI addon, or `uvx` required. Python 3 plus network access is enough. ## Connect Replace `SKILL_DIR` with this skill's absolute directory. Use native tools if exposed; otherwise use the bundled client: ```bash python3 SKILL_DIR/scripts/blender.py init python3 SKILL_DIR/scripts/blender.py call get_scene_info '{}' python3 SKILL_DIR/scripts/blender.py tools ``` Expect server identity, scene data, and live tool schemas. Override host/port with `BLENDER_HOST` / `BLENDER_PORT`. The client initializes each connection, buffers responses, saves inline images, and exits nonzero on errors. ## Preserve and find work Shared scene: coordinate ownership, make calls serially, and save an unused checkpoint before changes. Never automatically clear the scene or overwrite someone else's assets. **Choose the project-loading route; do not stop at the historical crash warning.** To bring assets into the shared scene, append selected objects. To open/render a complete `.blend`, use a separate Blender process with the file loaded at startup. Recipes: [existing .blend files](references/blend-files.md). `load_blend` passed three isolated tests using the deployed server on 2026-09-07 (Brother Green Paw, chair, tree). This demonstrates that the handler worked in those tests, not that replacing an active shared scene is harmless. Do not call `load_blend`, `bpy.ops.wm.open_mainfile`, or `read_homefile` in the shared production MCP interpreter. Isolated tests of that handler require explicit authorization; ordinary project work should use the established routes without asking again. Tool paths are inside the server: `/projects/` = host `/mnt/user/shared-projects/blender` = Paperclip `/paperclip/blender-projects` when mounted. OpenClaw has no assumed mount. Copy local files into the shared project tree before importing. ```bash python3 SKILL_DIR/scripts/blender.py call list_files '{"path":"/projects/","pattern":".blend"}' python3 SKILL_DIR/scripts/blender.py call execute_python '{"code":"from pathlib import Path; Path(\"/projects/my-job\").mkdir(parents=True, exist_ok=True)"}' python3 SKILL_DIR/scripts/blender.py call save_blend '{"filepath":"/projects/my-job/checkpoint-001.blend"}' ``` Replace `my-job` and filenames with actual project paths. ## Assets: search before modeling For ordinary props (a chair, tree, crate), search existing assets before building custom geometry. Call `asset_creation_strategy` first. **Free assets licensed for commercial use are authorized; do not ask permission again for each prop.** Prefer Poly Haven CC0, then Sketchfab CC0. For other free commercial-use licenses, verify the actual terms and retain required attribution; exclude noncommercial/editorial-only assets. Record asset URL, creator when relevant, license and attribution with the project. No purchases, paid APIs, trials, or new subscriptions without approval. A free asset license does not automatically authorize paid API access. Poly Haven and Sketchfab were already enabled at the 2026-09-07 audit. Check live status when needed; do not reinstall integrations merely because a task needs an asset. If credentials or access are unavailable, report the specific blocker and use another authorized source where possible. Do not change credentials or containers. ```bash python3 SKILL_DIR/scripts/blender.py call search_polyhaven_assets '{"asset_type":"models"}' python3 SKILL_DIR/scripts/blender.py call search_polyhaven_assets '{"asset_type":"textures","categories":"brick"}' python3 SKILL_DIR/scripts/blender.py call get_sketchfab_status '{}' python3 SKILL_DIR/scripts/blender.py call search_sketchfab '{"query":"wooden chair","license":"cc0","count":5}' ``` Consult live schemas for supported filters. Poly Haven: `download_polyhaven_asset` with returned `asset_id`, `asset_type`, and `resolution:"1k"`; apply textures using `set_texture` with `object_name` and `texture_id`. Sketchfab: use returned `uid` with `download_sketchfab_model`. **Asset download tools can import into the active scene.** Treat them as scene mutations, not download-only helpers. Use them only in the scene you own; isolated asset tests must not use production MCP to import their fixtures. For download-only work, fetch the complete asset and dependencies from its documented source into the project directory. **Complete the asset, not just the mesh:** retrieve referenced textures, resolve missing paths, preserve material connections and foliage alpha, and pack supported image dependencies into the final `.blend`. Check dependencies before saving and inspect a render afterward. Magenta materials, missing foliage, or broken transparency mean the import is unfinished. ## Import, edit, save For GLB/GLTF, FBX, OBJ, STL: ```bash python3 SKILL_DIR/scripts/blender.py call import_model '{"filepath":"/projects/my-job/model.glb"}' python3 SKILL_DIR/scripts/blender.py call get_scene_info '{}' python3 SKILL_DIR/scripts/blender.py call modify_object '{"object_name":"Cube","location":[0,0,1],"rotation":[0,0,25]}' python3 SKILL_DIR/scripts/blender.py call set_material '{"object_name":"Cube","material_name":"Blue","color":[0.05,0.2,0.8,1],"roughness":0.4}' python3 SKILL_DIR/scripts/blender.py call save_blend '{"filepath":"/projects/my-job/result.blend"}' ``` Use actual object names from inspection. Create geometry with `create_object`, e.g. `{"type":"SPHERE","name":"Ball","location":[0,0,0],"size":0.5}`. For `.blend` assets, append selected objects or open the full file in a separate process per the reference above. For arbitrary edits, write a local Python script importing `bpy`, then send its contents: ```bash python3 SKILL_DIR/scripts/blender.py python /absolute/local/edit_scene.py ``` Batch related edits; print brief summaries. Structured object rotations are degrees; Python `rotation_euler` uses radians. Cycles cannot use Shader to RGB: avoid `cel_shade`/`diffuse_steps`, use `emission_flat` or compatible materials. ## Preview, render, deliver GPU: Blender 4.2/Cycles CUDA on the Quadro K2200; no OptiX or silent CPU fallback. Serialize renders and coordinate GPU use, including separate Blender processes. ```bash python3 SKILL_DIR/scripts/blender.py --timeout 600 --image-out /tmp/preview.png call get_preview_render '{"max_size":512,"samples":8,"engine":"CYCLES"}' ``` Open the downloaded preview with an image tool. The preview restores temporary settings and supplies a temporary camera if needed. Frame the whole subject with margins; make surfaces readable through lighting and contrast. Check missing textures, foliage transparency, clipping and exposure. Fix visible defects before a full render; a successful render command alone is not visual verification. Only if the working scene lacks a camera/light: ```bash python3 SKILL_DIR/scripts/blender.py call setup_camera '{"preset":"isometric","ortho_scale":5}' python3 SKILL_DIR/scripts/blender.py call create_object '{"type":"LIGHT","name":"KeyLight","light_type":"POINT","location":[2,-3,5],"light_energy":1000}' ``` Configure and render: ```bash python3 SKILL_DIR/scripts/blender.py call execute_python '{"code":"import bpy; p=bpy.context.preferences.addons[\"cycles\"].preferences; p.compute_device_type=\"CUDA\"; p.get_devices(); gpu=[d for d in p.devices if d.type==\"CUDA\" and \"K2200\" in d.name]; assert gpu, \"K2200 CUDA unavailable\"; [setattr(d,\"use\",d in gpu) for d in p.devices]; print([(d.name,d.use) for d in p.devices])"}' python3 SKILL_DIR/scripts/blender.py call set_render_settings '{"engine":"CYCLES","device":"GPU","resolution_x":1024,"resolution_y":1024,"samples":32,"transparent":false,"output_format":"PNG"}' python3 SKILL_DIR/scripts/blender.py --timeout 7200 call render_image '{"output_path":"/projects/my-job/final.png"}' python3 SKILL_DIR/scripts/blender.py call save_blend '{"filepath":"/projects/my-job/result.blend"}' python3 SKILL_DIR/scripts/blender.py call list_files '{"path":"/projects/my-job/"}' ``` For animation, replace the render call with: ```bash python3 SKILL_DIR/scripts/blender.py --timeout 7200 call render_animation '{"output_path":"/projects/my-job/frame_","frame_start":1,"frame_end":24,"frame_step":1}' ``` Allow the shell at least the client's deadline, or use background execution with completion checks. A timeout does not cancel Blender: inspect logs/process/output evidence before another mutation; never retry blindly or restart services. The client downloads inline previews only. Final renders remain on the server; retrieve through an existing shared mount or approved file transfer. Paperclip's mounted final path is `/paperclip/blender-projects/my-job/final.png`. Verify files exist, inspect the actual images, then attach them in the visible reply along with the saved `.blend` path. **When screenshots are requested, deliver images—not merely a statement that they rendered.** Clearly label interim previews and remaining defects. Connection errors: report endpoint/reachability, no install/restart. Invalid arguments: consult `tools`. Missing files: inspect server paths, not local ones. Upstream uses different names/protocols—see [compatibility](references/upstream.md).