feat: [fme-8233]: Added List CCM Recomendations, List CCM Recommendations by resource type and Get CCM Recommendations Stats (#81)

* [fme-8233] Applying review changes

* [fme-8233] - Merge with master

* [fme-8233] Improving description

* [fme-8233] Added List CCM Recomendations, List CCM Recommendations by resource type and Get CCM Recommendations Stats

* [fme-7210] Fixing type issues and removing unused data in ccm recommendations list

* Merge branch 'fme-7210_ccm_create_persp_flow_mer' into fme-8233_ccm_recomm_list

* [fme-7210] Fixing several minor issues suggested by AI

* [fme-7210] Using standard view rules format

* [fme-8233] Added recommendations list

* [fme-7210] Removed commented code

* [fme-7210] Fixing filter constant

* [fme-7210] Removed default values used for testing

* fme-7210] Merge with master

* [fme-7210] - Merge with master

* [fme-7210] - Removing debug logs

* [fme-7210] - Fixing issues in Perspective Rules adapter

* [fme-7210] Fixing issue in CCM Graphql Filter values filter

* [fme-7210] Adding filter by values graphql functions and functions to improve create perspective flow

Author: javrudsky

README.md

@@ -99,7 +99,7 @@ Toolset Name: `dashboards`
 
 #### Cloud Cost Management Toolset
 
-Toolset Name: `cloudcostmanagement`
+Toolset Name: `ccm`
 
 - `get_ccm_overview`: Retrieves the cost overview for a specific account.
 - `list_ccm_cost_categories`: List all cost categories names for a specified account.
@@ -115,8 +115,11 @@ Toolset Name: `cloudcostmanagement`
 - `ccm_perspective_summary_with_budget`: Query a summary of cost perspectives with budget information in Harness Cloud Cost Management, including detailed cost and budget data grouped by time.
 - `ccm_perspective_budget`: Query the budget information for a perspective in Harness Cloud Cost Management.
 - `get_ccm_metadata`: Retrieves metadata about available cloud connectors, cost data sources, default perspectives, and currency preferences in Harness Cloud Cost Management.
-- `ccm_perspective_recommendations`: PerspectiveRecommendations: Returns monthly cost, savings, and a list of open recommendations for a perspective in Harness Cloud Cost Management.
+- `ccm_perspective_recommendations`: Returns monthly cost, savings, and a list of open recommendations for a perspective in Harness Cloud Cost Management.
 - `ccm_perspective_filter_values`: Returns available filter values for a cost perspective, enabling dynamic discovery of valid options for advanced queries in Harness Cloud Cost Management.
+- `list_ccm_recommendations`: Returns a filterable list of cost-optimization recommendations in Harness Cloud Cost Management.
+- `list_ccm_recommendations_by_resource_type`: Returns a aggregated statistics of cloud cost optimization recommendations grouped by resource type within a given account in Harness Cloud Cost Management.
+- `get_ccm_recommendations_stats`: Returns overall statistics for cloud cost optimization recommendations within a given account in Harness Cloud Cost Management.
 - `get_ccm_commitment_coverage`: Get commitment coverage information for an account in Harness Cloud Cost Management
 - `get_ccm_commitment_savings`: Get commitment savings information for an account in Harness Cloud Cost Management
 

client/ccmrecommendations.go

@@ -0,0 +1,50 @@
+package client
+
+import (
+	"context"
+	"fmt"
+	"github.com/harness/harness-mcp/client/dto"
+)
+const (
+	ccmRecommendationsListPath = ccmBasePath + "/recommendation/overview/list?accountIdentifier=%s"
+	ccmRecommendationsByResourceTypeListPath = ccmBasePath + "/recommendation/overview/resource-type/stats?accountIdentifier=%s"
+	ccmRecommendationsStatsPath = ccmBasePath + "/recommendation/overview/stats?accountIdentifier=%s"
+)
+
+
+func (r *CloudCostManagementService) ListRecommendations(ctx context.Context, scope dto.Scope, accountId string, options map[string]any) (*map[string]any, error) {
+
+	return r.getRecommendations(ctx, scope, accountId, options, ccmRecommendationsListPath)
+}
+
+func (r *CloudCostManagementService) ListRecommendationsByResourceType(ctx context.Context, scope dto.Scope, accountId string, options map[string]any) (*map[string]any, error) {
+
+	return r.getRecommendations(ctx, scope, accountId, options, ccmRecommendationsByResourceTypeListPath)
+}
+
+func (r *CloudCostManagementService) GetRecommendationsStats(ctx context.Context, scope dto.Scope, accountId string, options map[string]any) (*map[string]any, error) {
+
+	return r.getRecommendations(ctx, scope, accountId, options, ccmRecommendationsStatsPath)
+}
+
+func (r *CloudCostManagementService) getRecommendations(
+	ctx context.Context, 
+	scope dto.Scope, 
+	accountId string, 
+	options map[string]any,
+	url string,
+) (*map[string]any, error) {
+
+	path := fmt.Sprintf(url, accountId)
+	params := make(map[string]string)
+	addScope(scope, params)
+
+	items := new(map[string]any)
+
+	err := r.Client.Post(ctx, path, params, options, &items)
+	if err != nil {
+		return nil, fmt.Errorf("Failed to list cloud cost management recommendations: %w", err)
+	}
+
+	return items, nil
+}

client/dto/ccmcosts.go

@@ -25,6 +25,7 @@ const (
 type CCMBaseResponse struct {
 	Status        string     `json:"state,omitempty"`
 	Message       string     `json:"message,omitempty"`
+	MetaData      map[string]any `json:"metaData,omitempty"`
 	CorrelationID string     `json:"correlation_id,omitempty"`
 	Error         []CCMError `json:"error,omitempty"`
 }

pkg/ccmcommons/ccmconstants.go

@@ -227,3 +227,16 @@ var ConditionFieldDescriptions = []map[string]string{
 		"description": "Use this field to create a view filter rule to filter by Labels", 
 	},
 }
+
+var ListRecommendationsDescription = `
+Lists recommendation items with metadata such as resource identifiers, potential savings, current vs. recommended size, severity/status, and recommendation type.
+Supports rich filtering (for example by cloud account, Kubernetes attributes, resource type) so teams only fetch what’s relevant to them or their Perspective/RBAC scope in Harness Cloud Cost Management.
+`
+
+var ListRecommendationsByResourceTypeDescription = `
+Retrieves aggregated statistics of cloud cost optimization recommendations grouped by resource type within a given account. This includes counts and potential savings information for each resource type, helping to understand which resource categories offer the most cost optimization opportunities. Ideal for monitoring and prioritizing cloud resource cost-saving actions.
+`
+
+var GetRecommendationsStatsDescription = `
+Retrieves overall statistics for cloud cost optimization recommendations within a given account. The response provides aggregated metrics such as the total number of recommendations, total estimated cost savings, and the count of open and applied recommendations. This helps track the overall state and impact of cost optimization efforts across all resources.
+`

pkg/ccmcommons/ccmhelpers.go

@@ -65,7 +65,6 @@ func GetSupportedOperators() []string {
 	}
 }
 
-
 // AdaptViewRulesMap converts an array of rule maps (each with conditions) to []*CCMViewRule.
 // Uses OutputFields and OutputKeyValueFields for field metadata.
 func AdaptViewRulesMap(input []any) ([]dto.CCMViewRule, error) {

pkg/harness/tools.go

@@ -584,6 +584,9 @@ func RegisterCloudCostManagement(config *config.Config, tsg *toolsets.ToolsetGro
 			toolsets.NewServerTool(tools.CcmMetadataTool(config, ccmClient)),
 			toolsets.NewServerTool(tools.CcmPerspectiveRecommendationsTool(config, ccmClient)),
 			toolsets.NewServerTool(tools.CcmPerspectiveFilterValuesTool(config, ccmClient)),
+			toolsets.NewServerTool(tools.ListCcmRecommendationsTool(config, ccmClient)),
+			toolsets.NewServerTool(tools.ListCcmRecommendationsByResourceTypeTool(config, ccmClient)),
+			toolsets.NewServerTool(tools.GetCcmRecommendationsStatsTool(config, ccmClient)),
 			toolsets.NewServerTool(tools.FetchCommitmentCoverageTool(config, ccmClient)),
 			toolsets.NewServerTool(tools.FetchCommitmentSavingsTool(config, ccmClient)),
 		)