MCP Server API 1.0.0 API

Framework-agnostic server APIs for building MCP servers.

This package provides runtime interfaces and utilities that can be used by MCP server implementations. These APIs are designed to be framework-independent and can be implemented by any Java-based MCP server framework.

Defining server features

• Prompt - Define MCP prompts
• Resource - Define MCP resources
• ResourceTemplate - Define MCP resource templates
• Tool - Define MCP tools
• CompletePrompt - Provide completion for MCP prompt arguments
• CompleteResourceTemplate - Provide completion for MCP resource template arguments

Common APIs

• Cancellation - Request cancellation handling
• ContentEncoder - Custom content encoding
• McpException - Base MCP exception
• McpRequest - Request metadata
• Progress - Progress reporting for long-running operations

Framework-Agnostic Design

These interfaces use generic types for reactive returns (e.g., <T> T send()). Framework implementations should return their native reactive types:

• Quarkus: Uni<T> from SmallRye Mutiny
• Spring: Mono<T> from Project Reactor
• Standard Java: CompletableFuture<T>

See Also:

• Model Context Protocol
• MCP Specification

Packages

Package	Description
org.mcpjava.server	Core annotations and APIs for building Model Context Protocol (MCP) servers.
org.mcpjava.server.completion	Provide auto-completion functionality to the client.
org.mcpjava.server.content	Content blocks, for inclusion in resources and tool call responses.
org.mcpjava.server.progress	Report progress for long-running operations.
org.mcpjava.server.prompts	Define MCP prompts.
org.mcpjava.server.resources	Define MCP resources and resource templates.
org.mcpjava.server.spi	Mechanism for providing the implementation of the API.
org.mcpjava.server.tools	Define MCP tools.