Fix XML documentation spelling, grammar, and correctness issues across SDK (#1372)

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Co-authored-by: Stephen Toub <stoub@microsoft.com>
Co-authored-by: stephentoub <2642209+stephentoub@users.noreply.github.com>

Author: 3 people

src/Common/Experimentals.cs

@@ -3,7 +3,7 @@
 namespace ModelContextProtocol;
 
 /// <summary>
-/// Defines diagnostic IDs, Messages, and Urls for APIs annotated with <see cref="ExperimentalAttribute"/>.
+/// Defines diagnostic IDs, messages, and URLs for APIs annotated with <see cref="ExperimentalAttribute"/>.
 /// </summary>
 /// <remarks>
 /// When an experimental API is associated with an experimental specification, the message

src/Common/Obsoletions.cs

@@ -1,10 +1,10 @@
 namespace ModelContextProtocol;
 
 /// <summary>
-/// Defines diagnostic IDs, Messages, and Urls for APIs annotated with <see cref="ObsoleteAttribute"/>.
+/// Defines diagnostic IDs, messages, and URLs for APIs annotated with <see cref="ObsoleteAttribute"/>.
 /// </summary>
 /// <remarks>
-/// When a deprecated API is associated with an specification change, the message
+/// When a deprecated API is associated with a specification change, the message
 /// should refer to the specification version that introduces the change and the SEP
 /// when available. If there is a SEP associated with the experimental API, the Url should
 /// point to the SEP issue.

src/ModelContextProtocol.Analyzers/EquatableArray.cs

@@ -15,7 +15,7 @@ namespace ModelContextProtocol.Analyzers;
     /// <param name="source">The source to enumerate and wrap.</param>
     public EquatableArray(IEnumerable<T> source) => _array = source.ToArray();
 
-    /// <param name="source">The source to wrap.</param>
+    /// <param name="array">The source to wrap.</param>
     public EquatableArray(T[] array) => _array = array;
 
     /// <summary>Gets a reference to an item at a specified position within the array.</summary>

src/ModelContextProtocol.AspNetCore/Authentication/McpAuthenticationExtensions.cs

@@ -4,12 +4,12 @@
 namespace Microsoft.Extensions.DependencyInjection;
 
 /// <summary>
-/// Extension methods for adding MCP authorization support to ASP.NET Core applications.
+/// Extension methods for adding MCP authentication support to ASP.NET Core applications.
 /// </summary>
 public static class McpAuthenticationExtensions
 {
     /// <summary>
-    /// Adds MCP authorization support to the application.
+    /// Adds MCP authentication support to the application.
     /// </summary>
     /// <param name="builder">The authentication builder.</param>
     /// <param name="configureOptions">An action to configure MCP authentication options.</param>
@@ -26,7 +26,7 @@ public static AuthenticationBuilder AddMcp(
     }
 
     /// <summary>
-    /// Adds MCP authorization support to the application with a custom scheme name.
+    /// Adds MCP authentication support to the application with a custom scheme name.
     /// </summary>
     /// <param name="builder">The authentication builder.</param>
     /// <param name="authenticationScheme">The authentication scheme name to use.</param>

src/ModelContextProtocol.AspNetCore/HttpMcpServerBuilderExtensions.cs

@@ -20,7 +20,7 @@ public static class HttpMcpServerBuilderExtensions
     /// <see cref="McpServerOptions"/> and running logic before and after a session.</param>
     /// <returns>The builder provided in <paramref name="builder"/>.</returns>
     /// <remarks>For more information on configuring the underlying HTTP server
-    /// to control things like port binding custom TLS certificates, see the <see href="https://learn.microsoft.com/aspnet/core/fundamentals/minimal-apis">Minimal APIs quick reference</see>.
+    /// to control things like port binding and custom TLS certificates, see the <see href="https://learn.microsoft.com/aspnet/core/fundamentals/minimal-apis">Minimal APIs quick reference</see>.
     /// </remarks>
     /// <exception cref="ArgumentNullException"><paramref name="builder"/> is <see langword="null"/>.</exception>
     public static IMcpServerBuilder WithHttpTransport(this IMcpServerBuilder builder, Action<HttpServerTransportOptions>? configureOptions = null)

src/ModelContextProtocol.AspNetCore/HttpServerTransportOptions.cs

@@ -5,7 +5,7 @@ namespace ModelContextProtocol.AspNetCore;
 
 /// <summary>
 /// Represents configuration options for <see cref="M:McpEndpointRouteBuilderExtensions.MapMcp"/>,
-/// which implements the Streaming HTTP transport for the Model Context Protocol.
+/// which implements the Streamable 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-11-25/basic/transports#streamable-http"/>
 /// </summary>
 /// <remarks>
@@ -23,7 +23,7 @@ public class HttpServerTransportOptions
     /// Gets or sets an optional asynchronous callback for running new MCP sessions manually.
     /// </summary>
     /// <remarks>
-    /// This callback is useful for running logic before a sessions starts and after it completes.
+    /// This callback is useful for running logic before a session starts and after it completes.
     /// </remarks>
     public Func<HttpContext, McpServer, CancellationToken, Task>? RunSessionHandler { get; set; }
 
@@ -36,7 +36,7 @@ public class HttpServerTransportOptions
     /// </value>
     /// <remarks>
     /// If <see langword="true"/>, <see cref="McpSession.SessionId"/> will be null, and the "MCP-Session-Id" header will not be used,
-    /// the <see cref="RunSessionHandler"/> will be called once for for each request, and the "/sse" endpoint will be disabled.
+    /// the <see cref="RunSessionHandler"/> will be called once for each request, and the "/sse" endpoint will be disabled.
     /// Unsolicited server-to-client messages and all server-to-client requests are also unsupported, because any responses
     /// might arrive at another ASP.NET Core application process.
     /// Client sampling, elicitation, and roots capabilities are also disabled in stateless mode, because the server cannot make requests.
@@ -87,7 +87,7 @@ public class HttpServerTransportOptions
     public TimeSpan IdleTimeout { get; set; } = TimeSpan.FromHours(2);
 
     /// <summary>
-    /// Gets or sets maximum number of idle sessions to track in memory. This value is used to limit the number of sessions that can be idle at once.
+    /// Gets or sets the maximum number of idle sessions to track in memory. This value is used to limit the number of sessions that can be idle at once.
     /// </summary>
     /// <value>
     /// The maximum number of idle sessions to track in memory. The default is 10,000 sessions.

src/ModelContextProtocol.Core/AIContentExtensions.cs

@@ -367,7 +367,7 @@ public static IList<AIContent> ToAIContents(this IEnumerable<ContentBlock> conte
     /// </para>
     /// <para>
     /// Each <see cref="ResourceContents"/> object is converted using <see cref="ToAIContent(ResourceContents)"/>,
-    /// preserving the type-specific conversion logic: text resources become <see cref="TextContentBlock"/> objects and
+    /// preserving the type-specific conversion logic: text resources become <see cref="TextContent"/> objects and
     /// binary resources become <see cref="DataContent"/> objects.
     /// </para>
     /// </remarks>

src/ModelContextProtocol.Core/Authentication/ClientOAuthProvider.cs

@@ -772,7 +772,7 @@ private static string NormalizeUri(string uriString)
     /// <param name="response">The HTTP response containing the WWW-Authenticate header.</param>
     /// <param name="cancellationToken">The <see cref="CancellationToken"/> to monitor for cancellation requests.</param>
     /// <returns>The resource metadata if the resource matches the server, otherwise throws an exception.</returns>
-    /// <exception cref="InvalidOperationException">Thrown when the response is not a 401, the metadata can't be fetched, or the resource URI doesn't match the server URL.</exception>
+    /// <exception cref="McpException">Thrown when the metadata can't be fetched or the resource URI doesn't match the server URL.</exception>
     private async Task<ProtectedResourceMetadata> ExtractProtectedResourceMetadata(HttpResponseMessage response, CancellationToken cancellationToken)
     {
         Uri resourceUri = _serverUrl;

src/ModelContextProtocol.Core/Authentication/ProtectedResourceMetadata.cs

@@ -4,8 +4,7 @@
 namespace ModelContextProtocol.Authentication;
 
 /// <summary>
-/// Represents the resource metadata for OAuth authorization as defined in RFC 9396.
-/// Defined by <see href="https://datatracker.ietf.org/doc/rfc9728/">RFC 9728</see>.
+/// Represents the resource metadata for OAuth authorization as defined in <see href="https://datatracker.ietf.org/doc/rfc9728/">RFC 9728</see>.
 /// </summary>
 public sealed class ProtectedResourceMetadata
 {

src/ModelContextProtocol.Core/Client/HttpClientTransportOptions.cs

@@ -105,7 +105,7 @@ public required Uri Endpoint
     public bool OwnsSession { get; set; } = true;
 
     /// <summary>
-    /// Gets sor sets the authorization provider to use for authentication.
+    /// Gets or sets the authorization provider to use for authentication.
     /// </summary>
     public ClientOAuthOptions? OAuth { get; set; }
 
@@ -127,13 +127,13 @@ public required Uri Endpoint
     /// Gets or sets the default interval at which the client attempts reconnection after an SSE stream is disconnected.
     /// </summary>
     /// <remarks>
-    /// <p>
+    /// <para>
     /// The default value is 1 second.
-    /// </p>
-    /// <p>
+    /// </para>
+    /// <para>
     /// If the server sends a message specifying a different reconnection interval, that new value will be used for all
     /// subsequent reconnection attempts for that stream.
-    /// </p>
+    /// </para>
     /// </remarks>
     public TimeSpan DefaultReconnectionInterval { get; set; } = TimeSpan.FromSeconds(1);
 }