BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:527-543 (handler)

  The main handler function for the 'get_polyhaven_status' tool. It connects to Blender via get_blender_connection(), sends the 'get_polyhaven_status' command, processes the response, and returns a status message indicating if PolyHaven integration is enabled.

  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:527-527 (registration)

  The @mcp.tool() decorator registers the get_polyhaven_status function as an MCP tool.

  def get_polyhaven_status(ctx: Context) -> str:

• src/blender_mcp/server.py:216-220 (helper)

  Helper code in get_blender_connection() that calls the underlying Blender 'get_polyhaven_status' command to cache the PolyHaven enabled status.

  # 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:887-887 (helper)

  Documentation in the asset_creation_strategy prompt recommending the use of get_polyhaven_status() to check PolyHaven status before using related tools.

  Use get_polyhaven_status() to verify its status