Skip to content

Add server.schema.json for MCP registry schema versioning#1

Merged
domdomegg merged 1 commit intomainfrom
adamj/add-server-schema
Aug 27, 2025
Merged

Add server.schema.json for MCP registry schema versioning#1
domdomegg merged 1 commit intomainfrom
adamj/add-server-schema

Conversation

@domdomegg
Copy link
Member

Summary

  • Add JSON schema file for MCP server.json format at /schemas/2025-07-09/server.schema.json
  • Enable hosting at https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json
  • Support schema versioning and IDE validation for server.json files

Background

This change supports the $schema property being added to the server.json specification in modelcontextprotocol/registry#308. The $schema property enables:

  • Schema versioning: Future breaking changes can use new schema URLs
  • Self-describing files: server.json files become self-documenting
  • IDE support: Automatic validation, autocomplete, and error highlighting
  • Better tooling: Standard JSON Schema tooling works out of the box

Implementation

The schema file is copied from the registry repository and will be served via GitHub Pages to provide a stable, publicly accessible URL for the schema reference.

Related: modelcontextprotocol/registry#308
Addresses: modelcontextprotocol/registry#139

Add JSON schema file for MCP server.json format to enable schema versioning and IDE support. This schema will be served at https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json to support the $schema property added in modelcontextprotocol/registry#308.

The hosted schema enables:
- Self-describing server.json files
- IDE validation and autocomplete
- Version tracking for schema evolution
- Better tooling integration

Supports modelcontextprotocol/registry#308
Copy link
Member

@johnw188 johnw188 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@domdomegg domdomegg merged commit f1cd60b into main Aug 27, 2025
@domdomegg domdomegg deleted the adamj/add-server-schema branch August 27, 2025 00:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants