Skip to content

Commit e700951

Browse files
Copilotstephentoub
andauthored
docs: align roots terminology with MCP spec clarification (#1469)
Co-authored-by: copilot-swe-agent[bot] <198982749+Copilot@users.noreply.github.com> Co-authored-by: stephentoub <2642209+stephentoub@users.noreply.github.com>
1 parent 51a4fde commit e700951

File tree

4 files changed

+12
-10
lines changed

4 files changed

+12
-10
lines changed

docs/concepts/roots/roots.md

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -17,7 +17,7 @@ Roots provide a mechanism for the client to tell the server which directories, p
1717

1818
- Scope file searches to the user's project directories
1919
- Understand which repositories are being worked on
20-
- Limit operations to specific filesystem boundaries
20+
- Focus operations on relevant filesystem locations
2121

2222
Each root is represented by a <xref:ModelContextProtocol.Protocol.Root> with a URI and an optional human-readable name.
2323

src/ModelContextProtocol.Core/Protocol/NotificationMethods.cs

Lines changed: 4 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -53,9 +53,10 @@ public static class NotificationMethods
5353
/// <remarks>
5454
/// <para>
5555
/// This notification informs the server that the client's "roots" have changed.
56-
/// Roots define the boundaries of where servers can operate within the filesystem,
57-
/// allowing them to understand which directories and files they have access to. Servers
58-
/// can request the list of roots from supporting clients and receive notifications when that list changes.
56+
/// Roots inform servers about the directories and files the client considers relevant,
57+
/// so that servers can focus their operations accordingly. They are informational guidance
58+
/// rather than an access-control mechanism; the protocol does not enforce that servers stay within roots.
59+
/// Servers can request the list of roots from supporting clients and receive notifications when that list changes.
5960
/// </para>
6061
/// <para>
6162
/// After receiving this notification, servers can refresh their knowledge of roots by calling the appropriate

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)