Skip to main content
This page describes when a Specification Enhancement Proposal (SEP) is required and the procedure from pull request to Final. A SEP is a design document that gives a concise technical specification of a feature or process and its rationale. Its author is responsible for building consensus and recording dissenting opinions. SEP-1850 adopted the process and SEP-2484 the conformance gate. Changing either requires a Process SEP. The sponsorship rules on this page follow SEP-3398.

When you need a SEP

Write a SEP for:
  • A new, changed or removed protocol feature or method (a new RPC method such as tools/execute, a new capability negotiation field, a change to a transport)
  • Any change that is not backward compatible
  • A change to message formats or schema structure
  • An interoperability convention supported outside the core specification
  • A governance or process change
  • Anything controversial or with several plausible designs, such as a change to how authorization works
Bug fixes, clarifications, editorial changes, new examples for existing features, schema fixes that do not change behavior, and tests go in an ordinary pull request. Amendments to the governance document itself follow the procedure in SEP-2085, not this process. If unsure, ask in Discord first.

SEP types

  • Standards Track: a new protocol feature or implementation, or an interoperability standard supported outside the core specification.
  • Informational: a design issue or guidance for the community, with no new feature.
  • Process: a process surrounding MCP, or a change to one.
  • Extensions Track: a protocol extension. It receives the same review and acceptance as Standards Track. An accepted Extensions Track SEP moves the extension to Beta, and a second one moves it to Stable (see Extension Lifecycle for the stages).

Before you write

A SEP needs a working group to sponsor it before formal review (see Sponsors). To get a working group’s sponsorship:
  1. Check whether the idea fits the current focus on the roadmap. SEPs outside its priority areas face a longer queue and a higher bar (see SEP Prioritization).
  2. Bring the idea to the working group that covers the area, in its Discord channel or at a meeting (see Joining a group). An interest group can help frame the problem first, and a working group sponsors the SEP.
  3. Reach consensus in the working group, then draft a SEP that the group wants to sponsor. Read the design principles, try the idea as an extension first where its shape allows, and build a prototype that meets the Prototype Requirements.
  4. The working group brings the SEP to the Core Maintainers for review through the Workflow.
If an interest group covers the area and no working group does, the interest group can start a working group for the idea through the forming a group process, and that working group sponsors the SEP. This is the normal path for areas an interest group owns. If no working or interest group covers the area, propose a new working group through the forming a group process. A thread in #general on Discord can help find people to join a new working group.

Workflow

  1. Copy seps/TEMPLATE.md to seps/0000-<slug>.md and fill it in.
  2. Open a pull request against the specification repository, titled sep: <description> as in sep: propose task cancellation, following the pull request title guidelines. Authors who are not members of the modelcontextprotocol GitHub organization ask the working group’s leads or the sponsor to open the pull request and name them as the author.
  3. The SEP number is the PR number. Rename the file (PR #1850 becomes seps/1850-<slug>.md), update the header, and run npm run generate:seps, or the check:seps CI job fails. Rename the pull request to sep(SEP-1850): <description>; a follow-up commit is enough, with no amend or force-push. Later pull requests about this SEP keep SEP-1850 as their scope and link to it in the description.
  4. Until a working group has agreed to sponsor the SEP, it stays a draft pull request. A draft pull request is for developing a proposal in the open. It is not yet in the SEP process, the Status header in the SEP stays unset, and the wg-support-needed label marks it.
  5. Once a working group has agreed to sponsor the SEP, the pull request is marked ready for review. The Sponsor header names the person who acts on the sponsoring group’s behalf, and that person sets draft. Review takes place in PR comments.
  6. When the SEP is ready, the sponsor confirms that the prior discussion happened and is linked in the pull request description, sets in-review, and puts it on the Core Maintainer meeting agenda. The author and sponsor may present it.
  7. Core Maintainers decide under Review and acceptance. The sponsor records the outcome, accepted or rejected, on the PR and in the SEP header.
  8. For an accepted SEP, the author adds to the same PR: the specification prose, the schema.ts changes with regenerated output (see CONTRIBUTING.md), a changelog entry, and any required documentation edits (for a deprecation, the four edits under Deprecating a Feature). The reference implementation is completed where it lives: an SDK branch, a fork or a standalone repository (see Prototype Requirements). For a Standards Track SEP with observable protocol behavior, the conformance scenario and sep-NNNN.yaml are merged (see Conformance Test Requirement). SDK implementations are not required for Final.
  9. The sponsor verifies these artifacts and sets final. The PR is then merged.
The eight Status values, also defined on the SEP index: A SEP that has no sponsor after 180 days is marked dormant and its PR is closed. Dormant is not rejected: a dormant SEP is revived by finding a sponsor and reopening the PR, which returns it to draft.

Sponsors

A working group sponsors a SEP. The Core Maintainers can also sponsor one. Both paths lead to the same review and the same acceptance requirements.
  • Working group sponsorship: the working group whose scope the SEP falls in approves it through its decision-making process. Before you write covers how a working group comes to sponsor a SEP.
  • Core Maintainer sponsorship: the Core Maintainers agree to sponsor the SEP and designate a Core Maintainer to represent them. No separate working group approval is required, and the designated Core Maintainer consults the relevant working groups. Note that this path is the exception. In general Core Maintainers will not sponsor SEPs. The usual case is a proposal that comes from the Core Maintainers directly.
The Sponsor header names the Maintainer or Core Maintainer who acts on the sponsoring group’s behalf, as in Name (@handle), on behalf of the Transports Working Group or Name (@handle), on behalf of the Core Maintainers. A qualified WG Lead may fill this role for a working group. For the Core Maintainers, the designated Core Maintainer does. The rest of this page calls this person the sponsor. The sponsor is responsible for the SEP’s status and labels and for tracking its implementation. The sponsor reviews the proposal and requests changes, presents it with the author, brings it to the Core Maintainers for review, verifies the Final artifacts, and makes every status change in the Workflow. That covers the Status field in the SEP file, which is canonical, and the matching PR label, which is for filtering. A sponsor without write access to the branch sets the field through the author. Authors do not edit Status or labels themselves. They ask their sponsor. The sponsoring group, the sponsor and the author are responsible for moving the SEP forward. When the author cannot open pull requests on the repository, one of the working group’s leads or the sponsor opens the pull request and names the author. The SEP is numbered from that pull request as usual. A WG Lead may also triage and close in-scope SEPs under Leadership, subject to appeal to Core Maintainers.

Prototype Requirements

A SEP needs a working prototype before it can be accepted: an implementation in an official SDK as a branch or fork, a standalone proof of concept of the key mechanics, integration tests that exercise the proposed behavior, or a reference server or client. The prototype should show that the core functionality works as described and that the API design is practical and ergonomic, surface edge cases and implementation problems, and be runnable by reviewers from included setup instructions. Pseudocode alone, or a design document without code, is not sufficient. Production quality is not required.

Review and acceptance

Core Maintainers review in-review SEPs at their meeting every two weeks under the decision process. The criteria are a working prototype, clear benefit to the MCP ecosystem, community support and consensus, and fit with the roadmap and the design principles. The outcome is accepted, rejected, or a return to draft with specific feedback recorded on the PR.

Conformance Test Requirement

A Standards Track SEP that introduces or modifies observable protocol behavior cannot reach final until the conformance repository has:
  • A scenario tagged with the SEP number, targeting the repository’s draft spec-version tag.
  • A traceability file, sep-NNNN.yaml, mapping every MUST, MUST NOT, SHOULD and SHOULD NOT in the SEP’s Specification section to a check ID or to a documented exclusion, with a tracking issue where the exclusion is a framework gap.
  • The scenario passing against the SEP’s reference implementation.
Process SEPs, Informational SEPs, and Standards Track SEPs with no observable protocol behavior (documentation clarifications, schema annotations that do not change validation, implementation-hardening recommendations) are exempt. Anyone may write the scenario: the SEP author, an SDK maintainer, or any other contributor. The sponsor confirms that it exists and that sep-NNNN.yaml covers every normative statement, and the conformance repository’s maintainers review the scenario PR for technical correctness. Writing the scenario before Core Maintainer review is encouraged, not required. SEP-2484 defines the traceability format and the dispute process.

After the decision

A rejected SEP may be revised against the recorded feedback and resubmitted, or answered with a competing SEP. Before Final, raise problems on the SEP’s PR. A Final SEP is a frozen record of the design as accepted. Where the specification has since diverged, the specification governs: report problems as issues against it, not as edits to the SEP. A SEP is withdrawn at the author’s request. The author or the sponsor sets withdrawn. A SEP that replaces an earlier one carries a Supersedes: line in its header, and the earlier SEP is set superseded. Ownership of a SEP may pass to a new author when the original author no longer has time for it or cannot be reached. The original author stays on as co-author if they wish. Disagreement with the author’s direction is not grounds for transfer. Write a competing SEP instead.

Template and tooling

SEP files live in seps/, and each file’s git history is the record of the proposal. seps/TEMPLATE.md gives the structure: a preamble, then Abstract, Motivation, Specification, Rationale, Backward Compatibility, Security Implications and Reference Implementation. The Abstract is about 200 words. Insufficient Motivation is by itself grounds for rejection. The Specification must be detailed enough for independent, interoperable implementations. In the Rationale, record the alternatives considered, the objections raised and the evidence of consensus. Backward Compatibility is mandatory whenever the SEP introduces an incompatibility, and states its severity and the migration path. Security Implications are stated explicitly, including when there are none. npm run generate:seps renders the files into docs/seps/, and npm run check:seps verifies that the rendered pages are current. For a worked example, see SEP-2567, a recent Final Standards Track SEP.