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..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
@@ -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