Skip to content

Bug & Doc Fixes for SEP-2322: MRTR Docs - #2725

Merged
CaitieM20 merged 10 commits into
modelcontextprotocol:mainfrom
CaitieM20:mrtr-bugfixes
May 15, 2026
Merged

CaitieM20 merged 10 commits into
modelcontextprotocol:mainfrom
CaitieM20:mrtr-bugfixes

Conversation

@CaitieM20

Copy link
Copy Markdown
Contributor

Motivation and Context

Fixing some minor bugs/docs issues with SEP-2322 MRTR that were missed in the initial pull request:

  • Including Changelog entry
  • Updating examples to include required field ResultType
  • Fixing docs where IncompleteResult was still used should be InputRequiredResult.
  • SEP has the wrong status Accepted should be Approved

How Has This Been Tested?

Breaking Changes

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Documentation
  • My code follows the repository's style guidelines
  • New and existing tests pass locally
  • I have added appropriate error handling
  • I have added or updated documentation as needed

Additional context

@CaitieM20
CaitieM20 requested review from a team as code owners May 15, 2026 00:39
@CaitieM20
CaitieM20 requested review from kurtisvg and pja-ant May 15, 2026 00:39
@CaitieM20 CaitieM20 added bug Something isn't working documentation Improvements or additions to documentation roadmap/transport Roadmap: Transport Evolution & Scalability (incl. Server Cards) labels May 15, 2026
pja-ant
pja-ant previously approved these changes May 15, 2026
kurtisvg
kurtisvg previously approved these changes May 15, 2026
pja-ant added a commit that referenced this pull request May 15, 2026
…ward compat

- Remove `@default "complete"` from `Result.resultType` in schema.ts. A
  required field has no default; the JSDoc and generated JSON Schema
  annotation gave the false impression that omitting it is conformant.
- Add JSDoc explaining the actual model: servers implementing this
  protocol version MUST include `resultType`; clients MUST treat an
  absent `resultType` from older servers as "complete".
- Fix the TypeScript snippet in basic/index.mdx, which placed
  `resultType` as a sibling of `result` in the JSON-RPC envelope. Per
  the schema it is a field of `Result` and lives inside `result`.
- Split the contradictory sentence "MUST be included … if not specified
  assume complete" into a server requirement and a separate client-side
  backward-compatibility rule for results from earlier protocol versions.
- Add the missing verb ("indicates") in the two ResultType definition
  bullets, and fix "poly-morphic" -> "polymorphic".
- Regenerate schema.json and schema.mdx.

Note: 19 example JSON files that omit resultType are unchanged by this
PR; #2725 adds resultType to those examples.
pja-ant and others added 2 commits May 15, 2026 16:31
…ward compat

- Remove `@default "complete"` from `Result.resultType` in schema.ts. A
  required field has no default; the JSDoc and generated JSON Schema
  annotation gave the false impression that omitting it is conformant.
- Add JSDoc explaining the actual model: servers implementing this
  protocol version MUST include `resultType`; clients MUST treat an
  absent `resultType` from older servers as "complete".
- Fix the TypeScript snippet in basic/index.mdx, which placed
  `resultType` as a sibling of `result` in the JSON-RPC envelope. Per
  the schema it is a field of `Result` and lives inside `result`.
- Split the contradictory sentence "MUST be included … if not specified
  assume complete" into a server requirement and a separate client-side
  backward-compatibility rule for results from earlier protocol versions.
- Add the missing verb ("indicates") in the two ResultType definition
  bullets, and fix "poly-morphic" -> "polymorphic".
- Regenerate schema.json and schema.mdx.

Note: 19 example JSON files that omit resultType are unchanged by this
PR; modelcontextprotocol#2725 adds resultType to those examples.
@CaitieM20
CaitieM20 dismissed stale reviews from kurtisvg and pja-ant via 107ed22 May 15, 2026 18:30
@CaitieM20

Copy link
Copy Markdown
Contributor Author

@pja-ant I merged in your changes proposed here since they are all related #2726

@CaitieM20
CaitieM20 merged commit c410707 into modelcontextprotocol:main May 15, 2026
5 checks passed
@CaitieM20
CaitieM20 deleted the mrtr-bugfixes branch May 15, 2026 18:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

bug Something isn't working documentation Improvements or additions to documentation roadmap/transport Roadmap: Transport Evolution & Scalability (incl. Server Cards)

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants