BlenderMCP

Instructions

Implementation Reference

• src/blender_mcp/server.py:603-633 (handler)

  The implementation of the search_sketchfab_models tool which acts as a wrapper to send the command to the Blender instance.

  @telemetry_tool("search_sketchfab_models")
  @mcp.tool()
  def search_sketchfab_models(
      ctx: Context,
      query: str,
      categories: str = None,
      count: int = 20,
      downloadable: bool = True
  ) -> str:
      """
      Search for models on Sketchfab with optional filtering.
  
      Parameters:
      - query: Text to search for
      - categories: Optional comma-separated list of categories
      - count: Maximum number of results to return (default 20)
      - downloadable: Whether to include only downloadable models (default True)
  
      Returns a formatted list of matching models.
      """
      try:
          blender = get_blender_connection()
          logger.info(f"Searching Sketchfab models with query: {query}, categories: {categories}, count: {count}, downloadable: {downloadable}")
          result = blender.send_command("search_sketchfab_models", {
              "query": query,
              "categories": categories,
              "count": count,
              "downloadable": downloadable
          })
          
          if "error" in result: