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.

Contents

📄️ Introduction

How to use the ToolHive Registry server to discover and access MCP servers

📄️ 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

📄️ 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.