MCP Server for Coroot

Instructions

Implementation Reference

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

  Primary MCP tool handler for 'list_integrations'. Decorated with @mcp.tool() for automatic registration. Delegates to the error-handled implementation.
  @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-565 (handler)

  Error-handled implementation of list_integrations tool. Calls CorootClient.list_integrations and formats the 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-611 (helper)

  CorootClient method that executes the HTTP GET request to the Coroot API endpoint /api/project/{project_id}/integrations to fetch integration configurations.
  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
• src/mcp_coroot/server.py:92-113 (helper)

  Lazy client factory used by all tools to get the shared CorootClient instance with authentication.
  def get_client() -> CorootClient: """Get or create the client instance. Raises: ValueError: If no credentials are configured. """ global _client if _client is None: try: _client = CorootClient() except ValueError as e: # Re-raise with more context raise ValueError( "Coroot credentials not configured. " "Please set COROOT_BASE_URL and either:\n" " - COROOT_USERNAME and COROOT_PASSWORD for automatic login\n" " - COROOT_SESSION_COOKIE for direct authentication\n" " - COROOT_API_KEY for data ingestion endpoints" ) from e return _client