MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:1084-1112 (handler)

  MCP tool handler for 'get_application_profiling'. Decorated with @mcp.tool() for registration, includes docstring serving as schema description, and delegates to the implementation.

  @mcp.tool()
  async def get_application_profiling(
      project_id: str,
      app_id: str,
      from_timestamp: int | None = None,
      to_timestamp: int | None = None,
      query: str | None = None,
  ) -> dict[str, Any]:
      """Get CPU and memory profiling data for an application.
  
      Retrieves profiling data including flame graphs for CPU usage
      and memory allocation patterns to help identify performance
      bottlenecks and optimization opportunities.
  
      ⚠️ WARNING: This endpoint can return extremely large responses (180k+ tokens)
      for applications with extensive profiling data. Consider using time filters
      to limit the response size to specific time windows.
  
      Args:
          project_id: Project ID
          app_id: Application ID (format: namespace/kind/name)
          from_timestamp: Start timestamp (optional, strongly recommended)
          to_timestamp: End timestamp (optional, strongly recommended)
          query: Search query (optional)
      """
      return await get_application_profiling_impl(  # type: ignore[no-any-return]
          project_id, app_id, from_timestamp, to_timestamp, query
      )

• src/mcp_coroot/server.py:1066-1082 (helper)

  Implementation helper function decorated with @handle_errors that calls CorootClient.get_application_profiling and formats the response.

  @handle_errors
  async def get_application_profiling_impl(
      project_id: str,
      app_id: str,
      from_timestamp: int | None = None,
      to_timestamp: int | None = None,
      query: str | None = None,
  ) -> dict[str, Any]:
      """Get profiling data for an application."""
      profiling = await get_client().get_application_profiling(
          project_id, app_id, from_timestamp, to_timestamp, query
      )
      return {
          "success": True,
          "profiling": profiling,
      }

• src/mcp_coroot/client.py:849-888 (helper)

  CorootClient method that performs the HTTP GET request to the Coroot API endpoint for application profiling data, handling URL encoding and parameters.

  async def get_application_profiling(
      self,
      project_id: str,
      app_id: str,
      from_timestamp: int | None = None,
      to_timestamp: int | None = None,
      query: str | None = None,
  ) -> dict[str, Any]:
      """Get profiling data for an application.
  
      Args:
          project_id: Project ID.
          app_id: Application ID (format: namespace/kind/name).
          from_timestamp: Start timestamp.
          to_timestamp: End timestamp.
          query: Search query.
  
      Returns:
          Profiling data and flame graphs.
      """
      # URL encode the app_id since it contains slashes
      from urllib.parse import quote
  
      encoded_app_id = quote(app_id, safe="")
  
      params = {}
      if from_timestamp:
          params["from"] = str(from_timestamp)
      if to_timestamp:
          params["to"] = str(to_timestamp)
      if query:
          params["query"] = query
  
      response = await self._request(
          "GET",
          f"/api/project/{project_id}/app/{encoded_app_id}/profiling",
          params=params,
      )
      data: dict[str, Any] = response.json()
      return data