Struct McpServerSpec 

pub struct McpServerSpec {
    pub name: String,
    pub endpoint: String,
    pub headers: Vec<(String, String)>,
    pub tags: Vec<TrifectaTag>,
    pub aauth: Option<bool>,
    pub oauth: Option<McpOauthSpec>,
    pub auth: Option<AuthSpec>,
}

A declared MCP server. Serializable because it travels in the subagent spawn payload as the child’s scoped server subset (RFC 0005, RFC 0009).

As of v2.0.0 the sole transport is a remote endpoint reached over Streamable HTTP (RFC 0004; RFC 0012 — no local process spawn).

Fields

name: String

endpoint: String

Remote MCP endpoint — https://host[:port][/path] (loopback http:// for dev), reached over RFC 0004 Streamable HTTP.

headers: Vec<(String, String)>

Secret-FREE auth/framing header templates (e.g. ("Authorization", "Bearer {{secret:MCP_TOKEN}}")), resolved at connect time (RFC 0012 §3.7 — no credential in the spec/manifest/payload/logs).

tags: Vec<TrifectaTag>

Operator-declared capability tags (--mcp-tags) for the Rule-of-Two trifecta check (RFC 0012 §3.1). Travels in the spawn payload so a child’s narrowed grant carries the same tags. Empty = untagged (the check treats an untagged server conservatively as untrusted_input).

aauth: Option<bool>

Sign requests to THIS server with the AAuth agent identity (RFC 0023). Per-server opt-in: None inherits the global default (sign all when an --aauth-provider is configured); Some(false) opts out; Some(true) opts in even if the global default were off. Travels in the spawn payload.

oauth: Option<McpOauthSpec>

OAuth 2.1 client-credentials for an endpoint behind an OAuth gateway (RFC 0031 §7): a refreshing Authorization: Bearer … fetched from the token endpoint. Secret-free (client_secret is a {{secret:…}} template). Travels in the spawn payload; takes the request-signer seam when set (mutually exclusive with per-server AAuth signing).

auth: Option<AuthSpec>

The unified credential provider (RFC 0031 §5). Takes precedence over the legacy oauth/aauth when set. Travels in the spawn payload.

Trait Implementations

impl Clone for McpServerSpec

fn clone(&self) -> McpServerSpec

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for McpServerSpec

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

Formats the value using the given formatter.

impl Default for McpServerSpec

fn default() -> McpServerSpec

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for McpServerSpec

fn deserialize<__D>(__deserializer: __D) -> Result<Self, __D::Error>

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for McpServerSpec

impl PartialEq for McpServerSpec

fn eq(&self, other: &McpServerSpec) -> bool

Equality operator ==.

fn ne(&self, other: &Rhs) -> bool

Inequality operator !=.

impl Serialize for McpServerSpec

fn serialize<__S>(&self, __serializer: __S) -> Result<__S::Ok, __S::Error>

where __S: Serializer,

Serialize this value into the given Serde serializer.

impl StructuralPartialEq for McpServerSpec