MSP-1 Schemas

This directory contains machine-readable schemas for the Mark Semantic Protocol (MSP-1). These schemas define the structure, validation rules, and data model for MSP-1 metadata used by AI agents, validators, and implementers.

MSP-1 Site-Level Schema

The JSON Schema defining the site-level MSP-1 declaration is available at:

📄 msp-1-site.json

Schema ID:
https://msp-1.com/schema/msp-1-site.json

This schema validates the structure of the MSP-1 file found at:
/.well-known/msp.json

Key validated fields include:
protocol, version, site, compliance, policies, contact, and resources.

MSP-1 Page-Level Schema

The JSON Schema defining page-level MSP-1 metadata is available at:

📄 msp-1-page.json

Schema ID:
https://msp-1.com/schema/msp-1-page.json

This schema defines how individual HTML documents expose structured metadata, including:
page.id, page.url, page.title, topics, audience, lifecycle, importance, and relationships.

How AI Agents Use These Schemas

AI systems can use the schemas in this directory to:

A typical AI workflow:

  1. Fetch /.well-known/msp.json
  2. Validate against msp-1-site.json
  3. Discover schema links and related resources
  4. Follow page descriptors and validate against msp-1-page.json

Versioning

MSP-1 schemas follow semantic versioning. Breaking changes will always result in a new $id and persistent hosting so older implementations remain compatible.