Azure/aks-mcp is a Model Context Protocol server that lets compatible AI assistants send natural-language requests to Azure Kubernetes Service clusters and receive understandable results. It is for users who want an AI tool to inspect or manage AKS resources and Azure Fleet operations. Its catalogue instruction helps assistants work with AKS through this server.
Getting it into your agent
One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.
npx agentmods add instructions/azure/aks-mcp/copilot-instructionsgit clone --depth 1 https://github.com/Azure/aks-mcpWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/azure/aks-mcp/copilot-instructions)<a href="https://agentmods.dev/instructions/azure/aks-mcp/copilot-instructions"><img src="https://agentmods.dev/badge/instructions/azure/aks-mcp/copilot-instructions.svg" alt="Measured on agentmods" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.00889 | $0.00889 |
| Opus 5 | $0.00445 | $0.00445 |
| Sonnet 5 | $0.00178 | $0.00178 |
| Haiku 4.5 | $0.00089 | $0.00089 |
Grade A, and why
aks-mcp copilot-instructions.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 5d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 106 lines — stays where its author put it; the contents beside it link to each section on GitHub.
Copilot Instructions
This file provides guidance to Github Copilot when working with code in this repository.
Project Overview
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 between AI tools and AKS, translating natural language requests into AKS operations.
Architecture
High-Level Structure
- Entry Point:
cmd/aks-mcp/main.go- Main application entry point - Core Server:
internal/server/server.go- MCP server implementation with tool registration - Configuration:
internal/config/- Command line parsing and configuration management - Azure Integration:
internal/azure/- Azure SDK clients with caching layer - Resource Handlers:
internal/azure/resourcehandlers/- Handlers for Azure resource operations (VNet, NSG, Route Tables, Subnets) - Security:
internal/security/- Access level validation and security controls - Tools:
internal/tools/- MCP tool adapters and interfaces
Key Components
- Access Levels: Three security levels (readonly, readwrite, admin) control available operations
- Resource Caching: Azure resources are cached internally for performance
- Transport Support: Supports stdio transport
- Tool Registration: Tools are dynamically registered based on access level
Development Commands
Build
go build -o aks-mcp ./cmd/aks-mcp
Test
go test -v ./... # Run all tests
go test -race -coverprofile=coverage.txt -covermode=atomic ./... # Run tests with coverage
go test -v ./internal/azure/... # Run specific package tests
Lint
golangci-lint run # Run linter
golangci-lint run --timeout=5m # Run with extended timeout
Configuration
Command Line Arguments
--timeout: Command execution timeout in seconds (default: 600)--access-level: Access level (readonly, readwrite, admin)
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 5d ago First seen · 106 lines · 889 tokens per session scan A 8b7d533c7d34
aks-mcp copilot-instructions.md is an instructions file published in the GitHub repository Azure/aks-mcp (140 stars, last pushed 16d ago), licensed MIT. It adds 889 tokens to every session, about $0.0044 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.
Other instructions, from other repositories
ksail CLAUDE.md
Claude Code instructions for devantler-tech/ksail, a project described as: All-in-one Kubernetes SDK: create, manage, and operate clusters across distributions (Kind, K3d, Talos, VCluster) with built-in GitOps, secrets, AI assistant, and MCP server. Only requires Docker or a Cloud Provider.
timoni AGENTS.md
AGENTS.md instructions for stefanprodan/timoni, covering agents.md, what timoni is, common commands, architecture and cmd/timoni/ — cli (cobra).
Kubeli CLAUDE.md
Claude Code instructions for atilladeniz/Kubeli, covering kubeli - kubernetes management desktop app, project overview, quick start, development (tauri + vite) and web only development.
mcp-dockhand CLAUDE.md
Claude Code instructions for strausmann/mcp-dockhand, covering claude.md — mcp-dockhand server, projektübersicht, tech stack, verzeichnisstruktur and konventionen.
mcp-dockhand copilot-instructions.md
Copilot instructions for strausmann/mcp-dockhand, covering copilot instructions — mcp-dockhand, project context, critical: verify against upstream, code review guidelines and security.
ksail AGENTS.md
AGENTS.md instructions for devantler-tech/ksail, covering ksail - kubernetes sdk for local gitops development, working effectively, prerequisites and dependencies, node.js for documentation builds and ci uses node.js 24 (see .github/workflows/ci.yaml).