Add exception docs to HttpClientTransportOptions, StdioClientTransportOptions, ElicitRequestParams, Tool, and McpEndpointRouteBuilderExtensions

Co-authored-by: stephentoub <2642209+stephentoub@users.noreply.github.com>

Author: Copilot

src/ModelContextProtocol.AspNetCore/McpEndpointRouteBuilderExtensions.cs

@@ -19,6 +19,7 @@ public static class McpEndpointRouteBuilderExtensions
     /// <param name="endpoints">The web application to attach MCP HTTP endpoints.</param>
     /// <param name="pattern">The route pattern prefix to map to.</param>
     /// <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>.
     /// 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>.

src/ModelContextProtocol.Core/Client/HttpClientTransportOptions.cs

@@ -10,6 +10,8 @@ public sealed class HttpClientTransportOptions
     /// <summary>
     /// Gets or sets the base address of the server for SSE connections.
     /// </summary>
+    /// <exception cref="ArgumentNullException"><paramref name="value"/> is <see langword="null"/>.</exception>
+    /// <exception cref="ArgumentException"><paramref name="value"/> is not an absolute URI, or does not use the HTTP or HTTPS scheme.</exception>
     public required Uri Endpoint
     {
         get;

src/ModelContextProtocol.Core/Client/StdioClientTransportOptions.cs

@@ -8,6 +8,7 @@ public sealed class StdioClientTransportOptions
     /// <summary>
     /// Gets or sets the command to execute to start the server process.
     /// </summary>
+    /// <exception cref="ArgumentException"><paramref name="value"/> is <see langword="null"/>, empty, or composed entirely of whitespace.</exception>
     public required string Command
     {
         get;

src/ModelContextProtocol.Core/Protocol/ElicitRequestParams.cs

@@ -20,6 +20,7 @@ public sealed class ElicitRequestParams : RequestParams
     ///   <item><description><b>url</b>: Client navigates user to a URL for out-of-band interaction. Sensitive data is not exposed to the client.</description></item>
     /// </list>
     /// </remarks>
+    /// <exception cref="ArgumentException"><paramref name="value"/> is not "form" or "url".</exception>
     [JsonPropertyName("mode")]
     [field: MaybeNull]
     public string Mode

src/ModelContextProtocol.Core/Protocol/Tool.cs

@@ -39,6 +39,7 @@ public sealed class Tool : IBaseMetadata
     /// <summary>
     /// Gets or sets a JSON Schema object defining the expected parameters for the tool.
     /// </summary>
+    /// <exception cref="ArgumentException"><paramref name="value"/> is not a valid MCP tool JSON schema.</exception>
     /// <remarks>
     /// <para>
     /// The schema must be a valid JSON Schema object with the "type" property set to "object".
@@ -73,6 +74,7 @@ public JsonElement InputSchema
     /// <summary>
     /// Gets or sets a JSON Schema object defining the expected structured outputs for the tool.
     /// </summary>
+    /// <exception cref="ArgumentException"><paramref name="value"/> is not a valid MCP tool JSON schema.</exception>
     /// <remarks>
     /// <para>
     /// The schema must be a valid JSON Schema object with the "type" property set to "object".