Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 9 additions & 0 deletions docs/toolhive/concepts/registry-criteria.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -9,6 +9,15 @@ The ToolHive registry is a curated list of MCP servers that meet specific
criteria. We aim to establish a curated, community-auditable list of
high-quality MCP servers through clear, observable, and objective criteria.

:::note[Built-in registry vs. Registry Server]

This page describes criteria for MCP servers included in the built-in registry
that ships with the ToolHive CLI and UI. To host your own registry in
production, see the [ToolHive Registry Server](../guides-registry/index.mdx)
documentation.

:::

## Contribute to the registry

If you have an MCP server that you'd like to add to the ToolHive registry, you
Expand Down
9 changes: 9 additions & 0 deletions docs/toolhive/guides-cli/registry.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -173,6 +173,15 @@ thv config set-registry https://example.com/registry.json
thv config set-registry https://registry.example.com
```

:::tip[Host your own registry]

You can deploy the [ToolHive Registry Server](../guides-registry/index.mdx) to
host a registry with authentication, multiple data sources, and automatic
synchronization. Point `thv config set-registry` to your Registry Server
endpoint.

:::

### Set a local registry file

To configure ToolHive to use a local registry file, set the file path:
Expand Down
5 changes: 5 additions & 0 deletions docs/toolhive/guides-k8s/index.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -18,6 +18,11 @@ three resource types:
- **MCPRemoteProxy** — proxy an MCP server hosted outside your cluster
- **VirtualMCPServer** — aggregate multiple servers behind a single endpoint

Beyond managing MCP servers, the operator can deploy
[ToolHive Registry Server](../guides-registry/index.mdx) instances via
MCPRegistry resources, enabling automatic discovery of cluster-hosted MCP
servers.

## Where to start

- **New to ToolHive on Kubernetes?** Start with the
Expand Down
9 changes: 9 additions & 0 deletions docs/toolhive/guides-ui/registry.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -116,6 +116,15 @@ apply your configuration.
For detailed information on creating a custom registry, see the
[custom registry tutorial](../tutorials/custom-registry.mdx).

:::tip[Host your own registry]

You can deploy the [ToolHive Registry Server](../guides-registry/index.mdx) to
host a registry with authentication, multiple data sources, and automatic
synchronization. Point the **Remote Registry (URL)** setting to your Registry
Server endpoint.

:::

<ThemedImage
alt='Registry settings showing Local Registry File Path option selected with Registry File Path input field'
sources={{
Expand Down
10 changes: 10 additions & 0 deletions docs/toolhive/tutorials/custom-registry.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -25,6 +25,12 @@ Creating a custom registry allows you to:
- Pre-configure server settings for easier deployment
- Ensure all servers meet your organization's quality and security standards

For production environments, you can also deploy the
[ToolHive Registry Server](../guides-registry/index.mdx) to host your registry
with authentication, multiple data sources, and automatic synchronization. This
tutorial focuses on creating the registry data file itself, which the Registry
Server can also consume as a file source.

## Create your first custom registry

In this tutorial, you'll create a custom MCP registry for ToolHive and configure
Expand Down Expand Up @@ -304,6 +310,10 @@ you should:
- **Implement proper access controls** to prevent unauthorized modifications
- **Set up automated validation** to ensure registry entries follow the schema
- **Regularly update** the registry with new servers and remove deprecated ones
- **Deploy the ToolHive Registry Server** for production registries with
built-in authentication, multiple data sources, Kubernetes integration, and
automatic synchronization (see
[Registry Server documentation](../guides-registry/index.mdx))

For production use, configure ToolHive to use a remote registry URL:

Expand Down