Tool: kube_get
Gets one or more Kubernetes resources from a cluster. Resources can be filtered by type, name, namespace, and label selectors. Returns the resources in YAML format. This is similar to running kubectl get
.
The following sample demonstrate how to use curl
to invoke the kube_get
MCP tool.
| Curl Request |
|---|
curl --location 'https://container.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/call", "params": { "name": "kube_get", "arguments": { // provide these details according to the tool' s MCP specification } } , "jsonrpc" : "2.0" , "id" : 1 } ' |
Input Schema
Request for retrieving Kubernetes resources.
GetK8SResourceRequest
| JSON representation |
|---|
{
"parent"
:
string
,
"resourceType"
:
string
,
"name"
:
string
,
"namespace"
:
string
,
"labelSelector"
:
string
,
"fieldSelector"
:
string
,
"customColumns"
:
string
,
"outputFormat"
:
enum (
|
| Fields | |
|---|---|
parent
|
Required. The cluster, which owns this collection of resources. Format: projects/{project}/locations/{location}/clusters/{cluster} |
resourceType
|
Required. The type of resource to retrieve. Kubernetes resource/kind name in singular form, lower case. e.g. "pod", "deployment", "service". |
name
|
Optional. The name of the resource to retrieve. If not specified, all resources of the given type are returned. |
namespace
|
Optional. The namespace of the resource. If not specified, all namespaces are searched. |
labelSelector
|
Optional. A label selector to filter resources. |
fieldSelector
|
Optional. A field selector to filter resources. |
customColumns
|
Optional. The field mask to specify columns to display. Use a single "*" to get all fields. When both custom_columns and output_format are specified, output_format is ignored. This is a comma-separated list of fully qualified names of fields. Example: |
outputFormat
|
Optional. The output format. One of: (table, wide, yaml, json). If not specified, defaults to table. When both custom_columns and output_format are specified, output_format is ignored. |
FieldMask
| JSON representation |
|---|
{ "paths" : [ string ] } |
| Fields | |
|---|---|
paths[]
|
The set of field mask paths. |
Output Schema
Response for retrieving Kubernetes resources.
GetK8SResourceResponse
| JSON representation |
|---|
{ "output" : string } |
| Fields | |
|---|---|
output
|
The output of the command in the requested format. It may contain resources in YAML or JSON format, or a table in plain text, or errors. |
Tool Annotations
Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌

