Add custom registry tutorial and JSON schema reference

[danbarr]

Description

Adds a new tutorial for creating a custom registry. Also adds the Docusaurus JSON schema plugin to render the registry schema reference.

Related issues/PRs

N/A

Merge checklist

Content

• New pages include a frontmatter section with title and description at a minimum
• Sidebar navigation (sidebars.ts) updated for added, deleted, reordered, or renamed files
• (N/A) Redirects added to vercel.json for moved, renamed, or deleted pages (i.e., if the URL slug changed)

Reviews

• Content has been reviewed for technical accuracy
• Content has been reviewed for spelling, grammar, and style

Signed-off-by: Dan Barr [email protected]

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Preview	Comments	Updated (UTC)
docs-website	Ready	Preview	Comment	Aug 18, 2025 9:52pm

[Copilot]

Pull Request Overview

This PR adds a new tutorial for creating custom MCP registries and introduces JSON schema reference documentation. The primary purpose is to help users understand how to create and manage their own custom registries for ToolHive, complete with schema validation and proper documentation structure.

Key changes:

• Adds a comprehensive custom registry tutorial with step-by-step instructions
• Integrates JSON schema plugin for rendering registry schema documentation
• Reorganizes sidebar navigation to separate quickstart guides from tutorials

Reviewed Changes

Copilot reviewed 10 out of 13 changed files in this pull request and generated 1 comment.

Show a summary per file

File	Description
static/api-specs/toolhive-registry-schema.json	New JSON schema file defining the structure for ToolHive registry entries
docs/toolhive/tutorials/custom-registry.mdx	New tutorial teaching users how to create custom MCP registries
docs/toolhive/reference/registry-schema.mdx	New reference page rendering the registry JSON schema
sidebars.ts	Restructured navigation to separate quickstart from tutorials and added new sections
package.json	Added docusaurus-json-schema-plugin dependency for schema rendering
docusaurus.config.ts	Added JSON schema theme and new references dropdown menu
scripts/update-toolhive-reference.sh	Enhanced script to handle registry schema updates
docs/toolhive/guides-cli/registry.md	Updated to reference new tutorial and schema documentation
docs/toolhive/reference/crd-spec.mdx	Fixed import path for CRD API documentation
.github/workflows/update-toolhive-reference.yml	Minor wording improvement in PR description

---

_{You can also share your feedback on Copilot code review for a chance to win a $100 gift card. Take the survey.}