Struct McpSseServerConfig 

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

Configuration for an MCP server reachable over the legacy HTTP+SSE transport.

This is the SSE counterpart to McpServerConfig, which remains the stdio configuration type.

Example

use mentra::mcp::McpSseServerConfig;

let config = McpSseServerConfig::new("observability", "https://mcp.example.com/sse")
    .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 SSE stream URL, opened with a long-lived GET.

headers: BTreeMap<String, SecretString>

Headers sent on both the SSE GET and every JSON-RPC POST.

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: McpSseLimits

Timeouts and size limits, defaulted rather than deserialized.

Implementations

impl McpSseServerConfig

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

Creates a configuration with default timeouts and limits.

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

Adds a header sent on both the SSE GET and every JSON-RPC POST.

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

Adds a bearer Authorization header.

pub fn with_limits(self, limits: McpSseLimits) -> McpSseServerConfig

Replaces the timeouts and size limits.

pub fn allowing_plaintext_credentials(self) -> McpSseServerConfig

Permits sending configured headers over plaintext http://.

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

Validates the configuration and returns the parsed stream URL.

Runs before any connection is opened so a bad configuration fails at the boundary rather than mid-handshake. 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-build.

Trait Implementations

impl Clone for McpSseServerConfig

fn clone(&self) -> McpSseServerConfig

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for McpSseServerConfig

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for McpSseServerConfig

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.