Reads the cluster — namespaces, any resource type (custom resources too), events, and a
per-namespace map of resources, relationships and health.
Finds problems without Claude — Warning events and failing CronJobs (with the end of the
failed run's log) become a list of issues in seconds (?narrative=false).
Asks Claude about a resource, a whole namespace, or a GitLab merge request, with the context
it collected.
Watches its own ArgoCD access — it checks every 60 seconds that its token can still read
Applications, so a lost RBAC grant shows up as an error rather than an empty list.
Authenticates to Claude with an API key or Workload Identity Federation, so it can run
without a long-lived key.
It only reads: nothing it does changes Kubernetes, ArgoCD or GitLab.
It is a REST API. Despite the name it does not implement the Model Context Protocol's JSON-RPC
transport, so MCP clients such as Claude Desktop can't connect to it directly; call it over HTTP.
Quick start
Download a release binary (Linux and macOS, amd64 and arm64) from
Releases, write a config.yaml:
The quick start walks through it,
including checksum verification.
Install
Method
Helm
helm install kubernetes-mcp-server ./helm/kubernetes-mcp-server --set secrets.apiKey=... --set secrets.claudeApiKey=... from a checkout of a release tag. See Installation.