MCP Server for Coroot

Instructions

Implementation Reference

• src/mcp_coroot/server.py:948-974 (handler)

  MCP tool handler and registration for 'delete_application_category'. The @mcp.tool() decorator registers the function, and it calls the CorootClient to perform the deletion.

  @handle_errors
  async def delete_application_category_impl(
      project_id: str,
      name: str,
  ) -> dict[str, Any]:
      """Delete an application category."""
      await get_client().delete_application_category(project_id, name)
      return {
          "success": True,
          "message": f"Application category '{name}' deleted successfully",
      }
  
  
  @mcp.tool()
  async def delete_application_category(
      project_id: str,
      name: str,
  ) -> dict[str, Any]:
      """Delete an application category.
  
      Removes a custom application category. Built-in categories cannot be deleted.
  
      Args:
          project_id: Project ID
          name: Category name to delete
      """
      return await delete_application_category_impl(project_id, name)  # type: ignore[no-any-return]

• src/mcp_coroot/client.py:769-791 (helper)

  CorootClient helper method that implements the actual API call to delete an application category via POST to /api/project/{project_id}/application_categories with delete action.

  async def delete_application_category(
      self, project_id: str, category_name: str
  ) -> dict[str, Any]:
      """Delete an application category.
  
      Args:
          project_id: Project ID.
          category_name: Name of the category to delete.
  
      Returns:
          Deletion result.
      """
      # For delete, we need to send a minimal valid structure with action and id
      data = {
          "action": "delete",
          "id": category_name,
          "name": category_name,  # Required for validation
          "custom_patterns": "",  # Required for validation
      }
      response = await self._request(
          "POST", f"/api/project/{project_id}/application_categories", json=data
      )
      return self._parse_json_response(response)