Aks MCP Server

The AKS-MCP is a Model Context Protocol (MCP) server that enables AI assistants to interact with Azure Kubernetes Service (AKS) clusters. It serves

Local serverstdioGo

What is the Aks MCP Server?

The AKS-MCP is a Model Context Protocol (MCP) server that enables AI assistants to interact with Azure Kubernetes Service (AKS) clusters. It serves as a bridge

Configuration

  1. Set up Azure CLI and authenticate:

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

ToolWhat it does
cli_commandThe complete Azure CLI command to execute (e.g., az aks list --resource-group myRG, az vm list --subscription )
timeoutOptional timeout in seconds (default: 120)
readonlyOnly read operations (get, describe, logs, etc.) are allowed
Read-Onlyall access levels):
showGet details of a VM/VMSS
listList recommendations with filtering options
get-versionsGet available Kubernetes versions
check-networkPerform outbound network connectivity check
nodepool-listList node pools in cluster
nodepool-showShow node pool details
account-listList Azure subscriptions
Read-Writereadwrite/admin access levels):
createCreate new cluster
deleteDelete cluster
scaleScale cluster node count
startStart continuous gadgets
stopStop running gadgets
updateUpdate cluster configuration
upgradeUpgrade Kubernetes version
nodepool-addAdd node pool to cluster
nodepool-deleteDelete node pool
nodepool-scaleScale node pool
nodepool-upgradeUpgrade node pool
account-setSet active subscription
loginAzure authentication
Admin-Onlyadmin access level):
get-credentialsGet cluster credentials for kubectl access
allGet information about all network resources
vnetVirtual Network information
subnetSubnet information
nsgNetwork Security Group information
route_tableRoute Table information
load_balancerLoad Balancer information
private_endpointPrivate endpoint information
metricsList metric values for resources
resource_healthRetrieve resource health events for AKS clusters
app_insightsExecute KQL queries against Application Insights telemetry data
diagnosticsCheck if AKS cluster has diagnostic settings configured
control_plane_logsQuery AKS control plane logs with safety constraints
aks_resource_idrequired): AKS cluster resource ID
vmss_nameVMSS name (obtain from get_aks_vmss_info or kubectl get nodes)
instance_idVMSS instance ID
log_typeType of logs to collect (kubelet, containerd, kernel, syslog)
linesNumber of recent log lines to return (default: 500, max: 2000)
sinceTime range for logs (e.g., 1h, 30m, 2d) - takes precedence over lines
levelLog level filter (ERROR, WARN, INFO)
filterFilter logs by keyword (case-insensitive text match)
get-instance-viewGet runtime status
restartRestart VM/VMSS instances
reimageReimage VMSS instances (VM not supported for reimage)
runRun one-shot gadgets
run_by_categoryRun all detectors in a specific category
operationrequired): Operation to perform (list, run, or run_by_category)
detector_namerequired for run operation): Name of the detector to run
categoryrequired for run_by_category operation): Detector category
start_timerequired for run and run_by_category operations): Start time in UTC ISO format (within last 30 days)
end_timerequired for run and run_by_category operations): End time in UTC ISO format (within last 30 days, max 24h from start)
DeprecationsIdentity and Security
reportGenerate recommendation reports
argsThe kubectl command arguments (e.g., get pods, describe node mynode, apply -f deployment.yaml)
kubectl_resourcesFull resource management (get, describe, create, delete, apply, patch, replace, cordon, uncordon, drain, taint)
kubectl_diagnosticsDebug and diagnose (logs, events, top, exec, cp)
kubectl_clusterCluster information (cluster-info, api-resources, api-versions, explain)
kubectl_configFull configuration management (diff, auth, certificate, config)
ReadWrite/Admin (readwrite/admin access levels):
kubectl_workloadsWorkload lifecycle (run, expose, scale, autoscale, rollout)
kubectl_metadataMetadata management (label, annotate, set)
deployDeploy Inspektor Gadget to the cluster (via the AKS cluster extension)
undeployRemove the Inspektor Gadget cluster extension from the cluster
is_deployedCheck deployment status
get_resultsRetrieve gadget results
list_gadgetsList available gadgets
observe_dnsMonitor DNS requests and responses
observe_tcpMonitor TCP connections
observe_file_openMonitor file system operations
observe_process_executionMonitor process execution
observe_signalMonitor signal delivery
observe_system_callsMonitor system calls
top_fileTop files by I/O operations
top_tcpTop TCP connections by traffic
tcpdumpCapture network packets

How to install the Aks MCP Server

{
  "mcpServers": {
    "aks": {
      "command": "<path of binary aks-mcp>",
      "args": []
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

  1. Set up Azure CLI and authenticate:

Example prompts to try

  • “Use Aks MCP to cli command.”
  • “Use Aks MCP to timeout.”
  • “Use Aks MCP to readonly.”

Frequently asked questions

The AKS-MCP is a Model Context Protocol (MCP) server that enables AI assistants to interact with Azure Kubernetes Service (AKS) clusters. It serves as a bridge Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.