list_templates

Instructions

Implementation Reference

• src/yaparai/tools/templates.py:8-42 (handler)

  Handler function for the list_templates MCP tool. Accepts optional filters (category, media_type, search, featured), builds query params, and delegates to the HTTP client.

  async def list_templates(
      category: str | None = None,
      media_type: str | None = None,
      search: str | None = None,
      featured: bool = False,
  ) -> dict:
      """
      Browse 448+ ready-made AI templates.
  
      Discover pre-built workflows for common tasks: logo creation,
      product photography, portrait retouching, ad generation, and more.
      Each template has predefined inputs — just fill in prompts and images.
      No credits charged for browsing.
  
      Args:
          category: Filter by category slug (e.g., "logo", "product", "portrait")
          media_type: Filter by output type ("image", "video")
          search: Search templates by name/description
          featured: Show only featured templates
  
      Returns:
          Dict with templates list (name, slug, description, credit_cost,
          category, media_type, thumbnail_url).
      """
      client = YaparAIClient()
      params = {}
      if category:
          params["category"] = category
      if media_type:
          params["media_type"] = media_type
      if search:
          params["search"] = search
      if featured:
          params["featured"] = "true"
      return await client.list_templates(params or None)

• src/yaparai/tools/templates.py:8-42 (schema)

  Input parameters (category, media_type, search, featured) and return type (dict) for list_templates, effectively serving as the schema.

  async def list_templates(
      category: str | None = None,
      media_type: str | None = None,
      search: str | None = None,
      featured: bool = False,
  ) -> dict:
      """
      Browse 448+ ready-made AI templates.
  
      Discover pre-built workflows for common tasks: logo creation,
      product photography, portrait retouching, ad generation, and more.
      Each template has predefined inputs — just fill in prompts and images.
      No credits charged for browsing.
  
      Args:
          category: Filter by category slug (e.g., "logo", "product", "portrait")
          media_type: Filter by output type ("image", "video")
          search: Search templates by name/description
          featured: Show only featured templates
  
      Returns:
          Dict with templates list (name, slug, description, credit_cost,
          category, media_type, thumbnail_url).
      """
      client = YaparAIClient()
      params = {}
      if category:
          params["category"] = category
      if media_type:
          params["media_type"] = media_type
      if search:
          params["search"] = search
      if featured:
          params["featured"] = "true"
      return await client.list_templates(params or None)

• src/yaparai/server.py:141-141 (registration)

  Registration of list_templates as an MCP tool via FastMCP's tool() decorator.

  mcp.tool(list_templates)

• src/yaparai/client.py:167-169 (helper)

  HTTP client method that sends a GET request to /v1/comfy-templates with optional query parameters.

  async def list_templates(self, params: dict | None = None) -> dict:
      """List ComfyUI templates."""
      return await self._request("GET", "/v1/comfy-templates", params=params)