Files
cp1-agents/outcome-pattern/solution_architecture/mcp-servers/sa-azure-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

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"