Skip to content

Move registry contribution to the concepts page #62

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
danbarr merged 1 commit into from
Jul 18, 2025
Merged

Move registry contribution to the concepts page #62

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
1 commit
Select commit
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
23 changes: 19 additions & 4 deletions docs/toolhive/concepts/registry-criteria.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -5,17 +5,32 @@ description: Criteria for adding MCP servers to the ToolHive registry

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. Here
are the criteria for adding an MCP server to the ToolHive registry:
high-quality MCP servers through clear, observable, and objective criteria.

## Heuristics
## Contribute to the registry

If you have an MCP server that you'd like to add to the ToolHive registry, you
can
[open an issue](https://github.com/stacklok/toolhive/issues/new?template=add-an-mcp-server.md)
or submit a pull request to the ToolHive GitHub repository. The ToolHive team
will review your submission and consider adding it to the registry.

Criteria for adding an MCP server to the ToolHive registry are outlined below.
These criteria ensure that the servers in the registry meet the standards of
security, quality, and usability that ToolHive aims to uphold.

Registry entries are defined in the
[`pkg/registry/data/registry.json`](https://github.com/stacklok/toolhive/blob/main/pkg/registry/data/registry.json)
file in the ToolHive repository.

## Criteria for MCP servers

### Open source requirements

- Must be fully open source with no exceptions
- Source code must be publicly accessible
- Must use an acceptable open source license (see
[Acceptable licenses](#acceptable-licenses) below)
[Acceptable licenses](#acceptable-licenses))

### Security

Expand Down
25 changes: 5 additions & 20 deletions docs/toolhive/guides-cli/registry.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -3,9 +3,11 @@ title: Explore the registry
description: How to use the built-in registry to find MCP servers.
---

ToolHive includes a built-in registry of MCPs with verified configurations,
allowing you to discover and deploy MCP servers effortlessly. Simply select one
from the list and run it securely with a single command.
ToolHive includes a built-in registry of MCP servers with verified
configurations that meet a
[minimum quality standard](../concepts/registry-criteria.md), allowing you to
discover and deploy high-quality tools effortlessly. Simply select one from the
list and run it securely with a single command.

## Find MCP servers

Expand Down Expand Up @@ -174,23 +176,6 @@ thv config unset-registry-url

This restores the default behavior of using ToolHive's built-in registry.

## Contribute to the registry

If you have an MCP server that you'd like to add to the ToolHive registry, you
can
[open an issue](https://github.com/stacklok/toolhive/issues/new?template=add-an-mcp-server.md)
or submit a pull request to the ToolHive GitHub repository. The ToolHive team
will review your submission and consider adding it to the registry.

Criteria for adding an MCP server to the ToolHive registry are outlined in
[Registry criteria](../concepts/registry-criteria.md). These criteria ensure
that the servers in the registry meet the standards of security, quality, and
usability that ToolHive aims to uphold.

Registry entries are defined in the
[`pkg/registry/data/registry.json`](https://github.com/stacklok/toolhive/blob/main/pkg/registry/data/registry.json)
file in the ToolHive repository.

## Next steps

See [Run MCP servers](./run-mcp-servers.mdx) to run an MCP server from the
Expand Down
Loading