From b5f7fa1bd678b48487eb8f0e8626fea9fa2db45e Mon Sep 17 00:00:00 2001
From: Dan Barr <6922515+danbarr@users.noreply.github.com>
Date: Wed, 3 Dec 2025 13:58:40 -0500
Subject: [PATCH 1/2] Fix registry schema references and import

Signed-off-by: Dan Barr <6922515+danbarr@users.noreply.github.com>
---
 docs/toolhive/guides-cli/registry.mdx                         | 2 +-
 docs/toolhive/reference/registry-schema.mdx                   | 2 +-
 docs/toolhive/tutorials/custom-registry.mdx                   | 4 ++--
 scripts/update-toolhive-reference.sh                          | 4 ++--
 ...istry-schema.json => toolhive-legacy-registry.schema.json} | 0
 5 files changed, 6 insertions(+), 6 deletions(-)
 rename static/api-specs/{toolhive-registry-schema.json => toolhive-legacy-registry.schema.json} (100%)

diff --git a/docs/toolhive/guides-cli/registry.mdx b/docs/toolhive/guides-cli/registry.mdx
index 3ef595c2..e384a50e 100644
--- a/docs/toolhive/guides-cli/registry.mdx
+++ b/docs/toolhive/guides-cli/registry.mdx
@@ -246,7 +246,7 @@ purposes:
 
 ```json title='registry-with-groups.json'
 {
-  "$schema": "https://raw.githubusercontent.com/stacklok/toolhive/main/pkg/registry/data/schema.json",
+  "$schema": "https://raw.githubusercontent.com/stacklok/toolhive/main/pkg/registry/data/toolhive-legacy-registry.schema.json",
   "version": "1.0.0",
   "last_updated": "2025-08-15T10:00:00Z",
   "servers": {
diff --git a/docs/toolhive/reference/registry-schema.mdx b/docs/toolhive/reference/registry-schema.mdx
index 7e302406..bf3c06bf 100644
--- a/docs/toolhive/reference/registry-schema.mdx
+++ b/docs/toolhive/reference/registry-schema.mdx
@@ -16,7 +16,7 @@ the top of your JSON file:
 
 ```json
 {
-  "$schema": "https://raw.githubusercontent.com/stacklok/toolhive/main/pkg/registry/data/schema.json",
+  "$schema": "https://raw.githubusercontent.com/stacklok/toolhive/main/pkg/registry/data/toolhive-legacy-registry.schema.json",
   ...
 }
 ```
diff --git a/docs/toolhive/tutorials/custom-registry.mdx b/docs/toolhive/tutorials/custom-registry.mdx
index 5709b7ae..a19297d4 100644
--- a/docs/toolhive/tutorials/custom-registry.mdx
+++ b/docs/toolhive/tutorials/custom-registry.mdx
@@ -58,7 +58,7 @@ Create a new file called `registry.json` and add the following content:
 
 ```json title='registry.json'
 {
-  "$schema": "https://raw.githubusercontent.com/stacklok/toolhive/main/pkg/registry/data/schema.json",
+  "$schema": "https://raw.githubusercontent.com/stacklok/toolhive/main/pkg/registry/data/toolhive-legacy-registry.schema.json",
   "version": "1.0.0",
   "last_updated": "2025-08-15T10:00:00Z",
   "servers": {
@@ -255,7 +255,7 @@ if you try to run it):
 
 ```json title='registry.json'
 {
-  "$schema": "https://raw.githubusercontent.com/stacklok/toolhive/main/pkg/registry/data/schema.json",
+  "$schema": "https://raw.githubusercontent.com/stacklok/toolhive/main/pkg/registry/data/toolhive-legacy-registry.schema.json",
   "version": "1.0.0",
   "last_updated": "2025-08-15T10:00:00Z",
   "servers": {
diff --git a/scripts/update-toolhive-reference.sh b/scripts/update-toolhive-reference.sh
index cd4b6361..5d836692 100755
--- a/scripts/update-toolhive-reference.sh
+++ b/scripts/update-toolhive-reference.sh
@@ -17,8 +17,8 @@ CLI_DOCS_DST="${DOCS_DIR}/toolhive/reference/cli"
 API_SPEC_SRC="${IMPORT_DIR}/toolhive/docs/server/swagger.yaml"
 API_SPEC_DST="${STATIC_DIR}/api-specs/toolhive-api.yaml"
 
-REGISTRY_SCHEMA_SRC="${IMPORT_DIR}/toolhive/pkg/registry/data/schema.json"
-REGISTRY_SCHEMA_DST="${STATIC_DIR}/api-specs/toolhive-registry-schema.json"
+REGISTRY_SCHEMA_SRC="${IMPORT_DIR}/toolhive/pkg/registry/data/toolhive-legacy-registry.schema.json"
+REGISTRY_SCHEMA_DST="${STATIC_DIR}/api-specs/toolhive-legacy-registry.schema.json"
 
 CRD_API_SRC="${IMPORT_DIR}/toolhive/docs/operator/crd-api.md"
 CRD_API_DST="${STATIC_DIR}/api-specs/toolhive-crd-api.md"
diff --git a/static/api-specs/toolhive-registry-schema.json b/static/api-specs/toolhive-legacy-registry.schema.json
similarity index 100%
rename from static/api-specs/toolhive-registry-schema.json
rename to static/api-specs/toolhive-legacy-registry.schema.json

From 7cd489121262830908894db723920c20a290c625 Mon Sep 17 00:00:00 2001
From: Dan Barr <6922515+danbarr@users.noreply.github.com>
Date: Wed, 3 Dec 2025 14:03:57 -0500
Subject: [PATCH 2/2] Fix import

Signed-off-by: Dan Barr <6922515+danbarr@users.noreply.github.com>
---
 docs/toolhive/reference/registry-schema.mdx | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/toolhive/reference/registry-schema.mdx b/docs/toolhive/reference/registry-schema.mdx
index bf3c06bf..a3969606 100644
--- a/docs/toolhive/reference/registry-schema.mdx
+++ b/docs/toolhive/reference/registry-schema.mdx
@@ -5,7 +5,7 @@ displayed_sidebar: toolhiveSidebar
 ---
 
 import JSONSchemaViewer from '@theme/JSONSchemaViewer';
-import Schema from '@site/static/api-specs/toolhive-registry-schema.json';
+import Schema from '@site/static/api-specs/toolhive-legacy-registry.schema.json';
 
 This is the JSON schema for the ToolHive registry. It defines the structure and
 constraints for the registry entries, ensuring that all entries conform to a