Struct ValidatingToolHandler 

pub struct ValidatingToolHandler<H> { /* private fields */ }

A ToolHandler decorator that validates tool inputs and/or outputs against their declared JSON Schemas.

Wrap a tool handler with ServerBuilder::validate_tool_io (or construct directly with ValidatingToolHandler::new for adapter users who don’t build through Server). Schemas are resolved from the inner handler’s list_tools at call time; there is no cache, so a dynamic tool list is always seen correctly.

Implementations

impl<H> ValidatingToolHandler<H>

pub const fn new(inner: H, mode: ValidationMode) -> Self

Wrap inner, enforcing the directions selected by mode.

pub fn into_inner(self) -> H

Unwrap, returning the inner handler.

Trait Implementations

impl<H: PromptHandler> PromptHandler for ValidatingToolHandler<H>

fn list_prompts( &self, ctx: &Context<'_>, ) -> impl Future<Output = Result<Vec<Prompt>, McpError>> + Send

List all available prompts.

fn get_prompt( &self, name: &str, args: Option<Map<String, Value>>, ctx: &Context<'_>, ) -> impl Future<Output = Result<GetPromptResult, McpError>> + Send

Get a prompt with the given arguments.

impl<H: ResourceHandler> ResourceHandler for ValidatingToolHandler<H>

fn list_resources( &self, ctx: &Context<'_>, ) -> impl Future<Output = Result<Vec<Resource>, McpError>> + Send

List all available static resources.

fn list_resource_templates( &self, ctx: &Context<'_>, ) -> impl Future<Output = Result<Vec<ResourceTemplate>, McpError>> + Send

List all available resource templates.

fn read_resource( &self, uri: &str, ctx: &Context<'_>, ) -> impl Future<Output = Result<Vec<ResourceContents>, McpError>> + Send

Read a resource by URI.

fn subscribe( &self, uri: &str, ctx: &Context<'_>, ) -> impl Future<Output = Result<bool, McpError>> + Send

Subscribe to resource updates.

fn unsubscribe( &self, uri: &str, ctx: &Context<'_>, ) -> impl Future<Output = Result<bool, McpError>> + Send

Unsubscribe from resource updates.

impl<H: ServerHandler> ServerHandler for ValidatingToolHandler<H>

fn server_info(&self) -> ServerInfo

Return information about this server.

fn capabilities(&self) -> ServerCapabilities

Return the capabilities of this server.

fn instructions(&self) -> Option<String>

Return optional instructions for using this server.

fn on_initialized(&self, ctx: &Context<'_>) -> impl Future<Output = ()> + Send

Called after initialization is complete.

fn on_roots_list_changed( &self, ctx: &Context<'_>, ) -> impl Future<Output = ()> + Send

Called when the client sends notifications/roots/list_changed.

fn on_shutdown(&self) -> impl Future<Output = ()> + Send

Called when the connection is about to be closed.

fn set_log_level( &self, level: LogLevel, ctx: &Context<'_>, ) -> impl Future<Output = Result<(), McpError>> + Send

Handle a logging/setLevel request: the client’s requested minimum log severity. Only reached when the server advertises the logging capability. The default is a no-op.

impl<H: ToolHandler> ToolHandler for ValidatingToolHandler<H>

async fn list_tools(&self, ctx: &Context<'_>) -> Result<Vec<Tool>, McpError>

List all available tools.

async fn call_tool( &self, name: &str, args: Object, ctx: &Context<'_>, ) -> Result<ToolOutput, McpError>

Call a tool with the given arguments.

async fn on_tools_changed(&self)

Called when a tool’s definition has changed.