Skip to content

Commit 8ccee39

Browse files
authored
Merge branch 'main' into thisistonydang/catch-error
2 parents 0508454 + 7b429d4 commit 8ccee39

File tree

80 files changed

+11141
-14138
lines changed

Some content is hidden

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

80 files changed

+11141
-14138
lines changed

.github/CODEOWNERS

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
# CODEOWNERS file for MCP Specification repository
22

3-
# General documentation ownership - @modelcontextprotocol/docs-maintaners owns all of /docs
4-
/docs/ @modelcontextprotocol/docs-maintaners
3+
# General documentation ownership - @modelcontextprotocol/docs-maintaners and core-maintainers own all of /docs
4+
/docs/ @modelcontextprotocol/docs-maintaners @modelcontextprotocol/core-maintainers
55

66
# Specific ownership - @core-maintainer team owns docs/specification and schema/ directories
77
/docs/specification/ @modelcontextprotocol/core-maintainers

.prettierrc.json

Lines changed: 20 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,20 @@
1+
{
2+
"printWidth": 140,
3+
"tabWidth": 4,
4+
"useTabs": false,
5+
"semi": true,
6+
"singleQuote": true,
7+
"trailingComma": "none",
8+
"bracketSpacing": true,
9+
"bracketSameLine": false,
10+
"proseWrap": "always",
11+
"arrowParens": "avoid",
12+
"overrides": [
13+
{
14+
"files": "**/*.md",
15+
"options": {
16+
"printWidth": 280
17+
}
18+
}
19+
]
20+
}

ANTITRUST.md

Lines changed: 53 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,53 @@
1+
**MCP Project Antitrust Policy**
2+
3+
**Antitrust Policy**
4+
5+
Effective: September 29, 2025
6+
7+
**Introduction**
8+
9+
The goal of the Model Context Protocol open source project (the “Project”) is to develop a universal standard for model-to-world interactions, including enabling LLMs and agents to seamlessly connect with and utilize external data sources and tools. The purpose of this Antitrust Policy (the “Policy”) is to avoid antitrust risks in carrying out this pro-competitive mission.
10+
11+
Participants in and contributors to the Project (collectively, “participants”) will use their best reasonable efforts to comply in all respects with all applicable state and federal antitrust and trade regulation laws, and applicable antitrust/competition laws of other countries (collectively, the “Antitrust Laws”).
12+
13+
The goal of Antitrust Laws is to encourage vigorous competition. Nothing in this Policy prohibits or limits the ability of participants to make, sell or use any product, or otherwise to compete in the marketplace. This Policy provides general guidance on compliance with Antitrust Law. Participants should contact their respective legal counsel to address specific questions.
14+
15+
This Policy is conservative and is intended to promote compliance with the Antitrust Laws, not to create duties or obligations beyond what the Antitrust Laws actually require. In the event of any inconsistency between this Policy and the Antitrust Laws, the Antitrust Laws preempt and control.
16+
17+
**Participation**
18+
19+
Technical participation in the Project shall be open to all, subject only to compliance with the provisions of the Project’s charter and other governance documents.
20+
21+
**Conduct of Meetings**
22+
23+
At meetings among actual or potential competitors, there is a risk that participants in those meetings may improperly disclose or discuss information in violation of the Antitrust Laws or otherwise act in an anti-competitive manner. To avoid this risk, participants must adhere to the following policies when participating in Project-related or sponsored meetings, conference calls, or other forums (collectively, “Project Meetings”).
24+
25+
Participants must not, in fact or appearance, discuss or exchange information regarding:
26+
27+
- An individual company’s current or projected prices, price changes, price differentials, markups, discounts, allowances, terms and conditions of sale, including credit terms, etc., or data that bear on prices, including profits, margins or cost.
28+
- Industry-wide pricing policies, price levels, price changes, differentials, or the like.
29+
- Actual or projected changes in industry production, capacity or inventories.
30+
- Matters relating to bids or intentions to bid for particular products, procedures for responding to bid invitations or specific contractual arrangements.
31+
- Plans of individual companies concerning the design, characteristics, production, distribution, marketing or introduction dates of particular products, including proposed territories or customers.
32+
- Matters relating to actual or potential individual suppliers that might have the effect of excluding them from any market or of influencing the business conduct of firms toward such suppliers.
33+
- Matters relating to actual or potential customers that might have the effect of influencing the business conduct of firms toward such customers.
34+
- Individual company current or projected cost of procurement, development or manufacture of any product.
35+
- Individual company market shares for any product or for all products.
36+
- Confidential or otherwise sensitive business plans or strategy.
37+
38+
In connection with all Project Meetings, participants must do the following:
39+
40+
- Adhere to prepared agendas.
41+
- Insist that meeting minutes be prepared and distributed to all participants, and that meeting minutes accurately reflect the matters that transpired.
42+
- Consult with their respective counsel on all antitrust questions related to Project Meetings.
43+
- Protest against any discussions that appear to violate these policies or the Antitrust Laws, leave any meeting in which such discussions continue, and either insist that such protest be noted in the minutes.
44+
45+
**Requirements/Standard Setting**
46+
47+
The Project may establish standards, technical requirements and/or specifications for use (collectively, “requirements”). Participants shall not enter into agreements that prohibit or restrict any participant from establishing or adopting any other requirements. Participants shall not undertake any efforts, directly or indirectly, to prevent any firm from manufacturing, selling, or supplying any product not conforming to a requirement.
48+
49+
The Project shall not promote standardization of commercial terms, such as terms for license and sale.
50+
51+
**Contact Information**
52+
53+
To contact the Project regarding matters addressed by this Antitrust Policy, please send an email to [email protected], and reference “Antitrust Policy” in the subject line.

CONTRIBUTING.md

Lines changed: 67 additions & 17 deletions
Original file line numberDiff line numberDiff line change
@@ -18,37 +18,38 @@ The following software is required to work on the spec:
1818
### Getting Started
1919

2020
1. [Fork the repository](https://docs.github.com/en/pull-requests/collaborating-with-pull-requests/working-with-forks/fork-a-repo)
21+
2122
2. Clone your fork:
2223

23-
```bash
24-
git clone https://github.com/YOUR-USERNAME/modelcontextprotocol.git
25-
cd modelcontextprotocol
26-
```
24+
```bash
25+
git clone https://github.com/YOUR-USERNAME/modelcontextprotocol.git
26+
cd modelcontextprotocol
27+
```
2728

2829
3. Install dependencies:
2930

30-
```bash
31-
nvm install # install correct Node version
32-
npm install # install dependencies
33-
```
31+
```bash
32+
nvm install # install correct Node version
33+
npm install # install dependencies
34+
```
3435

35-
## Schema changes
36+
4. Create a new branch:
37+
38+
```bash
39+
git checkout -b feature/your-feature-name
40+
```
3641

37-
Note that schema changes are made to `schema.ts`, and `schema.json` is generated from
38-
`schema.ts`.
42+
## Schema changes
3943

40-
1. Create a new branch:
44+
Schema changes go in `schema/draft/schema.ts`. To validate your changes, run:
4145

4246
```bash
43-
git checkout -b feature/your-feature-name
47+
npm run check:schema:ts
4448
```
4549

46-
2. Make your changes.
47-
48-
3. Validate schema changes and generate `schema.json`:
50+
`schema/draft/schema.json` and `docs/specification/draft/schema.mdx` are generated from `schema/draft/schema.ts`; do not edit them directly. To generate them, run:
4951

5052
```bash
51-
npm run check:schema:ts
5253
npm run generate:schema
5354
```
5455

@@ -120,6 +121,55 @@ When contributing to the documentation:
120121
3. Follow the pull request template
121122
4. Wait for review
122123

124+
## AI Contributions
125+
126+
> [!IMPORTANT]
127+
>
128+
> If you are using **any kind of AI assistance** to contribute to Model Context Protocol,
129+
> it must be disclosed in the pull request or issue.
130+
131+
We welcome and encourage the use of AI tools to help improve Model Context Protocol. Many valuable contributions
132+
have been enhanced with AI assistance for code generation, issue detection, and feature definition.
133+
134+
That being said, if you are using any kind of AI assistance (e.g., agents such as Claude Code, ChatGPT)
135+
while contributing to Model Context Protocol, **this must be disclosed in the pull request or issue**,
136+
along with the extent to which AI assistance was used (e.g., documentation comments vs. code generation).
137+
138+
If your PR responses or comments are being generated by an AI, disclose that as well.
139+
140+
As an exception, trivial spacing or typo fixes don't need to be disclosed, so long as the changes are
141+
limited to small parts of the code or short phrases.
142+
143+
An example disclosure:
144+
145+
> This PR was written primarily by Claude Code.
146+
147+
Or a more detailed disclosure:
148+
149+
> I consulted ChatGPT to understand the codebase but the solution
150+
> was fully authored manually by myself.
151+
152+
Failure to disclose this is first and foremost rude to the human operators on the other end of the pull request,
153+
but it also makes it difficult to determine how much scrutiny to apply to the contribution.
154+
155+
In a perfect world, AI assistance would produce equal or higher quality work than any human. That isn't the world
156+
we live in today, and in most cases where human supervision or expertise is not in the loop, it's generating code
157+
or changes that cannot be reasonably maintained or evolved.
158+
159+
### What we're looking for
160+
161+
When submitting AI-assisted contributions, please ensure they include:
162+
163+
- **Clear disclosure of AI use** - You are transparent about AI use and degree to which you're using it for the contribution
164+
- **Human understanding** - You personally understand what the changes do
165+
- **Clear rationale** - You can explain why the change is needed and how it fits within Model Context Protocol goals
166+
- **Concrete evidence** - Include test cases, scenarios, or examples that demonstrate the improvement
167+
- **Your own analysis** - Share your thoughts on the end-to-end experience
168+
169+
### What we'll close
170+
171+
We reserve the right to close submissions that appear to not follow the disclosure policy.
172+
123173
## License
124174

125175
By contributing, you agree that your contributions will be licensed under the MIT

MAINTAINERS.md

Lines changed: 34 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2,7 +2,7 @@
22

33
This document lists current maintainers in the Model Context Protocol project.
44

5-
**Last updated:** August 17, 2025
5+
**Last updated:** October 15, 2025
66

77
## Lead Maintainers
88

@@ -41,6 +41,8 @@ This document lists current maintainers in the Model Context Protocol project.
4141
### Go SDK
4242

4343
- [Rob Findley](https://github.com/findleyr)
44+
- [Jonathan Amsterdam](https://github.com/jba)
45+
- [Sam Thanawalla](https://github.com/samthanawalla)
4446

4547
### C# SDK
4648

@@ -56,8 +58,8 @@ This document lists current maintainers in the Model Context Protocol project.
5658

5759
- [Inna Harper](https://github.com/ihrpr)
5860
- [Jerome Swannack](https://github.com/jerome3o)
59-
- [Samuel Colvin](https://github.com/samuelcolvin)
6061
- [Marcelo Trylesinski](https://github.com/Kludex)
62+
- [Max Isbey](https://github.com/maxisbey)
6163

6264
### TypeScript SDK
6365

@@ -69,6 +71,11 @@ This document lists current maintainers in the Model Context Protocol project.
6971

7072
- [Alex Hancock](https://github.com/alexhancock)
7173

74+
### PHP SDK
75+
76+
- [Kyrian Obikwelu](https://github.com/CodeWithKyrian)
77+
- [Christopher Hertel](https://github.com/chr-hertel)
78+
7279
## Project Maintainers
7380

7481
### use-mcp
@@ -77,14 +84,22 @@ This document lists current maintainers in the Model Context Protocol project.
7784

7885
### Inspector
7986

80-
- [Ola Hungerford](https://github.com/olaservo)
8187
- [Cliff Hall](https://github.com/cliffhall)
88+
- [Konstantin Konstantinov](https://github.com/KKonstantinov)
89+
- [Ola Hungerford](https://github.com/olaservo)
8290

8391
### Registry
8492

8593
- [Toby Padilla](https://github.com/toby)
8694
- [Tadas Antanavicius](https://github.com/tadasant)
8795
- [Adam Jones](https://github.com/domdomegg)
96+
- [Radoslav (Rado) Dimitrov](https://github.com/rdimitrov)
97+
98+
### MCPB (Model Context Protocol Bundle)
99+
100+
- [Alexander Sklar](https://github.com/asklar)
101+
- [Adam Jones](https://github.com/domdomegg)
102+
- [Joan Xie](https://github.com/joan-anthropic)
88103

89104
### Reference Servers
90105

@@ -120,9 +135,19 @@ This document lists current maintainers in the Model Context Protocol project.
120135

121136
### Client Implementor Interest Group
122137

123-
- [Michael Feldstein](https://github.com/msfeldstein)
124-
- [Harald Kirschner](https://github.com/digitarald)
125-
- [Connor Peet](https://github.com/connor4312)
138+
**Note:** These individuals serve as MCP protocol representatives for their respective clients. For client-specific issues, use the official support channels provided by each product.
139+
140+
- [Alex Hancock](https://github.com/alexhancock) - Goose
141+
- [Ben Brandt](https://github.com/benbrandt) - Zed
142+
- [Connor Peet](https://github.com/connor4312) - VS Code
143+
- [Gabriel Peal](https://github.com/gpeal) - Codex
144+
- [Jun Han](https://github.com/formulahendry) - GitHub Copilot for JetBrains
145+
- [Tyler Leonhardt](https://github.com/TylerLeonhardt) - VS Code
146+
- [Michael Feldstein](https://github.com/msfeldstein) - Cursor
147+
148+
### Financial Services Interest Group
149+
150+
- [Sambhav Kothari](https://github.com/sambhav)
126151

127152
### Transports Interest Group
128153

@@ -135,8 +160,10 @@ This document lists current maintainers in the Model Context Protocol project.
135160

136161
- [Nick Cooper](https://github.com/nicknotfun)
137162

138-
### Long-Running / Async Tool Calls Working Group
163+
### Agents Working Group
139164

165+
- [Peter Alexander](https://github.com/pja-ant)
166+
- [Luca Chang](https://github.com/LucaButBoring)
140167
- [Inna Harper](https://github.com/ihrpr)
141168

142169
## About This Document

README.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -15,6 +15,10 @@ compatibility.
1515
The official MCP documentation is built using Mintlify and available at
1616
[modelcontextprotocol.io](https://modelcontextprotocol.io).
1717

18+
## Authors
19+
20+
The Model Context Protocol was created by David Soria Parra ([@dsp](https://github.com/dsp)) and Justin Spahr-Summers ([@jspahrsummers](https://github.com/jspahrsummers)).
21+
1822
## Contributing
1923

2024
See [CONTRIBUTING.md](./CONTRIBUTING.md).

blog/content/posts/2025-09-08-mcp-registry-preview.md

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -9,8 +9,8 @@ Today, we're launching the Model Context Protocol (MCP) Registry—an open catal
99

1010
The MCP Registry is now available in preview. To get started:
1111

12-
- **Add your server** by following our guide on [Adding Servers to the MCP Registry](https://github.com/modelcontextprotocol/registry/blob/main/docs/guides/publishing/publish-server.md) (for server maintainers)
13-
- **Access server data** by following our guide on [Accessing MCP Registry Data](https://github.com/modelcontextprotocol/registry/blob/main/docs/guides/consuming/use-rest-api.md) (for client maintainers)
12+
- **Add your server** by following our guide on [Adding Servers to the MCP Registry](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx) (for server maintainers)
13+
- **Access server data** by following our guide on [Accessing MCP Registry Data](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/registry-aggregators.mdx) (for client maintainers)
1414

1515
# Single source of truth for MCP servers
1616

@@ -20,7 +20,7 @@ Our goal is to standardize how servers are distributed and discovered, providing
2020

2121
## Public and private sub-registries
2222

23-
In building a central registry, it was important to us not to take away from existing registries that the community and companies have built. The MCP Registry serves as a primary source of truth for publicly available MCP servers, and organizations can choose to [create sub-registries](https://github.com/modelcontextprotocol/registry/blob/main/docs/guides/consuming/use-rest-api.md#building-a-subregistry) based on custom criteria. For example:
23+
In building a central registry, it was important to us not to take away from existing registries that the community and companies have built. The MCP Registry serves as a primary source of truth for publicly available MCP servers, and organizations can choose to [create sub-registries](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/registry-aggregators.mdx) based on custom criteria. For example:
2424

2525
**Public subregistries** like opinionated “MCP marketplaces” associated with each MCP client are free to augment and enhance data they ingest from the upstream MCP Registry. Every MCP end-user persona will have different needs, and it is up to the MCP client marketplaces to properly serve their end-users in opinionated ways.
2626

@@ -30,14 +30,14 @@ In both cases, the MCP Registry is the starting point – it’s the centralized
3030

3131
## Community-driven mechanism for moderation
3232

33-
The MCP Registry is an official MCP project maintained by the registry working group and permissively licensed. Community members can submit issues to flag servers that violate the MCP [moderation guidelines](https://github.com/modelcontextprotocol/registry/blob/main/docs/guides/administration/moderation-guidelines.md)—such as those containing spam, malicious code, or impersonating legitimate services. Registry maintainers can then denylist these entries and retroactively remove them from public access.
33+
The MCP Registry is an official MCP project maintained by the registry working group and permissively licensed. Community members can submit issues to flag servers that violate the MCP [moderation guidelines](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/moderation-policy.mdx)—such as those containing spam, malicious code, or impersonating legitimate services. Registry maintainers can then denylist these entries and retroactively remove them from public access.
3434

3535
# Getting started
3636

3737
To get started:
3838

39-
- **Add your server** by following our guide on [Adding Servers to the MCP Registry](https://github.com/modelcontextprotocol/registry/blob/main/docs/guides/publishing/publish-server.md) (for server maintainers)
40-
- **Access server data** by following our guide on [Accessing MCP Registry Data](https://github.com/modelcontextprotocol/registry/blob/main/docs/guides/consuming/use-rest-api.md) (for client maintainers)
39+
- **Add your server** by following our guide on [Adding Servers to the MCP Registry](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/quickstart.mdx) (for server maintainers)
40+
- **Access server data** by following our guide on [Accessing MCP Registry Data](https://github.com/modelcontextprotocol/registry/blob/main/docs/modelcontextprotocol-io/registry-aggregators.mdx) (for client maintainers)
4141

4242
This preview of the MCP Registry is meant to help us improve the user experience before general availability and does not provide data durability guarantees or other warranties. We advise MCP adopters to watch development closely as breaking changes may occur before the registry is made generally available.
4343

0 commit comments

Comments
 (0)