Some checks failed
check agents / check (push) Failing after 13s
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>
430 lines
20 KiB
YAML
430 lines
20 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-azure-cloud
|
|
name: Solution Architecture Azure
|
|
description: Azure documentation and read-only estate tools for the Solution Architecture agent, through Microsoft Learn,
|
|
Resource Graph and ARM.
|
|
version: 0.1.0
|
|
port: 8116
|
|
verify_tool: azure_check_connection
|
|
shared_code:
|
|
- ../../../mcp-servers/_common/tool_support.py
|
|
- ../../../mcp-servers/_common/azure_support.py
|
|
- ../../../mcp-servers/_common/knowledge_support.py
|
|
- _support/docs_log.py
|
|
- _support/docs_support.py
|
|
- _support/azure_tools.py
|
|
extra_requirements:
|
|
- boto3==1.43.122
|
|
connection_fields:
|
|
- name: tenant_id
|
|
title: Tenant id
|
|
description: The Entra tenant id.
|
|
required: false
|
|
secret: false
|
|
- name: client_id
|
|
title: Client id
|
|
description: The app registration's id.
|
|
required: false
|
|
secret: false
|
|
- name: client_secret
|
|
title: Client secret
|
|
description: The client secret.
|
|
required: false
|
|
secret: true
|
|
- name: scope_root
|
|
title: Scope root
|
|
description: managementGroups/<id> or subscriptions/<id>.
|
|
required: true
|
|
secret: false
|
|
- name: cloud
|
|
title: Cloud
|
|
description: public, usgov or china. Optional.
|
|
required: false
|
|
secret: false
|
|
tools:
|
|
- name: azure_check_connection
|
|
display_name: Azure check connection
|
|
description: 'Test the stored connection: sign in and read the scope root. Returns no customer data.'
|
|
parameters: []
|
|
ai_implementation: "async def azure_check_connection(arguments: Dict[str, Any]) -> Dict[str, Any]:\n try:\n await\
|
|
\ _azure_graph(\"ResourceContainers | limit 1\", 1)\n except Exception as error:\n return {\"ok\": False, \"\
|
|
message\": _upstream_failed(\"azure\", error)[\"error\"][\"message\"]}\n return {\"ok\": True, \"message\": \"Signed\
|
|
\ in and read the scope root.\"}\n"
|
|
- name: azure_search_documents
|
|
display_name: Azure search documents
|
|
description: Search Microsoft Learn 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 azure_search_documents(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _docs_search(\"\
|
|
azure\", \"azure_search_documents\", arguments, {})\n"
|
|
- name: azure_get_documents
|
|
display_name: Azure get documents
|
|
description: Fetch one Microsoft Learn page by URL.
|
|
parameters:
|
|
- name: url
|
|
type: string
|
|
description: A learn.microsoft.com URL.
|
|
required: true
|
|
ai_implementation: "async def azure_get_documents(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _docs_read(\"\
|
|
azure\", \"azure_get_documents\", arguments, {}, \"microsoft_docs_fetch\", \"url\")\n"
|
|
- name: azure_analyze_access
|
|
display_name: Azure analyze access
|
|
description: List role assignments, optionally for one principal or below one scope.
|
|
parameters:
|
|
- name: principal_id
|
|
type: string
|
|
description: An object id.
|
|
required: false
|
|
- name: scope
|
|
type: string
|
|
description: An ARM scope.
|
|
required: false
|
|
- &id001
|
|
name: page_size
|
|
type: integer
|
|
description: Items per page, up to 200. Default 50.
|
|
required: false
|
|
- &id002
|
|
name: page_token
|
|
type: string
|
|
description: next_page_token from the previous reply.
|
|
required: false
|
|
ai_implementation: "async def azure_analyze_access(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_access(\"\
|
|
azure_analyze_access\", arguments)\n"
|
|
- name: azure_list_instance_attached_disks
|
|
display_name: Azure list instance attached disks
|
|
description: List the disks attached to one virtual machine.
|
|
parameters:
|
|
- &id003
|
|
name: resource_id
|
|
type: string
|
|
description: The full ARM resource id.
|
|
required: true
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_instance_attached_disks(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return\
|
|
\ await _azure_attached_disks(\"azure_list_instance_attached_disks\", arguments)\n"
|
|
- name: azure_list_node_pools
|
|
display_name: Azure list node pools
|
|
description: List AKS node pools.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_node_pools(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_node_pools(\"\
|
|
azure_list_node_pools\", arguments)\n"
|
|
- name: azure_search_subscriptions
|
|
display_name: Azure search subscriptions
|
|
description: List subscriptions.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_search_subscriptions(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await\
|
|
\ _azure_list(\"azure_search_subscriptions\", arguments, \"ResourceContainers\", ['microsoft.resources/subscriptions'])\n"
|
|
- name: azure_list_instances
|
|
display_name: Azure list instances
|
|
description: List virtual machines.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_instances(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_list(\"\
|
|
azure_list_instances\", arguments, \"Resources\", ['microsoft.compute/virtualmachines'])\n"
|
|
- name: azure_list_instance_group_managers
|
|
display_name: Azure list instance group managers
|
|
description: List scale sets.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_instance_group_managers(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return\
|
|
\ await _azure_list(\"azure_list_instance_group_managers\", arguments, \"Resources\", ['microsoft.compute/virtualmachinescalesets'])\n"
|
|
- name: azure_list_instance_templates
|
|
display_name: Azure list instance templates
|
|
description: List template specs and gallery images.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_instance_templates(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await\
|
|
\ _azure_list(\"azure_list_instance_templates\", arguments, \"Resources\", ['microsoft.resources/templatespecs', 'microsoft.compute/galleries/images'])\n"
|
|
- name: azure_list_disks
|
|
display_name: Azure list disks
|
|
description: List managed disks.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_disks(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_list(\"\
|
|
azure_list_disks\", arguments, \"Resources\", ['microsoft.compute/disks'])\n"
|
|
- name: azure_list_reservations
|
|
display_name: Azure list reservations
|
|
description: List capacity reservation groups.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_reservations(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_list(\"\
|
|
azure_list_reservations\", arguments, \"Resources\", ['microsoft.compute/capacityreservationgroups'])\n"
|
|
- name: azure_list_clusters
|
|
display_name: Azure list clusters
|
|
description: List AKS clusters.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_clusters(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_list(\"\
|
|
azure_list_clusters\", arguments, \"Resources\", ['microsoft.containerservice/managedclusters'])\n"
|
|
- name: azure_list_services
|
|
display_name: Azure list services
|
|
description: List Container Apps and App Service apps.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_services(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_list(\"\
|
|
azure_list_services\", arguments, \"Resources\", ['microsoft.app/containerapps', 'microsoft.web/sites'])\n"
|
|
- name: azure_list_sql_instances
|
|
display_name: Azure list sql instances
|
|
description: List SQL, PostgreSQL and MySQL servers.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_sql_instances(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_list(\"\
|
|
azure_list_sql_instances\", arguments, \"Resources\", ['microsoft.sql/servers', 'microsoft.sql/managedinstances', 'microsoft.dbforpostgresql/flexibleservers',\
|
|
\ 'microsoft.dbformysql/flexibleservers'])\n"
|
|
- name: azure_list_buckets
|
|
display_name: Azure list buckets
|
|
description: List storage accounts.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_buckets(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_list(\"\
|
|
azure_list_buckets\", arguments, \"Resources\", ['microsoft.storage/storageaccounts'])\n"
|
|
- name: azure_list_topics
|
|
display_name: Azure list topics
|
|
description: List Service Bus, Event Hubs and Event Grid topics.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_topics(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_list(\"\
|
|
azure_list_topics\", arguments, \"Resources\", ['microsoft.servicebus/namespaces', 'microsoft.eventhub/namespaces', 'microsoft.eventgrid/topics'])\n"
|
|
- name: azure_list_roles
|
|
display_name: Azure list roles
|
|
description: List role definitions.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_roles(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_list(\"\
|
|
azure_list_roles\", arguments, \"AuthorizationResources\", ['microsoft.authorization/roledefinitions'])\n"
|
|
- name: azure_list_alert_policies
|
|
display_name: Azure list alert policies
|
|
description: List alert rules.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_alert_policies(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await\
|
|
\ _azure_list(\"azure_list_alert_policies\", arguments, \"Resources\", ['microsoft.insights/metricalerts', 'microsoft.insights/activitylogalerts',\
|
|
\ 'microsoft.insights/scheduledqueryrules'])\n"
|
|
- name: azure_list_dashboards
|
|
display_name: Azure list dashboards
|
|
description: List dashboards.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_dashboards(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_list(\"\
|
|
azure_list_dashboards\", arguments, \"Resources\", ['microsoft.portal/dashboards'])\n"
|
|
- name: azure_list_connectivity_tests
|
|
display_name: Azure list connectivity tests
|
|
description: List connection monitors.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_connectivity_tests(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await\
|
|
\ _azure_list(\"azure_list_connectivity_tests\", arguments, \"Resources\", ['microsoft.network/networkwatchers/connectionmonitors'])\n"
|
|
- name: azure_get_instance_basic_info
|
|
display_name: Azure get instance basic info
|
|
description: Read one virtual machine.
|
|
parameters:
|
|
- *id003
|
|
ai_implementation: "async def azure_get_instance_basic_info(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await\
|
|
\ _azure_get(\"azure_get_instance_basic_info\", arguments, \"Resources\", ['microsoft.compute/virtualmachines'])\n"
|
|
- name: azure_get_instance_group_manager_basic_info
|
|
display_name: Azure get instance group manager basic info
|
|
description: Read one scale set.
|
|
parameters:
|
|
- *id003
|
|
ai_implementation: "async def azure_get_instance_group_manager_basic_info(arguments: Dict[str, Any]) -> Dict[str, Any]:\n\
|
|
\ return await _azure_get(\"azure_get_instance_group_manager_basic_info\", arguments, \"Resources\", ['microsoft.compute/virtualmachinescalesets'])\n"
|
|
- name: azure_get_instance_template_properties
|
|
display_name: Azure get instance template properties
|
|
description: Read one template spec or gallery image.
|
|
parameters:
|
|
- *id003
|
|
ai_implementation: "async def azure_get_instance_template_properties(arguments: Dict[str, Any]) -> Dict[str, Any]:\n \
|
|
\ return await _azure_get(\"azure_get_instance_template_properties\", arguments, \"Resources\", ['microsoft.resources/templatespecs',\
|
|
\ 'microsoft.compute/galleries/images'])\n"
|
|
- name: azure_get_disk_basic_info
|
|
display_name: Azure get disk basic info
|
|
description: Read one disk.
|
|
parameters:
|
|
- *id003
|
|
ai_implementation: "async def azure_get_disk_basic_info(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await\
|
|
\ _azure_get(\"azure_get_disk_basic_info\", arguments, \"Resources\", ['microsoft.compute/disks'])\n"
|
|
- name: azure_get_cluster
|
|
display_name: Azure get cluster
|
|
description: Read one AKS cluster.
|
|
parameters:
|
|
- *id003
|
|
ai_implementation: "async def azure_get_cluster(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_get(\"\
|
|
azure_get_cluster\", arguments, \"Resources\", ['microsoft.containerservice/managedclusters'])\n"
|
|
- name: azure_get_service
|
|
display_name: Azure get service
|
|
description: Read one app.
|
|
parameters:
|
|
- *id003
|
|
ai_implementation: "async def azure_get_service(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_get(\"\
|
|
azure_get_service\", arguments, \"Resources\", ['microsoft.app/containerapps', 'microsoft.web/sites'])\n"
|
|
- name: azure_get_sql_instance
|
|
display_name: Azure get sql instance
|
|
description: Read one database server.
|
|
parameters:
|
|
- *id003
|
|
ai_implementation: "async def azure_get_sql_instance(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_get(\"\
|
|
azure_get_sql_instance\", arguments, \"Resources\", ['microsoft.sql/servers', 'microsoft.sql/managedinstances', 'microsoft.dbforpostgresql/flexibleservers',\
|
|
\ 'microsoft.dbformysql/flexibleservers'])\n"
|
|
- name: azure_get_topic
|
|
display_name: Azure get topic
|
|
description: Read one messaging resource.
|
|
parameters:
|
|
- *id003
|
|
ai_implementation: "async def azure_get_topic(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_get(\"\
|
|
azure_get_topic\", arguments, \"Resources\", ['microsoft.servicebus/namespaces', 'microsoft.eventhub/namespaces', 'microsoft.eventgrid/topics'])\n"
|
|
- name: azure_get_role
|
|
display_name: Azure get role
|
|
description: Read one role definition.
|
|
parameters:
|
|
- *id003
|
|
ai_implementation: "async def azure_get_role(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_get(\"\
|
|
azure_get_role\", arguments, \"AuthorizationResources\", ['microsoft.authorization/roledefinitions'])\n"
|
|
- name: azure_get_alert_policy
|
|
display_name: Azure get alert policy
|
|
description: Read one alert rule.
|
|
parameters:
|
|
- *id003
|
|
ai_implementation: "async def azure_get_alert_policy(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_get(\"\
|
|
azure_get_alert_policy\", arguments, \"Resources\", ['microsoft.insights/metricalerts', 'microsoft.insights/activitylogalerts',\
|
|
\ 'microsoft.insights/scheduledqueryrules'])\n"
|
|
- name: azure_get_connectivity_test
|
|
display_name: Azure get connectivity test
|
|
description: Read one connection monitor.
|
|
parameters:
|
|
- *id003
|
|
ai_implementation: "async def azure_get_connectivity_test(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await\
|
|
\ _azure_get(\"azure_get_connectivity_test\", arguments, \"Resources\", ['microsoft.network/networkwatchers/connectionmonitors'])\n"
|
|
- name: azure_list_assets
|
|
display_name: Azure list assets
|
|
description: List every resource in scope, or one resource type.
|
|
parameters:
|
|
- name: resource_type
|
|
type: string
|
|
description: An ARM type.
|
|
required: false
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_assets(arguments: Dict[str, Any]) -> Dict[str, Any]:\n kind = arguments.get(\"\
|
|
resource_type\")\n if kind and not re.fullmatch(r\"[A-Za-z0-9./]+\", str(kind)):\n return _refuse(\"invalid_argument\"\
|
|
, \"resource_type must be an ARM type\")\n where = f\" | where type =~ '{kind}'\" if kind else \"\"\n return await\
|
|
\ _azure_page(\"azure_list_assets\", arguments, f\"Resources{where} | project id, name, type, location, resourceGroup,\
|
|
\ subscriptionId, tags | order by id asc\")\n"
|
|
- name: azure_get_node_pool
|
|
display_name: Azure get node pool
|
|
description: Read one AKS node pool.
|
|
parameters:
|
|
- *id003
|
|
- name: pool
|
|
type: string
|
|
description: The node pool's name.
|
|
required: true
|
|
ai_implementation: "async def azure_get_node_pool(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_resource_arm(\"\
|
|
azure_get_node_pool\", arguments, f\"/agentPools/{arguments.get('pool')}\", {\"api-version\": \"2024-05-01\"}) if re.fullmatch(r\"\
|
|
[A-Za-z0-9]+\", str(arguments.get(\"pool\"))) else _refuse(\"invalid_argument\", \"pool must be a pool name\")\n"
|
|
- name: azure_list_commitments
|
|
display_name: Azure list commitments
|
|
description: List reserved capacity orders, Azure's committed-use discounts.
|
|
parameters:
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_commitments(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_arm(\"\
|
|
azure_list_commitments\", arguments, \"/providers/Microsoft.Capacity/reservationOrders\", {\"api-version\": \"2022-11-01\"\
|
|
})\n"
|
|
- name: azure_get_k8s_version
|
|
display_name: Azure get k8s version
|
|
description: List the Kubernetes versions AKS offers in one location.
|
|
parameters:
|
|
- name: location
|
|
type: string
|
|
description: An Azure region, such as uksouth.
|
|
required: true
|
|
- &id004
|
|
name: subscription_id
|
|
type: string
|
|
description: Needed when the connection's scope is a management group.
|
|
required: false
|
|
ai_implementation: "async def azure_get_k8s_version(arguments: Dict[str, Any]) -> Dict[str, Any]:\n location = str(arguments.get(\"\
|
|
location\") or \"\")\n if not re.fullmatch(r\"[a-z0-9]+\", location):\n return _refuse(\"invalid_argument\"\
|
|
, \"location must be an Azure region name\")\n return await _azure_subscription_arm(\"azure_get_k8s_version\", arguments,\
|
|
\ f\"/providers/Microsoft.ContainerService/locations/{location}/kubernetesVersions\", {\"api-version\": \"2024-05-01\"\
|
|
})\n"
|
|
- name: azure_list_subscriptions
|
|
display_name: Azure list subscriptions
|
|
description: List Event Grid event subscriptions.
|
|
parameters:
|
|
- *id004
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_subscriptions(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_subscription_arm(\"\
|
|
azure_list_subscriptions\", arguments, \"/providers/Microsoft.EventGrid/eventSubscriptions\", {\"api-version\": \"2022-06-15\"\
|
|
})\n"
|
|
- name: azure_list_deny_policies
|
|
display_name: Azure list deny policies
|
|
description: List deny assignments.
|
|
parameters:
|
|
- *id004
|
|
- *id001
|
|
- *id002
|
|
ai_implementation: "async def azure_list_deny_policies(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await _azure_subscription_arm(\"\
|
|
azure_list_deny_policies\", arguments, \"/providers/Microsoft.Authorization/denyAssignments\", {\"api-version\": \"2022-04-01\"\
|
|
})\n"
|
|
- name: azure_list_metric_descriptors
|
|
display_name: Azure list metric descriptors
|
|
description: List the metrics one resource publishes.
|
|
parameters:
|
|
- *id003
|
|
ai_implementation: "async def azure_list_metric_descriptors(arguments: Dict[str, Any]) -> Dict[str, Any]:\n return await\
|
|
\ _azure_resource_arm(\"azure_list_metric_descriptors\", arguments, \"/providers/Microsoft.Insights/metricDefinitions\"\
|
|
, {\"api-version\": \"2018-01-01\"})\n"
|
|
- name: azure_list_timeseries
|
|
display_name: Azure list timeseries
|
|
description: Read metric values for one resource.
|
|
parameters:
|
|
- *id003
|
|
- name: metricnames
|
|
type: string
|
|
description: Comma-separated metric names.
|
|
required: true
|
|
- name: timespan
|
|
type: string
|
|
description: ISO 8601 interval, start/end.
|
|
required: true
|
|
- name: interval
|
|
type: string
|
|
description: ISO 8601 duration, such as PT1H.
|
|
required: false
|
|
- name: aggregation
|
|
type: string
|
|
description: Average, Total, Maximum, Minimum or Count.
|
|
required: false
|
|
ai_implementation: "async def azure_list_timeseries(arguments: Dict[str, Any]) -> Dict[str, Any]:\n wanted = {k: arguments.get(k)\
|
|
\ for k in (\"metricnames\", \"timespan\", \"interval\", \"aggregation\") if arguments.get(k)}\n if \"metricnames\"\
|
|
\ not in wanted or \"timespan\" not in wanted:\n return _refuse(\"invalid_argument\", \"metricnames and timespan\
|
|
\ are required\")\n return await _azure_resource_arm(\"azure_list_timeseries\", arguments, \"/providers/Microsoft.Insights/metrics\"\
|
|
, {\"api-version\": \"2018-01-01\", **wanted})\n"
|