Skip to content

Commit c8c934a

Browse files
Merge branch 'main' into feat/user-agent
2 parents 9040099 + aef89e1 commit c8c934a

File tree

82 files changed

+17179
-1367
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

82 files changed

+17179
-1367
lines changed

AGENTS.md

Lines changed: 37 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,37 @@
1+
# Model Context Protocol (MCP)
2+
3+
This repository contains the MCP specification, documentation, and blog.
4+
5+
## Documentation Structure
6+
7+
- `docs/` - Mintlify site (`npm run serve:docs`)
8+
- `docs/docs/` - guides and tutorials
9+
- `docs/specification/` - MCP specification (more formal, versioned)
10+
- `blog/` - Hugo blog (`npm run serve:blog`)
11+
12+
## Specification Versioning
13+
14+
Specifications use **date-based versioning** (YYYY-MM-DD), not semantic versioning:
15+
16+
- `schema/[YYYY-MM-DD]/` and `docs/specification/[YYYY-MM-DD]/` - released versions
17+
- `schema/draft/` and `docs/specification/draft/` - in-progress work
18+
19+
## Schema Generation
20+
21+
TypeScript files are the **source of truth** for the protocol schema:
22+
23+
- Edit: `schema/[version]/schema.ts`
24+
- Generate JSON + docs: `npm run generate:schema`
25+
- This creates both `schema/[version]/schema.json` and the Schema Reference document in `docs/specification/[version]/schema.mdx`
26+
27+
Always regenerate after editing schema files.
28+
29+
## Useful Commands
30+
31+
```bash
32+
npm run serve:docs # Local Mintlify docs server
33+
npm run serve:blog # Local Hugo blog server
34+
npm run generate:schema # Generate JSON schemas + MDX from TypeScript
35+
npm run check:docs # Check formatting and links
36+
npm run check # Run all checks
37+
```

CLAUDE.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1 @@
1+
AGENTS.md

GOVERNANCE.md

Lines changed: 11 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,11 @@
1+
General Project Policies
2+
3+
Model Context Protocol has been established as Model Context Protocol a Series of LF Projects, LLC. Policies applicable to Model Context Protocol and participants in Model Context Protocol, including guidelines on the usage of trademarks, are located at [https://www.lfprojects.org/policies/](https://www.lfprojects.org/policies/). Governance changes approved as per the provisions of this governance document must also be approved by LF Projects, LLC.
4+
5+
Model Context Protocol participants acknowledge that the copyright in all new contributions will be retained by the copyright holder as independent works of authorship and that no contributor or copyright holder will be required to assign copyrights to the project.
6+
7+
Except as described below, all code and specification contributions to the project must be made using the Apache License, Version 2.0 (available here: [https://www.apache.org/licenses/LICENSE-2.0](https://www.apache.org/licenses/LICENSE-2.0)) (the “Project License”).
8+
9+
All outbound code and specifications will be made available under the Project License. The Core Maintainers may approve the use of an alternative open license or licenses for inbound or outbound contributions on an exception basis.
10+
11+
All documentation (excluding specifications) will be made available under Creative Commons Attribution 4.0 International license, available at: https://creativecommons.org/licenses/by/4.0.

MAINTAINERS.md

Lines changed: 7 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -70,6 +70,7 @@ This document lists current maintainers in the Model Context Protocol project.
7070
### Rust SDK
7171

7272
- [Alex Hancock](https://github.com/alexhancock)
73+
- [Michael Bolin](https://github.com/bolinfest)
7374

7475
### PHP SDK
7576

@@ -148,6 +149,7 @@ This document lists current maintainers in the Model Context Protocol project.
148149
### Financial Services Interest Group
149150

150151
- [Sambhav Kothari](https://github.com/sambhav)
152+
- [Peder Holdgaard Pedersen](https://github.com/PederHP)
151153

152154
### Transports Interest Group
153155

@@ -166,6 +168,11 @@ This document lists current maintainers in the Model Context Protocol project.
166168
- [Luca Chang](https://github.com/LucaButBoring)
167169
- [Inna Harper](https://github.com/ihrpr)
168170

171+
### MCP Apps Working Group
172+
173+
- [Liad Yosef](https://github.com/liady)
174+
- [Ido Salomon](https://github.com/idosal)
175+
169176
## About This Document
170177

171178
This document is updated by the MCP maintainers and reflects the current

README.md

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,15 +1,15 @@
11
# Model Context Protocol (MCP)
22

3-
_Just heard of MCP and not sure where to start? See [the documentation website instead](https://modelcontextprotocol.io)._
3+
_Just heard of MCP and not sure where to start? Check out our [documentation website](https://modelcontextprotocol.io)._
44

55
This repo contains the:
66

77
- MCP specification
88
- MCP protocol schema
99
- Official MCP documentation
1010

11-
The schema is [defined in TypeScript](schema/2025-06-18/schema.ts) first, but
12-
[made available as JSON Schema](schema/2025-06-18/schema.json) as well, for wider
11+
The schema is [defined in TypeScript](schema/2025-11-25/schema.ts) first, but
12+
[made available as JSON Schema](schema/2025-11-25/schema.json) as well, for wider
1313
compatibility.
1414

1515
The official MCP documentation is built using Mintlify and available at

blog/content/_index.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,3 +1,3 @@
11
+++
2-
title = 'blog'
2+
title = 'Model Context Protocol Blog'
33
+++

0 commit comments

Comments
 (0)