Skip to content

Commit 2d8014a

Browse files
authored
Merge pull request modelcontextprotocol#969 from modelcontextprotocol/SEP-001-improvements-qualification
docs: Add Qualification section to clarify when to use SEP vs PR
2 parents eba3959 + 9e246bb commit 2d8014a

File tree

1 file changed

+16
-1
lines changed

1 file changed

+16
-1
lines changed

docs/community/sep-guidelines.mdx

Lines changed: 16 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -11,6 +11,21 @@ We intend SEPs to be the primary mechanisms for proposing major new features, fo
1111

1212
Because the SEPs are maintained as text files in a versioned repository (GitHub Issues), their revision history is the historical record of the feature proposal.
1313

14+
## What qualifies a SEP?
15+
16+
The goal is to reserve the SEP process for changes that are substantial enough to require broad community discussion, a formal design document, and a historical record of the decision-making process. A regular GitHub issue or pull request is often more appropriate for smaller, more direct changes.
17+
18+
Consider proposing a SEP if your change involves any of the following:
19+
20+
- **A New Feature or Protocol Change**: Any change that adds, modifies, or removes features in the Model Context Protocol. This includes:
21+
- Adding new API endpoints or methods.
22+
- Changing the syntax or semantics of existing data structures or messages.
23+
- Introducing a new standard for interoperability between different MCP-compatible tools.
24+
- Significant changes to how the specification itself is defined, presented, or validated.
25+
- **A Breaking Change**: Any change that is not backwards-compatible.
26+
- **A Change to Governance or Process**: Any proposal that alters the project's decision-making, contribution guidelines (like this document itself).
27+
- **A Complex or Controversial Topic**: If a change is likely to have multiple valid solutions or generate significant debate, the SEP process provides the necessary framework to explore alternatives, document the rationale, and build community consensus before implementation begins.
28+
1429
## SEP Types
1530

1631
There are three kinds of SEP:
@@ -44,7 +59,7 @@ The standard SEP workflow is:
4459
1. You, the SEP author, create a well-formatted GitHub Issue with the proposal and SEP tags
4560
2. Find a Core Maintainer or Maintainer to sponsor your proposal. Core Maintainers and Maintainers will regularly go over the list of open proposals to determine which proposals to sponsor. Once a sponsor is found, the sponsor is "assigned" to the issue and a milestone is assigned. The tag `draft` is added. At this point a unique SEP number is assigned.
4661
3. The sponsor will review and may request changes before formal review, based on community feedback. Once ready for review, the tag `in-review` is added.
47-
4. Once sponsored, the SEP enters formal review by the core team
62+
4. Once tagged `in-review`, the SEP enters formal review by the core team
4863
5. The SEP may be accepted, rejected, or returned for revision.
4964
6. If the SEP has not found a sponsor within three months, core-maintainers are free to close the SEP as `dormant`.
5065

0 commit comments

Comments
 (0)