http4k-mcp-core/org.http4k.mcp

Package-level declarations

Types

Client

interface Client

CompletionFilter

fun interface CompletionFilter

CompletionHandler

typealias CompletionHandler = (CompletionRequest) -> CompletionResponse

A CompletionHandler is a function which creates a Completion from a set of inputs

CompletionRequest

data class CompletionRequest(val argument: CompletionArgument, val meta: Meta = Meta.default, val client: Client = NoOp, val connectRequest: Request? = null)

CompletionResponse

data class CompletionResponse(val values: List<String>, val total: Int? = null, val hasMore: Boolean? = null)

McpError

sealed interface McpError

Sealed type encapsulating the known failure modes of MCP clients

McpResult

typealias McpResult<T> = Result4k<T, McpError>

PromptFilter

fun interface PromptFilter

PromptHandler

typealias PromptHandler = (PromptRequest) -> PromptResponse

A PromptHandler is a function which creates a Prompt from a set of inputs

PromptRequest

data class PromptRequest(val args: Map<String, String> = emptyMap(), val meta: Meta = Meta.default, val client: Client = NoOp, val connectRequest: Request? = null) : Map<String, String> , McpLensTarget

PromptResponse

data class PromptResponse(val messages: List<Message>, val description: String? = null)

ResourceFilter

fun interface ResourceFilter

ResourceHandler

typealias ResourceHandler = (ResourceRequest) -> ResourceResponse

A resource handler is responsible for loading the content of a Resource

ResourceRequest

data class ResourceRequest(val uri: Uri, val meta: Meta = Meta.default, val client: Client = NoOp, val connectRequest: Request? = null)

ResourceResponse

data class ResourceResponse(val list: List<Resource.Content>, val meta: Meta = Meta.default)

SamplingFilter

fun interface SamplingFilter

SamplingHandler

typealias SamplingHandler = (SamplingRequest) -> Sequence<SamplingResponse>

Processes a sampling request from an MCP server to a client

SamplingRequest

data class SamplingRequest(val messages: List<Message>, val maxTokens: MaxTokens, val systemPrompt: SystemMessage? = null, val includeContext: SamplingIncludeContext? = null, val temperature: Temperature? = null, val stopSequences: List<String>? = null, val modelPreferences: ModelPreferences? = null, val metadata: Map<String, Any> = emptyMap())

SamplingResponse

data class SamplingResponse(val model: ModelName, val role: Role, val content: Content, val stopReason: StopReason? = null)

ToolFilter

fun interface ToolFilter

ToolHandler

typealias ToolHandler = (ToolRequest) -> ToolResponse

A tool handler invokes a tool with an input and returns a response

ToolRequest

data class ToolRequest(val args: Map<String, Any> = emptyMap(), val meta: Meta = Meta.default, val client: Client = NoOp, val connectRequest: Request? = null) : McpLensTarget, Map<String, Any>

ToolResponse

sealed interface ToolResponse