Kubernetes CRD reference
The ToolHive operator manages MCP workloads using Kubernetes custom resources. Each page below documents one resource - its fields, defaults, validation rules, and a minimal example manifest - and links to the other resources it references.
Core workloads
MCPServer
Containerized MCP server managed by the operator.
MCPRemoteProxy
Proxy a remote MCP server through the operator.
MCPServerEntry
Declare a remote MCP server as a group member.
VirtualMCPServer
Aggregate multiple backends into a single vMCP endpoint.
MCPRegistry
Deploy a ToolHive Registry Server (deprecated).
Shared configuration
MCPGroup
Group backend workloads for shared configuration.
MCPOIDCConfig
Shared OIDC authentication settings.
MCPExternalAuthConfig
External authentication to upstream services.
MCPTelemetryConfig
Shared OpenTelemetry tracing, metrics, and logging.
MCPToolConfig
Tool filtering and renaming rules.
VirtualMCPCompositeToolDefinition
Composite tool workflow for a VirtualMCPServer.
EmbeddingServer
Local embedding model for the vMCP optimizer.
MCPWebhookConfig
Delegate MCP tool authorization to an external webhook.
MCPAuthzConfig
Shared authorization policy decoupled from a specific backend.