Improve docs on how to use `instructions` on `InitializeResult`

[felixweinberger]

Question

Lots of people want tool bundling / grouping / namespaces to guide servers how to use tools together.

We should make instructions more obvious and have examples for how to use it - maybe this can address a lot of requests for bundling and namespaces if it's more obvious this is something you can do.

https://modelcontextprotocol.io/specification/2025-06-18/schema#initializeresult-instructions

Additional Context

No response

[ChenyangLi4288]

Hi Felix,

If I am trying to provide with more obvious examples. Should I open a PR to modelcontextprotocol and edit the 'draft' version?

Thanks!

[maxisbey]

Hi Felix,

If I am trying to provide with more obvious examples. Should I open a PR to modelcontextprotocol and edit the 'draft' version?

Thanks!

I think this is more about how to do it in the Python SDK rather than the protocol itself. If you'd like to make a PR for this repo with examples for how to use instructions with the SDK then feel free!