Package google.cloud.apiregistry.v1beta

Index

• CloudApiRegistry (interface)
• GetMcpServerRequest (message) (deprecated)
• GetMcpToolRequest (message) (deprecated)
• ListMcpServersRequest (message) (deprecated)
• ListMcpServersResponse (message) (deprecated)
• ListMcpToolsRequest (message) (deprecated)
• ListMcpToolsResponse (message) (deprecated)
• McpServer (message) (deprecated)
• McpTool (message) (deprecated)
• State (enum)

CloudApiRegistry

The Cloud API Registry service provides a central registry for managing API Data.

GetMcpServer

This item is deprecated! rpc GetMcpServer(GetMcpServerRequest) returns (McpServer) Deprecated: The GetMcpServer method is deprecated and will be removed in a future release. Use AgentRegistry.GetMcpServer instead. For more information, see: https://docs.cloud.google.com/agent-registry/reference/rpc Gets a single McpServer. Authorization scopes Requires the following OAuth scope: https://www.googleapis.com/auth/cloud-platform For more information, see the Authentication Overview. IAM Permissions Requires the following IAM permission on the name resource: cloudapiregistry.mcpServers.get For more information, see the IAM documentation.

GetMcpTool

This item is deprecated! rpc GetMcpTool(GetMcpToolRequest) returns (McpTool) Deprecated: The GetMcpTool method is deprecated and will be removed in a future release. For similar functionality, you can use Agent Registry. Note: Agent Registry does not treat tools as a separate collection. To view the tools exposed by an MCP server, use the ListMcpServers or GetMcpServer methods in the Agent Registry API. For more information, see: https://docs.cloud.google.com/agent-registry/reference/rpc Gets a single McpTool. Authorization scopes Requires the following OAuth scope: https://www.googleapis.com/auth/cloud-platform For more information, see the Authentication Overview. IAM Permissions Requires the following IAM permission on the name resource: cloudapiregistry.mcpTools.get For more information, see the IAM documentation.

ListMcpServers

This item is deprecated! rpc ListMcpServers(ListMcpServersRequest) returns (ListMcpServersResponse) Deprecated: The ListMcpServers method is deprecated and will be removed in a future release. Use AgentRegistry. ListMcpServers instead. Note: AgentRegistry only lists MCP servers for service APIs that are enabled in a project. For more information, see: https://docs.cloud.google.com/agent-registry/reference/rpc Lists McpServers in a given Project. Authorization scopes Requires the following OAuth scope: https://www.googleapis.com/auth/cloud-platform For more information, see the Authentication Overview. IAM Permissions Requires the following IAM permission on the parent resource: cloudapiregistry.mcpServers.list For more information, see the IAM documentation.

ListMcpTools

This item is deprecated! rpc ListMcpTools(ListMcpToolsRequest) returns (ListMcpToolsResponse) Deprecated: The ListMcpTools method is deprecated and will be removed in a future release. For similar functionality, you can use Agent Registry. Note: AgentRegistry only lists MCP servers for service APIs that are enabled in a project. For more information, see: https://docs.cloud.google.com/agent-registry/reference/rpc Lists McpTools in a given McpServer. Authorization scopes Requires the following OAuth scope: https://www.googleapis.com/auth/cloud-platform For more information, see the Authentication Overview. IAM Permissions Requires the following IAM permission on the parent resource: cloudapiregistry.mcpTools.list For more information, see the IAM documentation.

GetMcpServerRequest

This item is deprecated!

Deprecated: This resource is no longer supported as GetMcpServer method is deprecated and will be removed in a future release. Use AgentRegistry. GetMcpServer instead. For more information, see: https://docs.cloud.google.com/agent-registry/reference/rpc Message for getting a McpServer

Fields
name	string Required. Name of the resource Format: projects/{project}/locations/{location}/mcpServers/{mcp_server}

GetMcpToolRequest

This item is deprecated!

Deprecated: This resource is no longer supported as GetMcpTool method is deprecated and will be removed in a future release. For similar functionality, you can use Agent Registry. Note: Agent Registry does not treat tools as a separate collection. To view the tools exposed by an MCP server, use the ListMcpServers or GetMcpServer methods in the Agent Registry API. For more information, see: https://docs.cloud.google.com/agent-registry/reference/rpc Message for getting a McpTool

Fields
name	string Required. Name of the resource Format: projects/{project}/locations/{location}/mcpServers/{mcp_server}/mcpTools/{mcp_tool}

ListMcpServersRequest

This item is deprecated!

Deprecated: This resource is no longer supported as ListMcpServers method is deprecated and will be removed in a future release. Use AgentRegistry. ListMcpServers instead. Note: AgentRegistry only lists MCP servers for service APIs that are enabled in a project. For more information, see: https://docs.cloud.google.com/agent-registry/reference/rpc Message for requesting list of McpServers

Fields
parent	string Required. Parent value for ListMcpServersRequest
page_size	int32 Optional. Requested page size. Server may return fewer items than requested. If unspecified, at most 50 items will be returned. The maximum value is 100; values above 100 will be coerced to 100.
page_token	string Optional. A token identifying a page of results the server should return.
filter	string Optional. An expression that filters the results. For syntax, see https://google.aip.dev/160.
order_by	string Optional. A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. For syntax, see https://google.aip.dev/132#ordering.

ListMcpServersResponse

This item is deprecated!

Deprecated: This resource is no longer supported as ListMcpServers method is deprecated and will be removed in a future release. Use AgentRegistry. ListMcpServers instead. Note: AgentRegistry only lists MCP servers for service APIs that are enabled in a project. For more information, see: https://docs.cloud.google.com/agent-registry/reference/rpc Message for response to listing McpServers

Fields
mcp_servers[]	McpServer The list of McpServer
next_page_token	string A token identifying a page of results the server should return.
unreachable[]	string Unordered list. Locations that could not be reached.

ListMcpToolsRequest

This item is deprecated!

Deprecated: This resource is no longer supported as ListMcpTools method is deprecated and will be removed in a future release. For similar functionality, you can use Agent Registry. Note: Agent Registry does not treat tools as a separate collection. To view the tools exposed by an MCP server, use the ListMcpServers or GetMcpServer methods in the Agent Registry API. For more information, see: https://docs.cloud.google.com/agent-registry/reference/rpc Message for requesting list of McpTools

Fields
parent	string Required. Parent value for ListMcpToolsRequest
page_size	int32 Optional. Requested page size. Server may return fewer items than requested. If unspecified, at most 50 items will be returned. The maximum value is 100; values above 100 will be coerced to 100.
page_token	string Optional. A token identifying a page of results the server should return.
filter	string Optional. An expression that filters the results. For syntax, see https://google.aip.dev/160.
order_by	string Optional. A comma-separated list of fields to order by, sorted in ascending order. Use "desc" after a field name for descending. For syntax, see https://google.aip.dev/132#ordering.

ListMcpToolsResponse

This item is deprecated!

Deprecated: This resource is no longer supported as ListMcpTools method is deprecated and will be removed in a future release. For similar functionality, you can use Agent Registry. Note: Agent Registry does not treat tools as a separate collection. To view the tools exposed by an MCP server, use the ListMcpServers or GetMcpServer methods in the Agent Registry API. For more information, see: https://docs.cloud.google.com/agent-registry/reference/rpc Message for response to listing McpTools

Fields
mcp_tools[]	McpTool The list of McpTool
next_page_token	string A token identifying a page of results the server should return.
unreachable[]	string Unordered list. Locations that could not be reached.

McpServer

This item is deprecated!

Deprecated: This resource is no longer supported as GetMcpServer method is deprecated and will be removed in a future release. Use AgentRegistry.GetMcpServer instead. For more information, see: https://docs.cloud.google.com/agent-registry/reference/rpc. Represents an MCP Server. MCP Servers act as endpoints that expose a collection of tools that can be invoked by agents.

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
display_name	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	Struct 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	State Output only. The state of the MCP Server.

McpTool

This item is deprecated!

Deprecated: This resource is no longer supported as GetMcpTool method is deprecated and will be removed in a future release. For similar functionality, you can use Agent Registry. Note: Agent Registry does not treat tools as a separate collection. To view the tools exposed by an MCP server, use the ListMcpServers or GetMcpServer methods in the Agent Registry API. For more information, see: https://docs.cloud.google.com/agent-registry/reference/rpc. Message describing McpTool object

Fields
name	string Identifier. The resource name of the McpTool. Format: projects/{project}/locations/{location}/mcpServers/{mcp_server}/mcpTools/{mcp_tool}. Example: projects/12345/locations/us-central1/mcpServers/google:bigquery.googleapis.com:mcp/mcpTools/insert_job for 1p projects/12345/locations/us-central1/mcpServers/apphub:starbucks/mcpTools/order_pizza for 2p
display_name	string Optional. A human-readable name for the tool, suitable for display.
description	string A human-readable description of the tool's functionality.
mcp_server_urls[]	string Automatically populated reference to MCP Server. Helpful when multiple tools are requested across different MCP Servers.
input_schema	Struct A JSON Schema object defining the expected parameters for invoking the tool.
output_schema	Struct Optional. A JSON Schema object defining the expected structure of the tool's output.
annotations	Struct Optional key-value object that allows developers to provide additional information regarding tool properties, behavior, and usage best practices. Annotations or tags to facilitate semantic search across tools ("semantic tags") are not in the MVP scope. When implemented, the first set of supported annotations will likely be the standard, predefined annotations from the open-source MCP spec. These include: - title: A human-readable title for the tool, useful for UI display. - readOnlyHint: If true, indicates the tool does not modify its environment. - destructiveHint: If true, the tool may perform destructive updates (only meaningful when readOnlyHint is false). - idempotentHint: If true, calling the tool repeatedly with the same arguments has no additional effect (only meaningful when readOnlyHint is false). - openWorldHint: If true, the tool may interact with an "open world" of external entities.

State

The state of McpServer resource.

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