awslabs.eks-mcp-server 0.1.2__py3-none-any.whl → 0.1.4__py3-none-any.whl

awslabs/eks_mcp_server/data/eks_cloudwatch_metrics_guidance.json

@@ -0,0 +1,287 @@
+{
+  "cluster": {
+    "metrics": [
+      {
+        "description": "The number of failed worker nodes in the cluster. A node is considered failed if it is suffering from any node conditions. For more information, see Conditions in the Kubernetes documentation.",
+        "dimensions": [
+          "ClusterName"
+        ],
+        "name": "cluster_failed_node_count"
+      },
+      {
+        "description": "The total number of worker nodes in the cluster.",
+        "dimensions": [
+          "ClusterName"
+        ],
+        "name": "cluster_node_count"
+      }
+    ]
+  },
+  "namespace": {
+    "metrics": [
+      {
+        "description": "The number of pods running per namespace in the resource that is specified by the dimensions that you're using.",
+        "dimensions": [
+          "Namespace,ClusterName",
+          "ClusterName"
+        ],
+        "name": "namespace_number_of_running_pods"
+      }
+    ]
+  },
+  "node": {
+    "metrics": [
+      {
+        "description": "The maximum number of CPU units that can be assigned to a single node in this cluster.",
+        "dimensions": [
+          "ClusterName"
+        ],
+        "name": "node_cpu_limit"
+      },
+      {
+        "description": "The percentage of CPU units that are reserved for node components, such as kubelet, kube-proxy, and Docker.",
+        "dimensions": [
+          "NodeName,ClusterName,InstanceId",
+          "ClusterName"
+        ],
+        "name": "node_cpu_reserved_capacity"
+      },
+      {
+        "description": "The number of CPU units being used on the nodes in the cluster.",
+        "dimensions": [
+          "ClusterName"
+        ],
+        "name": "node_cpu_usage_total"
+      },
+      {
+        "description": "The total percentage of CPU units being used on the nodes in the cluster.",
+        "dimensions": [
+          "NodeName,ClusterName,InstanceId",
+          "ClusterName"
+        ],
+        "name": "node_cpu_utilization"
+      },
+      {
+        "description": "The total number of GPU(s) available on the node.",
+        "dimensions": [
+          "ClusterName",
+          "ClusterName,InstanceId,NodeName"
+        ],
+        "name": "node_gpu_limit"
+      },
+      {
+        "description": "The number of GPU(s) being used by the running pods on the node.",
+        "dimensions": [
+          "ClusterName",
+          "ClusterName,InstanceId,NodeName"
+        ],
+        "name": "node_gpu_usage_total"
+      },
+      {
+        "description": "The percentage of GPU currently being reserved on the node. The formula is, node_gpu_request / node_gpu_limit.",
+        "dimensions": [
+          "ClusterName",
+          "ClusterName,InstanceId,NodeName"
+        ],
+        "name": "node_gpu_reserved_capacity"
+      },
+      {
+        "description": "The total percentage of file system capacity being used on nodes in the cluster.",
+        "dimensions": [
+          "NodeName,ClusterName,InstanceId",
+          "ClusterName"
+        ],
+        "name": "node_filesystem_utilization"
+      },
+      {
+        "description": "The maximum amount of memory, in bytes, that can be assigned to a single node in this cluster.",
+        "dimensions": [
+          "ClusterName"
+        ],
+        "name": "node_memory_limit"
+      },
+      {
+        "description": "The percentage of memory currently being used on the nodes in the cluster.",
+        "dimensions": [
+          "NodeName,ClusterName,InstanceId",
+          "ClusterName"
+        ],
+        "name": "node_memory_reserved_capacity"
+      },
+      {
+        "description": "The percentage of memory currently being used by the node or nodes. It is the percentage of node memory usage divided by the node memory limitation.",
+        "dimensions": [
+          "NodeName,ClusterName,InstanceId",
+          "ClusterName"
+        ],
+        "name": "node_memory_utilization"
+      },
+      {
+        "description": "The amount of memory, in bytes, being used in the working set of the nodes in the cluster.",
+        "dimensions": [
+          "ClusterName"
+        ],
+        "name": "node_memory_working_set"
+      },
+      {
+        "description": "The total number of bytes per second transmitted and received over the network per node in a cluster.",
+        "dimensions": [
+          "NodeName,ClusterName,InstanceId",
+          "ClusterName"
+        ],
+        "name": "node_network_total_bytes"
+      },
+      {
+        "description": "The number of running containers per node in a cluster.",
+        "dimensions": [
+          "NodeName,ClusterName,InstanceId",
+          "ClusterName"
+        ],
+        "name": "node_number_of_running_containers"
+      },
+      {
+        "description": "The number of running pods per node in a cluster.",
+        "dimensions": [
+          "NodeName,ClusterName,InstanceId",
+          "ClusterName"
+        ],
+        "name": "node_number_of_running_pods"
+      }
+    ]
+  },
+  "pod": {
+    "metrics": [
+      {
+        "description": "The CPU capacity that is reserved per pod in a cluster.",
+        "dimensions": [
+          "PodName,Namespace,ClusterName",
+          "ClusterName"
+        ],
+        "name": "pod_cpu_reserved_capacity"
+      },
+      {
+        "description": "The percentage of CPU units being used by pods.",
+        "dimensions": [
+          "PodName,Namespace,ClusterName",
+          "Namespace,ClusterName",
+          "Service,Namespace,ClusterName",
+          "ClusterName"
+        ],
+        "name": "pod_cpu_utilization"
+      },
+      {
+        "description": "The percentage of CPU units being used by pods relative to the pod limit.",
+        "dimensions": [
+          "PodName,Namespace,ClusterName",
+          "Namespace,ClusterName",
+          "Service,Namespace,ClusterName",
+          "ClusterName"
+        ],
+        "name": "pod_cpu_utilization_over_pod_limit"
+      },
+      {
+        "description": "The GPU requests for the pod. This value must always be equal to pod_gpu_limit.",
+        "dimensions": [
+          "ClusterName",
+          "ClusterName,Namespace,PodName",
+          "ClusterName,FullPodName,Namespace,PodName"
+        ],
+        "name": "pod_gpu_request"
+      },
+      {
+        "description": "The maximum number of GPU(s) that can be assigned to the pod in a node.",
+        "dimensions": [
+          "ClusterName",
+          "ClusterName,Namespace,PodName",
+          "ClusterName,FullPodName,Namespace,PodName"
+        ],
+        "name": "pod_gpu_limit"
+      },
+      {
+        "description": "The number of GPU(s) being allocated on the pod.",
+        "dimensions": [
+          "ClusterName",
+          "ClusterName,Namespace,PodName",
+          "ClusterName,FullPodName,Namespace,PodName"
+        ],
+        "name": "pod_gpu_usage_total"
+      },
+      {
+        "description": "The percentage of GPU currently being reserved for the pod. The formula is - pod_gpu_request / node_gpu_reserved_capacity.",
+        "dimensions": [
+          "ClusterName",
+          "ClusterName,Namespace,PodName",
+          "ClusterName,FullPodName,Namespace,PodName"
+        ],
+        "name": "pod_gpu_reserved_capacity"
+      },
+      {
+        "description": "The percentage of memory that is reserved for pods.",
+        "dimensions": [
+          "PodName,Namespace,ClusterName",
+          "ClusterName"
+        ],
+        "name": "pod_memory_reserved_capacity"
+      },
+      {
+        "description": "The percentage of memory currently being used by the pod or pods.",
+        "dimensions": [
+          "PodName,Namespace,ClusterName",
+          "Namespace,ClusterName",
+          "Service,Namespace,ClusterName",
+          "ClusterName"
+        ],
+        "name": "pod_memory_utilization"
+      },
+      {
+        "description": "The percentage of memory that is being used by pods relative to the pod limit. If any containers in the pod don't have a memory limit defined, this metric doesn't appear.",
+        "dimensions": [
+          "PodName,Namespace,ClusterName",
+          "Namespace,ClusterName",
+          "Service,Namespace,ClusterName",
+          "ClusterName"
+        ],
+        "name": "pod_memory_utilization_over_pod_limit"
+      },
+      {
+        "description": "The number of bytes per second being received over the network by the pod.",
+        "dimensions": [
+          "PodName,Namespace,ClusterName",
+          "Namespace,ClusterName",
+          "Service,Namespace,ClusterName",
+          "ClusterName"
+        ],
+        "name": "pod_network_rx_bytes"
+      },
+      {
+        "description": "The number of bytes per second being transmitted over the network by the pod.",
+        "dimensions": [
+          "PodName,Namespace,ClusterName",
+          "Namespace,ClusterName",
+          "Service,Namespace,ClusterName",
+          "ClusterName"
+        ],
+        "name": "pod_network_tx_bytes"
+      },
+      {
+        "description": "The total number of container restarts in a pod.",
+        "dimensions": [
+          "PodName,Namespace,ClusterName"
+        ],
+        "name": "pod_number_of_container_restarts"
+      }
+    ]
+  },
+  "service": {
+    "metrics": [
+      {
+        "description": "The number of pods running the service or services in the cluster.",
+        "dimensions": [
+          "Service,Namespace,ClusterName",
+          "ClusterName"
+        ],
+        "name": "service_number_of_running_pods"
+      }
+    ]
+  }
+}

awslabs/eks_mcp_server/eks_kb_handler.py

@@ -1,15 +1,18 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 #
-# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
-# with the License. A copy of the License is located at
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
 #
-#    http://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 
-"""Knowledge Base Retrival handler for the EKS MCP Server."""
+"""Knowledge Base Retrieval handler for the EKS MCP Server."""
 
 import requests
 from loguru import logger
@@ -24,7 +27,7 @@ AWS_SERVICE = 'eks-mcpserver'
 
 
 class EKSKnowledgeBaseHandler:
-    """Handler for retriving troubleshooting guide from the EKS Knowledge Base.
+    """Handler for retrieving troubleshooting guide from the EKS Knowledge Base.
 
     This class provides tools for fetching instructions to troubleshoot issues from the EKS Hosted MCP service.
     """

awslabs/eks_mcp_server/eks_stack_handler.py

@@ -1,13 +1,16 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 #
-# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
-# with the License. A copy of the License is located at
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
 #
-#    http://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 
 """EKS stack handler for the EKS MCP Server."""
 
@@ -135,6 +138,13 @@ class EksStackHandler:
         mechanism for creating and managing EKS clusters through CloudFormation, enabling standardized
         cluster creation, configuration updates, and resource cleanup.
 
+        IMPORTANT: Use this tool instead of 'aws eks create-cluster', 'aws eks delete-cluster',
+        'eksctl create cluster', 'eksctl delete cluster', or similar CLI commands.
+
+        IMPORTANT: Use this tool's standardized templates for creating EKS clusters with proper VPC configuration,
+        networking, security groups, and EKS auto mode. DO NOT create EKS clusters by generating CloudFormation
+        templates from scratch.
+
         ## Requirements
         - The server must be run with the `--allow-write` flag for generate, deploy, and delete operations
         - For deploy and delete operations, the stack must have been created by this tool
@@ -319,7 +329,7 @@ class EksStackHandler:
         - Security groups for cluster communication
         - IAM roles for the EKS cluster and worker nodes
         - An EKS cluster in Auto Mode with:
-          - Compute configuration with general-purpose and system node pools
+          - Compute configuration for automatic node management
           - Kubernetes network configuration with elastic load balancing
           - Block storage configuration
           - API authentication mode

awslabs/eks_mcp_server/iam_handler.py

@@ -1,13 +1,16 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 #
-# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
-# with the License. A copy of the License is located at
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
 #
-#    http://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 
 """IAM handler for the EKS MCP Server."""
 
@@ -63,6 +66,9 @@ class IAMHandler:
         permissions, identify missing or excessive permissions, troubleshoot EKS cluster issues,
         and verify trust relationships for service roles.
 
+        IMPORTANT: Use this tool instead of 'aws iam get-role', 'aws iam list-attached-role-policies',
+        'aws iam list-role-policies', and 'aws iam get-role-policy' commands.
+
         ## Requirements
         - The role must exist in your AWS account
         - Valid AWS credentials with permissions to read IAM role information
@@ -156,6 +162,8 @@ class IAMHandler:
         for granting EKS clusters access to AWS services, enabling worker nodes to access resources, and
         configuring permissions for CloudWatch logging and ECR access.
 
+        IMPORTANT: Use this tool instead of 'aws iam put-role-policy' commands.
+
         ## Requirements
         - The server must be run with the `--allow-write` flag
         - The role must exist in your AWS account

awslabs/eks_mcp_server/k8s_apis.py

@@ -1,19 +1,23 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 #
-# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
-# with the License. A copy of the License is located at
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
 #
-#    http://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 
 """Kubernetes API client for the EKS MCP Server."""
 
 import base64
 import os
 import tempfile
+from awslabs.eks_mcp_server import __version__
 from awslabs.eks_mcp_server.models import Operation
 from loguru import logger
 from typing import Any, Dict, List, Optional
@@ -72,6 +76,9 @@ class K8sApis:
             # Create base API client
             self.api_client = client.ApiClient(configuration)
 
+            # Set user-agent directly on the ApiClient
+            self.api_client.user_agent = f'awslabs/mcp/eks-mcp-server/{__version__}'
+
             # Create dynamic client
             self.dynamic_client = dynamic.DynamicClient(self.api_client)
 

awslabs/eks_mcp_server/k8s_client_cache.py

@@ -1,13 +1,16 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 #
-# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
-# with the License. A copy of the License is located at
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
 #
-#    http://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 
 """Kubernetes client cache for the EKS MCP Server."""
 

awslabs/eks_mcp_server/k8s_handler.py

@@ -1,13 +1,16 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 #
-# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
-# with the License. A copy of the License is located at
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
 #
-#    http://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 
 """Kubernetes handler for the EKS MCP Server."""
 
@@ -111,6 +114,8 @@ class K8sHandler:
         and can create or update resources, useful for deploying applications, creating
         Kubernetes resources, and applying complete application stacks.
 
+        IMPORTANT: Use this tool instead of 'kubectl apply -f' commands.
+
         ## Requirements
         - The server must be run with the `--allow-write` flag
         - The YAML file must exist and be accessible to the server
@@ -334,6 +339,9 @@ class K8sHandler:
         custom resources, update specific fields, read detailed information, and delete
         resources that are no longer needed.
 
+        IMPORTANT: Use this tool instead of 'kubectl create', 'kubectl edit', 'kubectl patch',
+        'kubectl delete', or 'kubectl get' commands.
+
         ## Requirements
         - The server must be run with the `--allow-write` flag for mutating operations
         - The server must be run with the `--allow-sensitive-data-access` flag for Secret resources
@@ -534,6 +542,8 @@ class K8sHandler:
         for listing pods in a namespace, finding services with specific labels, or
         checking resources in a specific state.
 
+        IMPORTANT: Use this tool instead of 'kubectl get' commands.
+
         ## Response Information
         The response includes a summary of each resource with name, namespace, creation timestamp,
         labels, and annotations.
@@ -875,6 +885,8 @@ class K8sHandler:
         to filter by container, time range, and size. It's useful for debugging application
         issues, monitoring behavior, investigating crashes, and verifying startup configuration.
 
+        IMPORTANT: Use this tool instead of 'kubectl logs' commands.
+
         ## Requirements
         - The server must be run with the `--allow-sensitive-data-access` flag
         - The pod must exist and be accessible in the specified namespace
@@ -1000,6 +1012,8 @@ class K8sHandler:
         are useful for troubleshooting pod startup failures, investigating deployment issues,
         understanding resource modifications, and diagnosing scheduling problems.
 
+        IMPORTANT: Use this tool instead of 'kubectl describe' or 'kubectl get events' commands.
+
         ## Requirements
         - The server must be run with the `--allow-sensitive-data-access` flag
         - The resource must exist and be accessible in the specified namespace

awslabs/eks_mcp_server/logging_helper.py

@@ -1,13 +1,16 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 #
-# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
-# with the License. A copy of the License is located at
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
 #
-#    http://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 
 """Logging helper for the EKS MCP Server."""
 

awslabs/eks_mcp_server/models.py

@@ -1,13 +1,16 @@
 # Copyright Amazon.com, Inc. or its affiliates. All Rights Reserved.
 #
-# Licensed under the Apache License, Version 2.0 (the "License"). You may not use this file except in compliance
-# with the License. A copy of the License is located at
+# Licensed under the Apache License, Version 2.0 (the "License");
+# you may not use this file except in compliance with the License.
+# You may obtain a copy of the License at
 #
-#    http://www.apache.org/licenses/LICENSE-2.0
+#     http://www.apache.org/licenses/LICENSE-2.0
 #
-# or in the 'license' file accompanying this file. This file is distributed on an 'AS IS' BASIS, WITHOUT WARRANTIES
-# OR CONDITIONS OF ANY KIND, express or implied. See the License for the specific language governing permissions
-# and limitations under the License.
+# Unless required by applicable law or agreed to in writing, software
+# distributed under the License is distributed on an "AS IS" BASIS,
+# WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+# See the License for the specific language governing permissions and
+# limitations under the License.
 
 """Data models for the EKS MCP Server."""
 
@@ -150,7 +153,7 @@ class CloudWatchLogsResponse(CallToolResult):
     """
 
     resource_type: str = Field(..., description='Resource type (pod, node, container)')
-    resource_name: str = Field(..., description='Resource name')
+    resource_name: Optional[str] = Field(None, description='Resource name')
     cluster_name: str = Field(..., description='Name of the EKS cluster')
     log_type: str = Field(
         ..., description='Log type (application, host, performance, control-plane, or custom)'
@@ -178,11 +181,9 @@ class CloudWatchMetricsResponse(CallToolResult):
     """Response model for get_cloudwatch_metrics tool.
 
     This model contains the response from a CloudWatch metrics query,
-    including resource information, metric details, time range, and data points.
+    including metric details, time range, and data points.
     """
 
-    resource_type: str = Field(..., description='Resource type (pod, node, container, cluster)')
-    resource_name: str = Field(..., description='Resource name')
     cluster_name: str = Field(..., description='Name of the EKS cluster')
     metric_name: str = Field(..., description='Metric name (e.g., cpu_usage_total, memory_rss)')
     namespace: str = Field(..., description='CloudWatch namespace (e.g., ContainerInsights)')
@@ -269,3 +270,16 @@ class AddInlinePolicyResponse(CallToolResult):
     permissions_added: Union[Dict[str, Any], List[Dict[str, Any]]] = Field(
         ..., description='Permissions to include in the policy (in JSON format)'
     )
+
+
+class MetricsGuidanceResponse(CallToolResult):
+    """Response model for get_eks_metrics_guidance tool.
+
+    This model contains the response from a metrics guidance query,
+    including resource type and available metrics with their details.
+    """
+
+    resource_type: str = Field(
+        ..., description='Resource type (cluster, node, pod, namespace, service)'
+    )
+    metrics: List[Dict[str, Any]] = Field(..., description='List of metrics with their details')