Struct ClientMetadata 

pub struct ClientMetadata { /* private fields */ }

The metadata a client presents to register.

This is RFC 7591 §2’s client metadata document, and MCP adds one requirement on top: 2026-07-28 §8 (SEP-837) makes application_type a MUST for dynamic registration “to avoid OpenID Connect redirect URI conflicts”.

Unknown fields

extra holds anything not named here and is merged into the serialized document. The named fields are the ones this crate has to read or gate on; a client that publishes client_uri, icon_uri or title — all of which the newer revisions name — sets them through with_field rather than losing them at a struct boundary. Preserving them matters for the same reason it matters on the IR: the authorization server sees the document this client published, and silently dropping a field turns a working registration into a failing one.

Implementations

impl ClientMetadata

pub fn new(redirect_uris: Vec<String>) -> Result<Self, ClientIdError>

Metadata with the redirect URIs it will be authorized to use.

RFC 7591 §2 makes redirect_uris the one required member of a client metadata document, so this constructor refuses an empty list rather than letting a server reject it.

Errors

ClientIdError::NotHttps if a redirect URI is not an absolute https URL, or ClientIdError::DocumentRegistration if the list is empty.

pub fn redirect_uris(&self) -> &[String]

The redirect URIs, in the order they were given.

pub fn client_name(&self) -> Option<&str>

The name this client presents at a consent screen.

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

Set the consent-screen name.

pub fn token_endpoint_auth_method(&self) -> Option<&str>

How this client authenticates at the token endpoint.

"none" declares a public client, which is what a Client ID Metadata Document client is: the draft is explicit that no shared secret can be established for that form.

pub fn with_token_endpoint_auth_method(self, method: impl Into<String>) -> Self

Set the token endpoint authentication method.

pub fn application_type(&self) -> Option<&str>

The OIDC application_type this client is.

pub fn with_application_type(self, application_type: impl Into<String>) -> Self

Set the OIDC application_type.

pub fn with_field( self, name: impl Into<String>, value: impl Into<Value>, ) -> Result<Self, ClientMetadataError>

Set one field this crate does not name, preserving it on the wire.

Takes precedence over a named field of the same name, so a caller cannot set redirect_uris through here and have it win over the typed value — that would let a document claim redirects the client never checked.

ClientMetadataError::ReservedField names the fields that are typed.

pub const fn extra(&self) -> &Map<String, Value>

The fields this crate does not name, as they will be serialized.

Trait Implementations

impl Clone for ClientMetadata

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 ClientMetadata

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

Formats the value using the given formatter.

impl Default for ClientMetadata

fn default() -> Self

Returns the “default value” for a type.

impl<'de> Deserialize<'de> for ClientMetadata

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

where __D: Deserializer<'de>,

Deserialize this value from the given Serde deserializer.

impl Eq for ClientMetadata

impl PartialEq for ClientMetadata

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

Equality operator ==.

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

Inequality operator !=.

impl Serialize for ClientMetadata

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 ClientMetadata