MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:568-586 (handler)

  MCP tool handler and registration for 'list_integrations'. This is the entrypoint function decorated with @mcp.tool() that handles the tool execution by delegating to the implementation helper.

  @mcp.tool()
  async def list_integrations(project_id: str) -> dict[str, Any]:
      """List all configured integrations for a project.
  
      Returns the configuration status of all available integrations:
      - Prometheus
      - ClickHouse
      - AWS
      - Slack
      - Microsoft Teams
      - PagerDuty
      - Opsgenie
      - Webhooks
  
      Args:
          project_id: Project ID
      """
      return await list_integrations_impl(project_id)  # type: ignore[no-any-return]

• src/mcp_coroot/server.py:558-566 (helper)

  Server-side helper function that calls CorootClient.list_integrations(project_id) and wraps the result in a success response.

  @handle_errors
  async def list_integrations_impl(project_id: str) -> dict[str, Any]:
      """List all integrations."""
      integrations = await get_client().list_integrations(project_id)
      return {
          "success": True,
          "integrations": integrations,
      }

• src/mcp_coroot/client.py:600-612 (helper)

  CorootClient method implementing the core API call to fetch integrations via GET /api/project/{project_id}/integrations.

  async def list_integrations(self, project_id: str) -> dict[str, Any]:
      """List all configured integrations for a project.
  
      Args:
          project_id: Project ID.
  
      Returns:
          Dictionary of integration configurations.
      """
      response = await self._request("GET", f"/api/project/{project_id}/integrations")
      data: dict[str, Any] = response.json()
      return data