Package org.springframework.ai.mcp.modern

@NullMarked package org.springframework.ai.mcp.modern

Support for MCP servers implementing the 2026-07-28 ("modern") specification revision, built on the io.modelcontextprotocol.modern server API of the MCP Java SDK.

The modern SDK serves each primitive from a repository that lists definitions and finds a definition with its handler (McpSyncTool, McpSyncPrompt, McpSyncResource). The InMemorySync*Repository classes are map-backed repositories with runtime add and remove, change broadcasts and key-cursor paging. SyncResourceRegistration and SyncResourceTemplateRegistration pair a resource or template definition with its handler, which the SDK's McpSyncResource does not carry; SyncCompletionRegistration does the same for a completion reference. McpSchemaConverter converts between the legacy and modern schema types, which lets handlers written against the legacy types be exposed on a modern server, and McpTransportContexts reads the request headers that the Spring transports put into the transport context.

Related Packages

Package	Description
org.springframework.ai.mcp	Core support for Model Context Protocol (MCP) integration in Spring AI.
org.springframework.ai.mcp.annotation	Annotations for declaring MCP capabilities (tools, prompts, resources, completion, logging, progress, sampling, elicitation) and list-changed handlers.
org.springframework.ai.mcp.aot
org.springframework.ai.mcp.customizer

Class	Description
InMemorySyncCompletionRepository	An in-memory McpSyncCompletionRepository that dispatches completion/complete to the SyncCompletionRegistration registered for the request's prompt or resource reference.
InMemorySyncCompletionRepository.Builder	Builds a InMemorySyncCompletionRepository.
InMemorySyncPromptRepository	A McpSyncPromptRepository that keeps McpSyncPrompts in a sorted, concurrent map.
InMemorySyncPromptRepository.Builder	Builder for InMemorySyncPromptRepository.
InMemorySyncResourceRepository	A McpSyncResourceRepository that keeps SyncResourceRegistrations and SyncResourceTemplateRegistrations in sorted, concurrent maps.
InMemorySyncResourceRepository.Builder	Builder for InMemorySyncResourceRepository.
InMemorySyncToolRepository	A McpSyncToolRepository that keeps McpSyncTools in a sorted, concurrent map.
InMemorySyncToolRepository.Builder	Builder for InMemorySyncToolRepository.
McpModernToolUtils	Exposes Spring AI ToolCallbacks as tools of a 2026-07-28 MCP server.
McpSchemaConverter	Converts between the legacy (io.modelcontextprotocol.spec.McpSchema) and the modern (io.modelcontextprotocol.modern.McpSchema) schema types.
McpTransportContexts	The transport context convention of the modern Spring AI transports, and accessors for it.
SyncCompletionRegistration	A completion provider exposed on a 2026-07-28 server: the prompt or resource reference it completes and the handler that serves completion/complete.
SyncCompletionRegistration.Handler	Serves a completion/complete request.
SyncResourceRegistration	A listed resource together with the McpSyncResource that reads it.
SyncResourceTemplateRegistration	A resource template together with the McpSyncResource that reads every URI matching it.