- NAME
-
- gcloud alpha network-services mcp-transcoders update - update an MCP Transcoder
- SYNOPSIS
-
-
gcloud alpha network-services mcp-transcoders updateMCP_TRANSCODER[--agent-gateway=AGENT_GATEWAY] [--async] [--description=DESCRIPTION] [--endpoints=[ENDPOINTS,…]] [--etag=ETAG] [--location=LOCATION] [--mcp-server-url=MCP_SERVER_URL] [--labels=[LABELS,…] |--update-labels=[UPDATE_LABELS,…]--clear-labels|--remove-labels=REMOVE_LABELS] [GCLOUD_WIDE_FLAG …]
-
- DESCRIPTION
-
(ALPHA)Updates the parameters of a single McpTranscoder. - EXAMPLES
-
To update the MCP server URL for the global MCP transcoder
my-mcp-transcoder, run:gcloud alpha network-services mcp-transcoders update my-mcp-transcoder --location=global --mcp-server-url="https://new.api.example.com/v2/mcp" - POSITIONAL ARGUMENTS
-
-
McpTranscoder resource - Identifier. Resource name of the McpTranscoder. It must
be in the format
projects/*/locations/*/mcpTranscoders/{mcp_transcoder}.{mcp_transcoder}must be 1-63 characters long and match the regex[a-z]([-a-z0-9]*[a-z0-9])?. 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
projectattribute:-
provide the argument
mcp_transcoderon the command line with a fully specified name; -
provide the argument
--projecton the command line; -
set the property
core/project.
To set the
locationattribute:-
provide the argument
mcp_transcoderon the command line with a fully specified name; -
provide the argument
--locationon the command line.
This must be specified.
MCP_TRANSCODER-
ID of the mcpTranscoder or fully qualified identifier for the mcpTranscoder.
To set the
mcp_transcoderattribute:-
provide the argument
mcp_transcoderon the command line.
-
provide the argument
-
provide the argument
-
McpTranscoder resource - Identifier. Resource name of the McpTranscoder. It must
be in the format
- FLAGS
-
-
AgentGateway resource - The resource name of the AgentGateway this McpTranscoder
is associated with. Must be in the format
projects/*/locations/*/agentGateways/{agent_gateway_id}. 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
projectattribute:-
provide the argument
--agent-gatewayon the command line with a fully specified name; -
provide the argument
--projecton the command line; -
set the property
core/project.
To set the
locationattribute:-
provide the argument
--agent-gatewayon the command line with a fully specified name; -
provide the argument
--locationon the command line.
-
provide the argument
--agent-gateway=AGENT_GATEWAY-
ID of the agentGateway or fully qualified identifier for the agentGateway.
To set the
agent-gatewayattribute:-
provide the argument
--agent-gatewayon the command line.
-
provide the argument
--async- Return immediately, without waiting for the operation in progress to complete.
--description=DESCRIPTION- An optional description of the McpTranscoder resource. Max length 1024 characters.
--endpoints=[ENDPOINTS,…]-
A list of resource URIs of Service resources (from Agent Registry) that contain
the OpenAPI specifications. Must be in the format
//agentregistry.googleapis.com/projects/*/locations/*/services/{service}. Note: For the MVP, each McpTranscoder is limited to a single tool set. --etag=ETAG- Etag of the resource. If this is provided, it must match the server's etag. If the provided etag does not match the server's etag, the request will fail with a 409 ABORTED error.
--location=LOCATION- For resources [agent-gateway, mcp_transcoder], provides fallback value for resource location attribute. When the resource's full URI path is not provided, location will fallback to this flag value.
--mcp-server-url=MCP_SERVER_URL-
Specifies the MCP server URL used for the MCP request calls. Must be a valid URL
starting with
http://orhttps://(e.g., "https://api.example.com/v1/mcp"). -
Update labels.
At most one of these can be specified:
--labels=[LABELS,…]-
Set labels to new value. Set of labels associated with the McpTranscoder
resource.
KEY-
Keys must start with a lowercase character and contain only hyphens
(
-), underscores (_), lowercase characters, and numbers. VALUE-
Values must contain only hyphens (
-), underscores (_), lowercase characters, and numbers.
Shorthand Example:--labels=string=string
JSON Example:--labels='{"string": "string"}'
File Example:--labels=path_to_file.(yaml|json)
-
Or at least one of these can be specified:
--update-labels=[UPDATE_LABELS,…]-
Update labels value or add key value pair. Set of labels associated with the
McpTranscoder resource.
KEY-
Keys must start with a lowercase character and contain only hyphens
(
-), underscores (_), lowercase characters, and numbers. VALUE-
Values must contain only hyphens (
-), underscores (_), lowercase characters, and numbers.
Shorthand Example:--update-labels=string=string
JSON Example:--update-labels='{"string": "string"}'
File Example:--update-labels=path_to_file.(yaml|json)
-
At most one of these can be specified:
--clear-labels- Clear labels value and set to empty map.
--remove-labels=REMOVE_LABELS-
Remove existing value from map labels. Sets
remove_labelsvalue.Shorthand Example:--remove-labels=string,stringJSON Example:--remove-labels=["string"]
File Example:--remove-labels=path_to_file.(yaml|json)
-
AgentGateway resource - The resource name of the AgentGateway this McpTranscoder
is associated with. Must be in the format
- 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 helpfor details. - API REFERENCE
-
This command uses the
networkservices/v1alpha1API. The full documentation for this API can be found at: https://cloud.google.com/networking - NOTES
- This command is currently in alpha and might change without notice. If this command fails with API permission errors despite specifying the correct project, you might be trying to access an API with an invitation-only early access allowlist.
gcloud alpha network-services mcp-transcoders update
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2026-10-20 UTC.