PlugWiki
aks-mcp logo

Azure AKS MCP Server: Setup for Claude, Cursor and Other Apps

Official · by MicrosoftLocal

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.

Install aks MCP

Claude Code

  1. 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. 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_az

  • Runs 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_kubectl

  • Reads 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_monitoring

  • Runs 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_detector

  • Lists 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_recommendation

  • Shows 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_resources

  • Shows 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_info

  • Collects 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_logs

  • Manages 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_fleet

  • Runs 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_helm

  • Runs 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_cilium

  • Runs 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_hubble

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

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-onlyThe server starts with --access-level readonly, which is the default. Use readwrite or admin only when you want it to change things.
Talks toAzure APIs and your cluster API
Sign-in and keysUses 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

GitHubDockerDocker MCP CatalogChangelogIssues

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 2
  1. github.com · github.com
  2. github.com · github.com

Facts from the official MCP registry, GitHub, npm, PyPI and the Docker catalog. Updated Nov 2, 2026.