Struct ClientCapabilitiesBuilder 

pub struct ClientCapabilitiesBuilder<S = ClientCapabilitiesBuilderState> { /* private fields */ }

Const-generic ClientCapabilities builder with compile-time validation

This builder ensures that capability-specific methods are only available when the corresponding capability is enabled, providing compile-time safety with comprehensive compile-time validation.

Implementations

impl ClientCapabilitiesBuilder

pub fn new() -> Self

Create a new ClientCapabilities builder

impl<S> ClientCapabilitiesBuilder<S>

pub fn build(self) -> ClientCapabilities

Build the final ClientCapabilities

Consumes the builder and returns the configured ClientCapabilities. All compile-time validations have been enforced during building.

pub fn with_strict_validation(self) -> Self

TurboMCP Extension: Enable strict validation mode

When enabled, the builder will perform additional runtime validations on top of the compile-time guarantees.

pub fn with_negotiator(self, negotiator: CapabilityNegotiator) -> Self

TurboMCP Extension: Set capability negotiator

Integrates with TurboMCP’s sophisticated capability negotiation system for advanced client-server capability matching.

pub fn validate(&self) -> Result<(), String>

TurboMCP Extension: Validate capability configuration

Performs additional runtime validation to ensure the capability configuration makes sense in the current context.

pub fn summary(&self) -> String

Get a summary of enabled capabilities

Returns a human-readable summary of which capabilities are enabled.

impl<const R: bool, const S: bool, const E: bool> ClientCapabilitiesBuilder<ClientCapabilitiesBuilderState<false, R, S, E>>

pub fn enable_experimental( self, ) -> ClientCapabilitiesBuilder<ClientCapabilitiesBuilderState<true, R, S, E>>

Enable experimental capabilities

Transitions the builder to a state where experimental capability methods become available at compile time.

pub fn enable_experimental_with( self, experimental: HashMap<String, Value>, ) -> ClientCapabilitiesBuilder<ClientCapabilitiesBuilderState<true, R, S, E>>

Enable experimental capabilities with specific values

impl<const X: bool, const S: bool, const E: bool> ClientCapabilitiesBuilder<ClientCapabilitiesBuilderState<X, false, S, E>>

pub fn enable_roots( self, ) -> ClientCapabilitiesBuilder<ClientCapabilitiesBuilderState<X, true, S, E>>

Enable roots capabilities

impl<const X: bool, const R: bool, const E: bool> ClientCapabilitiesBuilder<ClientCapabilitiesBuilderState<X, R, false, E>>

pub fn enable_sampling( self, ) -> ClientCapabilitiesBuilder<ClientCapabilitiesBuilderState<X, R, true, E>>

Enable sampling capabilities

impl<const X: bool, const R: bool, const S: bool> ClientCapabilitiesBuilder<ClientCapabilitiesBuilderState<X, R, S, false>>

pub fn enable_elicitation( self, ) -> ClientCapabilitiesBuilder<ClientCapabilitiesBuilderState<X, R, S, true>>

Enable elicitation capabilities

impl<const X: bool, const S: bool, const E: bool> ClientCapabilitiesBuilder<ClientCapabilitiesBuilderState<X, true, S, E>>

pub fn enable_roots_list_changed(self) -> Self

Enable roots list changed notifications

This method is only available when roots capabilities are enabled, providing compile-time safety.

impl<const R: bool, const S: bool, const E: bool> ClientCapabilitiesBuilder<ClientCapabilitiesBuilderState<true, R, S, E>>

pub fn add_experimental_capability<K, V>(self, key: K, value: V) -> Self

where K: Into<String>, V: Into<Value>,

Add experimental capability

This method is only available when experimental capabilities are enabled.

pub fn with_llm_provider(self, provider: &str, version: &str) -> Self

TurboMCP Extension: Add LLM provider metadata

Unique to TurboMCP - metadata about supported LLM providers for sampling.

pub fn with_ui_capabilities(self, capabilities: Vec<&str>) -> Self

TurboMCP Extension: Add UI capabilities metadata

Unique to TurboMCP - metadata about UI capabilities for elicitation.

impl ClientCapabilitiesBuilder

Convenience methods for common client capability combinations

pub fn full_featured() -> ClientCapabilitiesBuilder<ClientCapabilitiesBuilderState<true, true, true, true>>

TurboMCP Extension: Create a full-featured client configuration

Enables all standard capabilities with TurboMCP optimizations.

pub fn minimal() -> ClientCapabilitiesBuilder<ClientCapabilitiesBuilderState<false, false, true, false>>

Create a minimal client configuration

Only enables sampling capability for basic MCP compliance.

pub fn sampling_focused() -> ClientCapabilitiesBuilder<ClientCapabilitiesBuilderState<true, false, true, false>>

Create a sampling-focused client configuration

Optimized for clients that primarily handle sampling requests.

Trait Implementations

impl<S: Clone> Clone for ClientCapabilitiesBuilder<S>

fn clone(&self) -> ClientCapabilitiesBuilder<S>

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl<S: Debug> Debug for ClientCapabilitiesBuilder<S>

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for ClientCapabilitiesBuilder

fn default() -> Self

Returns the “default value” for a type.