Skip to content

Document FastMCP server instructions#2515

Open
MukundaKatta wants to merge 1 commit into
modelcontextprotocol:mainfrom
MukundaKatta:codex/document-server-instructions
Open

Document FastMCP server instructions#2515
MukundaKatta wants to merge 1 commit into
modelcontextprotocol:mainfrom
MukundaKatta:codex/document-server-instructions

Conversation

@MukundaKatta
Copy link
Copy Markdown

Adds a README section showing how to use FastMCP instructions to communicate workflow guidance and tool ordering/grouping context to clients through InitializeResult.\n\nCloses #1464.\n\nVerification:\n- Documentation-only change

@MukundaKatta MukundaKatta force-pushed the codex/document-server-instructions branch from 425e460 to f1a7520 Compare April 28, 2026 05:28
@ryanwilliams90
Copy link
Copy Markdown

Hi @MukundaKatta — I started on #1464 today and posted a plan there before noticing this PR was already open. Apologies for the overlap.

Happy to defer if this lands. If it would be useful, I have a slightly broader take that I'm happy to either fold into this PR (with credit) or open separately if maintainers prefer:

  • A runnable snippet file (examples/snippets/servers/instructions_example.py) wired through update_readme_snippets.py so the README block stays in sync the same way as the other server examples.
  • A worked example covering the bundling / sequencing case the original issue calls out (search → fetch → confirm → update), plus explicit guidance on what belongs in instructions vs. tool docstrings — that's the design call I find people get wrong most often.

@maxisbey — you green-lit the docs work on #1464; happy to be guided on which direction is most useful. I can also just leave review comments here if you'd rather land this PR as-is.

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.

2 participants