gcloud agent-registry mcp-servers search

NAME
gcloud agent-registry mcp-servers search - search mcpServers
SYNOPSIS
gcloud agent-registry mcp-servers search --location=LOCATION [--page-size=PAGE_SIZE] [--page-token=PAGE_TOKEN] [--search-string=SEARCH_STRING] [GCLOUD_WIDE_FLAG …]
DESCRIPTION
search mcpServers
EXAMPLES
To search all mcpServers, run: 
gcloud agent-registry mcp-servers search
REQUIRED FLAGS
Location resource - Parent value for SearchMcpServersRequest. Format: projects/{project}/locations/{location}. This represents a Cloud resource. (NOTE) Some attributes are not given arguments in this group but can be set in other ways.

To set the project attribute:

  • provide the argument --location on the command line with a fully specified name;
  • provide the argument --project on the command line;
  • set the property core/project.

This must be specified.

--location=LOCATION
ID of the location or fully qualified identifier for the location.

To set the location attribute:

  • provide the argument --location on the command line.
OPTIONAL FLAGS
--page-size=PAGE_SIZE
The maximum number of MCP Servers to return. The service may return fewer than this value. If unspecified, at most 20 MCP Servers will be returned. The maximum value is 100; values above 100 will be coerced to 100.
--page-token=PAGE_TOKEN
A page token, received from a previous SearchMcpServers call.
--search-string=SEARCH_STRING
Search criteria used to select the MCP Servers to return. If no search criteria is specified then all accessible MCP Servers will be returned.

Search expressions can be used to restrict results based upon searchable fields, where the operators can be used along with the suffix wildcard symbol *. See instructions for more details.

Allowed operators: =, :, NOT, AND, OR, and ().

Examples:

  • mcpServerId="urn:mcp:projects-123:projects:123:locations:us-central1:agentregistry:services:service-id" to find the MCP Server with the specified MCP Server ID.
  • name:important to find MCP Servers whose name contains important as a word.
  • displayName:works* to find MCP Servers whose display name contains words that start with works.
  • planner OR booking to find MCP Servers whose metadata contains the words planner or booking.
  • mcpServerId:service-id AND (displayName:planner OR displayName:booking) to find MCP Servers whose MCP Server ID contains service-id and whose display name contains planner or booking.
GCLOUD WIDE FLAGS
These flags are available to all commands: --access-token-file, --account, --billing-project, --configuration, --flags-file, --flatten, --format, --help, --impersonate-service-account, --log-http, --project, --quiet, --trace-token, --user-output-enabled, --verbosity.

Run $ gcloud help for details.

API REFERENCE
This command uses the agentregistry/v1 API. The full documentation for this API can be found at: https://docs.cloud.google.com/agent-registry/overview
NOTES
This variant is also available: 
gcloud alpha agent-registry mcp-servers search