Appendix A: Icon Object
Appendix B: Complete Example
Section titled “Appendix B: Complete Example”See examples/full-featured.yaml for a complete MCP Description document demonstrating a broad set of features from this specification.
Appendix C: JSON Schema
Section titled “Appendix C: JSON Schema”The normative JSON Schema for this specification version is available at:
- ../../../schemas/mcp-description/0.8.0.json
https://mcpdesc.org/schema/mcp-description/0.8.0.jsonfor the stable 0.8.0 canonical schema resource
Archival retrieval locations may also exist for frozen historical bytes, including the legacy Draft 3 short URI https://mcpdesc.org/schema/0.8.0.json and the stable 0.7.0 mirror https://mcpdesc.org/schema/mcp-description/0.7.0.json. Those retrieval URLs do not change the historical embedded $id values of the frozen schemas they mirror.
Appendix D: References
Section titled “Appendix D: References”Normative References
Section titled “Normative References”- [RFC 2119] Bradner, S., “Key words for use in RFCs to Indicate Requirement Levels”, RFC 2119, March 1997.
- [RFC 3986] Berners-Lee, T., Fielding, R., and L. Masinter, “Uniform Resource Identifier (URI): Generic Syntax”, RFC 3986, January 2005.
- [RFC 6570] Gregorio, J., Fielding, R., Hadley, M., Nottingham, M., and D. Orchard, “URI Template”, RFC 6570, March 2012.
- [RFC 8259] Bray, T., “The JavaScript Object Notation (JSON) Data Interchange Format”, RFC 8259, December 2017.
- [RFC 9512] Bormann, C., et al., “YAML Media Type”, RFC 9512, February 2024.
- [YAML 1.2.2] Ben-Kiki, O., Evans, C., and I. döt Net, “YAML Ain’t Markup Language, Version 1.2.2”, October 2021.
- [JSON Schema] Wright, A., Andrews, H., Hutton, B., “JSON Schema: A Media Type for Describing JSON Documents”, draft-bhutton-json-schema-01, June 2022.
Informative References
Section titled “Informative References”- [MCP Protocol] Anthropic, “Model Context Protocol Specification”, https://modelcontextprotocol.io
- [OpenAPI 3.1] OpenAPI Initiative, “OpenAPI Specification v3.1.0”, https://spec.openapis.org/oas/v3.1.0
- [Semantic Versioning] Preston-Werner, T., “Semantic Versioning 2.0.0”, https://semver.org