Package org.springframework.ai.mcp

Class AsyncMcpToolCallback

java.lang.Object

org.springframework.ai.mcp.AsyncMcpToolCallback

All Implemented Interfaces:

ToolCallback

public class AsyncMcpToolCallback
extends Object
implements ToolCallback

Adapts MCP tools to Spring AI's ToolCallback interface with asynchronous execution.

Bridges Model Context Protocol (MCP) tools with Spring AI's tool system, enabling seamless integration of MCP tools in Spring AI applications.

Author:

Christian Tzolov, YunKui Lu, Ilayaperumal Gopinathan

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	AsyncMcpToolCallback.Builder	Builder for constructing AsyncMcpToolCallback instances.

Constructor Summary

Constructors

Constructor	Description
AsyncMcpToolCallback(io.modelcontextprotocol.client.McpAsyncClient mcpClient, io.modelcontextprotocol.spec.McpSchema.Tool tool)	Deprecated. use AsyncMcpToolCallback.Builder instead

Method Summary

Modifier and Type	Method	Description
static AsyncMcpToolCallback.Builder	builder()	Creates a builder for constructing AsyncMcpToolCallback instances.
String	call(String toolCallInput)
String	call(String toolCallInput, ToolContext toolContext)
String	getOriginalToolName()
ToolDefinition	getToolDefinition()

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Methods inherited from interface org.springframework.ai.tool.ToolCallback

getToolMetadata

Constructor Details

AsyncMcpToolCallback

@Deprecated
public AsyncMcpToolCallback(io.modelcontextprotocol.client.McpAsyncClient mcpClient,
 io.modelcontextprotocol.spec.McpSchema.Tool tool)

Deprecated.

use AsyncMcpToolCallback.Builder instead

Creates an AsyncMcpToolCallback with default prefixed tool name.

Parameters:

mcpClient - the MCP client for tool execution

tool - the MCP tool to adapt

Method Details

getToolDefinition

public ToolDefinition getToolDefinition()

Specified by:

getToolDefinition in interface ToolCallback

getOriginalToolName

public String getOriginalToolName()

call

public String call(String toolCallInput)

Specified by:

call in interface ToolCallback

call

public String call(String toolCallInput,
 @Nullable
 ToolContext toolContext)

Specified by:

call in interface ToolCallback

builder

public static AsyncMcpToolCallback.Builder builder()

Creates a builder for constructing AsyncMcpToolCallback instances.

Returns:

a new builder