Virtual MCP Server

Virtual MCP Server (vMCP) is a feature of the ToolHive Kubernetes Operator that aggregates multiple backend MCP servers into a single endpoint, enabling unified tool access, centralized authentication, and multi-step workflows.

When to use vMCP

• You manage multiple MCP servers that should appear as one
• You need to centralize authentication across backends
• You want to create reusable workflows spanning multiple systems

Get started

• Understanding Virtual MCP Server - Learn what vMCP does and when to use it
• Quickstart: Virtual MCP Server - Deploy your first vMCP

Contents

📄️Introduction to vMCP

Understand what Virtual MCP Server (vMCP) does and when to use it.

📄️Quickstart

Learn how to aggregate multiple MCP servers into a single endpoint using Virtual MCP Server.

📄️Configure vMCP servers

How to configure a Virtual MCP Server for common scenarios.

📄️Backend discovery modes

Choose between discovered and inline backend discovery for Virtual MCP Server.

📄️Authentication

Configure client and backend authentication for vMCP.

📄️Tool aggregation and conflict resolution

How vMCP aggregates tools from multiple backend MCP servers and resolves naming conflicts.

📄️Composite tools and workflows

Create multi-step workflows that span multiple backend MCP servers.

📄️Optimize tool discovery

Enable the optimizer in vMCP to reduce token usage and improve tool selection across aggregated backends.

📄️Failure handling

Configure circuit breaker and partial failure modes to handle backend failures gracefully.

📄️Telemetry and metrics

How to enable OpenTelemetry traces and metrics for Virtual MCP Server.

📄️Audit logging

Configure audit logging for Virtual MCP Server to meet security compliance requirements and track MCP operations.

📄️Scaling and Performance

How to scale Virtual MCP Server deployments vertically and horizontally.