Class ClientCapabilities

Namespace

ModelContextProtocol.Protocol

Assembly

ModelContextProtocol.Core.dll

Represents the capabilities that a client supports.

public sealed class ClientCapabilities

Inheritance

object

ClientCapabilities

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.ReferenceEquals(object, object)

object.ToString()

Remarks

Capabilities define the features and functionality that a client can handle when communicating with an MCP server. These are advertised to the server during the initialize handshake.

See the schema for details.

Properties

Elicitation

Gets or sets the client's elicitation capability, which indicates whether the client supports elicitation of additional information from the user on behalf of the server.

[JsonPropertyName("elicitation")]
public ElicitationCapability? Elicitation { get; set; }

Property Value

ElicitationCapability

Experimental

Gets or sets experimental, non-standard capabilities that the client supports.

[JsonPropertyName("experimental")]
public IDictionary<string, object>? Experimental { get; set; }

Property Value

IDictionary<string, object>

Remarks

The Experimental dictionary allows clients to advertise support for features that are not yet standardized in the Model Context Protocol specification. This extension mechanism enables future protocol enhancements while maintaining backward compatibility.

Values in this dictionary are implementation-specific and should be coordinated between client and server implementations. Servers should not assume the presence of any experimental capability without checking for it first.

Roots

Gets or sets the client's roots capability, which are entry points for resource navigation.

[JsonPropertyName("roots")]
public RootsCapability? Roots { get; set; }

Property Value

RootsCapability

Remarks

When Roots is non-null, the client indicates that it can respond to server requests for listing root URIs. Root URIs serve as entry points for resource navigation in the protocol.

The server can use RequestRootsAsync(ListRootsRequestParams, CancellationToken) to request the list of available roots from the client, which will trigger the client's RootsHandler.

Sampling

Gets or sets the client's sampling capability, which indicates whether the client supports issuing requests to an LLM on behalf of the server.

[JsonPropertyName("sampling")]
public SamplingCapability? Sampling { get; set; }

Property Value

SamplingCapability

Tasks

Gets or sets the client's tasks capability for supporting task-augmented requests.

[JsonPropertyName("tasks")]
public McpTasksCapability? Tasks { get; set; }

Property Value

McpTasksCapability

Remarks

The tasks capability enables servers to augment their requests with tasks for long-running operations. When present, servers can request that certain operations (like sampling or elicitation) execute asynchronously, with the ability to poll for status and retrieve results later.

See McpTasksCapability for details on configuring which operations support tasks.