kotlin-sdk-core/io.modelcontextprotocol.kotlin.sdk.types/CreateMessageRequestBuilder

CreateMessageRequestBuilder

class CreateMessageRequestBuilder : RequestBuilder(source)

DSL builder for constructing CreateMessageRequest instances.

This builder creates LLM sampling requests with conversation history.

Required

maxTokens - Maximum number of tokens to generate
messages - List of conversation messages

Optional

systemPrompt - System-level instructions
context - Context inclusion settings
temperature - Sampling temperature (0.0-1.0)
stopSequences - Sequences that stop generation
preferences - Model selection preferences
metadata - Additional metadata
meta - Request metadata

See also

buildCreateMessageRequest

CreateMessageRequest

Properties

var context: IncludeContext?

Optional context inclusion settings.

var maxTokens: Int?

Maximum number of tokens to generate. This is a required field.

var stopSequences: List<String>?

Optional sequences that will stop generation when encountered.

var systemPrompt: String?

Optional system-level instructions for the model.

var temperature: Double?

Optional sampling temperature (0.0-1.0). Lower values are more deterministic.

Functions

fun messages(block: SamplingMessageBuilder.() -> Unit)

Sets messages using a DSL builder.

fun messages(messages: List<SamplingMessage>)

Sets messages directly from a list.

fun meta(builderAction: RequestMetaBuilder.() -> Unit)

Sets request metadata using a DSL builder.

fun metadata(block: JsonObjectBuilder.() -> Unit)

Sets additional metadata using a DSL builder.

fun preferences(value: ModelPreferences)

Sets model preferences directly.

fun preferences(hints: List<String>? = null, cost: Double? = null, speed: Double? = null, intelligence: Double? = null)

Sets model selection preferences using individual parameters.