# MCP Reference: container.googleapis.com

This is an MCP server which provides tools to manage Google Kubernetes Engine (GKE) clusters and their Kubernetes resources.

A [Model Context Protocol (MCP) server](https://modelcontextprotocol.io/docs/learn/server-concepts) acts as a proxy between an external service that provides context, data, or capabilities to a Large Language Model (LLM) or AI application. MCP servers connect AI applications to external systems such as databases and web services, translating their responses into a format that the AI application can understand.

### Server Setup


You must [enable MCP servers](https://docs.cloud.google.com/mcp/enable-disable-mcp-servers) and [set up authentication](https://docs.cloud.google.com/mcp/authenticate-mcp) before use. For more information about using Google and Google Cloud remote MCP servers, see [Google Cloud MCP servers overview](https://docs.cloud.google.com/mcp/overview).

### Server Endpoints

An MCP service endpoint is the network address and communication interface (usually a URL) of the MCP server that an AI application (the Host for the MCP client) uses to establish a secure, standardized connection. It is the point of contact for the LLM to request context, call a tool, or access a resource. Google MCP endpoints can be global or regional.

The Kubernetes Engine API MCP server offers the following MCP toolset endpoints:

- https://container.googleapis.com/mcp
- https://container.googleapis.com/mcp/read-only
- https://container.googleapis.com/mcp/delete-tools

## MCP Tools

An [MCP tool](https://modelcontextprotocol.io/legacy/concepts/tools) is a function or executable capability that an MCP server exposes to a LLM or AI application to perform an action in the real world. Toolsets are a group of tools that are useful for a specific task. Using toolsets can help your agent perform better because it decreases the number of tools available to your agent.

### Toolsets

The container.googleapis.com MCP server has the following toolsets:

| MCP Toolsets |||
| Endpoint | Description | Tools |
|---|---|---|
| /mcp | This toolset provides both read-only and mutating tools to list, get, create, update, and patch GKE clusters, operations, node pools, and their Kubernetes resources, excluding delete clusters and node pools. | ` - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/apply_k8s_manifest - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/cancel_operation - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/check_k8s_auth - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/create_cluster - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/create_node_pool - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/delete_k8s_resource - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/describe_k8s_resource - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_cluster - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_k8s_cluster_info - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_k8s_logs - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_k8s_resource - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_k8s_rollout_status - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_k8s_version - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_node_pool - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_operation - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/list_clusters - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/list_k8s_api_resources - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/list_k8s_events - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/list_node_pools - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/list_operations - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/patch_k8s_resource - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/update_cluster - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/update_node_pool ` |
| /mcp/read-only | This toolset provides read-only tools to list and get information about GKE clusters, operations, node pools, and their Kubernetes resources. | ` - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/check_k8s_auth - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/describe_k8s_resource - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_cluster - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_k8s_cluster_info - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_k8s_logs - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_k8s_resource - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_k8s_rollout_status - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_k8s_version - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_node_pool - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/get_operation - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/list_clusters - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/list_k8s_api_resources - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/list_k8s_events - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/list_node_pools - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/list_operations ` |
| /mcp/delete-tools | This toolset provides tools to delete GKE clusters and node pools. | ` - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/delete_cluster - https://docs.cloud.google.com/kubernetes-engine/docs/reference/mcp/tools_list/delete_node_pool ` |

### Get MCP tool specifications


To get the MCP tool specifications for all tools in an MCP server, use the `tools/list` method. The following example demonstrates how to use `curl` to list all tools and their specifications currently available within the MCP server.

| Curl Request |
|---|
| ```bash curl --location 'https://container.googleapis.com/mcp' \ --header 'content-type: application/json' \ --header 'accept: application/json, text/event-stream' \ --data '{ "method": "tools/list", "jsonrpc": "2.0", "id": 1 }' ``` |