MCP Tools Reference: container.googleapis.com

Tool: list_operations

Lists GKE operations in a given project and location. Location can be a region, zone, or '-' for all locations.

The following sample demonstrate how to use curl to invoke the list_operations 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": "list_operations",
    "arguments": {
      // provide these details according to the tool's MCP specification
    }
  },
  "jsonrpc": "2.0",
  "id": 1
}'

Input Schema

MCPListOperationsRequest lists operations.

MCPListOperationsRequest

JSON representation 
{
  "parent": string
}
Fields
parent

string

Required. The parent (project and location) where the operations will be listed. Specified in the format projects/*/locations/*. Location "-" matches all zones and all regions.

Output Schema

ListOperationsResponse is the result of ListOperationsRequest.

ListOperationsResponse

JSON representation 
{
  "operations": [
    {
      object (Operation)
    }
  ],
  "missingZones": [
    string
  ]
}
Fields
operations[]

object (Operation)

A list of operations in the project in the specified zone.
missingZones[]

string

If any zones are listed here, the list of operations returned may be missing the operations from those zones.

Operation

JSON representation 
{
  "name": string,
  "zone": string,
  "operationType": enum (Type),
  "status": enum (Status),
  "detail": string,
  "statusMessage": string,
  "selfLink": string,
  "targetLink": string,
  "location": string,
  "startTime": string,
  "endTime": string,
  "progress": {
    object (OperationProgress)
  },
  "clusterConditions": [
    {
      object (StatusCondition)
    }
  ],
  "nodepoolConditions": [
    {
      object (StatusCondition)
    }
  ],
  "error": {
    object (google.rpc.Status)
  }
}
Fields
name

string

Output only. The server-assigned ID for the operation.
zone
(deprecated)

string

Output only. The name of the Google Compute Engine zone in which the operation is taking place. This field is deprecated, use location instead.
operationType

enum (Type)

Output only. The operation type.
status

enum (Status)

Output only. The current status of the operation.
detail

string

Output only. Detailed operation progress, if available.
statusMessage
(deprecated)

string

Output only. If an error has occurred, a textual description of the error. Deprecated. Use the field error instead.
selfLink

string

Output only. Server-defined URI for the operation. Example: https://container.googleapis.com/v1alpha1/projects/123/locations/us-central1/operations/operation-123.
targetLink

string

Output only. Server-defined URI for the target of the operation. The format of this is a URI to the resource being modified (such as a cluster, node pool, or node). For node pool repairs, there may be multiple nodes being repaired, but only one will be the target.

Examples:

-

https://container.googleapis.com/v1/projects/123/zones/us-central1-c/clusters/my-cluster/nodePools/my-np/node/my-node
location

string

Output only. The name of the Google Compute Engine zone or region in which the cluster resides.
startTime

string

Output only. The time the operation started, in RFC3339 text format.
endTime

string

Output only. The time the operation completed, in RFC3339 text format.
progress

object (OperationProgress)

Output only. Progress information for an operation.
clusterConditions[]
(deprecated)

object (StatusCondition)

Which conditions caused the current cluster state. Deprecated. Use field error instead.
nodepoolConditions[]
(deprecated)

object (StatusCondition)

Which conditions caused the current node pool state. Deprecated. Use field error instead.
error

object (google.rpc.Status)

The error result of the operation in case of failure.

OperationProgress

JSON representation 
{
  "name": string,
  "status": enum (Status),
  "metrics": [
    {
      object (Metric)
    }
  ],
  "stages": [
    {
      object (OperationProgress)
    }
  ]
}
Fields
name

string

A non-parameterized string describing an operation stage. Unset for single-stage operations.
status

enum (Status)

Status of an operation stage. Unset for single-stage operations.
metrics[]

object (Metric)

Progress metric bundle, for example: metrics: [{name: "nodes done", int_value: 15}, {name: "nodes total", int_value: 32}] or metrics: [{name: "progress", double_value: 0.56}, {name: "progress scale", double_value: 1.0}]
stages[]

object (OperationProgress)

Substages of an operation or a stage.

Metric

JSON representation 
{
  "name": string,

  // Union field value can be only one of the following:
  "intValue": string,
  "doubleValue": number,
  "stringValue": string
  // End of list of possible types for union field value.
}
Fields
name

string

Required. Metric name, e.g., "nodes total", "percent done".
Union field value. Strictly one of the values is required. value can be only one of the following:
intValue

string (int64 format)

For metrics with integer value.
doubleValue

number

For metrics with floating point value.
stringValue

string

For metrics with custom values (ratios, visual progress, etc.).

StatusCondition

JSON representation 
{
  "code": enum (Code),
  "message": string,
  "canonicalCode": enum (google.rpc.Code)
}
Fields
code
(deprecated)

enum (Code)

Machine-friendly representation of the condition Deprecated. Use canonical_code instead.
message

string

Human-friendly representation of the condition
canonicalCode

enum (google.rpc.Code)

Canonical code of the condition.

Status

JSON representation 
{
  "code": integer,
  "message": string,
  "details": [
    {
      "@type": string,
      field1: ...,
      ...
    }
  ]
}
Fields
code

integer

The status code, which should be an enum value of google.rpc.Code.
message

string

A developer-facing error message, which should be in English. Any user-facing error message should be localized and sent in the google.rpc.Status.details field, or localized by the client.
details[]

object

A list of messages that carry the error details. There is a common set of message types for APIs to use.

An object containing fields of an arbitrary type. An additional field "@type" contains a URI identifying the type. Example: { "id": 1234, "@type": "types.example.com/standard/id" }.

Any

JSON representation 
{
  "typeUrl": string,
  "value": string
}
Fields
typeUrl

string

A URL/resource name that uniquely identifies the type of the serialized protocol buffer message. This string must contain at least one "/" character. The last segment of the URL's path must represent the fully qualified name of the type (as in path/google.protobuf.Duration). The name should be in a canonical form (e.g., leading "." is not accepted).

In practice, teams usually precompile into the binary all types that they expect it to use in the context of Any. However, for URLs which use the scheme http, https, or no scheme, one can optionally set up a type server that maps type URLs to message definitions as follows:

  • If no scheme is provided, https is assumed.
  • An HTTP GET on the URL must yield a google.protobuf.Type value in binary format, or produce an error.
  • Applications are allowed to cache lookup results based on the URL, or have them precompiled into a binary to avoid any lookup. Therefore, binary compatibility needs to be preserved on changes to types. (Use versioned type names to manage breaking changes.)

Note: this functionality is not currently available in the official protobuf release, and it is not used for type URLs beginning with type.googleapis.com. As of May 2023, there are no widely used type server implementations and no plans to implement one.

Schemes other than http, https (or the empty scheme) might be used with implementation specific semantics.
value

string (bytes format)

Must be a valid serialized protocol buffer of the above specified type.

A base64-encoded string.

Tool Annotations

Destructive Hint: ❌ | Idempotent Hint: ✅ | Read Only Hint: ✅ | Open World Hint: ❌