Class McpModernToolUtils
java.lang.Object
org.springframework.ai.mcp.modern.McpModernToolUtils
Exposes Spring AI
ToolCallbacks as tools of a 2026-07-28 MCP server.
The McpRequestContext of the current call is available to the callback through
the ToolContext under the TOOL_CONTEXT_MCP_REQUEST_CONTEXT_KEY key. It
deliberately does not reuse the legacy exchange key, whose accessor casts to the
session-based exchange type.
A ToolCallback blocks, so the asynchronous tools run it through
McpModernAsyncUtils.fromBlocking(io.modelcontextprotocol.modern.server.McpRequestContext, java.util.concurrent.Callable<T>): on the calling thread when the request is
served blocking, on boundedElastic otherwise.
- Since:
- 2.1.0
- Author:
- Christian Tzolov
-
Field Summary
FieldsModifier and TypeFieldDescriptionstatic final StringTheToolContextkey under which theMcpRequestContextof the current call is exposed toToolCallbacks. -
Method Summary
Modifier and TypeMethodDescriptionstatic @Nullable io.modelcontextprotocol.modern.server.McpRequestContextgetMcpRequestContext(@Nullable ToolContext toolContext) Retrieves theMcpRequestContextof the current tool call from theToolContext, if the callback is being invoked by a modern MCP server.static io.modelcontextprotocol.modern.server.feature.McpAsyncTooltoAsyncTool(ToolCallback toolCallback) static io.modelcontextprotocol.modern.server.feature.McpAsyncTooltoAsyncTool(ToolCallback toolCallback, @Nullable org.springframework.util.MimeType mimeType) Converts a Spring AIToolCallbackto an asynchronous modern tool, the twin oftoSyncTool(ToolCallback, MimeType).static List<io.modelcontextprotocol.modern.server.feature.McpAsyncTool>toAsyncTools(List<ToolCallback> toolCallbacks) Converts the given callbacks to asynchronous modern tools.static List<io.modelcontextprotocol.modern.server.feature.McpAsyncTool>toAsyncTools(ToolCallback... toolCallbacks) static io.modelcontextprotocol.modern.server.feature.McpSyncTooltoSyncTool(ToolCallback toolCallback) static io.modelcontextprotocol.modern.server.feature.McpSyncTooltoSyncTool(ToolCallback toolCallback, @Nullable org.springframework.util.MimeType mimeType) Converts a Spring AIToolCallbackto a modern tool.static List<io.modelcontextprotocol.modern.server.feature.McpSyncTool>toSyncTools(List<ToolCallback> toolCallbacks) Converts the given callbacks to modern tools.static List<io.modelcontextprotocol.modern.server.feature.McpSyncTool>toSyncTools(ToolCallback... toolCallbacks)
-
Field Details
-
TOOL_CONTEXT_MCP_REQUEST_CONTEXT_KEY
TheToolContextkey under which theMcpRequestContextof the current call is exposed toToolCallbacks.- See Also:
-
-
Method Details
-
toSyncTools
public static List<io.modelcontextprotocol.modern.server.feature.McpSyncTool> toSyncTools(List<ToolCallback> toolCallbacks) Converts the given callbacks to modern tools.- Parameters:
toolCallbacks- the callbacks to expose- Returns:
- one tool per callback
-
toSyncTools
public static List<io.modelcontextprotocol.modern.server.feature.McpSyncTool> toSyncTools(ToolCallback... toolCallbacks) -
toSyncTool
public static io.modelcontextprotocol.modern.server.feature.McpSyncTool toSyncTool(ToolCallback toolCallback) -
toSyncTool
public static io.modelcontextprotocol.modern.server.feature.McpSyncTool toSyncTool(ToolCallback toolCallback, @Nullable org.springframework.util.MimeType mimeType) Converts a Spring AIToolCallbackto a modern tool. The tool definition is built from the callback's name, description and input schema. The callback's text result becomes the tool's text content, or an image content when an image MIME type is given.- Parameters:
toolCallback- the callback to exposemimeType- the MIME type of the callback's output, ornullfor text- Returns:
- the tool
-
toAsyncTools
public static List<io.modelcontextprotocol.modern.server.feature.McpAsyncTool> toAsyncTools(List<ToolCallback> toolCallbacks) Converts the given callbacks to asynchronous modern tools.- Parameters:
toolCallbacks- the callbacks to expose- Returns:
- one tool per callback
- Since:
- 2.1.0
-
toAsyncTools
public static List<io.modelcontextprotocol.modern.server.feature.McpAsyncTool> toAsyncTools(ToolCallback... toolCallbacks) - Since:
- 2.1.0
-
toAsyncTool
public static io.modelcontextprotocol.modern.server.feature.McpAsyncTool toAsyncTool(ToolCallback toolCallback) - Since:
- 2.1.0
-
toAsyncTool
public static io.modelcontextprotocol.modern.server.feature.McpAsyncTool toAsyncTool(ToolCallback toolCallback, @Nullable org.springframework.util.MimeType mimeType) Converts a Spring AIToolCallbackto an asynchronous modern tool, the twin oftoSyncTool(ToolCallback, MimeType). The callback blocks, so it runs throughMcpModernAsyncUtils.fromBlocking(io.modelcontextprotocol.modern.server.McpRequestContext, java.util.concurrent.Callable<T>).- Parameters:
toolCallback- the callback to exposemimeType- the MIME type of the callback's output, ornullfor text- Returns:
- the tool
- Since:
- 2.1.0
-
getMcpRequestContext
public static @Nullable io.modelcontextprotocol.modern.server.McpRequestContext getMcpRequestContext(@Nullable ToolContext toolContext) Retrieves theMcpRequestContextof the current tool call from theToolContext, if the callback is being invoked by a modern MCP server.- Parameters:
toolContext- the tool context passed to the callback- Returns:
- the request context, or
nullwhen the callback is not being invoked by a modern MCP server
-