Struct McpClient 

pub struct McpClient { /* private fields */ }

Implementations

impl McpClient

pub fn new(config: McpClientConfig) -> Self

Create a new MCP client from the configuration.

pub fn set_elicitation_handler( &mut self, handler: Arc<dyn McpElicitationHandler>, )

Register a handler used to satisfy elicitation requests from providers.

pub async fn initialize(&mut self) -> Result<()>

Establish connections to all configured providers and complete the MCP handshake.

pub async fn execute_tool_with_validation( &self, tool_name: &str, args: Value, ) -> Result<Value>

Execute a tool call after validating arguments.

Public-facing version that takes ownership of args for compatibility with existing callers. Delegates to the reference-taking implementation to avoid unnecessary cloning when the caller already has a reference.

pub fn update_allowlist(&self, allowlist: McpAllowListConfig)

Refresh the internal allow list at runtime.

pub fn current_allowlist(&self) -> McpAllowListConfig

Current allow list snapshot.

pub fn provider_for_tool(&self, tool_name: &str) -> Option<String>

Return the provider name serving the given tool if previously cached.

pub fn provider_for_resource(&self, uri: &str) -> Option<String>

Return the provider responsible for the given resource URI if known.

pub fn provider_for_prompt(&self, prompt_name: &str) -> Option<String>

Return the provider that exposes the given prompt if known.

pub async fn execute_tool(&self, tool_name: &str, args: Value) -> Result<Value>

Execute a tool call on the appropriate provider.

pub async fn list_tools(&self) -> Result<Vec<McpToolInfo>>

List all tools from all active providers.

pub async fn list_resources(&self) -> Result<Vec<McpResourceInfo>>

List all resources exposed by connected MCP providers.

pub async fn refresh_resources(&self) -> Result<Vec<McpResourceInfo>>

Force refresh and list resources from providers.

pub async fn list_prompts(&self) -> Result<Vec<McpPromptInfo>>

List all prompts advertised by connected MCP providers.

pub async fn refresh_prompts(&self) -> Result<Vec<McpPromptInfo>>

Force refresh and list prompts from providers.

pub async fn read_resource(&self, uri: &str) -> Result<McpResourceData>

Read a single resource from its originating provider.

pub async fn get_prompt( &self, prompt_name: &str, arguments: Option<HashMap<String, String>>, ) -> Result<McpPromptDetail>

Retrieve a rendered prompt from its originating provider.

pub async fn shutdown(&self) -> Result<()>

Shutdown all active provider connections.

pub fn get_status(&self) -> McpClientStatus

Current status snapshot for UI/debugging purposes.

pub fn list_servers(&self) -> Vec<Value>

Return configured MCP servers and their current connection state.

pub fn allow_model_lifecycle_control(&self) -> bool

Return whether model-callable lifecycle tools are enabled by config.

pub async fn connect_server(&self, server_name: &str) -> Result<()>

Connect one configured MCP server by name.

pub async fn disconnect_server(&self, server_name: &str) -> Result<()>

Disconnect one active MCP server by name.

pub async fn sync_tools_to_files( &self, workspace_root: &Path, ) -> Result<(PathBuf, usize)>

Sync MCP tool descriptions to files for dynamic context discovery

This implements Cursor-style dynamic context discovery:

• Tool descriptions are written to .vtcode/mcp/tools/{provider}/{tool}.md
• Status is written to .vtcode/mcp/status.json
• Agents can discover tools via grep/read_file without loading all schemas

Returns the paths to written files (index path, tool count)

Trait Implementations

impl McpToolExecutor for McpClient

fn execute_mcp_tool<'life0, 'life1, 'life2, 'async_trait>( &'life0 self, tool_name: &'life1 str, args: &'life2 Value, ) -> Pin<Box<dyn Future<Output = Result<Value>> + Send + 'async_trait>>

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

fn list_mcp_tools<'life0, 'async_trait>( &'life0 self, ) -> Pin<Box<dyn Future<Output = Result<Vec<McpToolInfo>>> + Send + 'async_trait>>

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

fn has_mcp_tool<'life0, 'life1, 'async_trait>( &'life0 self, tool_name: &'life1 str, ) -> Pin<Box<dyn Future<Output = Result<bool>> + Send + 'async_trait>>

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

fn get_status(&self) -> McpClientStatus