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 is the Registry Server — a standalone service for hosting and curating your own MCP server catalog. For the built-in registry that ships with ToolHive, 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
Reference documentation for the ToolHive Registry Server REST API
📄️ Upstream registry JSON schema
The JSON schema for the official upstream MCP registry format.
📄️ ToolHive registry JSON schema
The JSON schema for the ToolHive registry.