REST Resource: projects.locations.mcpServers

Resource: McpServer

Represents an MCP Server. MCP Servers act as endpoints that expose a collection of tools that can be invoked by agents.

JSON representation
{
  "name": string,
  "displayName": string,
  "description": string,
  "urls": [
    string
  ],
  "capabilities": {
    object
  },
  "state": enum (State)
}
Fields
name

string

Identifier. The resource name of the MCP Server. Format: projects/{project}/locations/{location}/mcpServers/{mcp_server}. Example: projects/12345/locations/us-central1/mcpServers/google:bigquery.googleapis.com:mcp for 1p projects/12345/locations/us-central1/mcpServers/apphub:starbucks for 2p

displayName

string

Optional. A human readable name for the MCP server.

description

string

Optional. A human-readable description of the MCP Server's functionality.

urls[]

string

The base URL of the MCP server. Example: [geolocation.googleapis.com/mcp].

capabilities

object (Struct format)

The capabilities that a server may support. Known capabilities defined in https://modelcontextprotocol.io/specification/2025-06-18/schema#servercapabilities and additional capabilities defined by the servers.

state

enum (State)

Output only. The state of the MCP Server.

State

The state of McpServer resource.

Enums
STATE_UNSPECIFIED The McpServer state is unspecified.
ENABLED The McpServer is enabled.
DISABLED The McpServer is disabled.

Methods

get

Gets a single McpServer.

list

Lists McpServers in a given Project.