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.