Package google.cloud.apiregistry.v1beta

Index

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

CloudApiRegistry

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

GetMcpServer
rpc GetMcpServer(GetMcpServerRequest) returns (McpServer) 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
rpc GetMcpTool(GetMcpToolRequest) returns (McpTool) 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

rpc ListMcpServers(ListMcpServersRequest) returns (ListMcpServersResponse) 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

rpc ListMcpTools(ListMcpToolsRequest) returns (ListMcpToolsResponse) 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

Message for getting a McpServer

Fields
name	string Required. Name of the resource

GetMcpToolRequest

Message for getting a McpTool

Fields
name	string Required. Name of the resource

ListMcpServersRequest

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, server will pick an appropriate default.
page_token	string Optional. A token identifying a page of results the server should return.
filter	string Optional. Filtering results
order_by	string Optional. Hint for how to order the results

ListMcpServersResponse

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 Locations that could not be reached.

ListMcpToolsRequest

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, server will pick an appropriate default.
page_token	string Optional. A token identifying a page of results the server should return.
filter	string Optional. Filtering results
order_by	string Optional. Hint for how to order the results

ListMcpToolsResponse

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 Locations that could not be reached.

McpServer

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

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.