Struct Upstream 

pub struct Upstream { /* private fields */ }

An upstream MCP server (Streamable HTTP).

Implementations

impl Upstream

pub fn new(prefix: impl Into<String>, url: impl Into<String>) -> Self

The server at url (its MCP endpoint, e.g. https://mcp.example.com/mcp), whose tools appear as <prefix>__<tool>. prefix is letters, digits, - and single _s.

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

Send this header to the upstream on every request — its credentials, e.g. .header("Authorization", "Bearer <upstream token>").

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

where F: Fn(Option<&str>) -> Option<String> + Send + Sync + 'static,

Send header name on each tool call with a value computed from the caller’s verified claims (the JSON of McpContext::auth_claims, None for a caller without one) — e.g. each user’s own upstream token, looked up by sub, so the upstream acts as that user. None from value sends no header. Only tools/call carries a caller; listing and prompts/resources use the static Self::headers.

pub fn timeout_ms(self, timeout_ms: u64) -> Self

Give up on an upstream request after this long (default 30 s).

Trait Implementations

impl Clone for Upstream

fn clone(&self) -> Self

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for Upstream

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

Formats the value using the given formatter.