All Classes and Interfaces
Class
Description
Convenient base for asynchronous RPC method handlers.
Shared periodic-sweep scheduling for background cleanup tasks (session eviction, task
expiry/retention).
Abstract registry for named, paginated MCP features.
Experimental base class for class-based tool handlers.
Enforces MCP Accept-header rules per spec (`MUST include application/json, text/event-stream`
on POST; `MUST include text/event-stream` on GET).
Optional metadata that clients can use to tailor how content is presented.
Optional annotations for the client.
Optional annotations for the client.
Builder for
Annotations.Builder for
Annotations.Builder for
Annotations.Codec for
Annotations.Codec for
Annotations.Arguments container wrapping a
JsonObject with optional deserialization support.Asynchronously produces candidates for a completion request.
Asynchronously handles a prompt request.
Asynchronously reads static or templated resource contents from a full request.
Asynchronous tool function.
A typed, identity-based key for
InteractionContext.get(AttributeKey) /
InteractionContext.set(AttributeKey, Object).An audio content block provided to or from an LLM.
Audio provided to or from an LLM.
Audio provided to or from an LLM.
Builder for
AudioContent.Builder for
AudioContent.Builder for
AudioContent.Codec for
AudioContent.Codec for
AudioContent.Represents SSE stream backpressure state.
Base interface for metadata with name (identifier) and title (display name) properties.
Base interface for metadata with name (identifier) and title (display name) properties.
Builder for
BaseMetadata.Builder for
BaseMetadata.Binary resource contents, encoded as a base64 string.
A blob resource contents.
A blob resource contents.
Builder for
BlobResourceContents.Builder for
BlobResourceContents.Builder for
BlobResourceContents.Codec for
BlobResourceContents.Codec for
BlobResourceContents.A boolean schema.
A boolean schema.
Builder for
BooleanSchema.Builder for
BooleanSchema.Codec for
BooleanSchema.Codec for
BooleanSchema.A result that supports a time-to-live (TTL) hint for client-side caching.
Builder for
CacheableResult.Used by the client to invoke a tool provided by the server.
Used by the client to invoke a tool provided by the server.
Builder for
CallToolRequest.Builder for
CallToolRequest.Codec for
CallToolRequest.Codec for
CallToolRequest.Parameters for a `tools/call` request.
Parameters for a `tools/call` request.
Builder for
CallToolRequestParams.Builder for
CallToolRequestParams.Codec for
CallToolRequestParams.Codec for
CallToolRequestParams.The server's response to a tool call.
The result returned by the server for a tools/call request.
Builder for
CallToolResult.Builder for
CallToolResult.Codec for
CallToolResult.Codec for
CallToolResult.A successful response from the server for a tools/call request.
Builder for
CallToolResultResponse.Codec for
CallToolResultResponse.This notification can be sent by either side to indicate that it is cancelling a previously-issued request.
This notification is sent by the client to indicate that it is cancelling a request it previously issued.
Builder for
CancelledNotification.Builder for
CancelledNotification.Codec for
CancelledNotification.Codec for
CancelledNotification.Parameters for a `notifications/cancelled` notification.
Parameters for a `notifications/cancelled` notification.
Builder for
CancelledNotificationParams.Builder for
CancelledNotificationParams.Codec for
CancelledNotificationParams.Codec for
CancelledNotificationParams.A request to cancel a task.
Codec for
CancelTaskRequest.Params.Builder for
CancelTaskRequest.Builder for
CancelTaskRequest.Params.Codec for
CancelTaskRequest.The response to a tasks/cancel request.
Builder for
CancelTaskResult.Codec for
CancelTaskResult.Configuration of which MCP capabilities to enable and their behaviour.
Builder for
CapabilitiesConfig.Change-notification for registries: a list of listeners run when contents change.
Context for an MCP channel, providing access to the protocol, session, and lifecycle.
Capabilities a client may support.
Capabilities a client may support.
Codec for
ClientCapabilities.Elicitation.Codec for
ClientCapabilities.Elicitation.Codec for
ClientCapabilities.Roots.Codec for
ClientCapabilities.Sampling.Codec for
ClientCapabilities.Sampling.Codec for
ClientCapabilities.Tasks.Requests.Sampling.Codec for
ClientCapabilities.Tasks.Requests.Codec for
ClientCapabilities.Tasks.Builder for
ClientCapabilities.Builder for
ClientCapabilities.Builder for
ClientCapabilities.Elicitation.Builder for
ClientCapabilities.Elicitation.Builder for
ClientCapabilities.Roots.Builder for
ClientCapabilities.Sampling.Builder for
ClientCapabilities.Sampling.Builder for
ClientCapabilities.Tasks.Builder for
ClientCapabilities.Tasks.Requests.Builder for
ClientCapabilities.Tasks.Requests.Elicitation.Builder for
ClientCapabilities.Tasks.Requests.Sampling.Codec for
ClientCapabilities.Codec for
ClientCapabilities.Typed access to the client-facing collaboration channels a handler may invoke:
elicitation and sampling round-trips.
A client notification.
Builder for
ClientNotification.Codec for
ClientNotification.A client result.
Builder for
ClientResult.Codec for
ClientResult.Builder for
CodecRegistry.Builder for
CodecRegistry.A request from the client to the server, to ask for completion options.
A request from the client to the server, to ask for completion options.
Builder for
CompleteRequest.Builder for
CompleteRequest.Codec for
CompleteRequest.Codec for
CompleteRequest.Parameters for a `completion/complete` request.
Parameters for a `completion/complete` request.
Codec for
CompleteRequestParams.Argument.Codec for
CompleteRequestParams.Argument.Builder for
CompleteRequestParams.Argument.Builder for
CompleteRequestParams.Argument.Builder for
CompleteRequestParams.Builder for
CompleteRequestParams.Codec for
CompleteRequestParams.Codec for
CompleteRequestParams.The server's response to a completion/complete request
The result returned by the server for a completion/complete request.
Codec for
CompleteResult.Completion.Codec for
CompleteResult.Completion.Builder for
CompleteResult.Builder for
CompleteResult.Builder for
CompleteResult.Completion.Builder for
CompleteResult.Completion.Codec for
CompleteResult.Codec for
CompleteResult.A successful response from the server for a completion/complete request.
Builder for
CompleteResultResponse.Codec for
CompleteResultResponse.Synchronously produces candidates for a completion request.
JSON-RPC adapter for completion operations.
A
completion/complete request: the argument being completed and any
previously-resolved sibling arguments supplied as context.Completion candidates for a single argument, per the MCP
completion/complete result
shape.Builder for
CompletionResult.Façade interface for
completion/complete providers, keyed by the MCP reference they answer for:
a prompt name (ref/prompt) or a resource URI / resource-template URI (
ref/resource, matched verbatim against the URI the client sends — the same string returned by
resources/templates/list).A piece of content in a tool result, prompt message, or resource.
MCP protocol type discriminator for content block variants.
Codec for
ContentBlock.Codec for
ContentBlock.Maps content-block domain types to MCP 2025-11-25 wire models.
Handler-facing notification surface used from within an interaction (handler dispatch) context.
A request from the server to sample an LLM via the client.
A request from the server to sample an LLM via the client.
Builder for
CreateMessageRequest.Builder for
CreateMessageRequest.Codec for
CreateMessageRequest.Codec for
CreateMessageRequest.Parameters for a `sampling/createMessage` request.
Parameters for a `sampling/createMessage` request.
Builder for
CreateMessageRequestParams.Builder for
CreateMessageRequestParams.Codec for
CreateMessageRequestParams.Codec for
CreateMessageRequestParams.The client's response to a sampling/createMessage request from the server.
The result returned by the client for a sampling/createMessage request.
Builder for
CreateMessageResult.Builder for
CreateMessageResult.Codec for
CreateMessageResult.Codec for
CreateMessageResult.A response to a task-augmented request.
Builder for
CreateTaskResult.Codec for
CreateTaskResult.Registry of completion handlers, keyed independently by prompt name and by resource
URI/template.
Registry for resources, templates, and subscriptions.
AbstractRegistry for tool handlers with input/output schema validation.
Handles the mandatory modern MCP
server/discover request.A request from the client asking the server to advertise its supported protocol versions, capabilities, and other metadata.
Builder for
DiscoverRequest.Codec for
DiscoverRequest.The result returned by the server for a server/discover request.
Builder for
DiscoverResult.Codec for
DiscoverResult.A successful response from the server for a server/discover request.
Builder for
DiscoverResultResponse.Codec for
DiscoverResultResponse.Guards against DNS-rebinding attacks by validating the
Host and Origin headers.An optional notification from the server to the client, informing it of a completion of a out-of-band elicitation request.
Codec for
ElicitationCompleteNotification.Params.Builder for
ElicitationCompleteNotification.Builder for
ElicitationCompleteNotification.Params.Codec for
ElicitationCompleteNotification.A request to elicit additional information from the user via the client, in form mode.
The client's response to an elicitation request.
The user action in response to an elicitation request.
Requests additional information from the user via the client (
elicitation/create).A request from the server to elicit additional information from the user via the client.
A request from the server to elicit additional information from the user via the client.
Builder for
ElicitRequest.Builder for
ElicitRequest.Codec for
ElicitRequest.Codec for
ElicitRequest.The parameters for a request to elicit non-sensitive information from the user via a form in the client.
The parameters for a request to elicit non-sensitive information from the user via a form in the client.
Builder for
ElicitRequestFormParams.Builder for
ElicitRequestFormParams.Codec for
ElicitRequestFormParams.Codec for
ElicitRequestFormParams.The parameters for a request to elicit additional information from the user via the client.
The parameters for a request to elicit additional information from the user via the client.
Codec for
ElicitRequestParams.Codec for
ElicitRequestParams.The parameters for a request to elicit information from the user via a URL in the client.
The parameters for a request to elicit information from the user via a URL in the client.
Builder for
ElicitRequestURLParams.Builder for
ElicitRequestURLParams.Codec for
ElicitRequestURLParams.Codec for
ElicitRequestURLParams.The client's response to an elicitation request.
The result returned by the client for an elicitation/create request.
Builder for
ElicitResult.Builder for
ElicitResult.Codec for
ElicitResult.Codec for
ElicitResult.A complete resource embedded inline within a tool result, prompt, or other content.
The contents of a resource, embedded into a prompt or tool call result.
The contents of a resource, embedded into a prompt or tool call result.
Builder for
EmbeddedResource.Builder for
EmbeddedResource.Codec for
EmbeddedResource.Codec for
EmbeddedResource.An empty response carrying only optional metadata.
A response that indicates success but carries no data.
A result that indicates success but carries no data.
Builder for
EmptyResult.Builder for
EmptyResult.Codec for
EmptyResult.Codec for
EmptyResult.Rejects requests whose URI does not match the configured MCP endpoint path
with a
404 Not Found response.A error.
A error.
Builder for
Error.Builder for
Error.Codec for
Error.Indicates that an annotated element is experimental and may be subject to
change or removal in future versions.
Extension point that can hook into the connection lifecycle and register custom handlers.
Server surface available while bootstrapping an extension.
Handles a single raw JSON-RPC method owned by a
ServerExtension.Transport-neutral settings negotiated for a protocol extension.
Shared configuration for a single-list MCP capability (tools/prompts): enablement mode,
list-changed notifications, and default page size.
Builder for
FeatureConfig.Requests user input via a form described by a JSON schema.
Used by the client to get a prompt provided by the server.
Used by the client to get a prompt provided by the server.
Builder for
GetPromptRequest.Builder for
GetPromptRequest.Codec for
GetPromptRequest.Codec for
GetPromptRequest.Parameters for a `prompts/get` request.
Parameters for a `prompts/get` request.
Builder for
GetPromptRequestParams.Builder for
GetPromptRequestParams.Codec for
GetPromptRequestParams.Codec for
GetPromptRequestParams.The server's response to a prompts/get request from the client.
The result returned by the server for a prompts/get request.
Builder for
GetPromptResult.Builder for
GetPromptResult.Codec for
GetPromptResult.Codec for
GetPromptResult.A successful response from the server for a prompts/get request.
Builder for
GetPromptResultResponse.Codec for
GetPromptResultResponse.A request to retrieve the result of a completed task.
Codec for
GetTaskPayloadRequest.Params.Builder for
GetTaskPayloadRequest.Builder for
GetTaskPayloadRequest.Params.Codec for
GetTaskPayloadRequest.The response to a tasks/result request.
Builder for
GetTaskPayloadResult.Codec for
GetTaskPayloadResult.A request to retrieve the state of a task.
Codec for
GetTaskRequest.Params.Builder for
GetTaskRequest.Builder for
GetTaskRequest.Params.Codec for
GetTaskRequest.The response to a tasks/get request.
Builder for
GetTaskResult.Codec for
GetTaskResult.Static utilities for common CompletionStage patterns.
Fires a log entry at configurable thresholds when a handler takes longer than expected.
Marks types that carry optional metadata (
_meta) for protocol extensions.Returned when a server rejects a request because the values in the HTTP headers do not match the corresponding values in the request body, or because required headers are missing or malformed.
Builder for
HeaderMismatchError.Codec for
HeaderMismatchError.An icon entry for a tool or resource, pointing to an image resource.
An optionally-sized icon that can be displayed in a user interface.
An optionally-sized icon that can be displayed in a user interface.
Builder for
Icon.Builder for
Icon.Builder for
Icon.Codec for
Icon.Codec for
Icon.Base interface to add `icons` property.
Base interface to add `icons` property.
Builder for
Icons.Builder for
Icons.An image provided to or from an LLM.
An image provided to or from an LLM.
An image provided to or from an LLM.
Builder for
ImageContent.Builder for
ImageContent.Builder for
ImageContent.Codec for
ImageContent.Codec for
ImageContent.Describes the MCP implementation.
Describes the MCP implementation.
Builder for
Implementation.Builder for
Implementation.Codec for
Implementation.Codec for
Implementation.This notification is sent from the client to the server after initialization has finished.
Builder for
InitializedNotification.Codec for
InitializedNotification.This request is sent from the client to the server when it first connects, asking it to begin initialization.
Builder for
InitializeRequest.Codec for
InitializeRequest.Parameters for an `initialize` request.
Builder for
InitializeRequestParams.Codec for
InitializeRequestParams.Server response to the
initialize request.After receiving an initialize request from the client, the server sends this response.
Builder for
InitializeResult.Codec for
InitializeResult.In-memory event log bounded to
InMemorySessionEventStore.maxEvents: appends past the cap drop the oldest entry
(they remain unrecoverable — an SSE client reconnecting with a Last-Event-ID older than
the window simply misses those events, matching typical broker retention semantics).A request for additional user input during a tool call or prompt get.
Shared payload for an MCP
input_required outcome: the pending input requests keyed by
name, plus optional opaque continuation state.A map of server-initiated requests that the client must fulfill.
Builder for
InputRequests.Codec for
InputRequests.An InputRequiredResult sent by the server to indicate that additional input is needed before the request can be completed.
Builder for
InputRequiredResult.Codec for
InputRequiredResult.A input response request params.
Builder for
InputResponseRequestParams.A map of client responses to server-initiated requests.
Builder for
InputResponses.Codec for
InputResponses.Handler-facing view of the per-channel interaction: the current lifecycle phase, protocol
version, optional session identifier, and the collaboration channels a tool/resource/prompt
handler legitimately needs (
InteractionContext.notifications() and InteractionContext.sendRequest(String, Object)).Lifecycle phases of an MCP interaction.
INITIALIZATION → OPERATION: protocol negotiation complete.
SHUTDOWN complete: all cleanup done, channel may be closed.
OPERATION → SHUTDOWN: client requested graceful termination.
Creates and manages the per-channel
ChannelContext on channel
active/inactive lifecycle events.Marks a public type, member, or package that exists only for Tachyon's own cross-package
wiring.
A JSON-RPC error indicating that an internal error occurred on the receiver.
Builder for
InternalError.Codec for
InternalError.Thrown when a method argument cannot be decoded or validated.
A JSON-RPC error indicating that the method parameters are invalid or malformed.
Builder for
InvalidParamsError.Codec for
InvalidParamsError.A JSON-RPC error indicating that the request is not a valid request object.
Builder for
InvalidRequestError.Codec for
InvalidRequestError.Jackson 3-backed
JsonDocumentFactory and JsonSchemaFactory for String
sources: parses the source and rejects malformed JSON before wrapping it.Jackson
JsonNode-backed JsonDocumentFactory and JsonSchemaFactory: wraps
an already-parsed tree without re-serializing it, retaining the node for JsonDocument.unwrap(Class) instead of round-tripping through a JSON string.Jackson
ObjectNode-backed JsonDocumentFactory and JsonSchemaFactory:
wraps an already-parsed object node without re-serializing it, retaining it for JsonDocument.unwrap(Class) instead of round-tripping through a JSON string.Default
PayloadSerde backed by Jackson.An immutable, provider-neutral view of a JSON array.
JSON payload configuration for the server: serializer, deserializer, schema validators, and
schema parsing factory.
Builder for
JsonConfig.An encoded JSON value.
Creates a
JsonDocument from a source representation, validating it in the process.An immutable, provider-neutral view of a JSON object.
Low-level JSON-RPC 2.0 codec: parse and serialize messages to/from Netty
ByteBuf.A JSON-RPC error object, produced by a protocol version's
ProtocolResponseMapper.A response to a request that indicates an error occurred.
A response to a request that indicates an error occurred.
Builder for
JSONRPCErrorResponse.Builder for
JSONRPCErrorResponse.Codec for
JSONRPCErrorResponse.Codec for
JSONRPCErrorResponse.A parsed JSON-RPC 2.0 message: request, notification, response, or error.
Refers to any valid JSON-RPC object that can be decoded off the wire, or encoded to be sent.
Refers to any valid JSON-RPC object that can be decoded off the wire, or encoded to be sent.
A JSON-RPC error response.
A JSON-RPC notification (no ID, no response expected).
A JSON-RPC request with an ID (expecting a response).
A JSON-RPC success response.
A notification which does not expect a response.
A notification which does not expect a response.
Builder for
JSONRPCNotification.Builder for
JSONRPCNotification.A request that expects a response.
A request that expects a response.
Builder for
JSONRPCRequest.Builder for
JSONRPCRequest.A response to a request, containing either the result or error.
A response to a request, containing either the result or error.
A successful (non-error) response to a request.
A successful (non-error) response to a request.
Builder for
JSONRPCResultResponse.Builder for
JSONRPCResultResponse.Codec for
JSONRPCResultResponse.An immutable, encoded JSON Schema.
Creates a
JsonSchema from a source representation, validating it in the process.Validates JSON data against a JSON Schema.
Use TitledSingleSelectEnumSchema instead.
Use TitledSingleSelectEnumSchema instead.
Builder for
LegacyTitledEnumSchema.Builder for
LegacyTitledEnumSchema.Codec for
LegacyTitledEnumSchema.Codec for
LegacyTitledEnumSchema.Sent from the client to request a list of prompts and prompt templates the server has.
Sent from the client to request a list of prompts and prompt templates the server has.
Builder for
ListPromptsRequest.Builder for
ListPromptsRequest.Codec for
ListPromptsRequest.Codec for
ListPromptsRequest.The server's response to a prompts/list request from the client.
The result returned by the server for a prompts/list request.
Builder for
ListPromptsResult.Builder for
ListPromptsResult.Codec for
ListPromptsResult.Codec for
ListPromptsResult.A successful response from the server for a prompts/list request.
Builder for
ListPromptsResultResponse.Codec for
ListPromptsResultResponse.Shared parsing of limit/cursor from JSON-RPC request params.
Sent from the client to request a list of resources the server has.
Sent from the client to request a list of resources the server has.
Builder for
ListResourcesRequest.Builder for
ListResourcesRequest.Codec for
ListResourcesRequest.Codec for
ListResourcesRequest.The server's response to a resources/list request from the client.
The result returned by the server for a resources/list request.
Builder for
ListResourcesResult.Builder for
ListResourcesResult.Codec for
ListResourcesResult.Codec for
ListResourcesResult.A successful response from the server for a resources/list request.
Builder for
ListResourcesResultResponse.Codec for
ListResourcesResultResponse.Sent from the client to request a list of resource templates the server has.
Sent from the client to request a list of resource templates the server has.
Builder for
ListResourceTemplatesRequest.Builder for
ListResourceTemplatesRequest.Codec for
ListResourceTemplatesRequest.Codec for
ListResourceTemplatesRequest.The server's response to a resources/templates/list request from the client.
The result returned by the server for a resources/templates/list request.
Builder for
ListResourceTemplatesResult.Builder for
ListResourceTemplatesResult.Codec for
ListResourceTemplatesResult.Codec for
ListResourceTemplatesResult.A successful response from the server for a resources/templates/list request.
Builder for
ListResourceTemplatesResultResponse.Codec for
ListResourceTemplatesResultResponse.Sent from the server to request a list of root URIs from the client.
Sent from the server to request a list of root URIs from the client.
Codec for
ListRootsRequest.Params.Builder for
ListRootsRequest.Builder for
ListRootsRequest.Builder for
ListRootsRequest.Params.Codec for
ListRootsRequest.Codec for
ListRootsRequest.The client's response to a roots/list request from the server.
The result returned by the client for a roots/list request.
Builder for
ListRootsResult.Builder for
ListRootsResult.Codec for
ListRootsResult.Codec for
ListRootsResult.A request to retrieve a list of tasks.
Builder for
ListTasksRequest.Codec for
ListTasksRequest.The response to a tasks/list request.
Builder for
ListTasksResult.Codec for
ListTasksResult.Sent from the client to request a list of tools the server has.
Sent from the client to request a list of tools the server has.
Builder for
ListToolsRequest.Builder for
ListToolsRequest.Codec for
ListToolsRequest.Codec for
ListToolsRequest.The server's response to a tools/list request from the client.
The result returned by the server for a tools/list request.
Builder for
ListToolsResult.Builder for
ListToolsResult.Codec for
ListToolsResult.Codec for
ListToolsResult.A successful response from the server for a tools/list request.
Builder for
ListToolsResultResponse.Codec for
ListToolsResultResponse.Logging levels matching the MCP protocol specification.
The severity of a log message.
The severity of a log message.
Maps
LoggingLevel to and from the MCP 2025-11-25 wire model.JSONRPCNotification of a log message passed from server to client.
JSONRPCNotification of a log message passed from server to client.
Builder for
LoggingMessageNotification.Builder for
LoggingMessageNotification.Codec for
LoggingMessageNotification.Codec for
LoggingMessageNotification.Parameters for a `notifications/message` notification.
Parameters for a `notifications/message` notification.
Builder for
LoggingMessageNotificationParams.Builder for
LoggingMessageNotificationParams.Codec for
LoggingMessageNotificationParams.Codec for
LoggingMessageNotificationParams.Assembles the Netty pipeline for each new MCP channel: validation handlers
(endpoint, origin, protocol version, accept header, stateless guard),
InteractionHandler, HTTP aggregation, idle timeout, the
initialization-phase handler (McpInitializationHandler), and the
LifecyclePipelineCoordinator.Orchestrates the MCP server's per-request flow: parses JSON-RPC messages, establishes the session on
initialize, routes to registered handlers (including extension methods), tracks pending
requests, and encodes responses.A dispatched JSON-RPC response (result or error envelope) ready to write to the wire.
Transport-level signal: the transport must reply with a raw HTTP
code/message,
not a JSON-RPC error envelope.Constants for MCP-related HTTP header names.
Handles the INITIALIZATION lifecycle phase of an MCP connection.
Handles MCP requests during the OPERATION lifecycle phase: all JSON-RPC methods
after the initial
initialize handshake.Protocol implementation for the MCP protocol version 2025-11-25.MCP protocol implementation for the modern, per-request 2026-07-28 revision.
Request mapper for MCP 2025-11-25 and its backward-compatible request shapes.
Request mapper for MCP 2026-07-28.
ProtocolResponseMapper for MCP 2025-11-25.Maps the modern MCP discovery and empty response shapes.
A JSON-RPC error indicating that the requested method does not exist or is not available.
Builder for
MethodNotFoundError.Codec for
MethodNotFoundError.Returned when processing a request requires a capability the client did not declare in `clientCapabilities`.
Builder for
MissingRequiredClientCapabilityError.Codec for
MissingRequiredClientCapabilityError.Thrown by a handler when processing a request requires a client capability the client did not
declare in
_meta.io.modelcontextprotocol/clientCapabilities.Controls whether a capability is enabled, disabled, or auto-detected from registered features.
Hints to use for model selection.
Hints to use for model selection.
Builder for
ModelHint.Builder for
ModelHint.Codec for
ModelHint.Codec for
ModelHint.The server's preferences for model selection, requested of the client during sampling.
The server's preferences for model selection, requested of the client during sampling.
Builder for
ModelPreferences.Builder for
ModelPreferences.Codec for
ModelPreferences.Codec for
ModelPreferences.Monitoring configuration for the MCP server.
Builder for
MonitoringConfig.A Netty I/O transport engine — pairs an
IoHandlerFactory with a
ServerSocketChannel class.Netty-based MCP server with Streamable HTTP transport.
Configuration for the Netty transport.
SseConnection backed by a Netty Channel.Network-level server configuration.
Builder for
NetworkConfig.JSON Schema validator backed by
networknt/json-schema-validator.A notification.
A notification.
Builder for
Notification.Builder for
Notification.Codec for
Notification.Codec for
Notification.Shared
notifications/message wire-shape helpers for the two independent notification
senders — DefaultDispatchContext.NotificationsImpl (per-request) and
DefaultTachyonServer.broadcastLog (server-wide) — which live in different packages and
gate emission with their own, unrelated shouldEmit logic.Extends MetaObject with additional notification-specific fields.
Builder for
NotificationMetaObject.A notification params.
Common params for any notification.
Builder for
NotificationParams.Builder for
NotificationParams.Emits structured MCP
notifications/message logs.A number schema.
A number schema.
Builder for
NumberSchema.Builder for
NumberSchema.Codec for
NumberSchema.Codec for
NumberSchema.Outbound SSE stream bound to the current dispatch context.
Default
OutboundStreamResolver that diverts events through an OutboundSseStream bound in
the current dispatch context when the dispatch session matches the target session.Resolves the transport channel server-to-client SSE events should be delivered on.
A paginated request.
A paginated request.
Builder for
PaginatedRequest.Builder for
PaginatedRequest.Common parameters for paginated requests.
Common params for paginated requests.
Builder for
PaginatedRequestParams.Builder for
PaginatedRequestParams.Codec for
PaginatedRequestParams.Codec for
PaginatedRequestParams.A paginated result with an optional cursor for the next page.
A paginated result.
A paginated result.
Builder for
PaginatedResult.Builder for
PaginatedResult.Static pagination utility shared by registries.
A JSON-RPC error indicating that invalid JSON was received by the server.
Builder for
ParseError.Codec for
ParseError.Pluggable payload deserialization for structured values and arguments.
Pluggable payload serialization for structured values and arguments.
Pluggable payload serialization for structured values and arguments.
A ping, issued by either the server or the client, to check that the other party is still alive.
Builder for
PingRequest.Codec for
PingRequest.Per-POST SSE response stream.
Restricted schema definitions that only allow primitive types without nested objects or arrays.
Restricted schema definitions that only allow primitive types without nested objects or arrays.
An out-of-band notification used to inform the receiver of a progress update for a long-running request.
An out-of-band notification used to inform the receiver of a progress update for a long-running request.
Builder for
ProgressNotification.Builder for
ProgressNotification.Codec for
ProgressNotification.Codec for
ProgressNotification.Parameters for a `notifications/progress` notification.
Parameters for a notifications/progress notification.
Builder for
ProgressNotificationParams.Builder for
ProgressNotificationParams.Codec for
ProgressNotificationParams.Codec for
ProgressNotificationParams.An MCP progress token: an opaque value the client attaches to a request via
_meta.progressToken and the server echoes back on notifications/progress.A progress token carrying a numeric value.
A progress token carrying a string value.
A prompt or prompt template that the server offers.
A prompt or prompt template that the server offers.
Builder for
Prompt.Builder for
Prompt.Describes a single argument accepted by a prompt template.
Describes an argument that a prompt can accept.
Describes an argument that a prompt can accept.
Builder for
PromptArgument.Builder for
PromptArgument.Codec for
PromptArgument.Codec for
PromptArgument.Codec for
Prompt.Codec for
Prompt.Descriptor for a server-provided prompt template.
Builder for
PromptDescriptor.Synchronously handles a prompt request.
An optional notification from the server to the client, informing it that the list of prompts it offers has changed.
An optional notification from the server to the client, informing it that the list of prompts it offers has changed.
Builder for
PromptListChangedNotification.Builder for
PromptListChangedNotification.Codec for
PromptListChangedNotification.Codec for
PromptListChangedNotification.A single message within a prompt, associating a
Role with its ContentBlock.Describes a message returned as part of a prompt.
Describes a message returned as part of a prompt.
Builder for
PromptMessage.Builder for
PromptMessage.Codec for
PromptMessage.Codec for
PromptMessage.JSON-RPC adapters for prompt operations.
Identifies a prompt.
Identifies a prompt.
Builder for
PromptReference.Builder for
PromptReference.Codec for
PromptReference.Codec for
PromptReference.Request parameters for a prompt invocation.
Result of a prompt function invocation.
A prompt result that requests additional input from the client.
A prompt result containing one or more prompt messages.
Wraps another prompt result with protocol extension metadata.
Façade interface for MCP prompts
SPI for protocol versions, loadable via
ServiceLoader.Decoding helpers built on
CodecRegistry.Registry of
ProtocolResponseMapper implementations built from Protocols.list().Maps protocol-specific request parameters to protocol-neutral domain requests.
A cancellation notification.
A completion request.
Identifies what a completion request is completing against.
Completion against a prompt's argument.
Completion against a resource template's URI variable.
An initialize request.
A page request.
A prompt call request.
A task status update.
A tool call request.
Maps domain objects to protocol-specific response shapes.
Registry of
Protocol implementations discovered via ServiceLoader.Negotiates the protocol for each MCP POST and binds it to the interaction context.
Sent from the client to the server, to read a specific resource URI.
Sent from the client to the server, to read a specific resource URI.
Builder for
ReadResourceRequest.Builder for
ReadResourceRequest.Codec for
ReadResourceRequest.Codec for
ReadResourceRequest.Parameters for a `resources/read` request.
Parameters for a `resources/read` request.
Builder for
ReadResourceRequestParams.Builder for
ReadResourceRequestParams.Codec for
ReadResourceRequestParams.Codec for
ReadResourceRequestParams.The server's response to a resources/read request from the client.
The result returned by the server for a resources/read request.
Builder for
ReadResourceResult.Builder for
ReadResourceResult.Codec for
ReadResourceResult.Codec for
ReadResourceResult.A successful response from the server for a resources/read request.
Builder for
ReadResourceResultResponse.Codec for
ReadResourceResultResponse.Metadata for associating messages with a task.
Builder for
RelatedTaskMetadata.Codec for
RelatedTaskMetadata.A request.
A request.
Builder for
Request.Builder for
Request.Codec for
Request.Codec for
Request.Marker interface for a context associated with a single JSON-RPC request.
A JSON-RPC 2.0 request/response id: a bare JSON string or number, never an object or array.
An id carrying a numeric value.
An id carrying a string value.
Signals that protocol request parameters could not be mapped to a domain request.
Extends MetaObject with additional request-specific fields.
Builder for
RequestMetaObject.Common params for any request.
Common params for any request.
Builder for
RequestParams.Builder for
RequestParams.Placeholder for 2025-11-25 per-request validation, mirroring
v2026_07_28.transport.RequestValidationHandler in the pipeline (see
McpChannelInitializer). 2025-11-25 has no per-request _meta/header requirements
of its own today — session establishment already covers protocol-version and capability
negotiation — so this is a no-op.Validates every 2026-07-28 POST request against the requirements that only apply once a request
is self-describing (no protocol-level session): required
_meta fields (SEP-2575), the
Mcp-Method/Mcp-Name/Mcp-Param-* headers matching the body (SEP-2243), and
rejection of methods the draft removed.A known resource that the server is capable of reading.
A known resource that the server is capable of reading.
Builder for
Resource.Builder for
Resource.Codec for
Resource.Codec for
Resource.The actual content of a resource, either text or binary.
The contents of a specific resource or sub-resource.
The contents of a specific resource or sub-resource.
Codec for
ResourceContents.Codec for
ResourceContents.Descriptor for a static (non-template) resource.
Builder for
ResourceDescriptor.Synchronously reads static or templated resource contents from a full request.
A reference to another resource, embedded within a content block.
A resource that the server is capable of reading, included in a prompt or tool call result.
A resource that the server is capable of reading, included in a prompt or tool call result.
Builder for
ResourceLink.Builder for
ResourceLink.Codec for
ResourceLink.Codec for
ResourceLink.An optional notification from the server to the client, informing it that the list of resources it can read from has changed.
An optional notification from the server to the client, informing it that the list of resources it can read from has changed.
Builder for
ResourceListChangedNotification.Builder for
ResourceListChangedNotification.Codec for
ResourceListChangedNotification.Codec for
ResourceListChangedNotification.JSON-RPC adapters for resource operations.
Request passed to a resource function when a client invokes
resources/read.Builder for
ResourceRequest.Common parameters when working with resources.
Common params for resource-related requests.
Builder for
ResourceRequestParams.Builder for
ResourceRequestParams.Codec for
ResourceRequestParams.Façade interface for MCP resources
Configuration for the resources capability: the same knobs as
FeatureConfig plus
subscription support.Builder for
ResourcesConfig.A template description for resources available on the server.
A template description for resources available on the server.
Builder for
ResourceTemplate.Builder for
ResourceTemplate.Codec for
ResourceTemplate.Codec for
ResourceTemplate.Descriptor for a resource URI template.
Builder for
ResourceTemplateDescriptor.A reference to a resource or resource template definition.
A reference to a resource or resource template definition.
Builder for
ResourceTemplateReference.Builder for
ResourceTemplateReference.Codec for
ResourceTemplateReference.Codec for
ResourceTemplateReference.A notification from the server to the client, informing it that a resource has changed and may need to be read again.
A notification from the server to the client, informing it that a resource has changed and may need to be read again.
Builder for
ResourceUpdatedNotification.Builder for
ResourceUpdatedNotification.Codec for
ResourceUpdatedNotification.Codec for
ResourceUpdatedNotification.Parameters for a `notifications/resources/updated` notification.
Parameters for a `notifications/resources/updated` notification.
Builder for
ResourceUpdatedNotificationParams.Builder for
ResourceUpdatedNotificationParams.Codec for
ResourceUpdatedNotificationParams.Codec for
ResourceUpdatedNotificationParams.A result.
Common result fields.
Builder for
Result.Builder for
Result.Extends MetaObject with additional result-specific fields.
Builder for
ResultMetaObject.The sender of a message in a prompt or conversation.
The sender or recipient of messages and data in a conversation.
The sender or recipient of messages and data in a conversation.
Represents a root directory or file that the server can operate on.
Represents a root directory or file that the server can operate on.
Builder for
Root.Builder for
Root.Codec for
Root.Codec for
Root.A notification from the client to the server, informing it that the list of roots has changed.
Builder for
RootsListChangedNotification.Codec for
RootsListChangedNotification.Handles a single JSON-RPC method.
Requests user input by invoking another RPC method.
Handler-execution runtime configuration: settings governing how in-flight handlers are drained
on shutdown.
Builder for
RuntimeConfig.Describes a message issued to or received from an LLM API.
Describes a message issued to or received from an LLM API.
Builder for
SamplingMessage.Builder for
SamplingMessage.Codec for
SamplingMessage.Codec for
SamplingMessage.Remains in the specification for at least twelve months; see the deprecated features registry.
Codec for
SamplingMessageContentBlock.Codec for
SamplingMessageContentBlock.Deprecated.
SEP-2577 explicitly deprecates sampling.
A single schema validation error.
Configures and builds a
TachyonServer; call TachyonServer.start() to bind its transport.Capabilities the server advertises to the client during initialization.
Capabilities that a server may support.
Capabilities that a server may support.
Codec for
ServerCapabilities.Prompts.Codec for
ServerCapabilities.Prompts.Codec for
ServerCapabilities.Resources.Codec for
ServerCapabilities.Resources.Codec for
ServerCapabilities.Tasks.Requests.Tools.Codec for
ServerCapabilities.Tasks.Requests.Codec for
ServerCapabilities.Tasks.Codec for
ServerCapabilities.Tools.Codec for
ServerCapabilities.Tools.Builder for
ServerCapabilities.Builder for
ServerCapabilities.Builder for
ServerCapabilities.Prompt capabilities.
Builder for
ServerCapabilities.Prompts.Builder for
ServerCapabilities.Prompts.Resource capabilities.
Builder for
ServerCapabilities.Resources.Builder for
ServerCapabilities.Resources.Server task capabilities
Builder for
ServerCapabilities.Tasks.Builder for
ServerCapabilities.Tasks.Requests.Builder for
ServerCapabilities.Tasks.Requests.Tools.Tool capabilities.
Builder for
ServerCapabilities.Tools.Builder for
ServerCapabilities.Tools.Codec for
ServerCapabilities.Codec for
ServerCapabilities.Aggregated server configuration grouping identity, capabilities, session, network, runtime, and
monitoring settings.
Engine SPI for MCP server internals.
A protocol-neutral server error returned by server code.
Categorizes the nature of a server error.
Factories for protocol-neutral server errors.
Pluggable server extension that can add custom methods, capabilities, and lifecycle hooks.
Common interface for server features (tools, resources, prompts, tasks).
Server identity metadata sent to the client during initialization.
Builder for
ServerIdentity.A streamable-HTTP session shared by protocols on this transport.
Session lifecycle and persistence configuration.
Builder for
SessionConfig.A recorded session event — request, response, notification, or cancellation.
A cancellation request.
A notification sent to or received from the client.
An outbound (server-to-client) request.
An inbound request from the client.
A response sent to the client.
Persists and replays session events (request/responses, notifications).
Derives the session id for a newly initialized session from the incoming
initialize
request.Manages the lifecycle of MCP sessions.
Lifecycle states for a session.
Storage abstraction for MCP sessions.
Outbound handler that refreshes session liveness on every byte written to the channel.
A request from the client to the server, to enable or adjust logging.
Builder for
SetLevelRequest.Codec for
SetLevelRequest.Parameters for a `logging/setLevel` request.
Builder for
SetLevelRequestParams.Codec for
SetLevelRequestParams.A writable SSE connection to a client.
A single Server-Sent Event with an ID, event type, and data payload.
Keeps long-lived SSE streams alive across idle periods.
Manages SSE stream lifecycle for GET requests: opens stateful or stateless
streams via
NettySseConnection, writes opening frames and priming
events, and replays missed events on reconnection.Serializes an outbound
SseEvent into its text/event-stream wire framing, writing
straight into a pooled buffer from alloc.Guards stateless-mode channels: rejects requests carrying session-related
headers (
MCP-Session-Id, Last-Event-ID) and DELETE methods.A string schema.
A string schema.
Builder for
StringSchema.Builder for
StringSchema.Codec for
StringSchema.Codec for
StringSchema.Sent from the client to request resources/updated notifications from the server whenever a particular resource changes.
Builder for
SubscribeRequest.Codec for
SubscribeRequest.Parameters for a `resources/subscribe` request.
Builder for
SubscribeRequestParams.Codec for
SubscribeRequestParams.The set of notification types a client may opt in to on a subscriptions/listen request.
Builder for
SubscriptionFilter.Codec for
SubscriptionFilter.Sent by the server to acknowledge that a subscriptions/listen subscription has been established and to report which notification types it agreed to honor.
Builder for
SubscriptionsAcknowledgedNotification.Codec for
SubscriptionsAcknowledgedNotification.Parameters for a notifications/subscriptions/acknowledged notification.
Builder for
SubscriptionsAcknowledgedNotificationParams.Codec for
SubscriptionsAcknowledgedNotificationParams.Sent from the client to open a long-lived channel for receiving notifications outside the context of a specific request.
Builder for
SubscriptionsListenRequest.Codec for
SubscriptionsListenRequest.Parameters for a subscriptions/listen request.
Builder for
SubscriptionsListenRequestParams.Codec for
SubscriptionsListenRequestParams.The response to a subscriptions/listen request, signalling that the subscription has ended gracefully (for example, during server shutdown).
Builder for
SubscriptionsListenResult.Codec for
SubscriptionsListenResult.Extends ResultMetaObject with the subscription-stream identifier carried by a SubscriptionsListenResult.
Builder for
SubscriptionsListenResultMetaObject.A successful response from the server for a subscriptions/listen request, sent when the server tears the subscription down gracefully.
Builder for
SubscriptionsListenResultResponse.Codec for
SubscriptionsListenResultResponse.The one public type users hold — an MCP server that is
AutoCloseable.Represents an async task that may complete, fail, require input, or report progress.
Data associated with a task.
Builder for
Task.Common params for any task-augmented request.
Builder for
TaskAugmentedRequestParams.Codec for
Task.Strategy for generating task identifiers.
Metadata for augmenting a request with task execution.
Builder for
TaskMetadata.Codec for
TaskMetadata.JSON-RPC adapters for task operations.
Façade interface for MCP tasks
Configuration for the tasks capability.
Builder for
TasksConfig.Task lifecycle states — superset of MCP 2025-11-25 + A2A.
The status of a task.
An optional notification from the receiver to the requestor, informing them that a task's status has changed.
Builder for
TaskStatusNotification.Codec for
TaskStatusNotification.Parameters for a `notifications/tasks/status` notification.
Builder for
TaskStatusNotificationParams.Codec for
TaskStatusNotificationParams.A plain-text content block provided to or from an LLM.
Text provided to or from an LLM.
Text provided to or from an LLM.
Builder for
TextContent.Builder for
TextContent.Codec for
TextContent.Codec for
TextContent.Text-based resource contents returned by a resource handler.
A text resource contents.
A text resource contents.
Builder for
TextResourceContents.Builder for
TextResourceContents.Codec for
TextResourceContents.Codec for
TextResourceContents.Schema for multiple-selection enumeration with display titles for each option.
Schema for multiple-selection enumeration with display titles for each option.
Codec for
TitledMultiSelectEnumSchema.Items.Codec for
TitledMultiSelectEnumSchema.Items.Builder for
TitledMultiSelectEnumSchema.Builder for
TitledMultiSelectEnumSchema.Builder for
TitledMultiSelectEnumSchema.Items.Builder for
TitledMultiSelectEnumSchema.Items.Codec for
TitledMultiSelectEnumSchema.Codec for
TitledMultiSelectEnumSchema.Schema for single-selection enumeration with display titles for each option.
Schema for single-selection enumeration with display titles for each option.
Builder for
TitledSingleSelectEnumSchema.Builder for
TitledSingleSelectEnumSchema.Codec for
TitledSingleSelectEnumSchema.Codec for
TitledSingleSelectEnumSchema.Definition for a tool the client can call.
Definition for a tool the client can call.
Builder for
Tool.Builder for
Tool.Hints about tool behaviour that clients may use for safety or UX decisions.
Additional properties describing a Tool to clients.
Additional properties describing a Tool to clients.
Builder for
ToolAnnotations.Builder for
ToolAnnotations.Codec for
ToolAnnotations.Codec for
ToolAnnotations.Controls tool selection behavior for sampling requests.
Controls tool selection behavior for sampling requests.
Builder for
ToolChoice.Builder for
ToolChoice.Codec for
ToolChoice.Codec for
ToolChoice.Codec for
Tool.Codec for
Tool.Descriptor for a server-provided tool.
Builder for
ToolDescriptor.Execution-related properties for a tool.
Builder for
ToolExecution.Codec for
ToolExecution.Synchronous tool function.
Experimental class-based tool handler escape hatch.
An optional notification from the server to the client, informing it that the list of tools it offers has changed.
An optional notification from the server to the client, informing it that the list of tools it offers has changed.
Builder for
ToolListChangedNotification.Builder for
ToolListChangedNotification.Codec for
ToolListChangedNotification.Codec for
ToolListChangedNotification.JSON-RPC adapters for tool operations.
An incoming tool call request with the tool name, arguments, and metadata.
Outcome of a tool invocation: success, error, input-required, or deferred.
Sentinel returned by a task-augmented handler that defers completion to the caller.
A failed invocation carrying a human-readable error message.
Signals that completing the tool call requires additional input from the caller.
A successful invocation, carrying an optional structured value and its content blocks.
Wraps another result with request-level
_meta entries.The result of a tool use, provided by the user back to the assistant.
The result of a tool use, provided by the user back to the assistant.
Builder for
ToolResultContent.Builder for
ToolResultContent.Codec for
ToolResultContent.Codec for
ToolResultContent.Registry for server tools.
A request from the assistant to call a tool.
A request from the assistant to call a tool.
Builder for
ToolUseContent.Builder for
ToolUseContent.Codec for
ToolUseContent.Codec for
ToolUseContent.A unknown request.
A unknown request.
Builder for
UnknownRequest.Builder for
UnknownRequest.Codec for
UnknownRequest.Codec for
UnknownRequest.Sent from the client to request cancellation of resources/updated notifications from the server.
Builder for
UnsubscribeRequest.Codec for
UnsubscribeRequest.Parameters for a `resources/unsubscribe` request.
Builder for
UnsubscribeRequestParams.Codec for
UnsubscribeRequestParams.Returned when the request's protocol version is unknown to the server or unsupported (e.g., a known experimental or draft version the server has chosen not to implement).
Builder for
UnsupportedProtocolVersionError.Codec for
UnsupportedProtocolVersionError.Rejects requests
ProtocolVersionHandler flagged as naming an unsupported protocol
version, once http-aggregator has assembled the body, so the JSON-RPC id the
UnsupportedProtocolVersionError echoes back can be read from it (SEP-2575: error responses MUST
carry the request's id).Schema for multiple-selection enumeration without display titles for options.
Schema for multiple-selection enumeration without display titles for options.
Codec for
UntitledMultiSelectEnumSchema.Items.Codec for
UntitledMultiSelectEnumSchema.Items.Builder for
UntitledMultiSelectEnumSchema.Builder for
UntitledMultiSelectEnumSchema.Builder for
UntitledMultiSelectEnumSchema.Items.Builder for
UntitledMultiSelectEnumSchema.Items.Codec for
UntitledMultiSelectEnumSchema.Codec for
UntitledMultiSelectEnumSchema.Schema for single-selection enumeration without display titles for options.
Schema for single-selection enumeration without display titles for options.
Builder for
UntitledSingleSelectEnumSchema.Builder for
UntitledSingleSelectEnumSchema.Codec for
UntitledSingleSelectEnumSchema.Codec for
UntitledSingleSelectEnumSchema.Reverse parser for RFC 6570 URI templates with scalar and unambiguous exploded list values.
Value recovered from an RFC 6570 URI template.
A scalar template variable.
An exploded list template variable.
An error response that indicates that the server requires the client to provide additional information via an elicitation request.
Builder for
URLElicitationRequiredError.Codec for
URLElicitationRequiredError.Requests user input by opening a URL (e.g. for OAuth or form fill).
Adapts
InteractionContext.sendRequest(String, Object) into the typed ElicitationService/SamplingService surface, building wire-shaped params and parsing raw
JSON responses back into domain types.YouComSearchConfigBuilder collects parameters and invokes the static factory method:
new dev.tachyonmcp.extensions.tools.youcom.search.YouComSearchConfig(..).