Skip to content

docs: clarify that JSON response mode doesn't deliver notifications#1309

Closed
felixweinberger wants to merge 1 commit into
mainfrom
fweinberger/json-example-docs
Closed

docs: clarify that JSON response mode doesn't deliver notifications#1309
felixweinberger wants to merge 1 commit into
mainfrom
fweinberger/json-example-docs

Conversation

@felixweinberger
Copy link
Copy Markdown
Contributor

Clarifies that enableJsonResponse mode does not deliver notifications to the client.

Motivation and Context

Issue #866 reported confusion about notifications being silently dropped in JSON response mode. The example includes a multi-greet tool that sends notifications, but without explanation that these won't be delivered.

This was actually intentional (see PR #299: "Returning JSON is more limited in functionality as we are losing streaming tool notification/logging etc."), but the example didn't make this clear.

How Has This Been Tested?

Documentation-only change.

Breaking Changes

None.

Types of changes

  • 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

Fixes #866

Add comments explaining that enableJsonResponse mode does not deliver
notifications to the client, and that the multi-greet tool is included
to demonstrate the difference vs SSE mode.
@sonarqubecloud
Copy link
Copy Markdown

@pkg-pr-new
Copy link
Copy Markdown

pkg-pr-new Bot commented Dec 16, 2025

Open in StackBlitz

npm i https://pkg.pr.new/modelcontextprotocol/typescript-sdk/@modelcontextprotocol/sdk@1309

commit: 7977c14

@felixweinberger felixweinberger deleted the fweinberger/json-example-docs branch February 9, 2026 13:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Notifications with StreamableHTTPServerTransport and enableJsonResponse = true

1 participant