Struct McpToolBridge 

pub struct McpToolBridge { /* private fields */ }

Wraps an MCP server tool as a native Tool.

Each bridge holds a reference to the McpManager so that invoke can dispatch the call to the correct server.

Implementations

impl McpToolBridge

pub fn new( server_id: String, mcp_tool: McpTool, manager: Arc<McpManager>, ) -> Self

Create a new bridge wrapping an MCP tool on a named server.

pub fn normalized_name(server_id: &str, tool_name: &str) -> String

Normalized tool name: "mcp__<server>__<tool>".

This namespace avoids collisions when multiple MCP servers export tools with the same short name.

Trait Implementations

impl Tool for McpToolBridge

fn definition(&self) -> ToolDefinition

Describe the tool’s name, prose description, and JSON-schema input.

fn is_concurrency_safe(&self, _arguments: &Value) -> bool

Whether the tool is safe to run concurrently with other invocations.

fn check_permission<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _arguments: &'life1 Value, _context: &'life2 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<PermissionDecision, AgentError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Decide whether the call is allowed, denied, or needs human approval.

fn invoke<'life0, 'async_trait>( &'life0 self, arguments: Value, _context: ToolContext, ) -> Pin<Box<dyn Future<Output = Result<ToolOutput, AgentError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait,

Execute the tool. Errors are surfaced as is_error: true tool results rather than aborting the turn, so the model can try to recover.

fn prompt_text(&self) -> Option<&'static str>

Optional detailed usage instructions injected into the system prompt. Return None if the tool has no extra behavioral guidance.

fn validate<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, _arguments: &'life1 Value, _context: &'life2 ToolContext, ) -> Pin<Box<dyn Future<Output = Result<(), AgentError>> + Send + 'async_trait>>

where Self: 'async_trait, 'life0: 'async_trait, 'life1: 'async_trait, 'life2: 'async_trait,

Validate raw arguments before the permission check runs.

fn interrupt_behavior(&self) -> InterruptBehavior

How the tool wants to be interrupted.

fn invocation_detail(&self, arguments: &Value) -> String

Return a human-readable summary of the invocation from its arguments.