Class CreateMessageRequestParams

Namespace

ModelContextProtocol.Protocol.Types

Assembly

ModelContextProtocol.dll

A request from the server to sample an LLM via the client. The client has full discretion over which model to select. The client should also inform the user before beginning sampling, to allow them to inspect the request (human in the loop) and decide whether to approve it.

While these align with the protocol specification, clients have full discretion over model selection and should inform users before sampling. See the schema for details

public class CreateMessageRequestParams : RequestParams

Inheritance

object

RequestParams

CreateMessageRequestParams

Inherited Members

RequestParams.Meta

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Properties

IncludeContext

A request to include context from one or more MCP servers (including the caller), to be attached to the prompt. The client MAY ignore this request.

[JsonPropertyName("includeContext")]
public ContextInclusion? IncludeContext { get; init; }

Property Value

ContextInclusion?

MaxTokens

The maximum number of tokens to sample, as requested by the server. The client MAY choose to sample fewer tokens than requested.

[JsonPropertyName("maxTokens")]
public int? MaxTokens { get; init; }

Property Value

int?

Messages

Messages requested by the server to be included in the prompt.

[JsonPropertyName("messages")]
public required IReadOnlyList<SamplingMessage> Messages { get; init; }

Property Value

IReadOnlyList<SamplingMessage>

Metadata

Optional metadata to pass through to the LLM provider. The format of this metadata is provider-specific.

[JsonPropertyName("metadata")]
public object? Metadata { get; init; }

Property Value

object

ModelPreferences

The server's preferences for which model to select. The client MAY ignore these preferences.

[JsonPropertyName("modelPreferences")]
public ModelPreferences? ModelPreferences { get; init; }

Property Value

ModelPreferences

StopSequences

Optional stop sequences that the server wants to use for sampling.

[JsonPropertyName("stopSequences")]
public IReadOnlyList<string>? StopSequences { get; init; }

Property Value

IReadOnlyList<string>

SystemPrompt

An optional system prompt the server wants to use for sampling. The client MAY modify or omit this prompt.

[JsonPropertyName("systemPrompt")]
public string? SystemPrompt { get; init; }

Property Value

string

Temperature

The temperature to use for sampling, as requested by the server.

[JsonPropertyName("temperature")]
public float? Temperature { get; init; }

Property Value

float?