Spring AI MCP Java SDK - Annotations 2.0.0 API

This document is the API specification for Spring AI

For further API reference and developer documentation, see the Spring AI reference documentation. That documentation contains more detailed, developer-targeted descriptions, with conceptual overviews, definitions of terms, and working code examples.

Packages

Package	Description
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.annotation.adapter	Adapters that bridge MCP annotation-based providers to the MCP SDK transport layer.
org.springframework.ai.mcp.annotation.common	Common utilities for working with MCP annotation metadata.
org.springframework.ai.mcp.annotation.context	Request context types, specifications (logging, progress, sampling, elicitation), and default implementations for MCP request handling.
org.springframework.ai.mcp.annotation.method.changed.prompt	Method callbacks and specifications for MCP prompt list changed notifications.
org.springframework.ai.mcp.annotation.method.changed.resource	Method callbacks and specifications for MCP resource list changed notifications.
org.springframework.ai.mcp.annotation.method.changed.tool	Method callbacks and specifications for MCP tool list changed notifications.
org.springframework.ai.mcp.annotation.method.complete	Method callbacks for MCP completion (chat) requests, sync and async.
org.springframework.ai.mcp.annotation.method.elicitation	Method callbacks and specifications for MCP elicitation (user input) requests.
org.springframework.ai.mcp.annotation.method.logging	Method callbacks and specifications for MCP logging.
org.springframework.ai.mcp.annotation.method.progress	Method callbacks and specifications for MCP progress reporting.
org.springframework.ai.mcp.annotation.method.prompt	Method callbacks for MCP prompt template requests, sync and async.
org.springframework.ai.mcp.annotation.method.resource	Method callbacks and result converters for MCP resource read requests.
org.springframework.ai.mcp.annotation.method.sampling	Method callbacks for MCP sampling (create message) requests.
org.springframework.ai.mcp.annotation.method.tool	Method callbacks and utilities for MCP tool invocation (call_tool).
org.springframework.ai.mcp.annotation.method.tool.utils	Utilities for MCP tool support, such as JSON schema generation.
org.springframework.ai.mcp.annotation.provider.changed.prompt	MCP providers that expose prompt list changed handlers to the transport layer.
org.springframework.ai.mcp.annotation.provider.changed.resource	MCP providers that expose resource list changed handlers to the transport layer.
org.springframework.ai.mcp.annotation.provider.changed.tool	MCP providers that expose tool list changed handlers to the transport layer.
org.springframework.ai.mcp.annotation.provider.complete	MCP providers that expose completion (chat) handlers to the transport layer.
org.springframework.ai.mcp.annotation.provider.elicitation	MCP providers that expose elicitation handlers to the transport layer.
org.springframework.ai.mcp.annotation.provider.logging	MCP providers that expose logging handlers to the transport layer.
org.springframework.ai.mcp.annotation.provider.progress	MCP providers that expose progress handlers to the transport layer.
org.springframework.ai.mcp.annotation.provider.prompt	MCP providers that expose prompt template handlers to the transport layer.
org.springframework.ai.mcp.annotation.provider.resource	MCP providers that expose resource read handlers to the transport layer.
org.springframework.ai.mcp.annotation.provider.sampling	MCP providers that expose sampling (create message) handlers to the transport layer.
org.springframework.ai.mcp.annotation.provider.tool	MCP providers that expose tool (call_tool) handlers to the transport layer.
org.springframework.ai.mcp.annotation.spring
org.springframework.ai.mcp.annotation.spring.scan