BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:526-542 (handler)

  The handler function for the 'get_polyhaven_status' MCP tool. It proxies the request to the Blender connection, processes the result to check if PolyHaven is enabled, appends a descriptive message if enabled, and returns a status string.
  @mcp.tool() def get_polyhaven_status(ctx: Context) -> str: """ Check if PolyHaven integration is enabled in Blender. Returns a message indicating whether PolyHaven features are available. """ try: blender = get_blender_connection() result = blender.send_command("get_polyhaven_status") enabled = result.get("enabled", False) message = result.get("message", "") if enabled: message += "PolyHaven is good at Textures, and has a wider variety of textures than Sketchfab." return message except Exception as e: logger.error(f"Error checking PolyHaven status: {str(e)}") return f"Error checking PolyHaven status: {str(e)}"
• src/blender_mcp/server.py:214-220 (helper)

  Helper usage in get_blender_connection() function: sends 'get_polyhaven_status' command as a ping to validate the persistent Blender connection and caches the PolyHaven enabled status globally.
  if _blender_connection is not None: try: # First check if PolyHaven is enabled by sending a ping command result = _blender_connection.send_command("get_polyhaven_status") # Store the PolyHaven status globally _polyhaven_enabled = result.get("enabled", False) return _blender_connection
• src/blender_mcp/server.py:886-892 (helper)

  Reference to get_polyhaven_status() in the asset_creation_strategy prompt, instructing to use it first to check PolyHaven availability before downloading assets.
  1. PolyHaven Use get_polyhaven_status() to verify its status If PolyHaven is enabled: - For objects/models: Use download_polyhaven_asset() with asset_type="models" - For materials/textures: Use download_polyhaven_asset() with asset_type="textures" - For environment lighting: Use download_polyhaven_asset() with asset_type="hdris" 2. Sketchfab