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

McpTool

class McpTool(mcpClient: Client, descriptor: ToolDescriptor) : Tool<JsonObject, CallToolResult?> (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)

Properties

argsSerializer

val argsSerializer: KSerializer<JsonObject>

descriptor

val descriptor: ToolDescriptor

name

val name: String

resultSerializer

val resultSerializer: KSerializer<CallToolResult?>

Functions

decodeArgs

fun decodeArgs(rawArgs: JsonObject): JsonObject

decodeResult

fun decodeResult(rawResult: JsonElement): CallToolResult?

encodeArgs

fun encodeArgs(args: JsonObject): JsonObject

encodeArgsToString

fun encodeArgsToString(args: JsonObject): String

encodeArgsToStringUnsafe

fun encodeArgsToStringUnsafe(args: Any?): String

encodeArgsUnsafe

fun encodeArgsUnsafe(args: Any?): JsonObject

encodeResult

fun encodeResult(result: CallToolResult?): JsonElement

encodeResultToString

open override fun encodeResultToString(result: CallToolResult?): String

Postprocess result string representation for LLMs a bit, removing unnecessary meta fields.

encodeResultToStringUnsafe

fun encodeResultToStringUnsafe(result: Any?): String

encodeResultUnsafe

fun encodeResultUnsafe(result: Any?): JsonElement

execute

open suspend override fun execute(args: JsonObject): CallToolResult

Executes the MCP tool with the given arguments.

executeUnsafe

suspend fun executeUnsafe(args: Any?): CallToolResult?