Class McpPromptRegistration

java.lang.Object

com.soklet.McpPromptRegistration

@ThreadSafe
public final class McpPromptRegistration
extends Object

Immutable programmatic registration for one MCP prompt.

Registration is staged so a handler must be supplied before optional descriptor metadata can be configured and the registration built. Prompt arguments are flat strings and do not use JSON Schema.

Author:

Mark Allen

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static final class	McpPromptRegistration.Builder	Mutable builder for an immutable prompt registration.
static final class	McpPromptRegistration.HandlerStage	Required-handler stage for a named prompt.

Method Summary

Modifier and Type	Method	Description
@NonNull List<@NonNull McpPromptArgumentDeclaration>	getArguments()
@NonNull Optional<@NonNull McpCompletionHandler>	getCompletionHandler()
@NonNull Set<@NonNull McpProtocolVersion>	getCompletionProtocolVersions()
@NonNull Optional<@NonNull String>	getDescription()
@NonNull McpPromptHandler	getHandler()
@NonNull List<@NonNull McpIcon>	getIcons()
@NonNull List<@NonNull McpInputRequestDeclaration>	getInputRequestDeclarations()	Returns the input requests this prompt operation may emit.
@NonNull McpJsonObject	getMetadata()
@NonNull String	getName()
@NonNull Set<@NonNull McpProtocolVersion>	getProtocolVersions()
@NonNull McpRequestStateMode	getRequestStateMode()	Returns the request-state contract for this prompt operation.
@NonNull Optional<@NonNull String>	getTitle()
static @NonNull McpPromptRegistration.HandlerStage	withName(@NonNull String name, @NonNull Set<@NonNull McpProtocolVersion> protocolVersions)	Begins a staged registration for a named prompt.

Methods inherited from class Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Details

withName

public static @NonNull McpPromptRegistration.HandlerStage withName(@NonNull String name,
 @NonNull Set<@NonNull McpProtocolVersion> protocolVersions)

Begins a staged registration for a named prompt.

Parameters:

name - nonblank prompt name published to MCP clients

protocolVersions - nonempty exact revisions serving this prompt

Returns:

required-handler stage

Throws:

IllegalArgumentException - if name is blank

getName

public @NonNull String getName()

Returns:

published prompt name

getProtocolVersions

public @NonNull Set<@NonNull McpProtocolVersion> getProtocolVersions()

Returns:

exact protocol revisions on which this prompt is available

getTitle

public @NonNull Optional<@NonNull String> getTitle()

Returns:

human-readable title, if configured

getDescription

public @NonNull Optional<@NonNull String> getDescription()

Returns:

human-readable description, if configured

getIcons

public @NonNull List<@NonNull McpIcon> getIcons()

Returns:

immutable icon list in registration order

getArguments

public @NonNull List<@NonNull McpPromptArgumentDeclaration> getArguments()

Returns:

immutable argument declarations in registration order

getInputRequestDeclarations

public @NonNull List<@NonNull McpInputRequestDeclaration> getInputRequestDeclarations()

Returns the input requests this prompt operation may emit.

Returns:

immutable declarations in registration order

getRequestStateMode

public @NonNull McpRequestStateMode getRequestStateMode()

Returns the request-state contract for this prompt operation.

Returns:

request-state mode

getMetadata

public @NonNull McpJsonObject getMetadata()

Returns:

immutable protocol extension metadata

getHandler

public @NonNull McpPromptHandler getHandler()

Returns:

prompt handler

getCompletionHandler

public @NonNull Optional<@NonNull McpCompletionHandler> getCompletionHandler()

Returns:

configured argument completer, or empty when omitted

getCompletionProtocolVersions

public @NonNull Set<@NonNull McpProtocolVersion> getCompletionProtocolVersions()

Returns:

exact revisions on which the completion handler is available