Skip to content

Commit 0dde9a5

Browse files
Copilotstephentoub
andauthored
docs: update Root and RootsCapability XML doc comments to clarify informational nature
Agent-Logs-Url: https://github.com/modelcontextprotocol/csharp-sdk/sessions/d5710a76-b57b-4d4c-ba62-c73c7d50f862 Co-authored-by: stephentoub <2642209+stephentoub@users.noreply.github.com>
1 parent 4570196 commit 0dde9a5

File tree

2 files changed

+7
-6
lines changed

2 files changed

+7
-6
lines changed

src/ModelContextProtocol.Core/Protocol/Root.cs

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -9,9 +9,10 @@ namespace ModelContextProtocol.Protocol;
99
/// </summary>
1010
/// <remarks>
1111
/// Root URIs serve as entry points for resource navigation, typically representing
12-
/// top-level directories or container resources that can be accessed and traversed.
13-
/// Roots provide a hierarchical structure for organizing and accessing resources within the protocol.
14-
/// Each root has a URI that uniquely identifies it and optional metadata like a human-readable name.
12+
/// top-level directories or container resources that are relevant to the current session.
13+
/// Roots inform servers which locations the client considers important, providing informational
14+
/// guidance rather than an access-control mechanism. Each root has a URI that uniquely identifies
15+
/// it and optional metadata like a human-readable name.
1516
/// </remarks>
1617
public sealed class Root
1718
{

src/ModelContextProtocol.Core/Protocol/RootsCapability.cs

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -13,9 +13,9 @@ namespace ModelContextProtocol.Protocol;
1313
/// root URIs that serve as entry points for resource navigation.
1414
/// </para>
1515
/// <para>
16-
/// The roots capability establishes a mechanism for servers to discover and access the hierarchical
17-
/// structure of resources provided by a client. Root URIs represent top-level entry points from which
18-
/// servers can navigate to access specific resources.
16+
/// The roots capability establishes a mechanism for servers to discover the directories and files
17+
/// the client considers relevant. Root URIs represent top-level entry points that inform the server
18+
/// about the working context, providing informational guidance rather than enforcing access control.
1919
/// </para>
2020
/// <para>
2121
/// See the <see href="https://github.com/modelcontextprotocol/specification/blob/main/schema/">schema</see> for details.

0 commit comments

Comments
 (0)