Struct McpClient 

pub struct McpClient<T: McpTransport> { /* private fields */ }

MCP client for communicating with MCP servers.

The client handles the MCP protocol, including initialization, tool discovery, and tool execution.

Example

use agent_sdk::mcp::{McpClient, StdioTransport};

// Spawn server and create client
let transport = StdioTransport::spawn("npx", &["-y", "mcp-server"]).await?;
let client = McpClient::new(transport, "my-server".to_string()).await?;

// List available tools
let tools = client.list_tools().await?;

// Call a tool
let result = client.call_tool("tool_name", json!({"arg": "value"})).await?;

Implementations

impl<T: McpTransport> McpClient<T>

pub async fn new(transport: Arc<T>, server_name: String) -> Result<Self>

Create a new MCP client and initialize the connection.

Arguments

• transport - The transport to use for communication
• server_name - A name to identify this server connection

Errors

Returns an error if initialization fails.

pub const fn new_uninitialized(transport: Arc<T>, server_name: String) -> Self

Create a client without initialization.

Use this if you need to control when initialization happens.

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

Initialize the MCP connection.

This must be called before using other methods.

Errors

Returns an error if the server rejects initialization.

pub fn server_name(&self) -> &str

Get the server name.

pub const fn server_info(&self) -> Option<&InitializeResult>

Get server info if initialized.

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

List available tools from the server.

Errors

Returns an error if the request fails.

pub async fn call_tool( &self, name: &str, arguments: Value, ) -> Result<McpToolCallResult>

Call a tool on the server.

Arguments

• name - Tool name to call
• arguments - Tool arguments as JSON

Errors

Returns an error if the tool call fails.

pub async fn call_tool_raw( &self, name: &str, arguments: Option<Value>, ) -> Result<McpToolCallResult>

Call a tool with raw Value arguments.

Arguments

• name - Tool name to call
• arguments - Tool arguments as optional JSON

Errors

Returns an error if the tool call fails.

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

Close the client connection.

Errors

Returns an error if the transport fails to close.