Kubernetes MCP Server

{
  "mcpServers": {
    "kubernetes-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "kubernetes-mcp-server"
      ]
    }
  }
}

claude mcp add --transport stdio kubernetes-mcp-server -- npx -y kubernetes-mcp-server

{
  "mcpServers": {
    "kubernetes-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kubernetes-mcp-server"
      ]
    }
  }
}

{
  "servers": {
    "kubernetes-mcp-server": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "kubernetes-mcp-server"
      ]
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

• configuration_contexts_list

  List all available context names and associated server urls from the kubeconfig file

• targets_list

  List all available targets

• configuration_view

  Get the current Kubernetes configuration content as a kubeconfig YAML

• minified

  Return a minified version of the configuration. If set to true, keeps only the current-context and the relevant pieces…

• events_list

  List Kubernetes events (warnings, errors, state changes) for debugging and troubleshooting in the current cluster from…

• continue

  Opaque token from the continue field of the previous page. Send it unchanged with the same limit, namespace, and…

• limit

  Maximum number of items to return. Omit or set to 0 to list everything, which fails if the response exceeds…

• namespace

  Optional Namespace to retrieve the events from. If not provided, will list events from all namespaces

• namespaces_list

  List all the Kubernetes namespaces in the current cluster. Use limit and continue to retrieve a large list one page at…

• projects_list

  List all the OpenShift projects in the current cluster. Use limit and continue to retrieve a large list one page at a…

• nodes_log

  Get logs from a Kubernetes node (kubelet, kube-proxy, or other system logs).

• query

  (required) - query specifies services(s) or files from which to return logs (required).

• nodes_stats_summary

  Get detailed resource usage statistics from a Kubernetes node via the kubelet's Summary API.

• nodes_top

  List the resource consumption (CPU and memory) as recorded by the Kubernetes Metrics Server for the specified…

• label_selector

  Kubernetes label selector (e.g. 'node-role.kubernetes.io/worker=') to filter nodes by label (Optional, only applicable…

• pods_list

  List all the Kubernetes pods in the current cluster from all namespaces.

• pods_list_in_namespace

  List all the Kubernetes pods in the specified namespace in the current cluster.

• pods_get

  Get a Kubernetes Pod in the current or provided namespace with the provided name

• pods_delete

  Delete a Kubernetes Pod in the current or provided namespace with the provided name

• pods_top

  List the resource consumption (CPU and memory) as recorded by the Kubernetes Metrics Server for the specified…

• all_namespaces

  If true, list the resource consumption for all Pods in all namespaces.

• pods_exec

  Execute a command in a Kubernetes Pod (shell access, run commands in container) in the current or provided namespace…

• command

  (required) - Command to execute in the Pod container. The first item is the command to be run, and the rest are the…

• container

  Name of the Pod container where the command will be executed (Optional)

• pods_log

  Get the logs of a Kubernetes Pod in the current or provided namespace with the provided name

• previous

  Return previous terminated container logs (Optional)

• tail

  Number of lines to retrieve from the end of the logs (Optional, default: 100)

• pods_run

  Run a Kubernetes Pod in the current or provided namespace with the provided container image and optional name

• image

  (required) - Container Image to run in the Pod

• port

  TCP/IP port to expose from the Pod container (Optional, no port exposed if not provided)

• resources_list

  List Kubernetes resources and objects in the current cluster by providing their apiVersion and kind and optionally the…

• kind

  (required) - kind of the resources (examples of valid kind are: Pod, Service, Deployment, Ingress)

• resources_get

  Get a Kubernetes resource in the current cluster by providing its apiVersion, kind, optionally the namespace, and its…

• resources_create_or_update

  Create or update a Kubernetes resource via Server-Side Apply. The manifest is the complete desired state: any field…

• resource

  (required) - Complete YAML or JSON representation of the Kubernetes resource (full desired state, not a partial…

• resources_delete

  Delete a Kubernetes resource in the current cluster by providing its apiVersion, kind, optionally the namespace, and…

• resources_scale

  Get or update the scale of a Kubernetes resource in the current cluster by providing its apiVersion, kind, name, and…

• scale

  Optional scale to update the resources scale to. If not provided, will return the current scale of the resource, and…

• helm_install

  Install (deploy) a Helm chart to create a release in the current or provided namespace

• chart

  (required) - Chart reference to install (for example: stable/grafana, oci://ghcr.io/nginxinc/charts/nginx-ingress)

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

• containers
• context
• kubernetes
• mcp
• model
• openshift
• protocol
• modelcontextprotocol
• kubernetes-mcp