Skip to content

Align InitializeResult.instructions XML docs with latest MCP spec guidance#1290

Merged
stephentoub merged 3 commits intomainfrom
copilot/update-xml-comments-for-commit
Feb 17, 2026
Merged

Align InitializeResult.instructions XML docs with latest MCP spec guidance#1290
stephentoub merged 3 commits intomainfrom
copilot/update-xml-comments-for-commit

Conversation

Copy link
Contributor

Copilot AI commented Feb 17, 2026

This updates SDK XML documentation to reflect the MCP spec guidance introduced in modelcontextprotocol/modelcontextprotocol@ff8bd88: initialize instructions should help models use the server effectively and should not duplicate primitive descriptions.

  • Protocol DTO docs (InitializeResult)

    • Updated InitializeResult.Instructions remarks to emphasize model-usage guidance (workflow/capability conventions) over restating primitive metadata.
    • Explicitly calls out avoiding duplication of tool/prompt/resource descriptions already available via protocol responses.
  • Client API docs (McpClient.ServerInstructions)

    • Aligned client-facing wording with spec intent: treat instructions as high-level usage guidance, not repeated primitive docs.
  • Server options docs (McpServerOptions.ServerInstructions)

    • Aligned server-side configuration remarks to guide authors toward non-duplicative, model-oriented instruction content.

Example of the updated guidance style:

/// They should focus on information that helps models use the server effectively
/// and should not duplicate tool, prompt, or resource descriptions already exposed elsewhere.
public string? ServerInstructions { get; set; }

✨ Let Copilot coding agent set things up for you — coding agent works faster and does higher quality work when set up for your repo.

Co-authored-by: stephentoub <2642209+stephentoub@users.noreply.github.com>
Copilot AI changed the title [WIP] Update XML comments to reflect recent commit changes Align InitializeResult.instructions XML docs with latest MCP spec guidance Feb 17, 2026
Copilot AI requested a review from stephentoub February 17, 2026 08:16
@stephentoub stephentoub marked this pull request as ready for review February 17, 2026 08:19
halter73
halter73 previously approved these changes Feb 17, 2026
Co-authored-by: Stephen Halter <halter73@gmail.com>
@stephentoub stephentoub merged commit 49fbc51 into main Feb 17, 2026
8 checks passed
@stephentoub stephentoub deleted the copilot/update-xml-comments-for-commit branch February 17, 2026 20:39
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.

3 participants