Files
cp1-agents/outcome-pattern/solution_architecture/mcp-servers/sa-aws-cloud.server.yaml
Jonathan Boniface bc84ee4df6
Some checks failed
check agents / check (push) Failing after 13s
Solution architecture outcome pattern: agent and its MCP servers
The cp1-solution-architecture-agent and the sa-aws/azure/gcp-cloud MCP servers, a separate
stream from the individual and sub-agent patterns.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-05 22:13:25 +00:00

587 lines
23 KiB
YAML

# 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"