mcp_servers

Creates, updates, deletes, gets or lists a mcp_servers resource.

Overview

Name	mcp_servers
Type	Resource
Id	google.agentregistry.mcp_servers

Fields

The following fields are returned by SELECT queries:

get

Name	Datatype	Description
name	string	Identifier. The resource name of the MCP Server. Format: projects/{project}/locations/{location}/mcpServers/{mcp_server}.
attributes	object	Output only. Attributes of the MCP Server. Valid values: * agentregistry.googleapis.com/system/RuntimeIdentity: {"principal": "principal://..."} - the runtime identity associated with the MCP Server. * agentregistry.googleapis.com/system/RuntimeReference: {"uri": "//..."} - the URI of the underlying resource hosting the MCP Server, for example, the GKE Deployment.
createTime	string (google-datetime)	Output only. Create time.
description	string	Output only. The description of the MCP Server.
displayName	string	Output only. The display name of the MCP Server.
interfaces	array	Output only. The connection details for the MCP Server.
mcpServerId	string	Output only. A stable, globally unique identifier for MCP Servers.
tools	array	Output only. Tools provided by the MCP Server.
updateTime	string (google-datetime)	Output only. Update time.

list

Name	Datatype	Description
name	string	Identifier. The resource name of the MCP Server. Format: projects/{project}/locations/{location}/mcpServers/{mcp_server}.
attributes	object	Output only. Attributes of the MCP Server. Valid values: * agentregistry.googleapis.com/system/RuntimeIdentity: {"principal": "principal://..."} - the runtime identity associated with the MCP Server. * agentregistry.googleapis.com/system/RuntimeReference: {"uri": "//..."} - the URI of the underlying resource hosting the MCP Server, for example, the GKE Deployment.
createTime	string (google-datetime)	Output only. Create time.
description	string	Output only. The description of the MCP Server.
displayName	string	Output only. The display name of the MCP Server.
interfaces	array	Output only. The connection details for the MCP Server.
mcpServerId	string	Output only. A stable, globally unique identifier for MCP Servers.
tools	array	Output only. Tools provided by the MCP Server.
updateTime	string (google-datetime)	Output only. Update time.

Methods

The following methods are available for this resource:

Name	Accessible by	Required Params	Optional Params	Description
get	select	projectsId, locationsId, mcpServersId		Gets details of a single McpServer.
list	select	projectsId, locationsId	filter, pageToken, orderBy, pageSize	Lists McpServers in a given project and location.
search	exec	projectsId, locationsId		Searches McpServers in a given project and location.

Parameters

Parameters can be passed in the WHERE clause of a query. Check the Methods section to see which parameters are required or optional for each operation.

Name	Datatype	Description
locationsId	string
mcpServersId	string
projectsId	string
filter	string
orderBy	string
pageSize	integer (int32)
pageToken	string

SELECT examples

get

Gets details of a single McpServer.

SELECT
name,
attributes,
createTime,
description,
displayName,
interfaces,
mcpServerId,
tools,
updateTime
FROM google.agentregistry.mcp_servers
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND mcpServersId = '{{ mcpServersId }}' -- required
;

list

Lists McpServers in a given project and location.

SELECT
name,
attributes,
createTime,
description,
displayName,
interfaces,
mcpServerId,
tools,
updateTime
FROM google.agentregistry.mcp_servers
WHERE projectsId = '{{ projectsId }}' -- required
AND locationsId = '{{ locationsId }}' -- required
AND filter = '{{ filter }}'
AND pageToken = '{{ pageToken }}'
AND orderBy = '{{ orderBy }}'
AND pageSize = '{{ pageSize }}'
;

Lifecycle Methods

search

Searches McpServers in a given project and location.

EXEC google.agentregistry.mcp_servers.search 
@projectsId='{{ projectsId }}' --required, 
@locationsId='{{ locationsId }}' --required 
@@json=
'{
"pageToken": "{{ pageToken }}", 
"searchString": "{{ searchString }}", 
"pageSize": {{ pageSize }}
}'
;