# Generated by build_definitions.py; don't edit by hand. # Credentials arrive per call from the Vault Service. Store them per project. server_id: sa-aws-cloud name: Solution Architecture AWS description: AWS documentation and read-only estate tools for the Solution Architecture agent, through the customer's read-only role. version: 0.1.0 port: 8117 verify_tool: aws_check_connection shared_code: - ../../../mcp-servers/_common/tool_support.py - ../../../mcp-servers/_common/aws_support.py - ../../../mcp-servers/_common/knowledge_support.py - _support/docs_log.py - _support/docs_support.py - _support/aws_tools.py extra_requirements: - boto3==1.43.122 connection_fields: - name: access_key_id title: Access key id description: The broker identity that assumes the role. required: true secret: true - name: secret_access_key title: Secret access key description: Its secret key. required: true secret: true - name: role_arn title: Role ARN description: The read-only role. required: true secret: false - name: external_id title: External id description: The role's external id. required: false secret: true - name: regions title: Regions description: Comma-separated; the first is the default. required: true secret: false - name: account_ids title: Account ids description: Optional member accounts. required: false secret: false - name: member_role_name title: Member role name description: The role's name in member accounts. required: false secret: false - name: docs_access_key_id title: Documentation access key id description: Identity for the AWS documentation server. Defaults to the broker identity. required: false secret: true - name: docs_secret_access_key title: Documentation secret key description: Its secret key. required: false secret: true tools: - name: aws_check_connection display_name: Aws check connection description: 'Test the stored connection: assume the role and read its identity. Returns no customer data.' parameters: [] ai_implementation: "async def aws_check_connection(arguments: Dict[str, Any]) -> Dict[str, Any]:\n try:\n await\ \ _aws_call(arguments, \"sts\", \"get_caller_identity\")\n except Exception as error:\n return {\"ok\": False,\ \ \"message\": _upstream_failed(\"aws\", error)[\"error\"][\"message\"]}\n return {\"ok\": True, \"message\": \"Assumed\ \ the role.\"}\n" - name: aws_search_documents display_name: Aws search documents description: Search AWS documentation in free text. Queries are sent as written and logged. parameters: - name: query type: string description: What to look up. Keep client detail out. required: true ai_implementation: "async def aws_search_documents(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _docs_search(\"\ aws\", \"aws_search_documents\", arguments, _aws_docs_connection())\n" - name: aws_get_documents display_name: Aws get documents description: Read one AWS documentation page by URL. parameters: - name: url type: string description: A docs.aws.amazon.com URL. required: true ai_implementation: "async def aws_get_documents(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _docs_read(\"\ aws\", \"aws_get_documents\", arguments, _aws_docs_connection(), \"aws___read_documentation\", \"url\", _aws_docs_request)\n" - name: aws_search_projects display_name: Aws search projects description: List the organisation's accounts. parameters: - &id001 name: account_id type: string description: A member account of the connection. required: false - &id002 name: region type: string description: One of the connection's regions; the first by default. required: false - &id003 name: page_size type: integer description: Items per page, up to 200. Default 50. required: false - &id004 name: page_token type: string description: next_page_token from the previous reply. required: false ai_implementation: "async def aws_search_projects(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_search_projects\", arguments, ('organizations', 'list_accounts', 'Accounts', 'NextToken', 'NextToken', {}))\n" - name: aws_list_assets display_name: Aws list assets description: List tagged resources. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_assets(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_assets\", arguments, ('resourcegroupstaggingapi', 'get_resources', 'ResourceTagMappingList', 'PaginationToken',\ \ 'PaginationToken', {}))\n" - name: aws_list_instances display_name: Aws list instances description: List EC2 instances. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_instances(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_instances\", arguments, ('ec2', 'describe_instances', 'Reservations', 'NextToken', 'NextToken', {}))\n" - name: aws_list_instance_group_managers display_name: Aws list instance group managers description: List Auto Scaling groups. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_instance_group_managers(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return\ \ await _aws_list(\"aws_list_instance_group_managers\", arguments, ('autoscaling', 'describe_auto_scaling_groups', 'AutoScalingGroups',\ \ 'NextToken', 'NextToken', {}))\n" - name: aws_list_instance_templates display_name: Aws list instance templates description: List launch templates. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_instance_templates(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await\ \ _aws_list(\"aws_list_instance_templates\", arguments, ('ec2', 'describe_launch_templates', 'LaunchTemplates', 'NextToken',\ \ 'NextToken', {}))\n" - name: aws_list_disks display_name: Aws list disks description: List EBS volumes. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_disks(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_disks\", arguments, ('ec2', 'describe_volumes', 'Volumes', 'NextToken', 'NextToken', {}))\n" - name: aws_list_reservations display_name: Aws list reservations description: List capacity reservations. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_reservations(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_reservations\", arguments, ('ec2', 'describe_capacity_reservations', 'CapacityReservations', 'NextToken', 'NextToken',\ \ {}))\n" - name: aws_list_commitments display_name: Aws list commitments description: List Savings Plans. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_commitments(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_commitments\", arguments, ('savingsplans', 'describe_savings_plans', 'savingsPlans', 'nextToken', 'nextToken',\ \ {}))\n" - name: aws_list_clusters display_name: Aws list clusters description: List EKS clusters. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_clusters(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_clusters\", arguments, ('eks', 'list_clusters', 'clusters', 'nextToken', 'nextToken', {}))\n" - name: aws_list_services display_name: Aws list services description: List App Runner services. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_services(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_services\", arguments, ('apprunner', 'list_services', 'ServiceSummaryList', 'NextToken', 'NextToken', {}))\n" - name: aws_list_functions display_name: Aws list functions description: List Lambda functions. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_functions(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_functions\", arguments, ('lambda', 'list_functions', 'Functions', 'Marker', 'NextMarker', {}))\n" - name: aws_list_sql_instances display_name: Aws list sql instances description: List RDS instances. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_sql_instances(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_sql_instances\", arguments, ('rds', 'describe_db_instances', 'DBInstances', 'Marker', 'Marker', {}))\n" - name: aws_list_buckets display_name: Aws list buckets description: List S3 buckets. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_buckets(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_buckets\", arguments, ('s3', 'list_buckets', 'Buckets', 'ContinuationToken', 'ContinuationToken', {}))\n" - name: aws_list_topics display_name: Aws list topics description: List SNS topics. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_topics(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_topics\", arguments, ('sns', 'list_topics', 'Topics', 'NextToken', 'NextToken', {}))\n" - name: aws_list_subscriptions display_name: Aws list subscriptions description: List SNS subscriptions. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_subscriptions(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_subscriptions\", arguments, ('sns', 'list_subscriptions', 'Subscriptions', 'NextToken', 'NextToken', {}))\n" - name: aws_list_roles display_name: Aws list roles description: List IAM roles. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_roles(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_roles\", arguments, ('iam', 'list_roles', 'Roles', 'Marker', 'Marker', {}))\n" - name: aws_list_deny_policies display_name: Aws list deny policies description: List service control policies. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_deny_policies(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_deny_policies\", arguments, ('organizations', 'list_policies', 'Policies', 'NextToken', 'NextToken', {'Filter':\ \ 'SERVICE_CONTROL_POLICY'}))\n" - name: aws_list_alert_policies display_name: Aws list alert policies description: List CloudWatch metric alarms. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_alert_policies(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_alert_policies\", arguments, ('cloudwatch', 'describe_alarms', 'MetricAlarms', 'NextToken', 'NextToken', {}))\n" - name: aws_list_dashboards display_name: Aws list dashboards description: List CloudWatch dashboards. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_dashboards(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_dashboards\", arguments, ('cloudwatch', 'list_dashboards', 'DashboardEntries', 'NextToken', 'NextToken', {}))\n" - name: aws_list_metric_descriptors display_name: Aws list metric descriptors description: List CloudWatch metrics. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_metric_descriptors(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await\ \ _aws_list(\"aws_list_metric_descriptors\", arguments, ('cloudwatch', 'list_metrics', 'Metrics', 'NextToken', 'NextToken',\ \ {}))\n" - name: aws_list_connectivity_tests display_name: Aws list connectivity tests description: List Reachability Analyzer paths. parameters: - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_connectivity_tests(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await\ \ _aws_list(\"aws_list_connectivity_tests\", arguments, ('ec2', 'describe_network_insights_paths', 'NetworkInsightsPaths',\ \ 'NextToken', 'NextToken', {}))\n" - name: aws_list_node_pools display_name: Aws list node pools description: List one EKS cluster's node groups. parameters: - name: cluster type: string description: The cluster's name. required: true - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_node_pools(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_list(\"\ aws_list_node_pools\", arguments, (\"eks\", \"list_nodegroups\", \"nodegroups\", \"nextToken\", \"nextToken\", {}), [(\"\ clusterName\", \"cluster\")])\n" - name: aws_list_instance_attached_disks display_name: Aws list instance attached disks description: List the EBS volumes attached to one instance. parameters: - name: instance_id type: string description: The instance id. required: true - *id001 - *id002 - *id003 - *id004 ai_implementation: "async def aws_list_instance_attached_disks(arguments: Dict[str, Any]) -> Dict[str, Any]:\n instance\ \ = arguments.get(\"instance_id\")\n if not instance:\n return _refuse(\"invalid_argument\", \"instance_id is\ \ required\")\n return await _aws_list(\"aws_list_instance_attached_disks\", arguments, (\"ec2\", \"describe_volumes\"\ , \"Volumes\", \"NextToken\", \"NextToken\", {\"Filters\": [{\"Name\": \"attachment.instance-id\", \"Values\": [str(instance)]}]}))\n" - name: aws_get_instance_basic_info display_name: Aws get instance basic info description: Read one EC2 instance. parameters: - name: instance_id type: string description: The instance id. required: true - *id001 - *id002 ai_implementation: "async def aws_get_instance_basic_info(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await\ \ _aws_get(\"aws_get_instance_basic_info\", arguments, \"ec2\", \"describe_instances\", {\"InstanceIds\": [arguments.get(\"\ instance_id\")]})\n" - name: aws_get_instance_group_manager_basic_info display_name: Aws get instance group manager basic info description: Read one Auto Scaling group. parameters: - name: name type: string description: The group's name. required: true - *id001 - *id002 ai_implementation: "async def aws_get_instance_group_manager_basic_info(arguments: Dict[str, Any]) -> Dict[str, Any]:\n\ \ return await _aws_get(\"aws_get_instance_group_manager_basic_info\", arguments, \"autoscaling\", \"describe_auto_scaling_groups\"\ , {\"AutoScalingGroupNames\": [arguments.get(\"name\")]})\n" - name: aws_get_instance_template_properties display_name: Aws get instance template properties description: Read a launch template's versions. parameters: - name: template_id type: string description: The template id. required: true - *id001 - *id002 ai_implementation: "async def aws_get_instance_template_properties(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return\ \ await _aws_get(\"aws_get_instance_template_properties\", arguments, \"ec2\", \"describe_launch_template_versions\",\ \ {\"LaunchTemplateId\": arguments.get(\"template_id\")})\n" - name: aws_get_disk_basic_info display_name: Aws get disk basic info description: Read one EBS volume. parameters: - name: volume_id type: string description: The volume id. required: true - *id001 - *id002 ai_implementation: "async def aws_get_disk_basic_info(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_get(\"\ aws_get_disk_basic_info\", arguments, \"ec2\", \"describe_volumes\", {\"VolumeIds\": [arguments.get(\"volume_id\")]})\n" - name: aws_get_cluster display_name: Aws get cluster description: Read one EKS cluster. parameters: - name: name type: string description: The cluster's name. required: true - *id001 - *id002 ai_implementation: "async def aws_get_cluster(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_get(\"\ aws_get_cluster\", arguments, \"eks\", \"describe_cluster\", {\"name\": arguments.get(\"name\")})\n" - name: aws_get_node_pool display_name: Aws get node pool description: Read one EKS node group. parameters: - name: cluster type: string description: The cluster's name. required: true - name: name type: string description: The node group's name. required: true - *id001 - *id002 ai_implementation: "async def aws_get_node_pool(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_get(\"\ aws_get_node_pool\", arguments, \"eks\", \"describe_nodegroup\", {\"clusterName\": arguments.get(\"cluster\"), \"nodegroupName\"\ : arguments.get(\"name\")})\n" - name: aws_get_k8s_version display_name: Aws get k8s version description: Read EKS's supported Kubernetes versions. parameters: - *id001 - *id002 ai_implementation: "async def aws_get_k8s_version(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_get(\"\ aws_get_k8s_version\", arguments, \"eks\", \"describe_cluster_versions\", {})\n" - name: aws_get_service display_name: Aws get service description: Read one App Runner service. parameters: - name: arn type: string description: The service's ARN. required: true - *id001 - *id002 ai_implementation: "async def aws_get_service(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_get(\"\ aws_get_service\", arguments, \"apprunner\", \"describe_service\", {\"ServiceArn\": arguments.get(\"arn\")})\n" - name: aws_get_function display_name: Aws get function description: Read one Lambda function's configuration. parameters: - name: name type: string description: The function's name. required: true - *id001 - *id002 ai_implementation: "async def aws_get_function(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_get(\"\ aws_get_function\", arguments, \"lambda\", \"get_function_configuration\", {\"FunctionName\": arguments.get(\"name\")})\n" - name: aws_get_sql_instance display_name: Aws get sql instance description: Read one RDS instance. parameters: - name: name type: string description: The instance's identifier. required: true - *id001 - *id002 ai_implementation: "async def aws_get_sql_instance(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_get(\"\ aws_get_sql_instance\", arguments, \"rds\", \"describe_db_instances\", {\"DBInstanceIdentifier\": arguments.get(\"name\"\ )})\n" - name: aws_get_topic display_name: Aws get topic description: Read one SNS topic. parameters: - name: arn type: string description: The topic's ARN. required: true - *id001 - *id002 ai_implementation: "async def aws_get_topic(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_get(\"\ aws_get_topic\", arguments, \"sns\", \"get_topic_attributes\", {\"TopicArn\": arguments.get(\"arn\")})\n" - name: aws_get_subscription display_name: Aws get subscription description: Read one SNS subscription. parameters: - name: arn type: string description: The subscription's ARN. required: true - *id001 - *id002 ai_implementation: "async def aws_get_subscription(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_get(\"\ aws_get_subscription\", arguments, \"sns\", \"get_subscription_attributes\", {\"SubscriptionArn\": arguments.get(\"arn\"\ )})\n" - name: aws_get_role display_name: Aws get role description: Read one IAM role. parameters: - name: name type: string description: The role's name. required: true - *id001 - *id002 ai_implementation: "async def aws_get_role(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_get(\"aws_get_role\"\ , arguments, \"iam\", \"get_role\", {\"RoleName\": arguments.get(\"name\")})\n" - name: aws_get_deny_policy display_name: Aws get deny policy description: Read one service control policy. parameters: - name: policy_id type: string description: The policy id. required: true - *id001 - *id002 ai_implementation: "async def aws_get_deny_policy(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_get(\"\ aws_get_deny_policy\", arguments, \"organizations\", \"describe_policy\", {\"PolicyId\": arguments.get(\"policy_id\")})\n" - name: aws_get_alert_policy display_name: Aws get alert policy description: Read named CloudWatch alarms. parameters: - name: name type: string description: The alarm's name. required: true - *id001 - *id002 ai_implementation: "async def aws_get_alert_policy(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_get(\"\ aws_get_alert_policy\", arguments, \"cloudwatch\", \"describe_alarms\", {\"AlarmNames\": [arguments.get(\"name\")]})\n" - name: aws_get_connectivity_test display_name: Aws get connectivity test description: Read one Reachability Analyzer path. parameters: - name: path_id type: string description: The path id. required: true - *id001 - *id002 ai_implementation: "async def aws_get_connectivity_test(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await\ \ _aws_get(\"aws_get_connectivity_test\", arguments, \"ec2\", \"describe_network_insights_paths\", {\"NetworkInsightsPathIds\"\ : [arguments.get(\"path_id\")]})\n" - name: aws_analyze_access display_name: Aws analyze access description: Read the account's IAM users, groups, roles and policies. parameters: - *id001 - *id002 ai_implementation: "async def aws_analyze_access(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_get(\"\ aws_analyze_access\", arguments, \"iam\", \"get_account_authorization_details\", {})\n" - name: aws_list_timeseries display_name: Aws list timeseries description: Read CloudWatch metric values. parameters: - name: metric_queries type: array description: CloudWatch MetricDataQueries. required: true - name: start_time type: string description: ISO 8601 start. required: true - name: end_time type: string description: ISO 8601 end. required: true - *id001 - *id002 ai_implementation: "async def aws_list_timeseries(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _aws_metric_data(\"\ aws_list_timeseries\", arguments)\n"