Skip to content

SDK Documentation is missing guidance for how to use instructions #1021

@felixweinberger

Description

@felixweinberger

instructions is an optional param on the InitializeResult that allows users to provide an overarching description of the server and instructions to the LLM for how to use it.

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

It's possible to use this in the constructor on McpServer:

constructor(serverInfo: Implementation, options?: ServerOptions) {

But this isn't called out in our SDK docs anywhere, making it easy to miss this capability. I've seen the need to "bundle" tools or "tell a server how to use tools in order" multiple times - maybe this should have an example + clearer docs.

The python-sdk mentions it in the readme at least tangentially, though it could be improved: https://github.com/modelcontextprotocol/python-sdk?tab=readme-ov-file#fastmcp-properties

Metadata

Metadata

Labels

P1Significant bug affecting many users, highly requested featuredocumentationImprovements or additions to documentationready for workEnough information for someone to start working on

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions