
Azure AKS MCP Server: Setup for Claude, Cursor and Other Apps
Lets your assistant inspect and troubleshoot Azure Kubernetes Service (AKS) clusters, and manage them if you allow it.
This is Microsoft's server for Azure Kubernetes Service. It runs on your computer and uses your own Azure sign-in to run Azure CLI, kubectl, Helm and Cilium commands, read monitoring data and run diagnostics. It starts in read-only mode. The project says it must run locally for one trusted user, because anyone who can call it has the full Azure and Kubernetes access of the account it runs as.
Good for
- Platform and SRE teams who troubleshoot AKS clusters
- Developers who deploy to AKS and want help reading logs and events
- Teams reviewing cluster cost, security and health recommendations
Works in
12 should work
Tap an app to see how to set it up and any known problems.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Supports local MCP servers.
Client does not support this transport.
Client does not support this transport.
Install aks MCP
Claude Code
- 1
Copy this prompt.
Add the aks MCP server to Claude Code. Run this command: claude mcp add aks -e AZURE_SUBSCRIPTION_ID=<AZURE_SUBSCRIPTION_ID> -- /path/to/aks-mcp Then check that it loaded and tell me if I need to sign in or restart.
- 2
Paste it into Claude Code. It shows the change and asks before running it.
Requires Azure CLI (az login), aks-mcp binary.
Read-only mode: Leave the --access-level argument out, or set it to readonly. This is the default.
Download the aks-mcp binary for your system from the project's GitHub releases, make it executable, and use its full path above. Run az login first. The server starts in read-only mode.
From the project README. Source.
Tools
Runs Azure CLI commands for AKS and other Azure resources
Runs an Azure CLI command such as listing clusters or showing a VM. In read-only mode only read commands run. Pipes, redirects and az rest are not allowed, and a few commands that return credentials are blocked.
Try: “List all my AKS clusters in resource group myRG.”
Delete ·
call_azRuns kubectl commands against your cluster
Runs any kubectl command, such as get pods or describe node. Read-only mode allows get, describe and logs. In read-write or admin mode it can also create, apply and delete.
Try: “Show the pods in kube-system with their nodes.”
Delete ·
call_kubectlReads metrics, health events, logs and Application Insights data for a cluster
Pulls monitoring data for an AKS cluster: metric values, resource health events, KQL queries on Application Insights, diagnostic settings and control plane logs. Control plane log queries have safety limits and time range checks.
Try: “Show the control plane logs for cluster prod-aks from the last hour.”
Network ·
aks_monitoringRuns AKS diagnostic detectors to find problems
Runs Azure's built-in diagnostic detectors against a cluster to look for known problems.
Try: “Run the diagnostic detectors on my cluster and tell me what is wrong.”
Network ·
aks_detectorLists and reports Azure Advisor recommendations for AKS clusters
Lists Azure Advisor recommendations for your clusters and generates reports. You can filter by resource group, cluster, category (cost, availability, performance, security) and severity.
Try: “What high severity security recommendations do my AKS clusters have?”
Network ·
aks_advisor_recommendationShows the networks, subnets, security groups and load balancers a cluster uses
Looks up the virtual network, subnet, network security group, route table, load balancer and private endpoint information for a cluster.
Try: “Which subnet and network security group does my cluster use?”
Network ·
aks_network_resourcesShows the scale set settings behind a node pool
Returns the virtual machine scale set configuration for a cluster's node pools.
Try: “Show the scale set config for the nodepool1 node pool.”
Network ·
get_aks_vmss_infoCollects system logs from cluster nodes for troubleshooting
Gathers system logs from the nodes in a scale set to help debug a problem. It supports Linux scale set nodes only, and one run command can execute at a time per instance.
Try: “Collect kubelet logs from the node that keeps going NotReady.”
Runs code ·
collect_aks_node_logsManages Azure Fleet for multi-cluster setups
Lists, shows, creates, updates and deletes fleets, members, update runs and update strategies, and works with ClusterResourcePlacement objects. Writes need read-write or admin access.
Try: “List the members of fleet myFleet and show the latest update run.”
Delete ·
az_fleetRuns Helm commands to manage apps on your cluster
Runs Helm commands, for example listing releases or installing a chart.
Try: “List the Helm releases in the monitoring namespace.”
Delete ·
call_helmRuns Cilium commands for cluster networking and security
Runs the Cilium command line tool to check or manage Cilium networking on the cluster.
Try: “Check the Cilium status on my cluster.”
Runs code ·
call_ciliumRuns Hubble commands to watch network traffic
Runs Hubble to observe network flows in a cluster that uses Cilium.
Try: “Show recent dropped network flows in the default namespace.”
Runs code ·
call_hubbleDeploys Inspektor Gadget and watches DNS, TCP, file and process activity live
Installs the Inspektor Gadget extension on the cluster, runs or starts gadgets that watch DNS, TCP connections, file opens, process execution and system calls, and returns results. It can also remove the extension.
Try: “Watch DNS requests in the payments namespace for a minute.”
Delete ·
inspektor_gadget_observability
Read from the source code
Permissions
high risk · 5 things to watch
High risk
The server runs Azure CLI, kubectl and Helm commands as your Azure identity, so in read-write or admin mode it can change or delete cluster resources. Keep the default read-only level and use an account with limited permissions.
What it can do
- Read your data
- Create and change things
- Delete things
- Read-only modeHow to turn it on
Watch out for
It runs commands as your Azure identity
The README says anyone who can call it has the full Azure and Kubernetes rights of the identity it runs as. Use an account with only the permissions you need. github.com
Read-write and admin modes can delete and deploy
In those modes kubectl and Helm can delete resources, read Secrets and deploy workloads. Keep the default read-only level unless you need changes. github.com
Access level is a guardrail, not a security boundary
The README says it reduces accidents but does not stop a determined caller. Do not run it for users you would not trust with the credentials. github.com
Run it locally only
The project supports only a local stdio process and says not to expose it through HTTP, a container service, Helm or a gateway. github.com
Telemetry
The README has a telemetry section. Check it if that matters to your team. github.com
Security advisories
No published security advisories as of Nov 1, 2026.
Technical details
| Turning on read-only | The server starts with --access-level readonly, which is the default. Use readwrite or admin only when you want it to change things. |
|---|---|
| Talks to | Azure APIs and your cluster API |
| Sign-in and keys | Uses your existing Azure CLI login, or service principal, workload identity or managed identity settings from environment variables. |
Questions
Is the AKS MCP server official?
Yes. It is published by Microsoft in the Azure organization on GitHub. The README describes it as the AKS MCP server for AI assistants like GitHub Copilot and Claude.
Can it run read-only?
Yes, and it does by default. The access level starts at readonly. Setting it to readwrite or admin allows changes, such as creating or deleting resources.
How does it sign in to Azure?
It uses your Azure CLI session, so run az login first. It can also use a service principal, workload identity or managed identity through environment variables.
Can I run it in Docker or on a server?
Not as a supported setup. The README says it supports only a local stdio process, and warns against exposing it through HTTP, containers, Helm or a gateway.
How do I set it up in VS Code?
Install the Azure Kubernetes Service extension and run AKS: Setup AKS MCP Server from the Command Palette. For other apps, download the binary and use the install box.
Are there more tools than the ones listed?
Yes, in legacy mode. By default the server uses one tool for Azure CLI and one for kubectl. Setting the legacy tools option to true swaps them for older specialized tools. This page lists the default tools.
Can it limit which Kubernetes namespaces it reaches?
Yes. An option limits the server to the Kubernetes namespaces you list.
Information
updated Nov 2, 2026
- Publisher
- Microsoft (official)
- Transport
- stdio
- Auth
- None
- License
- MIT
- Last commit
- Oct 26, 2026
- Open issues
- 13
- Listed in
- Docker MCP Catalog
Other Microsoft Azure MCP servers
Sources
Docs, issue trackers and discussions this page is built from. Issues, quotes and findings above link to their own source.
Show all 2Hide
- github.com · github.com
- github.com · github.com