# 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/ or subscriptions/. 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"