want a static file hosted somewhere? static.modelcontextprotocol.io is somewhere!
by modelcontextprotocolHTML
Last 12 weeks · 0 commits
5 of 6 standards met
The definitions were not properly referenced. There are several definitions but not properly exported to root. Below is corrected option that keeps in line with original merging of several previous vendor standards and allows for easy addition of new client specific schemas. { "$comment": "Corrected root schema. Original schema was invalid because it referenced ServerDetail directly without exporting it as the root. This version wraps the intended root types in a oneOf union, preserving compatibility with all MCP contexts.", "$id": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json", "$schema": "http://json-schema.org/draft-07/schema#", "oneOf": [ { "$ref": "#/definitions/ServerDetail" }, { "$ref": "#/definitions/Package" }, { "$ref": "#/definitions/RemoteTransport" } ], "definitions": { / KEEP ALL ORIGINAL DEFINITIONS EXACTLY AS PUBLISHED / } }
In the description it already mentions that this is an URL Template. The regexp is more restrictive than this. Our actual problem is: MCP Servers might not know their full absolute URL, this is often defined later, e.g. by the Gateway. So for some MCP servers, they can only provide a relative URL or a templated URI. Is this correct or are there reasons why the current regexp insists on an absolute URL? I understand we want absolute URLs at the very end (in the registry), but when you self-describe yourself you might not yet have it.
The only change here vs. the version in the registry repo is the field to encode . Summary Adds the versioned server.json schema for release. What's New in This Schema Version URL Template Variables for Remote Servers - Remote servers can now define configurable variables in URLs using notation, enabling multi-tenant deployments. Release Sequence 1. This PR (static repo) must land first - Publishes the schema to 2. Then merge registry PR** - https://github.com/modelcontextprotocol/registry/pull/841 (updates code to reference the new schema version) Test Plan [ ] Verify schema is valid JSON Schema [ ] After merge, verify schema is accessible at https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json 🤖 Generated with Claude Code
Motivation and Context 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
Repository: modelcontextprotocol/static. Description: want a static file hosted somewhere? static.modelcontextprotocol.io is somewhere! Stars: 9, Forks: 9. Primary language: HTML. Languages: HTML (100%). License: MIT. Homepage: https://static.modelcontextprotocol.io/ Open PRs: 2, open issues: 1. Last activity: 5mo ago. Community health: 100%. Top contributors: domdomegg, rdimitrov, tadasant, pree-dew, joan-anthropic.