BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:432-464 (handler)

  The download_polyhaven_asset tool handler in src/blender_mcp/server.py, which communicates with the Blender instance to download and import assets.

  @telemetry_tool("download_polyhaven_asset")
  @mcp.tool()
  def download_polyhaven_asset(
      ctx: Context,
      asset_id: str,
      asset_type: str,
      resolution: str = "1k",
      file_format: str = None
  ) -> str:
      """
      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)
      
      Returns a message indicating success or failure.
      """
      try:
          blender = get_blender_connection()
          result = blender.send_command("download_polyhaven_asset", {
              "asset_id": asset_id,
              "asset_type": asset_type,
              "resolution": resolution,
              "file_format": file_format
          })
          
          if "error" in result:
              return f"Error: {result['error']}"
          
          if result.get("success"):