CANONICAL DEFINITIONS

JSON Schema Directory

Machine-readable JSON Schemas conforming to standard JSON Schema specifications (Draft 2020-12 and Draft-07).

Current Stable Draft 2020-12

msr-2.0.json

Canonical schema for modern software, APIs, MCP servers, and AI agents.

Download Schema (.json) View Raw Schema
Legacy Bridge Draft-07

msr-1.1.json

Bridge format connecting legacy PAD XML structures to early JSON registries.

Download Schema (.json) View Raw Schema
Working Draft Experimental

msr-2.1-draft.json

Development draft incorporating RFC-0004 AI sandboxing, A2A messaging, and RFC-0006 geographic and language availability.

Download Schema (.json) View Raw Schema

Referencing Schemas in Manifests

Manifests declare their canonical schema URI in the top-level $schema property. This enables code editors (such as VS Code, JetBrains, and Cursor) to provide instant auto-completion, linting, and hover documentation:

{
  "$schema": "https://msr-standard.org/schemas/msr-2.0.json",
  "protocol": {
    "name": "MSR JSON",
    "version": "2.0.0",
    "author": "Antonio Santos",
    "specification_license": "CC-BY-4.0",
    "reference_implementation_license": "MIT"
  }
}

Automated Validation in CI/CD

You can validate your manifest against the canonical schema in GitHub Actions or pre-commit hooks using standard JSON Schema CLI engines:

# Using python check-jsonschema
pip install check-jsonschema
check-jsonschema --schemafile https://msr-standard.org/schemas/msr-2.0.json .well-known/msr.json
# Using standard ajv-cli in Node.js
npx ajv-cli validate -s https://msr-standard.org/schemas/msr-2.0.json -d .well-known/msr.json --spec=draft2020

The reference msr CLI is specified but not yet released — see the CLI reference. No install command for it is advertised here until a signed artifact exists.