Struct McpClientSession 

pub struct McpClientSession { /* private fields */ }

A guard-based session for a single MCP server connection.

The session connects on creation and disconnects when dropped. Tool descriptors are cached after the first successful list_tools call to avoid redundant round-trips.

Implementations

impl McpClientSession

pub async fn connect( name: impl Into<String>, transport: Arc<dyn McpTransport>, ) -> Result<Self, AgentError>

Connects to the server and returns a new session.

Errors

Returns AgentError if the transport fails to connect.

pub fn name(&self) -> &str

Returns the server name.

pub async fn status(&self) -> McpServerStatus

Returns the current connection status from the transport.

pub async fn is_connected(&self) -> bool

Returns true if the session is currently connected.

pub fn cached_tools(&self) -> &[McpToolDescriptor]

Returns a reference to the cached tool descriptors.

The cache is empty until populate_tool_cache has been called.

pub async fn populate_tool_cache(&mut self) -> Result<(), AgentError>

Fetches the tool list from the server and caches the results.

Overwrites any previously cached descriptors.

Errors

Returns AgentError if the transport call fails.

pub fn transport(&self) -> &Arc<dyn McpTransport>

Returns a reference to the underlying transport.

Trait Implementations

impl Debug for McpClientSession

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

Formats the value using the given formatter.

impl Drop for McpClientSession

fn drop(&mut self)

Executes the destructor for this type.