Struct McpStreamableHttpServerConfig 

pub struct McpStreamableHttpServerConfig {
    pub name: String,
    pub url: String,
    pub headers: BTreeMap<String, SecretString>,
    pub allow_plaintext_credentials: bool,
    pub limits: McpStreamableHttpLimits,
}

Configuration for an MCP server reachable over the Streamable HTTP transport.

This is the transport from protocol revision 2025-03-26 and later, where one URL serves every message. It is the counterpart to McpServerConfig for stdio and McpSseServerConfig for the legacy HTTP+SSE transport.

Example

use mentra::mcp::McpStreamableHttpServerConfig;

let config = McpStreamableHttpServerConfig::new("observability", "https://mcp.example.com/mcp")
    .with_header("authorization", "Bearer <token>");

Security

Header values are stored as SecretString and never appear in Debug output, error messages, or logs. Configuring a header on a plaintext http:// URL is rejected unless the host is loopback, because the credential would otherwise cross the network in the clear; see allow_plaintext_credentials to override that deliberately.

Fields

name: String

Display name for the server, used to namespace its bridged tools.

url: String

The operator-configured MCP endpoint, which serves every request.

headers: BTreeMap<String, SecretString>

Headers sent on every request to the endpoint.

allow_plaintext_credentials: bool

Permits sending configured headers over plaintext http:// to a non-loopback host.

This exists so the refusal is overridable but never accidental.

limits: McpStreamableHttpLimits

Timeouts and size limits, defaulted rather than deserialized.

Implementations

impl McpStreamableHttpServerConfig

pub fn new( name: impl Into<String>, url: impl Into<String>, ) -> McpStreamableHttpServerConfig

Creates a configuration with default timeouts and limits.

pub fn with_header( self, name: impl Into<String>, value: impl Into<SecretString>, ) -> McpStreamableHttpServerConfig

Adds a header sent on every request to the endpoint.

pub fn with_bearer_token( self, token: impl Into<String>, ) -> McpStreamableHttpServerConfig

Adds a bearer Authorization header.

pub fn with_limits( self, limits: McpStreamableHttpLimits, ) -> McpStreamableHttpServerConfig

Replaces the timeouts and size limits.

pub fn allowing_plaintext_credentials(self) -> McpStreamableHttpServerConfig

Permits sending configured headers over plaintext http://.

pub fn validate(&self) -> Result<Url, McpStreamableHttpConfigError>

Validates the configuration and returns the parsed endpoint URL.

Checks the URL, header names, and credential handling without connecting, so a host can reject a bad configuration at its own boundary rather than discovering it mid-handshake.

Trait Implementations

impl Clone for McpStreamableHttpServerConfig

fn clone(&self) -> McpStreamableHttpServerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for McpStreamableHttpServerConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for McpStreamableHttpServerConfig

fn deserialize<__D>( __deserializer: __D, ) -> Result<McpStreamableHttpServerConfig, <__D as Deserializer<'de>>::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.