agents-mcp/ai.koog.agents.mcp/McpTool

McpTool

class McpTool(mcpClient: Client, val descriptor: ToolDescriptor) : Tool<McpTool.Args, McpTool.Result> (source)

A Tool implementation that calls an MCP (Model Context Protocol) tool.

This class serves as a bridge between the agent framework's Tool interface and the MCP SDK. It allows MCP tools to be used within the agent framework by:

Converting agent framework tool arguments to MCP tool arguments
Calling the MCP tool through the MCP client
Converting MCP tool results back to agent framework tool results

Constructors

McpTool

constructor(mcpClient: Client, descriptor: ToolDescriptor)

Types

Args

@Serializable(with = McpTool.ArgsSerializer::class)

data class Args(val arguments: JsonObject) : Tool.Args

Arguments for an MCP tool call.

ArgsSerializer

class ArgsSerializer : KSerializer<McpTool.Args>

Custom serializer for the Args class.

Result

class Result(val promptMessageContents: List<PromptMessageContent>) : ToolResult

Result of an MCP tool call.

Properties

argsSerializer

open override val argsSerializer: KSerializer<McpTool.Args>

descriptor

open override val descriptor: ToolDescriptor

name

val name: String

Functions

decodeArgs

fun decodeArgs(rawArgs: JsonObject): McpTool.Args

decodeArgsFromString

fun decodeArgsFromString(rawArgs: String): McpTool.Args

encodeArgs

fun encodeArgs(args: McpTool.Args): JsonObject

encodeArgsToString

fun encodeArgsToString(args: McpTool.Args): String

encodeResultToString

open fun encodeResultToString(result: McpTool.Result): String

encodeResultToStringUnsafe

fun encodeResultToStringUnsafe(result: ToolResult): String

executeAndSerialize

suspend fun executeAndSerialize(args: McpTool.Args, enabler: DirectToolCallsEnabler): Pair<McpTool.Result, String>

executeUnsafe

suspend fun executeUnsafe(args: Any?, enabler: DirectToolCallsEnabler): McpTool.Result