MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:1904-1927 (handler)

  MCP tool handler function for 'get_panel_data'. This is the entry point registered with FastMCP that handles tool calls and delegates to the implementation.
  @mcp.tool() async def get_panel_data( project_id: str, dashboard_id: str, panel_id: str, from_time: str | None = None, to_time: str | None = None, ) -> dict[str, Any]: """ Get data for a specific dashboard panel. Retrieves the data that powers a specific panel in a custom dashboard, including metrics, time series data, or aggregated values. Args: project_id: The project ID dashboard_id: The dashboard ID panel_id: The panel ID within the dashboard from_time: Optional start time (ISO format or relative like '-1h') to_time: Optional end time (ISO format or 'now') """ return await get_panel_data_impl( project_id, dashboard_id, panel_id, from_time, to_time )
• src/mcp_coroot/client.py:1502-1526 (handler)

  Core handler in CorootClient that makes the actual HTTP request to the Coroot API endpoint /api/project/{project_id}/panel/data to fetch the panel data.
  async def get_panel_data( self, project_id: str, dashboard_id: str, panel_id: str, params: dict[str, Any] | None = None, ) -> dict[str, Any]: """Get data for a specific dashboard panel. Args: project_id: The project ID dashboard_id: The dashboard ID panel_id: The panel ID params: Optional query parameters (time range, etc.) Returns: Dict containing panel data """ query_params = params or {} query_params.update({"dashboard": dashboard_id, "panel": panel_id}) response = await self._request( "GET", f"/api/project/{project_id}/panel/data", params=query_params ) data: dict[str, Any] = response.json() return data
• src/mcp_coroot/server.py:1881-1902 (helper)

  Helper implementation function in the MCP server that wraps the client call with error handling specific to the tool.
  async def get_panel_data_impl( project_id: str, dashboard_id: str, panel_id: str, from_time: str | None = None, to_time: str | None = None, ) -> dict[str, Any]: """Implementation for get_panel_data tool.""" try: client = get_client() params = {} if from_time: params["from"] = from_time if to_time: params["to"] = to_time data = await client.get_panel_data(project_id, dashboard_id, panel_id, params) return {"success": True, "data": data} except ValueError as e: return {"success": False, "error": str(e)} except Exception as e: return {"success": False, "error": f"Unexpected error: {str(e)}"}
• src/mcp_coroot/server.py:1904-1904 (registration)

  FastMCP tool registration decorator that registers the get_panel_data handler with name 'get_panel_data'.
  @mcp.tool()