Struct ServerNotifier 

pub struct ServerNotifier { /* private fields */ }

A cloneable handle for sending server-initiated notifications from outside a request context.

A handler’s Context can only send notifications while a request is being served. When the server’s own state changes between requests — for example its tool set changes — use a ServerNotifier to push the corresponding notification (tools/list_changed, resources/list_changed, etc.) to the client.

Obtain one from ServerRuntime::notifier before spawning the runtime:

let runtime = ServerRuntime::new(server, transport);
let notifier = runtime.notifier();
tokio::spawn(async move { runtime.run().await });

// later, from anywhere:
notifier.tools_list_changed().await?;

Implementations

impl ServerNotifier

pub async fn notify( &self, method: impl Into<Cow<'static, str>>, params: Option<Value>, ) -> Result<(), McpError>

Send a notification with the given method and optional params.

Errors

Returns an error if the notification could not be sent over the transport.

pub async fn log( &self, level: LoggingLevel, logger: Option<&str>, data: Value, ) -> Result<(), McpError>

Emit a notifications/message log to the client at level, optionally tagged with a logger name and carrying arbitrary JSON data.

Errors

Returns an error if the notification could not be sent.

pub async fn tools_list_changed(&self) -> Result<(), McpError>

Notify the client that the available tool list has changed.

Errors

Returns an error if the notification could not be sent.

pub async fn resources_list_changed(&self) -> Result<(), McpError>

Notify the client that the available resource list has changed.

Errors

Returns an error if the notification could not be sent.

pub async fn prompts_list_changed(&self) -> Result<(), McpError>

Notify the client that the available prompt list has changed.

Errors

Returns an error if the notification could not be sent.

pub async fn resource_updated( &self, uri: impl Into<String>, ) -> Result<(), McpError>

Notify the client that a subscribed resource was updated.

Errors

Returns an error if the notification could not be sent.

pub async fn elicitation_complete( &self, elicitation_id: impl Into<String>, ) -> Result<(), McpError>

Notify the client that a URL-mode elicitation’s out-of-band interaction has completed (notifications/elicitation/complete).

Errors

Returns an error if the notification could not be sent.

Trait Implementations

impl Clone for ServerNotifier

fn clone(&self) -> ServerNotifier

Returns a duplicate of the value.

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

Performs copy-assignment from source.