MSP-1 Documentation Hub

Core Documentation

These documents define how MSP-1 sites communicate intent, policy, and responsibilities.

• AI Usage Policy — how AI is used, disclosed, and respected on MSP-1 implementations.
• Editorial Policy — standards for content review, accuracy, and corrections.
• Privacy & Security — how user data, logs, and AI-facing metadata are handled.
• Terms of Use — legal terms for accessing and using MSP-1 resources.

Accessibility & Security

Documents that emphasize trust, accessibility, and responsible disclosure.

• Accessibility — accessibility principles and commitments for MSP-1 content.
• Security Acknowledgments — recognition of responsible disclosures and contributors.

Implementation Guide

Use the following steps to implement MSP-1 on your own site. This ties together the specification, schemas, and practical actions so that both humans and AI agents can rely on your metadata.

1. Understand the protocol
   Start by reading the MSP-1 specification to understand site-level declarations, page-level descriptors, and how AI agents are expected to use them.
   📄 View MSP-1 Specification
2. Publish your site-level declaration
   Implement a /.well-known/msp.json file that describes your site, contact information, policies, and key resources.
   • Declare protocol name, version, and site identity.
   • Expose links to your spec, schema index, and (optional) validator.
   • Reference AI usage, editorial, and privacy/security policies.

   Refer to the site-level schema:

   📄 msp-1-site.json

3. Add page-level descriptors
   For important pages, create JSON descriptors that conform to the MSP-1 page-level schema. These describe page identity, topics, audience, lifecycle, and relationships.

   📄 msp-1-page.json

   Typical fields include:

   • page.id, page.url, page.title
   • content.topics, audience, importance
   • lifecycle.created, updated, status
   • relationships.parent, children, related
4. Prepare for validation
   MSP-1 encourages validation at both the site and page level. A future validator tool will be able to fetch your declarations, check them against the official schemas, and return a structured report.

   🔍 MSP-1 Validator (planned)

5. Connect your policies
   Make your implementation more trustworthy by publishing clear policies that your site-level declaration can reference, such as:
   • Editorial policy
   • AI usage & disclosure policy
   • Privacy & security practices
   • Accessibility commitments