From cfa89a39079985589160826e2174304c81efc8fa Mon Sep 17 00:00:00 2001
From: Copilot <198982749+Copilot@users.noreply.github.com>
Date: Tue, 3 Feb 2026 15:51:32 -0800
Subject: [PATCH] Clarify McpMetaAttribute documentation scope (#1242)

Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com>
Co-authored-by: stephentoub <2642209+stephentoub@users.noreply.github.com>
---
 .../Server/McpMetaAttribute.cs                         | 10 +++++++++-
 1 file changed, 9 insertions(+), 1 deletion(-)

diff --git a/src/ModelContextProtocol.Core/Server/McpMetaAttribute.cs b/src/ModelContextProtocol.Core/Server/McpMetaAttribute.cs
index a70c26c..c629277 100644
--- a/src/ModelContextProtocol.Core/Server/McpMetaAttribute.cs
+++ b/src/ModelContextProtocol.Core/Server/McpMetaAttribute.cs
@@ -11,7 +11,15 @@ namespace ModelContextProtocol.Server;
 /// <remarks>
 /// <para>
 /// The metadata is used to populate the <see cref="Tool.Meta"/>, <see cref="Prompt.Meta"/>,
-/// or <see cref="Resource.Meta"/> property of the corresponding primitive.
+/// or <see cref="Resource.Meta"/> property of the corresponding primitive. This metadata is
+/// included in the responses to listing operations (<c>tools/list</c>, <c>prompts/list</c>,
+/// <c>resources/list</c>).
+/// </para>
+/// <para>
+/// This metadata is <b>not</b> propagated to the results of invocation operations such as
+/// <c>tools/call</c>, <c>prompts/get</c>, or <c>resources/read</c>. To include metadata in
+/// those results, set the <c>Meta</c> property on the <see cref="CallToolResult"/>,
+/// <see cref="GetPromptResult"/>, or <see cref="ReadResourceResult"/> directly in your method implementation.
 /// </para>
 /// <para>
 /// This attribute can be applied multiple times to a method to specify multiple key/value pairs