BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:559-575 (handler)

  The primary handler function for the 'get_sketchfab_status' tool. It uses the @mcp.tool() decorator for registration and implements the logic by sending a 'get_sketchfab_status' command to the Blender addon via socket connection, processing the response to return a status message indicating if Sketchfab integration is enabled.

  @mcp.tool()
  def get_sketchfab_status(ctx: Context) -> str:
      """
      Check if Sketchfab integration is enabled in Blender.
      Returns a message indicating whether Sketchfab features are available.
      """
      try:
          blender = get_blender_connection()
          result = blender.send_command("get_sketchfab_status")
          enabled = result.get("enabled", False)
          message = result.get("message", "")
          if enabled:
              message += "Sketchfab is good at Realistic models, and has a wider variety of models than PolyHaven."        
          return message
      except Exception as e:
          logger.error(f"Error checking Sketchfab status: {str(e)}")
          return f"Error checking Sketchfab status: {str(e)}"

• src/blender_mcp/server.py:888-894 (helper)

  Helper prompt in asset_creation_strategy that instructs the AI on when and how to use the get_sketchfab_status tool to check Sketchfab integration status before using related tools.

  Sketchfab is good at Realistic models, and has a wider variety of models than PolyHaven.
  Use get_sketchfab_status() to verify its status
  If Sketchfab is enabled:
  - For objects/models: First search using search_sketchfab_models() with your query
  - Then download specific models using download_sketchfab_model() with the UID
  - Note that only downloadable models can be accessed, and API key must be properly configured
  - Sketchfab has a wider variety of models than PolyHaven, especially for specific subjects

• src/blender_mcp/server.py:559-559 (registration)

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

  @mcp.tool()