ToolHive Registry Server
Introduction
The ToolHive Registry Server helps you publish and govern a catalog of MCP servers or skills for your team. Use it when you want a trusted catalog that aggregates entries from Kubernetes clusters, Git repositories, API endpoints, and local files behind a standard MCP Registry API.
Within the ToolHive platform, the Registry Server is the self-hosted catalog service. It is separate from the built-in registry in the ToolHive CLI and UI. If you only need to browse the default ToolHive catalog, see Use the registry (CLI) or Use the registry (UI).
Where to start
- New to the Registry Server? Follow the Registry Server quickstart to get a working deployment on a local Kubernetes cluster.
- Evaluating the Registry Server? Read the Introduction for architecture, features, and supported registry source types.
- Ready to deploy? See Deploy the Registry Server to choose between the Operator, Helm, and manual methods.
- Already running? Jump to Configuration, Authentication, or Authorization.
- Want a web catalog? Deploy the ToolHive Cloud UI to browse a Registry Server catalog with OIDC-based authentication.
Contents
Introduction
Architecture, features, and registry source types for the ToolHive Registry Server
Quickstart
Deploy the ToolHive Registry Server on a local Kubernetes cluster with a file-based source and query its API.
Deploy the Registry Server
3 items
Database configuration
Configure PostgreSQL storage, connection pooling, and migrations for the ToolHive Registry Server
Configuration
Configure the ToolHive Registry Server with sources, registries, and sync policies
Publish MCP servers
How to publish MCP server entries to a ToolHive Registry Server using a Git or file source, or the managed source admin API.
Manage skills
Publish, list, retrieve, and delete skills in the ToolHive Registry Server through the admin API or a synced source.
Authentication configuration
Configure anonymous or OAuth authentication for the ToolHive Registry Server
Authorization
Configure role-based access control and claims-based authorization for the Registry Server
Audit logging
Configure audit logging for the ToolHive Registry Server to track API operations and meet security compliance requirements.
Telemetry and metrics
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.
Registry JSON schema
JSON schema reference for the ToolHive registry format, which builds on the official MCP server schema and adds skills and publisher-provided metadata.