Package org.springframework.ai.mcp

Class SyncMcpToolCallback

java.lang.Object

org.springframework.ai.mcp.SyncMcpToolCallback

All Implemented Interfaces:

ToolCallback

public class SyncMcpToolCallback
extends Object
implements 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, ToolContext toolContext)
String	getOriginalToolName()	Returns the original MCP tool name without prefixing.
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

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 ToolDefinition getToolDefinition()

Specified by:

getToolDefinition in interface 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 ToolCallback

call

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

Specified by:

call in interface ToolCallback

builder

public static SyncMcpToolCallback.Builder builder()

Creates a builder for constructing SyncMcpToolCallback instances.

Returns:

a new builder