Class RootsCapability

Namespace

ModelContextProtocol.Protocol

Assembly

ModelContextProtocol.Core.dll

Represents a client capability that enables root resource discovery in the Model Context Protocol.

public sealed class RootsCapability

Inheritance

object

RootsCapability

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

When present in ClientCapabilities, it indicates that the client supports listing root URIs that serve as entry points for resource navigation.

The roots capability establishes a mechanism for servers to discover the directories and files the client considers relevant. Root URIs represent top-level entry points that inform the server about the working context, providing informational guidance rather than enforcing access control.

See the schema for details.

Properties

ListChanged

Gets or sets a value that indicates whether the client supports notifications for changes to the roots list.

[JsonPropertyName("listChanged")]
public bool? ListChanged { get; set; }

Property Value

bool?

Remarks

When set to true, the client can notify servers when roots are added, removed, or modified, allowing servers to refresh their roots cache accordingly. This enables servers to stay synchronized with client-side changes to available roots.