Struct HttpClientConfig 

pub struct HttpClientConfig {
    pub headers: HashMap<String, String>,
    pub auto_sse: bool,
    pub channel_capacity: usize,
    pub request_timeout: Duration,
    pub notification_timeout: Duration,
    pub sse_reconnect: bool,
    pub sse_reconnect_delay: Duration,
    pub max_sse_reconnect_attempts: u32,
    pub session_recovery: bool,
    pub max_sse_event_size: usize,
}

Configuration for HttpClientTransport.

Example

use tower_mcp::client::{HttpClientTransport, HttpClientConfig};
use std::time::Duration;

let config = HttpClientConfig {
    request_timeout: Duration::from_secs(60),
    ..Default::default()
};
let transport = HttpClientTransport::with_config("http://localhost:3000", config);

Fields

headers: HashMap<String, String>

Custom headers to include on every request (e.g., auth tokens).

auto_sse: bool

Whether to automatically open the standalone SSE notification stream after initialization. Associated POST response streams used for sampling, elicitation, and roots requests work independently. Default: true.

channel_capacity: usize

Capacity of the internal message channel. Default: 256.

request_timeout: Duration

Timeout for HTTP requests. Default: 30 seconds.

notification_timeout: Duration

Timeout for notification POSTs (frames without an id), capped at request_timeout.

Notifications are awaited inline so notifications/initialized is ordered ahead of the first request, which blocks the client’s message loop for the duration. This bounds that block independently of request_timeout so a server that stalls a notification’s 202 cannot freeze the client for the full request timeout. Default: 5 seconds.

sse_reconnect: bool

Whether to attempt SSE reconnection on disconnect. Default: true.

sse_reconnect_delay: Duration

Delay before SSE reconnection attempts. Default: 1 second.

max_sse_reconnect_attempts: u32

Maximum SSE reconnection attempts before giving up. Default: 5.

session_recovery: bool

Whether to support automatic session recovery on expiry. When enabled, HTTP 404 responses (with a session ID attached) and JSON-RPC -32005 errors trigger re-initialization. Default: true.

max_sse_event_size: usize

Maximum size in bytes buffered for a single SSE event.

A server that streams an event without ever terminating it would otherwise grow the parse buffer without bound. When a single event’s buffered size exceeds this cap, the stream is terminated with Error::SseEventTooLarge. Default: 16 MiB (matching rmcp).

Implementations

impl HttpClientConfig

pub fn bearer_token(self, token: impl Into<String>) -> Self

Set a Bearer token for authentication.

pub fn api_key_header( self, name: impl Into<String>, key: impl Into<String>, ) -> Self

Set an API key using a custom header name.

pub fn basic_auth( self, username: impl AsRef<str>, password: impl AsRef<str>, ) -> Self

Set Basic authentication credentials.

pub fn header(self, name: impl Into<String>, value: impl Into<String>) -> Self

Add a custom header.

Trait Implementations

impl Clone for HttpClientConfig

fn clone(&self) -> HttpClientConfig

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for HttpClientConfig

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

Formats the value using the given formatter.

impl Default for HttpClientConfig

fn default() -> Self

Returns the “default value” for a type.