Class McpPromptRegistration.Builder

java.lang.Object

com.soklet.McpPromptRegistration.Builder

Enclosing class:

McpPromptRegistration

@NotThreadSafe
public static final class McpPromptRegistration.Builder
extends Object

Mutable builder for an immutable prompt registration.

Author:

Mark Allen

Method Summary

Modifier and Type	Method	Description
@NonNull McpPromptRegistration.Builder	arguments(@Nullable List<@NonNull McpPromptArgumentDeclaration> argumentDeclarations)	Replaces prompt-argument declarations in supplied order.
@NonNull McpPromptRegistration	build()	Builds an immutable prompt registration.
@NonNull McpPromptRegistration.Builder	completionHandler(@NonNull McpCompletionHandler completionHandler, @NonNull Set<@NonNull McpProtocolVersion> protocolVersions)	Configures the handler for partial prompt-argument suggestions.
@NonNull McpPromptRegistration.Builder	description(@NonNull String description)
@NonNull McpPromptRegistration.Builder	icons(@Nullable List<@NonNull McpIcon> icons)	Replaces icon descriptors in supplied order.
@NonNull McpPromptRegistration.Builder	inputRequestDeclarations(@Nullable List<@NonNull McpInputRequestDeclaration> inputRequestDeclarations)	Replaces input-request declarations in supplied order.
@NonNull McpPromptRegistration.Builder	metadata(@NonNull McpJsonObject metadata)
@NonNull McpPromptRegistration.Builder	requestStateMode(@NonNull McpRequestStateMode requestStateMode)	Sets the request-state contract for this prompt operation.
@NonNull McpPromptRegistration.Builder	title(@NonNull String title)

Methods inherited from class Object

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

Method Details

title

public @NonNull McpPromptRegistration.Builder title(@NonNull String title)

Parameters:

title - human-readable title

Returns:

this builder

description

public @NonNull McpPromptRegistration.Builder description(@NonNull String description)

Parameters:

description - human-readable description

Returns:

this builder

icons

public @NonNull McpPromptRegistration.Builder icons(@Nullable List<@NonNull McpIcon> icons)

Replaces icon descriptors in supplied order. Null or empty clears the property. The complete list is validated and snapshotted before replacing the prior value.

Parameters:

icons - icon descriptors, or null to clear

Returns:

this builder

Throws:

NullPointerException - if a list element is null

arguments

public @NonNull McpPromptRegistration.Builder arguments(@Nullable List<@NonNull McpPromptArgumentDeclaration> argumentDeclarations)

Replaces prompt-argument declarations in supplied order. Null or empty clears the property. The complete list is validated and snapshotted before replacing the prior value.

Parameters:

argumentDeclarations - prompt-argument declarations, or null to clear

Returns:

this builder

Throws:

NullPointerException - if a list element is null

inputRequestDeclarations

public @NonNull McpPromptRegistration.Builder inputRequestDeclarations(@Nullable List<@NonNull McpInputRequestDeclaration> inputRequestDeclarations)

Replaces input-request declarations in supplied order. Null or empty clears the property. The complete list is validated and snapshotted before replacing the prior value.

Parameters:

inputRequestDeclarations - input-request declarations, or null to clear

Returns:

this builder

Throws:

NullPointerException - if a list element is null

requestStateMode

public @NonNull McpPromptRegistration.Builder requestStateMode(@NonNull McpRequestStateMode requestStateMode)

Sets the request-state contract for this prompt operation.

Parameters:

requestStateMode - request-state mode

Returns:

this builder

metadata

public @NonNull McpPromptRegistration.Builder metadata(@NonNull McpJsonObject metadata)

Parameters:

metadata - protocol extension metadata

Returns:

this builder

completionHandler

public @NonNull McpPromptRegistration.Builder completionHandler(@NonNull McpCompletionHandler completionHandler,
 @NonNull Set<@NonNull McpProtocolVersion> protocolVersions)

Configures the handler for partial prompt-argument suggestions. Completion is supported for MCP 2025-06-18, 2025-11-25, and 2026-07-28. Repeated calls replace the previous handler and revision selection.

Parameters:

completionHandler - non-null argument completer

protocolVersions - nonempty subset of this prompt's revisions

Returns:

this builder

build

public @NonNull McpPromptRegistration build()

Builds an immutable prompt registration.

Returns:

prompt registration

Throws:

IllegalStateException - if argument names are duplicated