SiteBay MCP Server

Instructions

Implementation Reference

• src/sitebay_mcp/server.py:455-490 (handler)

  The primary handler function for the 'sitebay_posthog_proxy' MCP tool. It processes input parameters, initializes the SiteBay client, constructs proxy data, calls the client's posthog_proxy method, formats the response, and handles errors appropriately.

  @mcp.tool
  async def sitebay_posthog_proxy(
      ctx: Context,
      path: str,
      query_params_json: str = "",
      method: str = "get",
  ) -> str:
      """
      Proxy POST requests to PostHog analytics API.
      
      Args:
          path: PostHog API path
          query_params_json: Optional JSON string for payload or query params
          method: HTTP method (get, post, put, delete)
      
      Returns:
          PostHog API response
      """
      try:
          await ctx.info(f"PostHog proxy request to {path}")
          
          client = await initialize_client()
          proxy_data: dict[str, Any] = {"path": path, "method": method}
          if query_params_json:
              proxy_data["query_params_json"] = query_params_json
              
          result = await client.posthog_proxy(proxy_data)
          return f"✅ PostHog API Response:\n```json\n{result}\n```"
          
      except SiteBayError as e:
          await ctx.error(f"PostHog proxy error: {str(e)}")
          return f"❌ PostHog Proxy Error: {str(e)}"
      except Exception as e:
          await ctx.error(f"Unexpected proxy error: {str(e)}")
          return f"❌ Unexpected error: {str(e)}"

• src/sitebay_mcp/client.py:331-333 (helper)

  Supporting helper method in SiteBayClient class that forwards the proxy request to the SiteBay API endpoint '/posthog-proxy' via a POST request.

  async def posthog_proxy(self, proxy_data: Dict[str, Any]) -> Any:
      """Proxy request to PostHog API"""
      return await self.post("/posthog-proxy", json_data=proxy_data)

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

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

  @mcp.tool