Skip to content

Clarify that empty cursors are valid cursors - #1942

Merged
olaservo merged 1 commit into
modelcontextprotocol:mainfrom
stephentoub:clarifyemptycursor
Dec 21, 2025
Merged

olaservo merged 1 commit into
modelcontextprotocol:mainfrom
stephentoub:clarifyemptycursor

Conversation

@stephentoub

Copy link
Copy Markdown
Contributor

Motivation and Context

The C# SDK has client APIs that automatically follow cursors, and we've received several reports of folks complaining that it's following an empty string cursor when it should instead treat it as end of results. Our understanding of the spec is clients should not be parsing cursors in any way, and thus an empty string is as valid a cursor as any. This PR is simply attempting to further clarify in order to remove any ambiguity around this case.

How Has This Been Tested?

n/a

Breaking Changes

No

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

@localden

localden commented Dec 9, 2025

Copy link
Copy Markdown
Contributor

This seems like a surgical clarification/documentation change, so no concerns on my part.

@localden localden added documentation Improvements or additions to documentation enhancement New feature or request labels Dec 9, 2025
@olaservo
olaservo merged commit 630db61 into modelcontextprotocol:main Dec 21, 2025
2 checks passed
@stephentoub
stephentoub deleted the clarifyemptycursor branch December 21, 2025 03:40
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

documentation Improvements or additions to documentation enhancement New feature or request

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants