Update OpenAPI spec to use v0.1 endpoints and make _meta optional #811
+6
−7
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
- Update all API endpoint paths from /v0/ to /v0.1/ - Bump schema version from 2025-10-17 to 2025-12-01 - Regenerate server.schema.json with updated version This ensures sub-registries implementing the spec are adhering to the stable v0.1 version rather than the unstable v0. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
The OpenAPI spec version (2025-12-01) is separate from the server.json $schema version that the backend validates. The example should continue to point to 2025-10-17 which is the currently supported schema version. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
PR #803 decouples server.schema.json versioning from openapi.yaml by using a draft URL scheme. This PR should only update the OpenAPI spec endpoints and version, not the server.schema.json. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
The _meta field and its io.modelcontextprotocol.registry/official extension were never intended to be required parts of the spec. Sub-registries may not use these fields, so they should be optional. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude <[email protected]>
tadasant
changed the title
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Prepared by Claude Code, reviewed by me.
Important
This PR depends on #803 and must be merged after it. PR #803 decouples the
server.schema.jsonversioning fromopenapi.yamlby using a draft URL scheme. Until #803 is merged, CI will fail because the schema generation tool expectsserver.schema.jsonto be regenerated fromopenapi.yaml, but this PR intentionally does not modifyserver.schema.jsonto avoid conflicts. After #803 merges, a rebase will resolve the CI failure.Summary
/v0/to/v0.1/in the OpenAPI spec2025-10-17to2025-12-01(in$idandinfo.version)Rationale
This ensures sub-registries implementing the spec are adhering to the stable v0.1 version rather than the unstable v0. The API freeze (v0.1) provides stability guarantees that sub-registries need.
Additional cleanup: Make
_metaoptional inServerResponseThe
_metafield (and itsio.modelcontextprotocol.registry/officialextension) were never intended to be required parts of the spec. Sub-registries may not use these registry-specific metadata fields, so they should be optional.🤖 Generated with Claude Code