MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:831-863 (handler)

  Primary MCP tool handler: the @mcp.tool()-decorated function that defines the tool interface, input parameters, and calls the implementation. This is the exact implementation executed when the tool is called.
  @mcp.tool() async def create_application_category( project_id: str, name: str, custom_patterns: str, notify_incidents: bool = True, notify_deployments: bool = False, slack_channel: str | None = None, ) -> dict[str, Any]: """Create a new application category. Creates a category for grouping applications based on namespace/name patterns. Patterns must be space-separated and in format namespace/name (e.g., "test/* demo/*"). Each pattern must contain exactly one '/' and cannot start with '/'. Args: project_id: Project ID name: Category name (lowercase letters, numbers, hyphens, underscores; min 3 chars) custom_patterns: Space-separated glob patterns (e.g., "test/* demo/*") notify_incidents: Whether to notify about incidents (default: True) notify_deployments: Whether to notify about deployments (default: False) slack_channel: Slack channel for notifications (optional) """ return await create_application_category_impl( # type: ignore[no-any-return] project_id, name, custom_patterns, notify_incidents, notify_deployments, slack_channel, )
• src/mcp_coroot/server.py:787-829 (helper)

  Supporting implementation function that constructs the category configuration dictionary (with patterns, notifications) and calls the CorootClient method.
  async def create_application_category_impl( project_id: str, name: str, custom_patterns: str, notify_incidents: bool = True, notify_deployments: bool = False, slack_channel: str | None = None, ) -> dict[str, Any]: """Create a new application category.""" category: dict[str, Any] = { "name": name, "builtin": False, "default": False, "builtin_patterns": "", "custom_patterns": custom_patterns, "notification_settings": { "incidents": { "enabled": notify_incidents, }, "deployments": { "enabled": notify_deployments, }, }, } # Add Slack channel if specified if slack_channel: notifications = category["notification_settings"] notifications["incidents"]["slack"] = { "enabled": True, "channel": slack_channel, } notifications["deployments"]["slack"] = { "enabled": notify_deployments, "channel": slack_channel, } await get_client().create_application_category(project_id, category) return { "success": True, "message": f"Application category '{name}' created successfully", }
• src/mcp_coroot/client.py:732-747 (helper)

  CorootClient HTTP client method that sends the POST request to Coroot API endpoint /api/project/{project_id}/application_categories to create the application category.
  async def create_application_category( self, project_id: str, category: dict[str, Any] ) -> dict[str, Any]: """Create a new application category. Args: project_id: Project ID. category: Category object with name and patterns. Returns: Created category. """ response = await self._request( "POST", f"/api/project/{project_id}/application_categories", json=category ) return self._parse_json_response(response)
• src/mcp_coroot/server.py:831-831 (registration)

  FastMCP tool registration decorator @mcp.tool() that registers the create_application_category function as an MCP tool.
  @mcp.tool()