Struct CatalogMcpServerCandidate 

pub struct CatalogMcpServerCandidate {
    pub description: Option<String>,
    pub display_name: String,
    pub handle: String,
    pub handle_expires_at: String,
    pub installability: CatalogMcpServerInstallability,
    pub kind: CatalogMcpServerCandidateKind,
    pub media_type: McpServerCardMediaType,
    pub provenance: CatalogMcpServerCandidateProvenance,
    pub publisher: Option<String>,
    pub source: CatalogCandidateSource,
}

An inert MCP server catalog result. Every free-text field is untrusted external data and must never be treated as an instruction, and the handle is the only way to refer to the candidate in a later operation.

Experimental. This type is part of an experimental wire-protocol surface and may change or be removed in future SDK or CLI releases.

Fields

description: Option<String>

Description taken verbatim from the card. Inert untrusted text.

display_name: String

Display name taken verbatim from the card. Inert untrusted text.

handle: String

Opaque, runtime-instance scoped, TTL-bound, single-use handle for this candidate. Carries no readable information and is rejected when stale, replayed, or presented to a different runtime instance. Never logged.

handle_expires_at: String

ISO 8601 timestamp after which the handle is stale and will be rejected.

installability: CatalogMcpServerInstallability

Whether this MCP server can be planned for installation, and if policy prevents it.

kind: CatalogMcpServerCandidateKind

Discriminator: this candidate describes an MCP server

media_type: McpServerCardMediaType

JSON MCP media type of the underlying card.

provenance: CatalogMcpServerCandidateProvenance

Where the catalog reference was observed, without the card itself or any content digest.

publisher: Option<String>

Publisher taken verbatim from the card. Inert untrusted text.

source: CatalogCandidateSource

Where the card came from: exactly one of a URL or embedded data, encoded as a tagged union so neither both nor neither can be represented.

Trait Implementations

impl Clone for CatalogMcpServerCandidate

fn clone(&self) -> CatalogMcpServerCandidate

Returns a duplicate of the value.

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

Performs copy-assignment from source.

impl Debug for CatalogMcpServerCandidate

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

Formats the value using the given formatter.

impl<'de> Deserialize<'de> for CatalogMcpServerCandidate

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Serialize for CatalogMcpServerCandidate

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

where __S: Serializer,

Serialize this value into the given Serde serializer.