Struct ToolBuilder

pub struct ToolBuilder { /* private fields */ }

Builder for creating tools with fluent API, advanced validation, and enhanced metadata

Implementations

impl ToolBuilder

pub fn new<S: Into<String>>(name: S) -> Self

Create a new tool builder with the given name

pub fn description<S: Into<String>>(self, description: S) -> Self

Set the tool description

pub fn title<S: Into<String>>(self, title: S) -> Self

Set the tool title (for UI display)

pub fn schema(self, schema: Value) -> Self

Set the input schema

pub fn validation_config(self, config: ValidationConfig) -> Self

Set custom validation configuration

pub fn strict_validation(self) -> Self

Enable strict validation (no additional properties, strict types)

pub fn permissive_validation(self) -> Self

Enable permissive validation (allow additional properties, type coercion)

pub fn behavior_hints(self, hints: ToolBehaviorHints) -> Self

Set behavior hints for the tool

pub fn read_only(self) -> Self

Mark tool as read-only

pub fn destructive(self) -> Self

Mark tool as destructive

pub fn idempotent(self) -> Self

Mark tool as idempotent

pub fn requires_auth(self) -> Self

Mark tool as requiring authentication

pub fn long_running(self) -> Self

Mark tool as potentially long-running

pub fn resource_intensive(self) -> Self

Mark tool as resource-intensive

pub fn cacheable(self) -> Self

Mark tool results as cacheable

pub fn category(self, category: ToolCategory) -> Self

Set tool category

pub fn category_simple(self, primary: String, secondary: Option<String>) -> Self

Set tool category with primary and secondary classification

pub fn tag(self, tag: String) -> Self

Add category tag

pub fn version<S: Into<String>>(self, version: S) -> Self

Set tool version

pub fn author<S: Into<String>>(self, author: S) -> Self

Set tool author

pub fn deprecated(self, deprecation: ToolDeprecation) -> Self

Mark tool as deprecated

pub fn deprecated_simple<S: Into<String>>(self, reason: S) -> Self

Mark tool as deprecated with simple reason

pub fn custom_metadata<S: Into<String>>(self, key: S, value: Value) -> Self

Add custom metadata field

pub fn build<H>(self, handler: H) -> McpResult<Tool>

where H: ToolHandler + 'static,

Build the tool with the given handler

pub fn build_with_validation_chain<H>( self, handler: H, validation_fn: impl Fn(&mut HashMap<String, Value>) -> McpResult<()> + Send + Sync + 'static, ) -> McpResult<ValidationChainTool>

where H: ToolHandler + 'static,

Build the tool with validation chain - allows chaining parameter validation