Class ModelPreferences

Namespace

ModelContextProtocol.Protocol.Types

Assembly

ModelContextProtocol.dll

The server's preferences for model selection, requested of the client during sampling. Because LLMs can vary along multiple dimensions, choosing the "best" model is rarely straightforward. Different models excel in different areas—some are faster but less capable, others are more capable but more expensive, and so on. This interface allows servers to express their priorities across multiple dimensions to help clients make an appropriate selection for their use case.

These preferences are always advisory. The client MAY ignore them. It is also up to the client to decide how to interpret these preferences and how to balance them against other considerations. See the schema for details

public class ModelPreferences

Inheritance

object

ModelPreferences

Inherited Members

object.Equals(object)

object.Equals(object, object)

object.GetHashCode()

object.GetType()

object.MemberwiseClone()

object.ReferenceEquals(object, object)

object.ToString()

Properties

CostPriority

How much to prioritize cost when selecting a model. A value of 0 means cost\nis not important, while a value of 1 means cost is the most important factor.

[JsonPropertyName("costPriority")]
public float? CostPriority { get; init; }

Property Value

float?

Hints

Optional hints to use for model selection.

If multiple hints are specified, the client MUST evaluate them in order (such that the first match is taken).

The client SHOULD prioritize these hints over the numeric priorities, but MAY still use the priorities to select from ambiguous matches.

[JsonPropertyName("hints")]
public IReadOnlyList<ModelHint>? Hints { get; init; }

Property Value

IReadOnlyList<ModelHint>

IntelligencePriority

How much to prioritize intelligence and capabilities when selecting a model. A value of 0 means intelligence is not important, while a value of 1 means intelligence is the most important factor.

[JsonPropertyName("intelligencePriority")]
public float? IntelligencePriority { get; init; }

Property Value

float?

SpeedPriority

How much to prioritize sampling speed (latency) when selecting a model. A value of 0 means speed is not important, while a value of 1 means speed is the most important factor.

[JsonPropertyName("speedPriority")]
public float? SpeedPriority { get; init; }

Property Value

float?

Methods

Validate(out string)

Validates the model preferences.

public bool Validate(out string errorMessage)

Parameters

errorMessage string

Error message if object isn't valid

Returns

bool

True if valid, false if invalid