REST Resource: projects.locations.mcpServers.mcpTools

Resource: McpTool

Message describing McpTool object

JSON representation 
{
  "name": string,
  "displayName": string,
  "description": string,
  "mcpServerUrls": [
    string
  ],
  "inputSchema": {
    object
  },
  "outputSchema": {
    object
  },
  "annotations": {
    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
displayName

string

Optional. A human-readable name for the tool, suitable for display.
description

string

A human-readable description of the tool's functionality.
mcpServerUrls[]

string

Automatically populated reference to MCP Server. Helpful when multiple tools are requested across different MCP Servers.
inputSchema

object (Struct format)

A JSON Schema object defining the expected parameters for invoking the tool.
outputSchema

object (Struct format)

Optional. A JSON Schema object defining the expected structure of the tool's output.
annotations

object (Struct format)

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.

Methods

get

 Gets a single McpTool.

list

 Lists McpTools in a given McpServer.