MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:456-486 (handler)

  The primary handler for the 'get_traces_overview' MCP tool. Includes the @mcp.tool() decorator for registration, error handling, the implementation logic that invokes the CorootClient, and the tool docstring serving as input schema definition.

  @handle_errors
  async def get_traces_overview_impl(
      project_id: str,
      query: str | None = None,
  ) -> dict[str, Any]:
      """Get traces overview."""
      overview = await get_client().get_traces_overview(project_id, query)
      return {
          "success": True,
          "overview": overview,
      }
  
  
  @mcp.tool()
  async def get_traces_overview(
      project_id: str,
      query: str | None = None,
  ) -> dict[str, Any]:
      """Get distributed tracing overview.
  
      Returns a summary of distributed traces across all applications:
      - Trace volume and trends
      - Error rates
      - Latency percentiles
      - Service dependencies
  
      Args:
          project_id: Project ID
          query: Search/filter query (optional)
      """
      return await get_traces_overview_impl(project_id, query)  # type: ignore[no-any-return]

• src/mcp_coroot/client.py:520-544 (helper)

  Supporting utility in CorootClient that makes the authenticated HTTP GET request to the Coroot API endpoint '/api/project/{project_id}/overview/traces' and returns the parsed JSON response.

  async def get_traces_overview(
      self,
      project_id: str,
      query: str | None = None,
  ) -> dict[str, Any]:
      """Get distributed tracing overview.
  
      Args:
          project_id: Project ID.
          query: Search/filter query.
  
      Returns:
          Traces overview data.
      """
      params = {}
      if query:
          params["query"] = query
  
      response = await self._request(
          "GET",
          f"/api/project/{project_id}/overview/traces",
          params=params,
      )
      data: dict[str, Any] = response.json()
      return data