Skip to content

Conversation

ben221199
Copy link

This pull request fixes the capitalization of the session id header from Mcp-Session-Id to MCP-Session-Id.

Motivation and Context

The characters MCP are an abbreviation and it is usual in the English/American language to capitalize those characters. This is also usual in HTTP header names, like MIME-Version and ALPN. Because MCP already has a header MCP-Protocol-Version where the capitalization is correct, it seems reasonable to me that Mcp-Session-Id will follow the same rules and should be changed to MCP-Session-Id.

How Has This Been Tested?

No, documentation update.

Breaking Changes

No, HTTP header names are case-insensitive, so compliant HTTP clients should not break.

Types of changes

  • Bug fix (non-breaking change which fixes an issue)
  • New feature (non-breaking change which adds functionality)
  • Breaking change (fix or feature that would cause existing functionality to change)
  • Documentation update

Checklist

  • I have read the MCP Documentation
  • My code follows the repository's style guidelines
  • New and existing tests pass locally
  • I have added appropriate error handling
  • I have added or updated documentation as needed

Additional context

Consider registering MCP headers at IANA: https://www.iana.org/assignments/http-fields/http-fields.xhtml.

@ben221199 ben221199 requested a review from a team as a code owner August 11, 2025 12:42
@hesreallyhim
Copy link
Contributor

@ben221199 the language of this PR ("Fix") implies that something is broken/wrong with the header names, but since, as you note, header names are case-insensitive, this is more like an improvement in the consistency of the documentation, or some such thing. I'm pretty unopinionated about it, but it might be worth reframing the request in light of this, unless you think there's some other issue at stake. 👍

@ben221199
Copy link
Author

Hi @hesreallyhim, in the Discord server we had some discussion about this issue and one of the mods (specifically @olaservo) said this was an example of gray area pull request where stuff is between bugfixes and documentation updates.

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