Add upstream registry schema documentation

[danbarr]

Description

Adds documentation for the official upstream MCP registry format alongside the existing ToolHive-native format:

• New reference page for the upstream registry JSON schema with embedded MCP server schema
• Renamed existing schema page to registry-schema-toolhive for clarity
• Added build script to fetch and bundle the MCP server schema from upstream
• Added links to schema docs from the registry configuration guide
• Custom CSS for neutral schema viewer appearance

Type of change

• New documentation
• Navigation/structure change

Submitter checklist

Content and formatting

• I have reviewed the content for technical accuracy
• I have reviewed the content for spelling, grammar, and style

Navigation

• 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
• Redirects added to vercel.json for moved, renamed, or deleted pages

Reviewer checklist

Content

• I have reviewed the content for technical accuracy
• I have reviewed the content for spelling, grammar, and style

[vercel]

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

Project	Deployment	Review	Updated (UTC)
docs-website	Ready	Preview, Comment	Jan 23, 2026 5:04pm

[Copilot]

Pull request overview

This PR adds documentation for the official upstream MCP registry format alongside the existing ToolHive-native format. The changes include:

Changes:

• New reference page for upstream registry JSON schema with embedded MCP server schema
• Renamed existing schema page to registry-schema-toolhive for clarity
• Added build script to fetch and bundle the MCP server schema from upstream
• Added navigation links and redirects for the new schema documentation
• Custom CSS for neutral JSON schema viewer appearance

Reviewed changes

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

Show a summary per file

File	Description
vercel.json	Redirect from old schema URL to renamed ToolHive-specific schema page
static/api-specs/upstream-registry.schema.json	New upstream registry schema with simplified MCP server references
static/api-specs/mcp-server.schema.json	Complete MCP server schema fetched from upstream
src/css/custom.css	Custom styling for JSON schema viewer to use neutral colors
scripts/update-toolhive-reference.sh	Updated to fetch and bundle both registry schemas
scripts/bundle-upstream-schema.mjs	New script to resolve schema references and fetch upstream schema
package.json	Added json-schema-ref-parser dev dependency
docusaurus.config.ts	Updated navigation links for both schema types
docs/toolhive/reference/registry-schema-upstream.mdx	New documentation page for upstream registry format
docs/toolhive/reference/registry-schema-toolhive.mdx	Updated existing page with clarification about legacy status
docs/toolhive/guides-registry/configuration.mdx	Added explanation of registry data formats
docs/toolhive/guides-cli/registry.mdx	Updated link to renamed schema page
docs/toolhive/tutorials/custom-registry.mdx	Updated link to renamed schema page
.github/workflows/update-toolhive-reference.yml	Simplified to use shared setup action

[danbarr]

Security issues are not related to this PR; ran npm audit fix but only a partial resolution is possible until a Docusaurus release happens.