Package org.apache.juneau.rest.server.mcp.v20250618

Interface McpEndpoint

All Superinterfaces:

McpEndpointMixin

All Known Implementing Classes:

SpringMcpRestServlet

public interface McpEndpoint
extends McpEndpointMixin

Mixin interface that exposes a 2025-06-18 MCP endpoint at POST /mcp on any Juneau REST resource.

The mixin path and the servlet-subclass path (McpRestServlet) are at parity: both bind the revision at compile time and both expose the same capabilities() hook.

Example:

Method Summary

Modifier and Type	Method	Description
default ServerCapabilities	capabilities()	Optional explicit capabilities advertisement for initialize.
default McpRevision	revision()	The MCP protocol revision this endpoint speaks.

Methods inherited from interface org.apache.juneau.rest.server.mcp.McpEndpointMixin

getMcpConfig, handleMcpRequest, subscriptionBroker

Method Details

revision

default McpRevision revision()

Description copied from interface: McpEndpointMixin

The MCP protocol revision this endpoint speaks.

Specified by:

revision in interface McpEndpointMixin

Returns:

The bound revision. Never null.

capabilities

default ServerCapabilities capabilities()

Optional explicit capabilities advertisement for initialize.

Returning null (the default) leaves capabilities auto-derived from the registered tool / prompt / resource lists; a non-null value bypasses auto-derivation.

Stays a default interface method (Correction C8), for the same reason McpRestServlet.capabilities() stays protected: only revision() above, declared on this same interface, ever calls it.

Returns:

The explicit capabilities, or null to auto-derive.