ToolHive Registry Server
Introduction
The ToolHive Registry Server is an implementation of the official Model Context Protocol (MCP) Registry API specification. It provides a standardized REST API for discovering and accessing MCP servers from multiple backend sources, including Kubernetes clusters, Git repositories, API endpoints, and local files.
This section covers the Registry Server, a standalone service you deploy yourself. Looking for the built-in registry instead? See Explore the registry (CLI) or Explore the registry (UI).
Where to start
- Evaluating the Registry Server? Read the Introduction for architecture, features, and supported registry source types.
- Ready to deploy? See Deployment overview to choose between Kubernetes Operator and manual deployment methods.
- Already running? Jump to Configuration or Authentication.
Contents
Introduction
How to use the ToolHive Registry Server to discover and access MCP servers and skills
Deploy the Registry Server
Deployment options for the ToolHive Registry Server in Kubernetes
Deploy with the ToolHive Operator
How to deploy the ToolHive Registry Server in Kubernetes using the ToolHive Operator
Deploy manually
How to deploy the ToolHive Registry Server in Kubernetes using raw manifests
Configuration
How to configure the ToolHive Registry Server with registry and sync policies
Authentication configuration
How to configure authentication for the ToolHive Registry Server with anonymous and OAuth modes
Database configuration
How to configure PostgreSQL database storage and migrations for the ToolHive Registry server
Manage skills
How to publish, list, retrieve, and delete skills using the ToolHive Registry server extensions API.
Telemetry and metrics
How to enable OpenTelemetry metrics and distributed tracing for the ToolHive Registry Server
API reference
REST API reference for the ToolHive Registry Server, covering server discovery and skill management.
Upstream registry JSON schema
JSON schema reference for the official MCP registry format defined by the Model Context Protocol community.
ToolHive registry JSON schema
JSON schema reference for ToolHive registry entries, including server metadata and configuration fields.