MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:1246-1252 (handler)

  Core handler implementation for the get_incident MCP tool. Calls CorootClient.get_incident to fetch details and wraps in success response.

  async def get_incident_impl(project_id: str, incident_id: str) -> dict[str, Any]:
      """Get incident details."""
      incident = await get_client().get_incident(project_id, incident_id)
      return {
          "success": True,
          "incident": incident,
      }

• src/mcp_coroot/server.py:1255-1270 (registration)

  MCP tool registration with @mcp.tool() decorator, including schema from parameters and docstring.

  @mcp.tool()
  async def get_incident(project_id: str, incident_id: str) -> dict[str, Any]:
      """Get detailed information about a specific incident.
  
      Retrieves comprehensive incident information including:
      - Timeline of events
      - Affected applications
      - Impact assessment
      - Resolution status
  
      Args:
          project_id: Project ID
          incident_id: Incident ID
      """
      return await get_incident_impl(project_id, incident_id)  # type: ignore[no-any-return]

• src/mcp_coroot/client.py:948-962 (helper)

  CorootClient helper method that performs the actual HTTP API request to retrieve incident data from the Coroot server.

  async def get_incident(self, project_id: str, incident_id: str) -> dict[str, Any]:
      """Get detailed information about a specific incident.
  
      Args:
          project_id: Project ID.
          incident_id: Incident ID.
  
      Returns:
          Incident details including timeline and impact.
      """
      response = await self._request(
          "GET", f"/api/project/{project_id}/incident/{incident_id}"
      )
      data: dict[str, Any] = response.json()
      return data