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>

src/ModelContextProtocol.Core/Client/HttpClientTransportOptions.cs

@@ -105,7 +105,7 @@ public sealed class HttpClientTransportOptions
     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 sealed class HttpClientTransportOptions
     /// 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);
 }

src/ModelContextProtocol.Core/Client/IClientTransport.cs

@@ -11,7 +11,7 @@ namespace ModelContextProtocol.Client;
 /// and servers, allowing different transport protocols to be used interchangeably.
 /// </para>
 /// <para>
-/// When creating an <see cref="McpClient"/>, <see cref="McpClient"/> is typically used, and is
+/// When creating an <see cref="McpClient"/>, <see cref="McpClient.CreateAsync"/> is typically used, and is
 /// provided with the <see cref="IClientTransport"/> based on expected server configuration.
 /// </para>
 /// </remarks>

src/ModelContextProtocol.Core/Client/McpClientHandlers.cs

@@ -14,7 +14,7 @@ namespace ModelContextProtocol.Client;
 /// <para>
 /// Each handler in this class corresponds to a specific client endpoint in the Model Context Protocol and
 /// is responsible for processing a particular type of message. The handlers are used to customize
-/// the behavior of the MCP server by providing implementations for the various protocol operations.
+/// the behavior of the MCP client by providing implementations for the various protocol operations.
 /// </para>
 /// <para>
 /// When a server sends a message to the client, the appropriate handler is invoked to process it
@@ -47,7 +47,7 @@ public sealed class McpClientHandlers
     /// Gets or sets the handler for <see cref="RequestMethods.RootsList"/> requests.
     /// </summary>
     /// <remarks>
-    /// This handler is invoked when a client sends a <see cref="RequestMethods.RootsList"/> request to retrieve available roots.
+    /// This handler is invoked when the server sends a <see cref="RequestMethods.RootsList"/> request to retrieve available roots.
     /// The handler receives request parameters and should return a <see cref="ListRootsResult"/> containing the collection of available roots.
     /// </remarks>
     public Func<ListRootsRequestParams?, CancellationToken, ValueTask<ListRootsResult>>? RootsHandler { get; set; }

src/ModelContextProtocol.Core/Client/McpClientOptions.cs

@@ -43,7 +43,7 @@ public sealed class McpClientOptions
     /// If non-<see langword="null"/>, this version will be sent to the server, and the handshake
     /// will fail if the version in the server's response does not match this version.
     /// If <see langword="null"/>, the client will request the latest version supported by the server
-    /// but will allow any supported version that the server advertizes in its response.
+    /// but will allow any supported version that the server advertises in its response.
     /// </para>
     /// </remarks>
     public string? ProtocolVersion { get; set; }

src/ModelContextProtocol.Core/Client/McpClientTool.cs

@@ -171,7 +171,7 @@ public sealed class McpClientTool : AIFunction
     /// </returns>
     /// <remarks>
     /// The base <see cref="AIFunction.InvokeAsync"/> method is overridden to invoke this <see cref="CallAsync"/> method.
-    /// The only difference in behavior is that <see cref="AIFunction.InvokeAsync"/> serializes the resulting <see cref="CallToolResult"/>"/>
+    /// The only difference in behavior is that <see cref="AIFunction.InvokeAsync"/> serializes the resulting <see cref="CallToolResult"/>
     /// such that the <see cref="object"/> returned is a <see cref="JsonElement"/> containing the serialized <see cref="CallToolResult"/>.
     /// This <see cref="CallAsync"/> method is intended to be called directly by user code, whereas the base <see cref="AIFunction.InvokeAsync"/>
     /// is intended to be used polymorphically via the base class, typically as part of an <see cref="IChatClient"/> operation.
@@ -247,7 +247,6 @@ public sealed class McpClientTool : AIFunction
     /// the value returned from this instance's <see cref="AITool.Name"/>.
     /// </para>
     /// </remarks>
-    /// <returns>A new instance of <see cref="McpClientTool"/> with the provided name.</returns>
     public McpClientTool WithName(string name) =>
         new(_client, ProtocolTool, JsonSerializerOptions, name, _description, _progress, _meta);
 

src/ModelContextProtocol.Core/Client/ResumeClientSessionOptions.cs

@@ -8,7 +8,7 @@ namespace ModelContextProtocol.Client;
 public sealed class ResumeClientSessionOptions
 {
     /// <summary>
-    /// Gets or sets the server capabilities that were negotiated during the original session setialization.
+    /// Gets or sets the server capabilities that were negotiated during the original session initialization.
     /// </summary>
     public required ServerCapabilities ServerCapabilities { get; set; }