Add 2025-11-25 as supported version (#1130)

Copilot · stephentoub · web-flow · commit 774411b22c27 · 2026-01-15T09:59:42.000-05:00
Co-authored-by: copilot-swe-agent[bot] &lt;198982749+Copilot@users.noreply.github.com&gt;
Co-authored-by: stephentoub &lt;2642209+stephentoub@users.noreply.github.com&gt;
diff --git a/docs/concepts/elicitation/samples/server/Elicitation.http b/docs/concepts/elicitation/samples/server/Elicitation.http
@@ -5,7 +5,7 @@
 POST {{HostAddress}}/
 Accept: application/json, text/event-stream
 Content-Type: application/json
-MCP-Protocol-Version: 2025-06-18
+MCP-Protocol-Version: 2025-11-25
 
 {
     "jsonrpc": "2.0",
@@ -34,7 +34,7 @@ Content-Type: application/json
         "capabilities": {
              "elicitation": {}
         },
-        "protocolVersion": "2025-06-18"
+        "protocolVersion": "2025-11-25"
     }
 }
 
@@ -46,7 +46,7 @@ POST {{HostAddress}}/
 Accept: application/json, text/event-stream
 Content-Type: application/json
 Mcp-Session-Id: {{SessionId}}
-MCP-Protocol-Version: 2025-06-18
+MCP-Protocol-Version: 2025-11-25
 
 {
     "jsonrpc": "2.0",
diff --git a/docs/concepts/httpcontext/samples/HttpContext.http b/docs/concepts/httpcontext/samples/HttpContext.http
@@ -3,7 +3,7 @@
 POST {{HostAddress}}/
 Accept: application/json, text/event-stream
 Content-Type: application/json
-MCP-Protocol-Version: 2025-06-18
+MCP-Protocol-Version: 2025-11-25
 
 {
     "jsonrpc": "2.0",
diff --git a/docs/concepts/logging/logging.md b/docs/concepts/logging/logging.md
@@ -9,7 +9,7 @@ uid: logging
 
 MCP servers can expose log messages to clients through the [Logging utility].
 
-[Logging utility]: https://modelcontextprotocol.io/specification/2025-06-18/server/utilities/logging
+[Logging utility]: https://modelcontextprotocol.io/specification/2025-11-25/server/utilities/logging
 
 This document describes how to implement logging in MCP servers and how clients can consume log messages.
 
@@ -43,7 +43,7 @@ dropped when sending messages to the client.
 MCP servers that implement the Logging utility must declare this in the capabilities sent in the
 [Initialization] phase at the beginning of the MCP session.
 
-[Initialization]: https://modelcontextprotocol.io/specification/2025-06-18/basic/lifecycle#initialization
+[Initialization]: https://modelcontextprotocol.io/specification/2025-11-25/basic/lifecycle#initialization
 
 Servers built with the C# SDK always declare the logging capability. Doing so does not obligate the server
 to send log messages&mdash;only allows it. Note that stateless MCP servers might not be capable of sending log
diff --git a/docs/concepts/logging/samples/server/Logging.http b/docs/concepts/logging/samples/server/Logging.http
@@ -14,7 +14,7 @@ Content-Type: application/json
             "version": "0.1.0"
         },
         "capabilities": {},
-        "protocolVersion": "2025-06-18"
+        "protocolVersion": "2025-11-25"
     }
 }
 
@@ -27,7 +27,7 @@ Content-Type: application/json
 POST {{HostAddress}}/
 Accept: application/json, text/event-stream
 Content-Type: application/json
-MCP-Protocol-Version: 2025-06-18
+MCP-Protocol-Version: 2025-11-25
 Mcp-Session-Id: {{SessionId}}
 
 {
diff --git a/docs/concepts/progress/progress.md b/docs/concepts/progress/progress.md
@@ -9,7 +9,7 @@ uid: progress
 
 The Model Context Protocol (MCP) supports [progress tracking] for long-running operations through notification messages.
 
-[progress tracking]: https://modelcontextprotocol.io/specification/2025-06-18/basic/utilities/progress
+[progress tracking]: https://modelcontextprotocol.io/specification/2025-11-25/basic/utilities/progress
 
 Typically progress tracking is supported by server tools that perform operations that take a significant amount of time to complete, such as image generation or complex calculations.
 However, progress tracking is defined in the MCP specification as a general feature that can be implemented for any request that's handled by either a server or a client.
diff --git a/docs/concepts/progress/samples/server/Progress.http b/docs/concepts/progress/samples/server/Progress.http
@@ -3,7 +3,7 @@
 POST {{HostAddress}}/
 Accept: application/json, text/event-stream
 Content-Type: application/json
-MCP-Protocol-Version: 2025-06-18
+MCP-Protocol-Version: 2025-11-25
 
 {
     "jsonrpc": "2.0",
diff --git a/samples/EverythingServer/EverythingServer.http b/samples/EverythingServer/EverythingServer.http
@@ -14,7 +14,7 @@ Content-Type: application/json
             "version": "0.1.0"
         },
         "capabilities": {},
-        "protocolVersion": "2025-06-18"
+        "protocolVersion": "2025-11-25"
     }
 }
 
@@ -25,7 +25,7 @@ Content-Type: application/json
 POST {{HostAddress}}/
 Accept: application/json, text/event-stream
 Content-Type: application/json
-MCP-Protocol-Version: 2025-06-18
+MCP-Protocol-Version: 2025-11-25
 Mcp-Session-Id: {{SessionId}}
 
 {
@@ -41,7 +41,7 @@ Mcp-Session-Id: {{SessionId}}
 POST {{HostAddress}}/
 Accept: application/json, text/event-stream
 Content-Type: application/json
-MCP-Protocol-Version: 2025-06-18
+MCP-Protocol-Version: 2025-11-25
 Mcp-Session-Id: {{SessionId}}
 
 {
@@ -58,7 +58,7 @@ Mcp-Session-Id: {{SessionId}}
 POST {{HostAddress}}/
 Accept: application/json, text/event-stream
 Content-Type: application/json
-MCP-Protocol-Version: 2025-06-18
+MCP-Protocol-Version: 2025-11-25
 Mcp-Session-Id: {{SessionId}}
 
 {
@@ -73,5 +73,5 @@ Mcp-Session-Id: {{SessionId}}
 ###
 
 DELETE {{HostAddress}}/
-MCP-Protocol-Version: 2025-06-18
+MCP-Protocol-Version: 2025-11-25
 Mcp-Session-Id: {{SessionId}}
diff --git a/src/ModelContextProtocol.AspNetCore/HttpServerTransportOptions.cs b/src/ModelContextProtocol.AspNetCore/HttpServerTransportOptions.cs
@@ -6,10 +6,10 @@ namespace ModelContextProtocol.AspNetCore;
 /// <summary>
 /// Represents configuration options for <see cref="M:McpEndpointRouteBuilderExtensions.MapMcp"/>,
 /// which implements the Streaming HTTP transport for the Model Context Protocol.
-/// See the protocol specification for details on the Streamable HTTP transport. <see href="https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#streamable-http"/>
+/// See the protocol specification for details on the Streamable HTTP transport. <see href="https://modelcontextprotocol.io/specification/2025-11-25/basic/transports#streamable-http"/>
 /// </summary>
 /// <remarks>
-/// For details on the Streamable HTTP transport, see the <see href="https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#streamable-http">protocol specification</see>.
+/// For details on the Streamable HTTP transport, see the <see href="https://modelcontextprotocol.io/specification/2025-11-25/basic/transports#streamable-http">protocol specification</see>.
 /// </remarks>
 public class HttpServerTransportOptions
 {
diff --git a/src/ModelContextProtocol.AspNetCore/McpEndpointRouteBuilderExtensions.cs b/src/ModelContextProtocol.AspNetCore/McpEndpointRouteBuilderExtensions.cs
@@ -21,7 +21,7 @@ public static class McpEndpointRouteBuilderExtensions
     /// <returns>Returns a builder for configuring additional endpoint conventions like authorization policies.</returns>
     /// <exception cref="InvalidOperationException">The required MCP services have not been registered. Ensure <see cref="HttpMcpServerBuilderExtensions.WithHttpTransport"/> has been called during application startup.</exception>
     /// <remarks>
-    /// For details about the Streamable HTTP transport, see the <see href="https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#streamable-http">2025-06-18 protocol specification</see>.
+    /// For details about the Streamable HTTP transport, see the <see href="https://modelcontextprotocol.io/specification/2025-11-25/basic/transports#streamable-http">2025-11-25 protocol specification</see>.
     /// This method also maps legacy SSE endpoints for backward compatibility at the path "/sse" and "/message". For details about the HTTP with SSE transport, see the <see href="https://modelcontextprotocol.io/specification/2024-11-05/basic/transports#http-with-sse">2024-11-05 protocol specification</see>.
     /// </remarks>
     public static IEndpointConventionBuilder MapMcp(this IEndpointRouteBuilder endpoints, [StringSyntax("Route")] string pattern = "")
diff --git a/src/ModelContextProtocol.Core/Client/HttpClientTransportOptions.cs b/src/ModelContextProtocol.Core/Client/HttpClientTransportOptions.cs
@@ -44,7 +44,7 @@ public required Uri Endpoint
     /// When set to <see cref="HttpTransportMode.AutoDetect"/> (the default), the client will first attempt to use
     /// Streamable HTTP transport and automatically fall back to SSE transport if the server doesn't support it.
     /// </remarks>
-    /// <seealso href="https://modelcontextprotocol.io/specification/2025-06-18/basic/transports#streamable-http">Streamable HTTP transport specification</seealso>.
+    /// <seealso href="https://modelcontextprotocol.io/specification/2025-11-25/basic/transports#streamable-http">Streamable HTTP transport specification</seealso>.
     /// <seealso href="https://modelcontextprotocol.io/specification/2024-11-05/basic/transports#http-with-sse">HTTP with SSE transport specification</seealso>.
     public HttpTransportMode TransportMode { get; set; } = HttpTransportMode.AutoDetect;
 
diff --git a/tests/ModelContextProtocol.AspNetCore.Tests/MapMcpStreamableHttpTests.cs b/tests/ModelContextProtocol.AspNetCore.Tests/MapMcpStreamableHttpTests.cs
@@ -178,10 +178,10 @@ public async Task StreamableHttpClient_SendsMcpProtocolVersionHeader_AfterInitia
 
         await using var mcpClient = await ConnectAsync(clientOptions: new()
         {
-            ProtocolVersion = "2025-03-26",
+            ProtocolVersion = "2025-06-18",
         });
 
-        Assert.Equal("2025-03-26", mcpClient.NegotiatedProtocolVersion);
+        Assert.Equal("2025-06-18", mcpClient.NegotiatedProtocolVersion);
         await mcpClient.ListToolsAsync(cancellationToken: TestContext.Current.CancellationToken);
 
         await mcpClient.DisposeAsync();
@@ -190,7 +190,7 @@ public async Task StreamableHttpClient_SendsMcpProtocolVersionHeader_AfterInitia
         // Stateless mode due to the lack of an Mcp-Session-Id, but the header should be included in the
         // initialized notification and the tools/list call at a minimum.
         Assert.True(protocolVersionHeaderValues.Count > 1);
-        Assert.All(protocolVersionHeaderValues, v => Assert.Equal("2025-03-26", v));
+        Assert.All(protocolVersionHeaderValues, v => Assert.Equal("2025-06-18", v));
     }
 
     [Fact]
diff --git a/tests/ModelContextProtocol.AspNetCore.Tests/StreamableHttpClientConformanceTests.cs b/tests/ModelContextProtocol.AspNetCore.Tests/StreamableHttpClientConformanceTests.cs
@@ -217,7 +217,7 @@ public async Task ResumeSessionStartsGetImmediately()
     {
         const string sessionId = "resume-session-123";
         const string resumeInstructions = "Use cached instructions";
-        const string resumeProtocolVersion = "2025-06-18";
+        const string resumeProtocolVersion = "2025-11-25";
         var resumeServer = await StartResumeServerAsync(sessionId);
 
         await using var transport = new HttpClientTransport(new()
diff --git a/tests/ModelContextProtocol.ConformanceServer/ModelContextProtocol.ConformanceServer.http b/tests/ModelContextProtocol.ConformanceServer/ModelContextProtocol.ConformanceServer.http
@@ -26,7 +26,7 @@ Content-Type: application/json
             "version": "0.1.0"
         },
         "capabilities": {},
-        "protocolVersion": "2025-06-18"
+        "protocolVersion": "2025-11-25"
     }
 }
 
@@ -37,7 +37,7 @@ Content-Type: application/json
 POST {{HostAddress}}/
 Accept: application/json, text/event-stream
 Content-Type: application/json
-MCP-Protocol-Version: 2025-06-18
+MCP-Protocol-Version: 2025-11-25
 Mcp-Session-Id: {{SessionId}}
 
 {
@@ -51,7 +51,7 @@ Mcp-Session-Id: {{SessionId}}
 POST {{HostAddress}}/
 Accept: application/json, text/event-stream
 Content-Type: application/json
-MCP-Protocol-Version: 2025-06-18
+MCP-Protocol-Version: 2025-11-25
 Mcp-Session-Id: {{SessionId}}
 
 {
@@ -65,7 +65,7 @@ Mcp-Session-Id: {{SessionId}}
 POST {{HostAddress}}/
 Accept: application/json, text/event-stream
 Content-Type: application/json
-MCP-Protocol-Version: 2025-06-18
+MCP-Protocol-Version: 2025-11-25
 Mcp-Session-Id: {{SessionId}}
 
 {
diff --git a/tests/ModelContextProtocol.Tests/Client/McpClientTests.cs b/tests/ModelContextProtocol.Tests/Client/McpClientTests.cs
@@ -585,7 +585,7 @@ public async Task AsClientLoggerProvider_MessagesSentToClient()
 
     [Theory]
     [InlineData(null)]
-    [InlineData("2025-03-26")]
+    [InlineData("2025-06-18")]
     public async Task ReturnsNegotiatedProtocolVersion(string? protocolVersion)
     {
         await using McpClient client = await CreateMcpClientForServer(new() { ProtocolVersion = protocolVersion });

Original file line number	Diff line number	Diff line change
`@@ -5,7 +5,7 @@`
`5`	`5`	`POST {{HostAddress}}/`
`6`	`6`	`Accept: application/json, text/event-stream`
`7`	`7`	`Content-Type: application/json`
`8`		`-MCP-Protocol-Version: 2025-06-18`
	`8`	`+MCP-Protocol-Version: 2025-11-25`
`9`	`9`
`10`	`10`	`{`
`11`	`11`	`"jsonrpc": "2.0",`
`@@ -34,7 +34,7 @@ Content-Type: application/json`
`34`	`34`	`"capabilities": {`
`35`	`35`	`"elicitation": {}`
`36`	`36`	`},`
`37`		`- "protocolVersion": "2025-06-18"`
	`37`	`+ "protocolVersion": "2025-11-25"`
`38`	`38`	`}`
`39`	`39`	`}`
`40`	`40`
`@@ -46,7 +46,7 @@ POST {{HostAddress}}/`
`46`	`46`	`Accept: application/json, text/event-stream`
`47`	`47`	`Content-Type: application/json`
`48`	`48`	`Mcp-Session-Id: {{SessionId}}`
`49`		`-MCP-Protocol-Version: 2025-06-18`
	`49`	`+MCP-Protocol-Version: 2025-11-25`
`50`	`50`
`51`	`51`	`{`
`52`	`52`	`"jsonrpc": "2.0",`
Original file line number	Diff line number	Diff line change
`@@ -3,7 +3,7 @@`
`3`	`3`	`POST {{HostAddress}}/`
`4`	`4`	`Accept: application/json, text/event-stream`
`5`	`5`	`Content-Type: application/json`
`6`		`-MCP-Protocol-Version: 2025-06-18`
	`6`	`+MCP-Protocol-Version: 2025-11-25`
`7`	`7`
`8`	`8`	`{`
`9`	`9`	`"jsonrpc": "2.0",`
Original file line number	Diff line number	Diff line change
`@@ -14,7 +14,7 @@ Content-Type: application/json`
`14`	`14`	`"version": "0.1.0"`
`15`	`15`	`},`
`16`	`16`	`"capabilities": {},`
`17`		`- "protocolVersion": "2025-06-18"`
	`17`	`+ "protocolVersion": "2025-11-25"`
`18`	`18`	`}`
`19`	`19`	`}`
`20`	`20`
`@@ -27,7 +27,7 @@ Content-Type: application/json`
`27`	`27`	`POST {{HostAddress}}/`
`28`	`28`	`Accept: application/json, text/event-stream`
`29`	`29`	`Content-Type: application/json`
`30`		`-MCP-Protocol-Version: 2025-06-18`
	`30`	`+MCP-Protocol-Version: 2025-11-25`
`31`	`31`	`Mcp-Session-Id: {{SessionId}}`
`32`	`32`
`33`	`33`	`{`