google-adk-kotlin-core/com.google.adk.kt.tools.mcp/McpTool

McpTool

Initializes an MCP tool.

This wraps an MCP Tool interface and an active MCP Session. It invokes the MCP Tool through executing the tool from remote MCP Session.

Types

Companion

object Companion

Properties

annotations

val annotations: McpSchema.ToolAnnotations?

customMetadata

val customMetadata: Map<String, Any>

The custom metadata of the tool.

description

val description: String

The description of the tool.

isLongRunning

val isLongRunning: Boolean = false

Whether the tool's final result will be delivered out-of-band. When true, the framework marks the call as long-running and uses the tool's return value as the function-response payload. Returning Unit means "no response yet": the FR event is suppressed so the function-call event (which carries the call id in longRunningToolIds and is thus the turn's final response) ends the turn without re-invoking the model. A non-Unit return -- including an explicit empty Map -- is treated as a real response and emitted. (Unit suppression aligns with Python; Java instead always emits {}.) The longRunningToolIds id also drives the resumable-mode pause gate so the invocation can be resumed later via a user-injected function-response.

mcpSessionClient

val mcpSessionClient: McpAsyncClient

Functions

open override fun close()

declaration

open override fun declaration(): FunctionDeclaration?

Returns the underlying function declaration.

processLlmRequest

open suspend fun processLlmRequest(toolContext: ToolContext, llmRequest: LlmRequest): LlmRequest

Processes the LLM request before it is sent.

run

open suspend override fun run(context: ToolContext, args: Map<String, Any>): Any

Executes the tool and returns its result.