SiteBay MCP Server

Instructions

Implementation Reference

• src/sitebay_mcp/server.py:111-192 (handler)

  Primary MCP tool handler registered with @mcp.tool for 'sitebay_create_site'. Handles context, client initialization, input validation, delegates to core logic in sites.py, and provides comprehensive error handling with ctx.error calls.
  @mcp.tool async def sitebay_create_site( ctx: Context, team_id: str, fqdn: str, wordpress_blog_name: str, wordpress_first_name: str, wordpress_last_name: str, wordpress_email: str, wordpress_username: str, wordpress_password: str, git_url: Optional[str] = None, ready_made_site_name: Optional[str] = None, is_free: Optional[bool] = None, ) -> str: """ Create a new WordPress site (SiteLiveCreate schema). Args: team_id: Team UUID that owns the site fqdn: The fully qualified domain name for the new site (e.g., "www.example.org") wordpress_blog_name: Blog/site title wordpress_first_name: Admin first name wordpress_last_name: Admin last name wordpress_email: Admin email address wordpress_username: Admin username wordpress_password: Admin password (strong) git_url: Optional Git repository URL ready_made_site_name: Optional ready-made site name is_free: Optional flag for free plan Returns: Success message with new site details and access information """ try: await ctx.info(f"Starting site creation for: {fqdn}") client = await initialize_client() # Basic validation if not fqdn or '.' not in fqdn: raise ValueError("Invalid domain name provided") if not team_id: raise ValueError("team_id is required") result = await sites.sitebay_create_site( client, team_id, fqdn, wordpress_blog_name, wordpress_first_name, wordpress_last_name, wordpress_email, wordpress_username, wordpress_password, git_url, ready_made_site_name, is_free, ) await ctx.info(f"Successfully created site: {fqdn}") return result except ValueError as e: await ctx.error(f"Validation error creating site {fqdn}: {str(e)}") return f"❌ Validation Error: {str(e)}" except ValidationError as e: await ctx.error(f"SiteBay validation error creating site {fqdn}: {str(e)}") error_msg = f"❌ Validation Error - Please check your input:\n{str(e)}\n" if hasattr(e, 'field_errors') and e.field_errors: error_msg += "\nSpecific field errors:\n" for field, msg in e.field_errors.items(): error_msg += f" • {field}: {msg}\n" error_msg += "\nPlease adjust your parameters and try again." return error_msg except SiteBayError as e: await ctx.error(f"SiteBay API error creating site {fqdn}: {str(e)}") return f"❌ SiteBay Error: {str(e)}" except Exception as e: await ctx.error(f"Unexpected error creating site {fqdn}: {str(e)}") return f"❌ Unexpected error: {str(e)}"
• src/sitebay_mcp/tools/sites.py:94-164 (handler)

  Core handler logic for site creation. Constructs the site_data dictionary from parameters and calls client.create_site(site_data). Formats the success response with site details or error message.
  async def sitebay_create_site( client: SiteBayClient, team_id: str, fqdn: str, wordpress_blog_name: str, wordpress_first_name: str, wordpress_last_name: str, wordpress_email: str, wordpress_username: str, wordpress_password: str, git_url: Optional[str] = None, ready_made_site_name: Optional[str] = None, is_free: Optional[bool] = None, ) -> str: """ Create a new WordPress site (SiteLiveCreate schema). Args: team_id: Team UUID fqdn: New site domain wordpress_blog_name: Blog/site title wordpress_first_name: Admin first name wordpress_last_name: Admin last name wordpress_email: Admin email wordpress_username: Admin username wordpress_password: Admin password git_url: Optional repository URL ready_made_site_name: Optional ready-made site name is_free: Optional free plan flag Returns: Formatted string with new site details """ try: site_data: Dict[str, Any] = { "team_id": team_id, "fqdn": fqdn, "wordpress_blog_name": wordpress_blog_name, "wordpress_first_name": wordpress_first_name, "wordpress_last_name": wordpress_last_name, "wordpress_email": wordpress_email, "wordpress_username": wordpress_username, "wordpress_password": wordpress_password, } if git_url: site_data["git_url"] = git_url if ready_made_site_name: site_data["ready_made_site_name"] = ready_made_site_name if is_free is not None: site_data["is_free"] = is_free site = await client.create_site(site_data) result = f"✅ **Site Created Successfully!**\n\n" result += f"• **Domain**: {site.get('fqdn')}\n" result += f"• **Active**: {site.get('active', 'Unknown')}\n" result += f"• **HTTP Auth Enabled**: {site.get('http_auth_enabled', 'Unknown')}\n" result += f"• **Admin Username**: {wordpress_username}\n" result += f"• **Admin Email**: {wordpress_email}\n" if git_url: result += f"• **Git URL**: {git_url}\n" if ready_made_site_name: result += f"• **Ready-made**: {ready_made_site_name}\n" if is_free is not None: result += f"• **Plan**: {'Free' if is_free else 'Paid'}\n" result += "\n🚀 Your WordPress site is being deployed and will be ready shortly!" return result except SiteBayError as e: return f"Error creating site: {str(e)}"
• src/sitebay_mcp/server.py:111-111 (registration)

  Registration of the 'sitebay_create_site' tool via the @mcp.tool decorator in the FastMCP server.
  @mcp.tool