MCP for Blender
Menu Poly Haven

Integrations

Poly Haven Integration: Free HDRIs, Textures, and Models

Use Poly Haven inside MCP for Blender to download free HDRIs, PBR textures, and 3D models directly into your scene with a single prompt.

Poly Haven is a library of thousands of free, CC0-licensed HDRIs, physically-based textures, and 3D models. With MCP for Blender, you can search and download any asset directly into your scene using natural language. No API key is required, and all assets are free to use for any purpose.

Enabling

To start using Poly Haven assets in MCP for Blender, enable the integration in Blender's interface.

  1. In the 3D viewport, press N to open the sidebar.

  2. Select the MCP for Blender tab.

  3. Tick Poly Haven.

Once enabled, your LLM can search and download Poly Haven assets automatically when you ask for them.

What You Can Download

Poly Haven provides three types of assets, each handled differently when imported:

HDRIs

High dynamic range environment images. When downloaded, they are packed into the file and set up in a new world, so they don't overwrite a world you built.

PBR Textures

Physically-based material sets including diffuse, normal, roughness, and displacement maps. MCP for Blender creates a full material and applies it to the target object.

3D Models

Complete 3D assets imported from the artist's original .blend file, which keeps full material detail.

Example Prompts

You can ask your LLM to use Poly Haven assets in natural language. Here are some effective prompts:

  • "Create a beach scene using HDRIs, textures, and vegetation from Poly Haven"
  • "Set up studio lighting using a Poly Haven HDRI"
  • "Apply a wood texture from Poly Haven to the floor"

Tools Used

Your AI finds Poly Haven assets with search_assets and imports them with import_asset, using source="polyhaven":

search_assets(source="polyhaven", query="sunny beach", asset_type="hdris", previews=3)
import_asset(source="polyhaven", id="<id from search>", asset_type="textures", apply_to=["Floor"])

Search understands meaning, so "couch" finds sofas, and it can filter by category, attributes like {"weather": "clear"}, and a minimum real-world texture size with min_size_m. For textures, apply_to puts the new material on the objects you name.

Download Options

When downloading assets, you can specify resolution and format:

  • Resolution: 1k, 2k, 4k, or 8k for most assets, and up to 16k or 24k for some HDRIs. File size grows roughly fourfold per step, so prefer 1k–2k unless the asset is close to camera.
  • HDRIs: file_format of hdr (default) or exr
  • Textures: file_format of jpg (default), png, or exr
  • 3D Models: always imported from .blend; no format argument

No API key is required. All Poly Haven assets are CC0 licensed, so you can use them freely in personal and commercial projects without attribution. On import, the asset's ID, page URL, authors, resolution, and licence are written onto the imported data as custom properties (polyhaven_id, polyhaven_url, and so on).