SiteBay MCP Server

Instructions

Implementation Reference

• src/sitebay_mcp/server.py:303-336 (handler)

  The primary MCP tool handler for 'sitebay_list_ready_made_sites'. Decorated with @mcp.tool for registration. Initializes the SiteBayClient, calls list_ready_made_sites() on it, formats the results as a markdown list grouped by category, and handles SiteBayError exceptions.

  @mcp.tool
  async def sitebay_list_ready_made_sites() -> str:
      """
      List available ready-made sites for quick launches.
      
      Returns:
          List of ready-made sites with descriptions
      """
      try:
          client = await initialize_client()
          items = await client.list_ready_made_sites()
          
          if not items:
              return "No ready-made sites available."
          
          result = f"**Available Ready-made Sites** ({len(items)}):\n\n"
          
          for item in items:
              result += f"• **{item.get('name', 'Unknown')}**\n"
              result += f"  - ID: {item.get('id', 'Unknown')}\n"
              
              if item.get('description'):
                  result += f"  - Description: {item.get('description')}\n"
              
              if item.get('category'):
                  result += f"  - Category: {item.get('category')}\n"
              
              result += "\n"
          
          return result
          
      except SiteBayError as e:
          return f"Error listing ready-made sites: {str(e)}"

• src/sitebay_mcp/client.py:342-346 (helper)

  Helper method in SiteBayClient class that performs the actual API request to fetch the list of ready-made sites from '/ready_made_site' endpoint and extracts the 'results' array from the response.

  async def list_ready_made_sites(self) -> List[Dict[str, Any]]:
      """List available ready-made sites"""
      response = await self.get("/ready_made_site")
      return response.get("results", [])

• src/sitebay_mcp/server.py:303-303 (registration)

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

  @mcp.tool