From d8bae5d6dbb846e17133063bbf9d259655a460e6 Mon Sep 17 00:00:00 2001
From: Stephen Toub <stoub@microsoft.com>
Date: Tue, 14 Oct 2025 17:39:03 -0400
Subject: [PATCH] Fix comments on McpServerTool/Prompt/Resource

They were a bit out of date with the implementation.
---
 src/ModelContextProtocol.Core/Server/McpServerPrompt.cs   | 6 +++++-
 src/ModelContextProtocol.Core/Server/McpServerResource.cs | 6 +++++-
 src/ModelContextProtocol.Core/Server/McpServerTool.cs     | 4 ----
 3 files changed, 10 insertions(+), 6 deletions(-)

diff --git a/src/ModelContextProtocol.Core/Server/McpServerPrompt.cs b/src/ModelContextProtocol.Core/Server/McpServerPrompt.cs
index a7fa0e242..dafdd7f7c 100644
--- a/src/ModelContextProtocol.Core/Server/McpServerPrompt.cs
+++ b/src/ModelContextProtocol.Core/Server/McpServerPrompt.cs
@@ -105,9 +105,13 @@ namespace ModelContextProtocol.Server;
 ///     <description>Converted to a list of <see cref="PromptMessage"/> instances derived from the <see cref="ChatMessage"/> with <see cref="AIContentExtensions.ToPromptMessages"/>.</description>
 ///   </item>
 ///   <item>
-///     <term><see cref="IEnumerable{PromptMessage}"/> of <see cref="PromptMessage"/></term>
+///     <term><see cref="IEnumerable{ChatMessage}"/> of <see cref="ChatMessage"/></term>
 ///     <description>Converted to a list of <see cref="PromptMessage"/> instances derived from all of the <see cref="ChatMessage"/> instances with <see cref="AIContentExtensions.ToPromptMessages"/>.</description>
 ///   </item>
+///   <item>
+///     <term><see cref="GetPromptResult"/></term>
+///     <description>Returned directly without modification.</description>
+///   </item>
 /// </list>
 /// <para>
 /// Other returned types will result in an <see cref="InvalidOperationException"/> being thrown.
diff --git a/src/ModelContextProtocol.Core/Server/McpServerResource.cs b/src/ModelContextProtocol.Core/Server/McpServerResource.cs
index 2a43e3349..00d89c774 100644
--- a/src/ModelContextProtocol.Core/Server/McpServerResource.cs
+++ b/src/ModelContextProtocol.Core/Server/McpServerResource.cs
@@ -90,7 +90,7 @@ namespace ModelContextProtocol.Server;
 ///     <description>Wrapped in a list containing the single <see cref="ResourceContents"/>.</description>
 ///   </item>
 ///   <item>
-///     <term><see cref="TextContentBlock"/></term>
+///     <term><see cref="TextContent"/></term>
 ///     <description>Converted to a list containing a single <see cref="TextResourceContents"/>.</description>
 ///   </item>
 ///   <item>
@@ -113,6 +113,10 @@ namespace ModelContextProtocol.Server;
 ///     <term><see cref="IEnumerable{String}"/> of <see cref="string"/></term>
 ///     <description>Converted to a list containing a <see cref="TextResourceContents"/>, one for each <see cref="string"/>.</description>
 ///   </item>
+///   <item>
+///     <term><see cref="ReadResourceResult"/></term>
+///     <description>Returned directly without modification.</description>
+///   </item>
 /// </list>
 /// <para>
 /// Other returned types will result in an <see cref="InvalidOperationException"/> being thrown.
diff --git a/src/ModelContextProtocol.Core/Server/McpServerTool.cs b/src/ModelContextProtocol.Core/Server/McpServerTool.cs
index 4136f5913..6948ea912 100644
--- a/src/ModelContextProtocol.Core/Server/McpServerTool.cs
+++ b/src/ModelContextProtocol.Core/Server/McpServerTool.cs
@@ -110,10 +110,6 @@ namespace ModelContextProtocol.Server;
 ///     <description>Returned as a single-item <see cref="ContentBlock"/> list.</description>
 ///   </item>
 ///   <item>
-///     <term><see cref="IEnumerable{String}"/> of <see cref="string"/></term>
-///     <description>Each <see cref="string"/> is converted to a <see cref="TextContentBlock"/> object with its text set to the string value.</description>
-///   </item>
-///   <item>
 ///     <term><see cref="IEnumerable{AIContent}"/> of <see cref="AIContent"/></term>
 ///     <description>Each <see cref="AIContent"/> is converted to a <see cref="ContentBlock"/> object using <see cref="AIContentExtensions.ToContent(AIContent)"/>.</description>
 ///   </item>