MCP Tools - cturner8/kube-mcp GitHub Wiki

This page documents all available tools exposed by the kube-mcp MCP server for interacting with Kubernetes clusters.

Most tools require Kubernetes API permissions, ensure RBAC access has been configured appropriately. See RBAC and Configuration Options for additional info.

Default Tool Access

By default, the following tools are disabled to prevent exposure of sensitive data:

  • get_config_map
  • get_secret
  • list_config_maps
  • list_secrets

To enable these tools, update the mcp.tools.disallowed and rbac.rules configuration. See Configuration Options and RBAC for details.

Tools Reference

get_config_map

⚠️ Disabled by default

Get a config map in the Kubernetes cluster.

Arguments:

  • name (string): The name of the config map
  • namespace (string): The namespace of the config map

Example prompt:

"Get the config map named 'web-api-config' in the 'production' namespace"

get_deployment

Get a deployment in the Kubernetes cluster.

Arguments:

  • name (string): The name of the deployment
  • namespace (string): The namespace of the deployment

Example prompt:

"Show me the 'web-api' deployment in the 'production' namespace"

get_ingress

Get an ingress in the Kubernetes cluster.

Arguments:

  • name (string): The name of the ingress
  • namespace (string): The namespace of the ingress

Example prompt:

"Get the ingress called 'web-api' in namespace 'production'"

get_namespace

Get a namespace in the Kubernetes cluster.

Arguments:

  • name (string): The name of the namespace

Example prompt:

"Show me details of the 'production' namespace"

get_node

Get a node in the Kubernetes cluster.

Arguments:

  • name (string): The name of the node

Example prompt:

"Get information about node 'worker-1'"

get_persistent_volume

Get a persistent volume in the Kubernetes cluster.

Arguments:

  • name (string): The name of the persistent volume

Example prompt:

"Show me the persistent volume 'web-api-data-pv'"

get_persistent_volume_claim

Get a persistent volume claim in the Kubernetes cluster.

Arguments:

  • name (string): The name of the pvc
  • namespace (string): The namespace of the pvc

Example prompt:

"Get the PVC 'web-api-storage' in the 'production' namespace"

get_pod

Get a pod in the Kubernetes cluster.

Arguments:

  • name (string): The name of the pod
  • namespace (string): The namespace of the pod

Example prompt:

"Show me the pod 'web-api' in the 'production' namespace"

get_secret

⚠️ Disabled by default

Get a secret in the Kubernetes cluster.

Arguments:

  • name (string): The name of the secret
  • namespace (string): The namespace of the secret

Example prompt:

"Get the secret 'web-api-credentials' in the 'production' namespace"

get_server_version

Get the Kubernetes API server version details.

Arguments: None

Example prompt:

"What version of Kubernetes is this cluster running?"

get_service

Get a service in the Kubernetes cluster.

Arguments:

  • name (string): The name of the service
  • namespace (string): The namespace of the service

Example prompt:

"Show me the service 'web-api' in the 'production' namespace"

list_config_maps

⚠️ Disabled by default

List the config maps in the Kubernetes cluster.

Arguments:

  • namespace (string, optional): The namespace of the config maps

Example prompt:

"List all config maps in the 'production' namespace"

list_deployments

List the deployments in the Kubernetes cluster.

Arguments:

  • namespace (string, optional): The namespace of the deployments

Example prompt:

"What deployments are running in the 'production' namespace?"

list_events

List the events in the Kubernetes cluster.

Arguments:

  • namespace (string, optional): The namespace of the events

Example prompt:

"Show me recent events in the 'production' namespace"

list_ingresses

List the ingresses in the Kubernetes cluster.

Arguments:

  • namespace (string, optional): The namespace of the ingress(es)

Example prompt:

"List all ingresses across the cluster"

list_namespaces

List the namespaces in the Kubernetes cluster.

Arguments: None

Example prompt:

"What namespaces exist in this cluster?"

list_nodes

List the nodes in the Kubernetes cluster.

Arguments: None

Example prompt:

"Show me all nodes in the cluster"

list_persistent_volume_claims

List the persistent volume claims in the Kubernetes cluster.

Arguments:

  • namespace (string, optional): The namespace of the pvcs

Example prompt:

"List all PVCs in the 'production' namespace"

list_persistent_volumes

List the persistent volumes in the Kubernetes cluster.

Arguments: None

Example prompt:

"What persistent volumes are available in the cluster?"

list_pods

List the pods in the Kubernetes cluster.

Arguments:

  • namespace (string, optional): The namespace of the pods

Example prompt:

"List all pods in the 'production' namespace"

list_secrets

⚠️ Disabled by default

List the secrets in the Kubernetes cluster.

Arguments:

  • namespace (string, optional): The namespace of the secrets

Example prompt:

"What secrets exist in the 'production' namespace?"

list_services

List the services in the Kubernetes cluster.

Arguments:

  • namespace (string, optional): The namespace of the services

Example prompt:

"List all services running in the cluster"