MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:1476-1488 (handler)

  Primary handler and registration for the 'update_project_settings' tool using @mcp.tool() decorator. This is the entry point executed when the tool is called.
  @mcp.tool() async def update_project_settings( project_id: str, settings: dict[str, Any] ) -> dict[str, Any]: """Update project settings and configuration. Updates project-level settings such as retention, alerting, etc. Args: project_id: Project ID settings: Updated project settings """ return await update_project_settings_impl(project_id, settings) # type: ignore[no-any-return]
• src/mcp_coroot/server.py:1464-1474 (helper)

  Helper implementation that wraps the CorootClient call and formats the response with success/error handling via @handle_errors decorator.
  async def update_project_settings_impl( project_id: str, settings: dict[str, Any] ) -> dict[str, Any]: """Update project settings.""" result = await get_client().update_project(project_id, settings) return { "success": True, "message": "Project settings updated successfully", "project": result, }
• src/mcp_coroot/client.py:1097-1127 (helper)

  Core API client method that performs the HTTP POST request to Coroot's /api/project/{project_id} endpoint to update project settings, including name validation.
  async def update_project( self, project_id: str, settings: dict[str, Any] ) -> dict[str, Any]: """Update project settings. Args: project_id: Project ID. settings: Updated project settings. Only 'name' field is supported. Name must match pattern: ^[-_0-9a-z]{3,}$ Returns: Updated project. """ # Validate project name if provided if "name" in settings: import re if not re.match(r"^[-_0-9a-z]{3,}$", settings["name"]): raise ValueError( "Project name must contain only lowercase letters, " "numbers, hyphens, and underscores (min 3 chars)" ) response = await self._request( "POST", f"/api/project/{project_id}", json=settings, ) data: dict[str, Any] = response.json() return data
• src/mcp_coroot/server.py:92-112 (helper)

  Utility function that lazily initializes and returns the shared CorootClient instance used by all tools.
  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