Package org.springframework.ai.mcp

Class SyncMcpToolCallbackProvider

java.lang.Object

org.springframework.ai.mcp.SyncMcpToolCallbackProvider

All Implemented Interfaces:

org.springframework.ai.tool.ToolCallbackProvider

public class SyncMcpToolCallbackProvider
extends Object
implements org.springframework.ai.tool.ToolCallbackProvider

Provides Spring AI tool callbacks by discovering tools from MCP servers.

Automatically discovers and exposes tools from multiple MCP servers as Spring AI ToolCallback instances.

Since:

1.0.0

Author:

Christian Tzolov, YunKui Lu

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	SyncMcpToolCallbackProvider.Builder	Builder for SyncMcpToolCallbackProvider.

Constructor Summary

Constructors

Constructor	Description
SyncMcpToolCallbackProvider(io.modelcontextprotocol.client.McpSyncClient... mcpClients)	Deprecated. use builder() instead
SyncMcpToolCallbackProvider(List<io.modelcontextprotocol.client.McpSyncClient> mcpClients)	Deprecated. use builder() instead
SyncMcpToolCallbackProvider(McpToolFilter toolFilter, List<io.modelcontextprotocol.client.McpSyncClient> mcpClients)	Deprecated. use builder() instead
SyncMcpToolCallbackProvider(McpToolFilter toolFilter, McpToolNamePrefixGenerator toolNamePrefixGenerator, io.modelcontextprotocol.client.McpSyncClient... mcpClients)	Deprecated. use builder() instead

Method Summary

Modifier and Type	Method	Description
static SyncMcpToolCallbackProvider.Builder	builder()	Creates a builder for constructing provider instances.
org.springframework.ai.tool.ToolCallback[]	getToolCallbacks()
static List<org.springframework.ai.tool.ToolCallback>	syncToolCallbacks(List<io.modelcontextprotocol.client.McpSyncClient> mcpClients)	Creates tool callbacks from multiple MCP clients.

Methods inherited from class java.lang.Object

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

Constructor Details

SyncMcpToolCallbackProvider

@Deprecated
public SyncMcpToolCallbackProvider(McpToolFilter toolFilter,
 List<io.modelcontextprotocol.client.McpSyncClient> mcpClients)

Deprecated.

use builder() instead

Creates a provider with MCP clients and tool filter.

Parameters:

mcpClients - MCP clients for tool discovery

toolFilter - filter for discovered tools

SyncMcpToolCallbackProvider

@Deprecated
public SyncMcpToolCallbackProvider(List<io.modelcontextprotocol.client.McpSyncClient> mcpClients)

Deprecated.

use builder() instead

Creates a provider with MCP clients using default filter.

Parameters:

mcpClients - MCP clients for tool discovery

SyncMcpToolCallbackProvider

@Deprecated
public SyncMcpToolCallbackProvider(McpToolFilter toolFilter,
 McpToolNamePrefixGenerator toolNamePrefixGenerator,
 io.modelcontextprotocol.client.McpSyncClient... mcpClients)

Deprecated.

use builder() instead

Creates a provider with MCP clients, filter, and prefix generator.

Parameters:

mcpClients - MCP clients for tool discovery

toolNamePrefixGenerator - generates prefixes for tool names

toolFilter - filter for discovered tools

SyncMcpToolCallbackProvider

@Deprecated
public SyncMcpToolCallbackProvider(io.modelcontextprotocol.client.McpSyncClient... mcpClients)

Deprecated.

use builder() instead

Creates a provider with MCP clients using default filter.

Parameters:

mcpClients - MCP clients for tool discovery

Method Details

getToolCallbacks

public org.springframework.ai.tool.ToolCallback[] getToolCallbacks()

Specified by:

getToolCallbacks in interface org.springframework.ai.tool.ToolCallbackProvider

syncToolCallbacks

public static List<org.springframework.ai.tool.ToolCallback> syncToolCallbacks(List<io.modelcontextprotocol.client.McpSyncClient> mcpClients)

Creates tool callbacks from multiple MCP clients.

Discovers and consolidates tools from all provided clients into a single list, ensuring no naming conflicts.

Parameters:

mcpClients - MCP clients to discover tools from

Returns:

consolidated list of tool callbacks

builder

public static SyncMcpToolCallbackProvider.Builder builder()

Creates a builder for constructing provider instances.

Returns:

new builder