---
title: "Kubernetes MCP Server: review, setup & limitations · Undominated.ai"
canonical: https://undominated.ai/mcp-servers/kubernetes/
description: "Exposes Kubernetes and OpenShift resource inspection and management using kubeconfig or in-cluster credentials."
---

# Kubernetes MCP Server: review, setup & limitations · Undominated.ai

> Exposes Kubernetes and OpenShift resource inspection and management using kubeconfig or in-cluster credentials.

[← Explore all mcp servers](/mcp-servers/)

CLUSTER OPERATIONS / containers project

# Kubernetes MCP Server

Exposes Kubernetes and OpenShift resource inspection and management using kubeconfig or in-cluster credentials.

 [See setup guidance ↓](#setup)[Original source ↗](https://github.com/containers/kubernetes-mcp-server)

SOURCE REVIEW

 Reviewed 2026-10-13
 Evidence 6 linked sources
 Publisher containers project
 Licence [Apache-2.0 ↗](https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/LICENSE)
 Revision aecddcb72999
 [Read what was—and wasn’t—checked ↓](#review)

“A powerful and flexible Kubernetes Model Context Protocol (MCP) server implementation with support for Kubernetes and OpenShift.”

 [containers project · upstream description ↗](https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/README.md) Our analysis follows below.

01 / THE REASONING

## Why this made the selection.

 - Supports generic Kubernetes resources, making its role broader than a fixed set of pod commands.
- Documents toolsets, read-only configuration and a restricted service-account setup.

### A good fit for

 - Inspecting pod failures and resource state in a deliberately limited cluster context.
- Giving an agent Helm, KubeVirt, Tekton, Kiali, kcp or NetObserv tools through optional toolsets, beyond the default config and core toolsets.

### Weigh up before choosing

 - The configuration defaults read_only to false; enabled tools can create, update or delete resources.
- The README's client blocks (Claude Desktop, Cursor, VS Code) launch the server without --config, so that default applies and the core toolset's pods_exec, pods_run and resources_delete are exposed.
- The selected kubeconfig context and Kubernetes RBAC determine the reachable cluster and resources.
- Enabling HTTP defaults the bind address to 0.0.0.0, with TLS/OAuth requiring configuration. A separate metrics listener, if enabled, has neither TLS nor OAuth.

02 / THE REVIEW RECORD

## What we actually inspected.

Source review has boundaries. A clear record is more useful than a “safe” badge.

### Material inspected

 - README.md at aecddcb7299972afa003b3fbd577f3008b96c8a1 (features, getting started, configuration, toolsets and tool list)
- docs/configuration.md at the same commit
- pkg/http/http.go at the same commit
- cmd/kubernetes-mcp-server/main.go and go.mod at the same commit
- LICENSE at the same commit

### Our findings

 - The Go entrypoint and go.mod (module github.com/containers/kubernetes-mcp-server) establish the implementation language; npx and uvx are launchers for the same executable.
- HTTP authentication has dedicated OAuth/OIDC guidance (require_oauth, token exchange); local kubeconfig access remains a separate credential boundary.
- pkg/http/http.go serves Streamable HTTP at /mcp; legacy SSE was not established and is not listed.
- The default toolsets are config and core. At aecddcb7 the README lists 19 core tools, including pods_delete, pods_exec, pods_run, resources_create_or_update, resources_delete and resources_scale, and 3 config tools: configuration_contexts_list, targets_list and configuration_view.
- docs/configuration.md says configuration_view is disabled by default in HTTP mode because it exposes kubeconfig contents.
- configExample is the README's Claude Desktop block at aecddcb7.
- Correction: the install command recorded on 2026-09-21 (npx kubernetes-mcp-server@latest --config ./mcp-config.toml) does not appear in the README at 6fd66fb4 or at aecddcb7. It is replaced by the README's own TOML launch line.

### Not established by this review

 - Server startup, authentication and tool execution were not tested.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

## Connect a server deliberately.

[Upstream setup instructions ↗](https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/README.md)

DOCUMENTED COMMAND

 kubernetes-mcp-server --config /etc/kubernetes-mcp-server/config.toml Copy command ↗

Copying does not execute this command. It may retrieve a newer version than the reviewed source.

 - Get the kubernetes-mcp-server executable. The README names three ways to run it: npx, uvx, or the latest release binary.
- Write the TOML file the command names. The README's example sets read_only = true and a toolsets list; read_only and toolsets are TOML settings, not launch flags. Select a kubeconfig or service account restricted to the intended cluster resources.
- For HTTP mode, set port in the TOML and explicitly set bind_address = "127.0.0.1" for local access, or configure the documented OAuth/TLS controls before sharing the listener.
- The command was copied from the README and not run.

### Before you start

 - Access to a Kubernetes cluster (the README's stated requirement), through kubeconfig or in-cluster configuration.
- npm for npx, uv for uvx, or the downloaded release binary; the README says the native binary needs neither Node nor Python.
- A TOML configuration file at the command's path.

### Documented configuration example

Use the client and authentication context described in the setup guidance. Configuration formats vary between hosts.

 {
 "mcpServers": {
 "kubernetes": {
 "command": "npx",
 "args": [
 "-y",
 "kubernetes-mcp-server@latest"
 ]
 }
 }
} Copy configuration ↗

### Compatibility

Claude Desktop · Claude Code · VS Code · Cursor · Goose CLI

### Implementation

Go

### Transports

stdio · Streamable HTTP

### Cluster operations / Configured credentials or local access

 - Reads cluster resources and logs; enabled operations can mutate or delete resources and use administrative tools.
- The default core toolset includes pods_exec (run a command in a pod) and pods_run (run a container image in a pod).
- Authenticates to the cluster with the selected kubeconfig context or in-cluster configuration; HTTP mode can additionally require OAuth/OIDC bearer tokens (require_oauth).

### Cost model

Cluster hosting and any resources created through enabled tools determine cost.

04 / FOLLOW THE EVIDENCE

## The source trail.

Our notes are separate from the original resource. Check upstream before adopting a new version.

 - [Official documentation ↗](https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/README.md) Checked 2026-10-13 https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/README.md Supports: summary, whySelected, bestFor, limitations, install, access, compatibility, transports, upstreamDescription, configExample
- [Applicable source licence ↗](https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/LICENSE) Checked 2026-10-13 https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/LICENSE Supports: license
- [Implementation: go.mod ↗](https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/go.mod) Checked 2026-10-13 https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/go.mod Supports: language, review
- [Implementation: cmd/kubernetes-mcp-server/main.go ↗](https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/cmd/kubernetes-mcp-server/main.go) Checked 2026-10-13 https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/cmd/kubernetes-mcp-server/main.go Supports: language, review
- [Implementation: pkg/http/http.go ↗](https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/pkg/http/http.go) Checked 2026-10-13 https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/pkg/http/http.go Supports: review, transports
- [Implementation: docs/configuration.md ↗](https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/docs/configuration.md) Checked 2026-10-13 https://github.com/containers/kubernetes-mcp-server/blob/aecddcb7299972afa003b3fbd577f3008b96c8a1/docs/configuration.md Supports: review, limitations, transports, install, access

KEEP COMPARING

## Other approaches to consider.

Related by category or shared topics. These are alternatives to inspect, not a measured quality order.

 [### GKE MCP Server ↗ Inspects GKE. The documented install is a Go binary or a Gemini extension, not an npm package.](/mcp-servers/googlecloudplatform-gke-mcp/)[### CockroachDB MCP Server ↗ Typed CockroachDB tools written in Go, registering read-only tools by default with write and DDL tools behind an explicit environment variable. Supports stdio and HTTP modes, cert-based authentication and a least-privilege SQL role recipe.](/mcp-servers/cockroachdb/)[### Firebolt MCP Server ↗ Go MCP server from Firebolt that connects a client to Firebolt Cloud or Firebolt Core, runs SQL, and exposes Firebolt documentation tools.](/mcp-servers/firebolt/)

 [AI Tools ↗](/tools/)[Skills ↗](/skills/)[Agents ↗](/agents/)[MCP Servers ↗](/mcp-servers/)[Workflows ↗](/workflows/)

## Continue your investigation

 - [Inspect resource evidence](/tools/)
- [Choose a host](/agents/)
- [Inspect reusable workflows](/skills/)
- [Use Undominated data](/api/)
