> ## Documentation Index
> Fetch the complete documentation index at: https://mcp-for-blender.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Blender MCP Capabilities: What You Can Build

> Blender MCP exposes tools for scene inspection, object manipulation, materials, Python execution, screenshots, and asset downloads from multiple sources.

Blender MCP gives your AI client a toolkit of actions in Blender, from reading scene state to downloading production-ready assets.

## Capability Overview

<CardGroup cols={2}>
  <Card title="Scene Inspection" icon="eye">
    Read the full scene graph, object lists, transforms, and collections in real time.
  </Card>

  <Card title="Object Manipulation" icon="cube">
    Create, move, rotate, scale, rename, and delete objects using natural language prompts.
  </Card>

  <Card title="Material Control" icon="palette">
    Assign and configure materials, textures, and shaders on any object in the scene.
  </Card>

  <Card title="Code Execution" icon="code">
    Run arbitrary Blender Python (`bpy`) for operations not covered by built-in tools.
  </Card>

  <Card title="Asset Integration" icon="download">
    Search and download HDRIs, textures, and 3D models from Poly Haven, Sketchfab, Poly Pizza, Hyper3D, and Hunyuan3D.
  </Card>

  <Card title="Viewport Screenshots" icon="camera">
    Capture the current 3D viewport and return it to the AI client for visual feedback.
  </Card>
</CardGroup>

## Full Tool Reference

| Tool                                | Category | What It Does                                                      |
| ----------------------------------- | -------- | ----------------------------------------------------------------- |
| `get_scene_info`                    | Scene    | Returns the full scene graph, objects, and collections.           |
| `get_object_info`                   | Scene    | Returns detailed data for a specific object by name.              |
| `get_viewport_screenshot`           | Viewport | Captures the current 3D viewport as an image.                     |
| `execute_blender_code`              | Code     | Runs arbitrary Python in Blender and returns the result.          |
| `get_polyhaven_status`              | Asset    | Checks whether Poly Haven integration is enabled and reachable.   |
| `search_polyhaven_assets`           | Asset    | Searches Poly Haven for HDRIs, textures, or models.               |
| `download_polyhaven_asset`          | Asset    | Downloads and imports a Poly Haven asset into the scene.          |
| `set_texture`                       | Material | Applies a texture or material to the selected object.             |
| `search_sketchfab_models`           | Asset    | Searches Sketchfab for downloadable 3D models.                    |
| `download_sketchfab_model`          | Asset    | Downloads and imports a Sketchfab model into the scene.           |
| `search_polypizza_models`           | Asset    | Searches Poly Pizza for low-poly 3D models.                       |
| `download_polypizza_model`          | Asset    | Downloads and imports a Poly Pizza model into the scene.          |
| `generate_hyper3d_model_via_text`   | AI       | Generates a 3D model from a text prompt using Hyper3D Rodin.      |
| `generate_hyper3d_model_via_images` | AI       | Generates a 3D model from one or more images using Hyper3D Rodin. |
| `poll_rodin_job_status`             | AI       | Checks the generation status of a Hyper3D Rodin job.              |
| `import_generated_asset`            | AI       | Imports a completed Hyper3D Rodin model into Blender.             |
| `generate_hunyuan3d_model`          | AI       | Generates a 3D model from text or image using Hunyuan3D.          |
| `poll_hunyuan_job_status`           | AI       | Checks the generation status of a Hunyuan3D job.                  |
| `import_generated_asset_hunyuan`    | AI       | Imports a completed Hunyuan3D model into Blender.                 |

## Asset Priority Guide

When you need an asset, the right integration depends on what you are building:

* **Sketchfab** for specific, realistic objects with detailed geometry and textures.
* **Poly Pizza** for stylised, low-poly game assets. The library includes over 10,600 free models.
* **Poly Haven** for generic objects, furniture, HDRIs, and PBR textures.
* **Hyper3D Rodin** or **Hunyuan3D** for custom, unique items that do not exist in any library. These are AI generation services that create models from text or images.

<Tip>
  Start with library assets when possible. They are faster to download and usually higher quality than generated models for common objects.
</Tip>

## Limitations

Complex operations may need to be broken into smaller steps. The AI client works best with incremental, explicit instructions rather than single large prompts that try to do everything at once.

Blender must be running with a GUI. Headless mode (`blender -b`) is not supported unless you use `xvfb-run -a blender` to provide a virtual display.

Only one MCP server instance can connect to Blender at a time. Do not run both Cursor and Claude Desktop against the same Blender session simultaneously.