Skip to content

docs: document tool list changed notifications#1857

Open
nielskaspers wants to merge 2 commits intomodelcontextprotocol:mainfrom
nielskaspers:docs/issue-1132-tool-list-changed-notification
Open

docs: document tool list changed notifications#1857
nielskaspers wants to merge 2 commits intomodelcontextprotocol:mainfrom
nielskaspers:docs/issue-1132-tool-list-changed-notification

Conversation

@nielskaspers
Copy link
Copy Markdown
Contributor

Summary

  • Add documentation for the tool list changed notification feature to the server guide
  • Include a type-checked example showing automatic and manual notification usage

Issue

Closes #1132

Changes

  • docs/server.md: Add "List changed notifications" subsection under Tools, covering automatic notification on registerTool() and manual sendToolListChanged(), with cross-reference to client-side listChanged option
  • examples/server/src/serverGuide.examples.ts: Add sendToolListChanged_basic example region

Testing

  • Example is type-checked as part of the existing examples build
  • Documentation follows the existing format with source= references and {@linkcode} tags

Add a "List changed notifications" subsection to the Tools section
in the server guide, explaining how McpServer automatically notifies
clients when tools are registered at runtime and how to send the
notification manually via sendToolListChanged().

Include a type-checked example in serverGuide.examples.ts and a
cross-reference to the client-side listChanged option.

Closes modelcontextprotocol#1132
@nielskaspers nielskaspers requested a review from a team as a code owner April 6, 2026 06:16
@changeset-bot
Copy link
Copy Markdown

changeset-bot bot commented Apr 6, 2026

⚠️ No Changeset found

Latest commit: 6dae484

Merging this PR will not cause a version bump for any packages. If these changes should not result in a new version, you're good to go. If these changes should result in a version bump, you need to add a changeset.

This PR includes no changesets

When changesets are added to this PR, you'll see the packages that this PR includes changesets for and the associated semver types

Click here to learn what changesets are, and how to add one.

Click here if you're a maintainer who wants to add a changeset to this PR

@pkg-pr-new
Copy link
Copy Markdown

pkg-pr-new bot commented Apr 6, 2026

Open in StackBlitz

@modelcontextprotocol/client

npm i https://pkg.pr.new/@modelcontextprotocol/client@1857

@modelcontextprotocol/server

npm i https://pkg.pr.new/@modelcontextprotocol/server@1857

@modelcontextprotocol/express

npm i https://pkg.pr.new/@modelcontextprotocol/express@1857

@modelcontextprotocol/fastify

npm i https://pkg.pr.new/@modelcontextprotocol/fastify@1857

@modelcontextprotocol/hono

npm i https://pkg.pr.new/@modelcontextprotocol/hono@1857

@modelcontextprotocol/node

npm i https://pkg.pr.new/@modelcontextprotocol/node@1857

commit: 6dae484

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.

Question: Tool list changed notification

1 participant