Class SyncMcpToolCallback

java.lang.Object

org.springframework.ai.mcp.SyncMcpToolCallback

All Implemented Interfaces:

org.springframework.ai.tool.ToolCallback

public class SyncMcpToolCallback
extends Object
implements org.springframework.ai.tool.ToolCallback

Synchronous adapter bridging MCP tools to Spring AI's ToolCallback interface. Handles tool execution and data conversion between MCP and Spring AI.

Since:

1.0.0

Author:

Christian Tzolov, YunKui Lu, Ilayaperumal Gopinathan

Nested Class Summary

Nested Classes

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

Constructor Summary

Constructors

Constructor	Description
SyncMcpToolCallback(io.modelcontextprotocol.client.McpSyncClient mcpClient, io.modelcontextprotocol.spec.McpSchema.Tool tool)	Deprecated. use builder() instead

Method Summary

Modifier and Type	Method	Description
static SyncMcpToolCallback.Builder	builder()	Creates a builder for constructing SyncMcpToolCallback instances.
String	call(String toolCallInput)
String	call(String toolCallInput, org.springframework.ai.chat.model.ToolContext toolContext)
String	getOriginalToolName()	Returns the original MCP tool name without prefixing.
org.springframework.ai.tool.definition.ToolDefinition	getToolDefinition()

Methods inherited from class Object

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

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

getToolMetadata

Constructor Details

SyncMcpToolCallback

@Deprecated
public SyncMcpToolCallback(io.modelcontextprotocol.client.McpSyncClient mcpClient,
 io.modelcontextprotocol.spec.McpSchema.Tool tool)

Deprecated.

use builder() instead

Creates a callback with default settings.

Parameters:

mcpClient - the MCP client for tool execution

tool - the MCP tool to adapt

Method Details

getToolDefinition

public org.springframework.ai.tool.definition.ToolDefinition getToolDefinition()

Specified by:

getToolDefinition in interface org.springframework.ai.tool.ToolCallback

getOriginalToolName

public String getOriginalToolName()

Returns the original MCP tool name without prefixing.

Returns:

the original tool name

call

public String call(String toolCallInput)

Specified by:

call in interface org.springframework.ai.tool.ToolCallback

call

public String call(String toolCallInput,
 @Nullable
 org.springframework.ai.chat.model.ToolContext toolContext)

Specified by:

call in interface org.springframework.ai.tool.ToolCallback

builder

public static SyncMcpToolCallback.Builder builder()

Creates a builder for constructing SyncMcpToolCallback instances.

Returns:

a new builder