Package dev.tachyonmcp.api.server.features.tools

Interface ToolHandler

All Superinterfaces:

ServerFeature<ToolDescriptor>

All Known Implementing Classes:

AbstractToolHandler, EchoToolHandler, YouComSearchTool

@ExperimentalApi
public interface ToolHandler
extends ServerFeature<ToolDescriptor>

Experimental class-based tool handler escape hatch.

Prefer Tools.register(ToolDescriptor, ToolFn) or Tools.registerAsync(ToolDescriptor, AsyncToolFn). Implement this interface only when a class-based handler is required.

Nested Class Summary

Nested classes/interfaces inherited from interface dev.tachyonmcp.api.server.ServerFeature

ServerFeature.Descriptor, ServerFeature.Request

Method Summary

Modifier and Type	Method	Description
ToolDescriptor	descriptor()	Returns the tool descriptor.
CompletionStage<? extends ToolResult>	handleAsync(InteractionContext context, ToolRequest request)	Handles a tool request asynchronously.

Method Details

descriptor

ToolDescriptor descriptor()

Returns the tool descriptor.

Specified by:

descriptor in interface ServerFeature<ToolDescriptor>

Returns:

the tool descriptor

handleAsync

CompletionStage<? extends ToolResult> handleAsync(InteractionContext context,
 ToolRequest request)

Handles a tool request asynchronously.

Parameters:

context - the interaction context

request - the tool request

Returns:

the pending tool result