package envoy.extensions.clusters.mcp_multicluster.v3

Get desktop application:
View/edit binary Protocol Buffers messages

Configuration for the MCP multi cluster. See the :ref:`architecture overview <arch_overview_mcp_multicluster>` for more information. This cluster type allows aggregation of multiple clusters into one, providing metadata with the list of aggregated clusters. Use the ``attemptCount`` property of the request ``StreamInfo`` object to select host in a specific subcluster. If the ``attemptCount`` value is greater than the number of aggregated clusters, the host selection will fail. The primary purpose of this cluster extension is to provide the list of servers for the MCP router configured for tool and resource aggregation. For details of how tools and resource are aggregated see :ref:`MCP router documentation<config_http_filters_mcp_router>`. Example configuration: .. code-block:: yaml name: mcp_multicluster connect_timeout: 0.25s lb_policy: CLUSTER_PROVIDED cluster_type: name: envoy.clusters.mcp_multicluster typed_config: "@type": type.googleapis.com/envoy.extensions.clusters.mcp_multicluster.v3.ClusterConfig servers: - name: build_tools mcp_cluster: cluster: build_tools - name: review_tools mcp_cluster: cluster: review_tools host_rewrite_literal: "mcp.review_tools.acme.com" [#extension: envoy.clusters.mcp_multicluster]

• repeated ClusterConfig.McpBackend servers = 1

  A list of remote MCP servers. Based on the MCP multi cluster configuration the MCP router aggregates capabilities, tools and resources from remote MCP servers and presents itself as single MCP server to the client. All remote MCP servers are sent the same capabilities that the client presented to Envoy. MCP router prefixes tool names and resource path with the server name to resolve naming collisions.

Specification of the MCP server.

Used in: ClusterConfig

• string name = 1

  Unique name for this backend. Used for: - Tool name prefixing (e.g., "time__get_current_time") - Session ID composition - Logging and error messages. Default will be the cluster name if not specified.

• optional McpCluster mcp_cluster = 2

  Backend target specification.

Cluster-based backend configuration.

Used in: McpBackend

• string cluster = 1

  Cluster name to route requests to.

• string path = 2

  Path to use for MCP requests. Defaults to "/mcp".

• optional google.protobuf.Duration timeout = 3

  Request timeout. If not set, uses cluster's timeout configuration.

• string host_rewrite_literal = 4

  Indicates that during forwarding, the host header will be swapped with this value.