BlenderMCP

Instructions

Returns the generation task status. The task is done if status is "DONE".
The task is in progress if status is "RUN".
If status is "DONE", returns ResultFile3Ds, which is the generated ZIP model path
When the status is "DONE", the response includes a field named ResultFile3Ds that contains the generated ZIP file path of the 3D model in OBJ format.
This is a polling API, so only proceed if the status are finally determined ("DONE" or some failed state).

Implementation Reference

• src/blender_mcp/server.py:940-965 (handler)

  The handler function poll_hunyuan_job_status that polls the status of a Hunyuan3D job by calling a command via the blender connection.

  @mcp.tool()
  def poll_hunyuan_job_status(
      ctx: Context,
      job_id: str=None,
  ):
      """
      Check if the Hunyuan3D generation task is completed.
  
      For Hunyuan3D:
          Parameters:
          - job_id: The job_id given in the generate model step.
  
          Returns the generation task status. The task is done if status is "DONE".
          The task is in progress if status is "RUN".
          If status is "DONE", returns ResultFile3Ds, which is the generated ZIP model path
          When the status is "DONE", the response includes a field named ResultFile3Ds that contains the generated ZIP file path of the 3D model in OBJ format.
          This is a polling API, so only proceed if the status are finally determined ("DONE" or some failed state).
      """
      try:
          blender = get_blender_connection()
          kwargs = {
              "job_id": job_id,
          }
          result = blender.send_command("poll_hunyuan_job_status", kwargs)
          return result
      except Exception as e: