ai-elements-core/dev.ai.elements.core.mcp/McpAgentTool

McpAgentTool

class McpAgentTool(client: McpClient, val tool: McpTool, val server: McpServerConfig) : AgentTool(source)

One MCP tool as an AgentTool. The model sees <server>__<tool> (unique across servers, within the 64-character limit), the UI the tool's title and server name. Progress notifications stream as preliminary output; results the server flags isError become tool errors; questions the server asks the user (elicitation) go to the chat's dev.ai.elements.core.chat.ToolApprover.input.

Constructors

constructor(client: McpClient, tool: McpTool, server: McpServerConfig)

Types

object Companion

Properties

open override val description: String

open override val name: String

open override val parameters: JsonObject

requiresApproval

open override val requiresApproval: Boolean

Ask the user before running (rendered as a Confirmation).

val server: McpServerConfig

open override val source: String

Who provides the tool when it is not the agent itself (e.g. an MCP server), shown next to the title.

open override val title: String

Human-readable label for the UI (e.g. an MCP tool's title); null shows name.

val tool: McpTool

Functions

open fun categoryFor(arguments: JsonObject): ToolCategory?

What one call does (ACP ToolKind vocabulary), which picks its step view; none by default.

open suspend override fun execute(arguments: JsonObject): String

Run the tool. Throwing reports a tool error back to the model.

open fun kindFor(arguments: JsonObject): ToolKind

What one call means for the UI (a delegation, a skill load…); an ordinary function by default.

open fun locationFor(arguments: JsonObject): String?

The file path or URL one call acts on (ACP ToolCallLocation); none by default.

open fun titleFor(arguments: JsonObject): String?

Label for one call from its arguments (e.g. the skill or agent it names); defaults to title.