MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:535-552 (handler)

  MCP tool handler function for 'get_risks_overview'. This is the entry point decorated with @mcp.tool() that defines the tool schema via type hints and delegates to the implementation.

  @mcp.tool()
  async def get_risks_overview(
      project_id: str,
      query: str | None = None,
  ) -> dict[str, Any]:
      """Get risk assessment overview.
  
      Returns comprehensive risk analysis across all applications:
      - High-risk applications
      - Risk trends over time
      - Critical issues requiring attention
      - Compliance and security risks
  
      Args:
          project_id: Project ID
          query: Search/filter query (optional)
      """
      return await get_risks_overview_impl(project_id, query)  # type: ignore[no-any-return]

• src/mcp_coroot/server.py:522-532 (helper)

  Error-handling wrapper that calls the CorootClient method and formats the response.

  @handle_errors
  async def get_risks_overview_impl(
      project_id: str,
      query: str | None = None,
  ) -> dict[str, Any]:
      """Get risks overview."""
      overview = await get_client().get_risks_overview(project_id, query)
      return {
          "success": True,
          "overview": overview,
      }

• src/mcp_coroot/client.py:572-596 (helper)

  Core CorootClient method that executes the HTTP GET request to the Coroot API endpoint for risks overview.

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