Struct Tool

pub struct Tool {
    pub info: ToolInfo,
    pub handler: Box<dyn ToolHandler>,
    pub enabled: bool,
    pub validator: Option<ParameterValidator>,
    pub enhanced_metadata: EnhancedToolMetadata,
}

A registered tool with its handler, validation, and enhanced metadata

Fields

info: ToolInfo

Information about the tool

handler: Box<dyn ToolHandler>

Handler that implements the tool’s functionality

enabled: bool

Whether the tool is currently enabled

validator: Option<ParameterValidator>

Parameter validator for input validation

enhanced_metadata: EnhancedToolMetadata

Enhanced metadata for tool behavior, categorization, and performance

Implementations

impl Tool

pub fn new<H>( name: String, description: Option<String>, input_schema: Value, handler: H, ) -> Self

where H: ToolHandler + 'static,

Create a new tool with the given information and handler

Arguments

• name - Name of the tool
• description - Optional description of the tool
• input_schema - JSON schema describing the input parameters
• handler - Implementation of the tool’s functionality

pub fn with_validation<H>( name: String, description: Option<String>, input_schema: Value, handler: H, validation_config: ValidationConfig, ) -> Self

where H: ToolHandler + 'static,

Create a new tool with custom validation configuration

pub fn enable(&mut self)

Enable the tool

pub fn disable(&mut self)

Disable the tool

pub fn is_enabled(&self) -> bool

Check if the tool is enabled

pub async fn call( &self, arguments: HashMap<String, Value>, ) -> McpResult<ToolResult>

Execute the tool if it’s enabled with parameter validation and performance tracking

Arguments

• arguments - Tool arguments as key-value pairs

Returns

Result containing the tool execution result or an error

pub async fn call_unchecked( &self, arguments: HashMap<String, Value>, ) -> McpResult<ToolResult>

Execute the tool without validation or performance tracking (for advanced use cases)

pub fn validate_parameters( &self, arguments: &mut HashMap<String, Value>, ) -> McpResult<()>

Validate parameters without executing the tool

pub fn set_behavior_hints(&mut self, hints: ToolBehaviorHints)

Set behavior hints for the tool

pub fn behavior_hints(&self) -> &ToolBehaviorHints

Get behavior hints for the tool

pub fn set_category(&mut self, category: ToolCategory)

Set category for the tool

pub fn category(&self) -> Option<&ToolCategory>

Get category for the tool

pub fn set_version(&mut self, version: String)

Set version for the tool

pub fn version(&self) -> Option<&String>

Get version of the tool

pub fn set_author(&mut self, author: String)

Set author for the tool

pub fn author(&self) -> Option<&String>

Get author of the tool

pub fn deprecate(&mut self, deprecation: ToolDeprecation)

Mark tool as deprecated

pub fn is_deprecated(&self) -> bool

Check if tool is deprecated

pub fn deprecation_warning(&self) -> Option<String>

Get deprecation warning if tool is deprecated

pub fn performance_metrics(&self) -> ToolPerformanceMetrics

Get performance metrics for the tool

pub fn add_custom_metadata(&mut self, key: String, value: Value)

Add custom metadata field

pub fn get_custom_metadata(&self, key: &str) -> Option<&Value>

Get custom metadata field

pub fn matches_category_filter(&self, filter: &CategoryFilter) -> bool

Check if tool matches a category filter

pub fn is_cacheable(&self) -> bool

Check if tool is suitable for caching based on behavior hints

pub fn is_destructive(&self) -> bool

Check if tool is destructive

pub fn is_read_only(&self) -> bool

Check if tool is read-only

pub fn is_idempotent(&self) -> bool

Check if tool is idempotent

pub fn requires_auth(&self) -> bool

Check if tool requires authentication

Trait Implementations

impl Debug for Tool

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

Formats the value using the given formatter.