Long-lived notification subscriptions for MCP 2026-07-28.

The modern subscriptions/listen request replaces legacy GET notification streams. Every notification category is explicitly opted in.

Functions

listen

fn (session: ::mcp::types/Session, filter: ::mcp::types/SubscriptionFilter): Iter

Open a modern long-lived notification stream.

Returns an iterator of parsed StreamEvent values. The final event, when a server closes the subscription gracefully, contains the subscriptions/listen JSON-RPC result.

require-supported

fn (supported: Bool, message: Str): Any

validate-filter

fn (session: ::mcp::types/Session, filter: ::mcp::types/SubscriptionFilter): Map

Validate subscription opt-ins against discovered server capabilities.

wire-filter

fn (filter: ::mcp::types/SubscriptionFilter): Map

Convert a typed subscription filter to the MCP wire shape.