update schema url point to the actual location

[deerajkumar18]

Motivation and Context

This PR ensures that the draft URL points to the actual draft schema
improvement suggested in #814

How Has This Been Tested?

Breaking Changes

Types of changes

• Bug fix (non-breaking change which fixes an issue)
• New feature (non-breaking change which adds functionality)
• Breaking change (fix or feature that would cause existing functionality to change)
• Documentation update

Checklist

• I have read the MCP Documentation
• My code follows the repository's style guidelines
• New and existing tests pass locally
• I have added appropriate error handling
• I have added or updated documentation as needed

Additional context

[tadasant]

Thanks for jumping in on this!

[tadasant]

Let's keep the example the static. URL since that is more representative of what should live here

[deerajkumar18]

Reverted back to the static schema URL in the example field . Auto-generated after updating the openapi.yaml spec

[tadasant]

Same with this one

[deerajkumar18]

Reverted back to the static schema URL in the example field .

[tadasant]

Suggested change

	"$id": "https://raw.githubusercontent.com/modelcontextprotocol/registry/main/docs/reference/server-json/server.schema.json",
	"$id": "https://raw.githubusercontent.com/modelcontextprotocol/registry/main/docs/reference/server-json/draft/server.schema.json",

Just for clarity, I think we should preserve draft in the ID; which means we should move the file inside a folder called draft

[deerajkumar18]

Moved the server.schema.json file to the draft directory . Made necessary changes to schemaOutputDir and schemaID in the tools/extract-server-schema/main.go file .

[tadasant]

I had Claude do a first pass at reviewing (see summary below) -- I haven't had the chance to dig in and verify its findings yet, but would appreciate help ensuring we're not missing things here.

---

2. Missing file references that should be updated

Several documentation files still reference ./server.schema.json (without draft/) that should be updated:

• docs/contributing/add-package-registry.md lines 7, 36 - references ../../reference/server-json/server.schema.json
• docs/reference/server-json/generic-server-json.md line 11 - references ./server.schema.json
• docs/reference/server-json/CONTRIBUTING.md line 9 - references updating server.schema.json
• docs/modelcontextprotocol-io/about.mdx line 19 - links to the schema in the repo

These relative links will break after the file is moved to draft/.

3. Workflow file may need updates

.github/workflows/sync-schema.yml has logic looking for server.schema.json files. The pattern may need adjustment if the draft schema is now in a draft/ subdirectory.

---

Edit: I just took a closer look and it appears (3) was not helpful but at least (2) seems right (we should update those references). Can you please do another pass making sure we haven't missed other references?

[deerajkumar18]

@tadasant I have updated the references in the files that you have highlighted above and also in few other files :

• complete.md
• docs/design/proposed-enhanced-validation.md

[deerajkumar18]

@rdimitrov merge conflict resolved by rebasing with the main branch

[tadasant]

Thanks @deerajkumar18!