@mastra/mcp 2.5.0-alpha.1 → 2.5.0-alpha.3

package/dist/client/events/types.d.ts

@@ -0,0 +1,181 @@
+import type { MastraError } from '@mastra/core/error';
+import type { EventActiveNotificationParams, EventErrorNotificationParams, EventHeartbeatNotificationParams, EventNotificationParams, EventOccurrence, EventTerminatedNotificationParams, PollEventsRequestParams, PollEventsResult, StreamEventsRequestParams, SubscribeEventsRequestParams, SubscribeEventsResult, UnsubscribeEventsRequestParams, WebhookDeliveryStatus } from '../../shared/events/index.js';
+import type { WebhookReceiver } from './webhook-receiver.js';
+/**
+ * One event occurrence delivered by an MCP Events subscription.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export type MCPEventOccurrence = EventOccurrence;
+/**
+ * How occurrences reach the client: `poll` repeats `events/poll`; `push` holds one long-lived
+ * `events/stream` request open per subscription; `webhook` has the server POST each occurrence to
+ * the client's `webhook.url` (registered with `events/subscribe`).
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export type MCPEventDeliveryMode = 'poll' | 'push' | 'webhook';
+/**
+ * Webhook delivery settings for `MCPClient`. With these set, event types whose servers offer
+ * webhook delivery use it in preference to push and poll.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export interface MCPClientWebhookOptions {
+    /** Public `https` URL that reaches `mcp.events.handleWebhook()`. */
+    url: string;
+    /**
+     * `whsec_` signing secret shared by every subscription. Default: a fresh random secret per
+     * subscription, so one server cannot sign deliveries for another server's subscriptions.
+     */
+    secret?: string;
+    /** Suggested subscription lifetime. `null` asks for no expiry. Default: the server's default. */
+    ttlMs?: number | null;
+    /** How long before `refreshBefore` to refresh. Default: the smaller of 60 seconds and 20% of the grant. */
+    refreshMarginMs?: number;
+}
+/** Webhook settings and receiver shared by the subscriptions of one `MCPClient`. */
+export interface EventsWebhookSetup {
+    options: MCPClientWebhookOptions;
+    receiver: WebhookReceiver;
+}
+/**
+ * Error passed to {@link MCPEventSubscription.onError} for recoverable problems, and thrown by
+ * the subscription iterator when the subscription ends. Ids:
+ *
+ * - `MCP_EVENTS_STREAM_ERROR` – the server reported a recoverable error on a push stream (`details.code`).
+ * - `MCP_EVENTS_HEARTBEAT_TIMEOUT` – a push stream went silent; the client reopens it.
+ * - `MCP_EVENTS_DELIVERY_INTERRUPTED` – a transient failure; the client retries with backoff.
+ * - `MCP_EVENTS_SUBSCRIPTION_FAILED` – a non-retryable JSON-RPC error (`details.code`). Ends the subscription.
+ * - `MCP_EVENTS_SUBSCRIPTION_TERMINATED` – the server terminated the subscription (`details.code`). Ends it.
+ * - `MCP_EVENTS_RETRIES_EXHAUSTED` – `retry.maxAttempts` was reached. Ends the subscription.
+ * - `MCP_EVENTS_BUFFER_OVERFLOW` – the consumer fell `maxBufferedEvents` behind and the oldest unread occurrences were dropped; the next one is flagged `truncated`.
+ * - `MCP_EVENTS_WEBHOOK_DELIVERY_FAILING` – the server reports that it cannot deliver to the
+ *   webhook URL (`details.lastError`, `details.active`). Refreshing resumes a suspended subscription.
+ * - `MCP_EVENTS_WEBHOOK_UNAVAILABLE` – the server rejected webhook delivery (`details.code`, e.g. an
+ *   unauthenticated connection or a full webhook subscription cap), so a subscription that did not force a mode fell back to
+ *   `details.fallback`. Reported once, to the first `onError` handler.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export type MCPEventSubscriptionError = MastraError;
+/**
+ * Retry policy for transient failures. Delays use full jitter:
+ * `random(0, min(maxDelayMs, initialDelayMs * factor ** (attempt - 1)))`.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export interface MCPEventRetryOptions {
+    /** Default 1000. */
+    initialDelayMs?: number;
+    /** Default 30000. */
+    maxDelayMs?: number;
+    /** Default 2. */
+    factor?: number;
+    /** Retries allowed after consecutive failures; the next failure ends the subscription. Default unlimited. */
+    maxAttempts?: number;
+}
+/**
+ * Options for `events.subscribe()`.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export interface MCPEventSubscribeOptions {
+    /**
+     * Force a delivery mode. Rejects when the server does not offer it for this event, or for
+     * `webhook` when the client has no `webhook` settings. Default: webhook (when configured), then
+     * push, then poll.
+     */
+    delivery?: MCPEventDeliveryMode;
+    /** Resume from a cursor you persisted earlier. Default `null` (start from now). */
+    cursor?: string | null;
+    /** Do not replay occurrences older than this. */
+    maxAgeMs?: number;
+    /** Upper bound on occurrences per `events/poll` response (poll only). */
+    maxEvents?: number;
+    /** Floor applied to the server's `nextPollMs`. Default 1000. */
+    minPollIntervalMs?: number;
+    /** Silence on a push stream after which it is reopened. Default 60000 (twice the 30s heartbeat). */
+    heartbeatTimeoutMs?: number;
+    /** How long to wait for `notifications/events/active` after opening a push stream. Default: the server's request timeout. */
+    streamOpenTimeoutMs?: number;
+    /** Number of recent `eventId`s remembered for de-duplication. Default 1000. */
+    dedupWindow?: number;
+    /**
+     * Most occurrences held for a consumer that is not reading. When full, the oldest is dropped,
+     * the next occurrence is flagged `truncated`, and `MCP_EVENTS_BUFFER_OVERFLOW` is reported.
+     * Default 1000.
+     */
+    maxBufferedEvents?: number;
+    /** Backoff for transient failures. */
+    retry?: MCPEventRetryOptions;
+    /** Aborting it is the same as calling `cancel()`. */
+    signal?: AbortSignal;
+}
+/**
+ * A live MCP Events subscription. Iterate it with `for await`; leaving the loop early cancels it.
+ *
+ * @experimental SEP-3415 is a draft; this API may change.
+ */
+export interface MCPEventSubscription extends AsyncIterable<MCPEventOccurrence> {
+    /** Event name. */
+    readonly name: string;
+    /** Subscription arguments sent with every request. */
+    readonly arguments: Record<string, unknown> | undefined;
+    /** Delivery mode in use. */
+    readonly mode: MCPEventDeliveryMode;
+    /**
+     * Cursor that is safe to persist and pass back as `cursor` to resume: it never moves past an
+     * occurrence that has not been yielded yet. A poll batch's cursor applies once the batch's last
+     * occurrence has been yielded; heartbeat and confirmation cursors apply once every occurrence
+     * buffered before them has been yielded. Persist it after handling each occurrence for
+     * at-least-once processing. `null` means the server offers no replay for this subscription;
+     * do not persist it.
+     */
+    readonly cursor: string | null;
+    /**
+     * Whether the server reported a gap (occurrences were skipped) right before the occurrence just
+     * yielded. It turns true when the gap is reported, stays true while the first occurrence after
+     * the gap is being handled, and is false again for the occurrences after it.
+     */
+    readonly truncated: boolean;
+    /** Webhook only: the server's latest report on delivery to the webhook URL, from the last refresh. */
+    readonly deliveryStatus?: WebhookDeliveryStatus;
+    /** Registers a handler for recoverable errors. Returns a function that removes it. */
+    onError(handler: (error: MCPEventSubscriptionError) => void): () => void;
+    /** Stops delivery and releases the server-side stream. Pending iteration ends with `done`. */
+    cancel(): Promise<void>;
+}
+/** Receives the notifications of one push stream. */
+export interface EventStreamSink {
+    active(params: EventActiveNotificationParams): void;
+    event(params: EventNotificationParams): void;
+    heartbeat(params: EventHeartbeatNotificationParams): void;
+    error(params: EventErrorNotificationParams): void;
+    terminated(params: EventTerminatedNotificationParams): void;
+}
+/** A push stream that has been confirmed with `notifications/events/active`. */
+export interface EventStreamHandle {
+    /** Settles when the `events/stream` request ends: resolves on a graceful close, rejects on failure. */
+    readonly done: Promise<void>;
+    /** Cancels the request and stops routing its notifications. */
+    abort(): void;
+}
+/** The narrow surface of the MCP client that subscriptions drive. */
+export interface EventsPort {
+    poll(params: PollEventsRequestParams, signal: AbortSignal): Promise<PollEventsResult>;
+    openStream(params: StreamEventsRequestParams, sink: EventStreamSink, options: {
+        signal: AbortSignal;
+        openTimeoutMs: number;
+    }): Promise<EventStreamHandle>;
+    /** `events/subscribe` (webhook delivery). */
+    subscribe(params: SubscribeEventsRequestParams, signal: AbortSignal): Promise<SubscribeEventsResult>;
+    /** `events/unsubscribe` (webhook delivery). */
+    unsubscribe(params: UnsubscribeEventsRequestParams): Promise<void>;
+    /** The webhook settings and receiver, when the client is configured for webhook delivery. */
+    webhook(): EventsWebhookSetup | undefined;
+    /** Resolves once the client is connected, reconnecting if needed. */
+    ensureConnected(): Promise<void>;
+    log(level: 'debug' | 'warning' | 'error', message: string, details?: Record<string, unknown>): void;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/client/events/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/client/events/types.ts"],"names":[],"mappings":"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"}

package/dist/client/events/webhook-driver.d.ts

@@ -0,0 +1,10 @@
+import type { DeliveryDriver } from './mode.js';
+/**
+ * Webhook delivery: registers the client's webhook URL with `events/subscribe`, routes verified
+ * deliveries from the shared receiver into the subscription, and refreshes before the server's
+ * `refreshBefore`. Local subscriptions with the same event name and arguments share one server
+ * subscription; cancelling the last one unregisters the route and sends a best-effort
+ * `events/unsubscribe`.
+ */
+export declare const webhookDriver: DeliveryDriver;
+//# sourceMappingURL=webhook-driver.d.ts.map

package/dist/client/events/webhook-driver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-driver.d.ts","sourceRoot":"","sources":["../../../src/client/events/webhook-driver.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAmB,cAAc,EAAE,MAAM,QAAQ,CAAC;AAmO9D;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,EAAE,cA2C3B,CAAC"}

package/dist/client/events/webhook-receiver.d.ts

@@ -0,0 +1,41 @@
+import type { EventOccurrence, WebhookControlBody } from '../../shared/events/index.js';
+/** A verified webhook body other than the verification handshake. */
+export type WebhookBody = {
+    kind: 'event';
+    event: EventOccurrence;
+} | {
+    kind: 'control';
+    control: Exclude<WebhookControlBody, {
+        type: 'verification';
+    }>;
+};
+/** Where verified deliveries for one subscription go. */
+export interface WebhookRoute {
+    secret: string;
+    onBody: (body: WebhookBody) => void;
+}
+/**
+ * Receives webhook deliveries for every subscription of one `MCPClient` and routes them by
+ * `X-MCP-Subscription-Id`. Every body is signature-checked before it is parsed.
+ *
+ * @internal
+ */
+export declare class WebhookReceiver {
+    /** Several routes per id only if two servers derive the same id; the verifying secret picks one. */
+    private readonly routes;
+    /** Secrets of subscribes still in flight, which have no id yet but must answer the handshake. */
+    private readonly pendingSecrets;
+    /** Accepts verification handshakes signed with `secret` until the returned function is called. */
+    expect(secret: string): () => void;
+    /** Routes deliveries for subscription `id` signed with `route.secret`. Returns the unregister function. */
+    register(id: string, route: WebhookRoute): () => void;
+    /**
+     * Handles one webhook request: `405` for non-POST, `413` for a body over 1 MiB, `503` for an id not routed yet (the server
+     * retries), `401` for a bad or stale signature, `400` for a malformed body, otherwise `200`.
+     * Verification handshakes are answered with the echoed challenge.
+     */
+    handle(request: Request): Promise<Response>;
+}
+/** Largest webhook body read. The route is public, so the body is capped before any check. */
+export declare const MAX_WEBHOOK_BODY_BYTES: number;
+//# sourceMappingURL=webhook-receiver.d.ts.map

package/dist/client/events/webhook-receiver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhook-receiver.d.ts","sourceRoot":"","sources":["../../../src/client/events/webhook-receiver.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE/E,qEAAqE;AACrE,MAAM,MAAM,WAAW,GACnB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,eAAe,CAAA;CAAE,GACzC;IAAE,IAAI,EAAE,SAAS,CAAC;IAAC,OAAO,EAAE,OAAO,CAAC,kBAAkB,EAAE;QAAE,IAAI,EAAE,cAAc,CAAA;KAAE,CAAC,CAAA;CAAE,CAAC;AAExF,yDAAyD;AACzD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,CAAC,IAAI,EAAE,WAAW,KAAK,IAAI,CAAC;CACrC;AAQD;;;;;GAKG;AACH,qBAAa,eAAe;IAC1B,oGAAoG;IACpG,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAqC;IAC5D,iGAAiG;IACjG,OAAO,CAAC,QAAQ,CAAC,cAAc,CAA6B;IAE5D,kGAAkG;IAClG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,IAAI,CAUjC;IAED,2GAA2G;IAC3G,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,GAAG,MAAM,IAAI,CAWpD;IAED;;;;OAIG;IACG,MAAM,CAAC,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,CAgChD;CACF;AAED,8FAA8F;AAC9F,eAAO,MAAM,sBAAsB,QAAc,CAAC"}

package/dist/client/index.d.ts

@@ -1,6 +1,7 @@
 export type { LoggingLevel, LogMessage, LogHandler, MastraMCPServerDefinition, MCPClientCapabilities, MCPClientInfo, MCPClientProtocolVersion, MCPInputRequest, MCPInputRequestHandler, MCPServerImplementation, ProgressHandler, InternalMastraMCPClientOptions, RequireToolApproval, RequireToolApprovalFn, RequireToolApprovalContext, ToolAnnotations, SerializableMCPToolDefinition, SerializableMCPToolCatalog, } from './types.js';
 export { MCP_CLIENT_PROTOCOL_VERSION } from './types.js';
 export * from './client.js';
+export type * from './events/index.js';
 export * from './configuration.js';
 export type { MCPDiscoveryErrorDetails } from './error-utils.js';
 export * from './oauth-provider.js';

package/dist/client/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,yBAAyB,EACzB,qBAAqB,EACrB,aAAa,EACb,wBAAwB,EACxB,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,8BAA8B,EAC9B,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AACtD,cAAc,UAAU,CAAC;AACzB,cAAc,iBAAiB,CAAC;AAChC,YAAY,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC9D,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/client/index.ts"],"names":[],"mappings":"AAAA,YAAY,EACV,YAAY,EACZ,UAAU,EACV,UAAU,EACV,yBAAyB,EACzB,qBAAqB,EACrB,aAAa,EACb,wBAAwB,EACxB,eAAe,EACf,sBAAsB,EACtB,uBAAuB,EACvB,eAAe,EACf,8BAA8B,EAC9B,mBAAmB,EACnB,qBAAqB,EACrB,0BAA0B,EAC1B,eAAe,EACf,6BAA6B,EAC7B,0BAA0B,GAC3B,MAAM,SAAS,CAAC;AACjB,OAAO,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AACtD,cAAc,UAAU,CAAC;AACzB,mBAAmB,UAAU,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,YAAY,EAAE,wBAAwB,EAAE,MAAM,eAAe,CAAC;AAC9D,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC;AACxC,OAAO,EAAE,oBAAoB,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/client/types.d.ts

@@ -2,6 +2,7 @@ import type { IOType } from 'node:child_process';
 import type { RequestContext } from '@mastra/core/di';
 import type { StreamableHTTPClientTransportOptions, ClientCapabilities, ElicitRequestParams, ElicitResult, LoggingLevel, ProgressNotification, ToolAnnotations, jsonSchemaValidator } from '@modelcontextprotocol/client';
 import type { MCPTraceContext } from '../shared/trace-context.js';
+import type { EventsWebhookSetup } from './events/types.js';
 export type { FetchLike } from '@modelcontextprotocol/client';
 export type { ToolAnnotations } from '@modelcontextprotocol/client';
 export type { LoggingLevel } from '@modelcontextprotocol/client';
@@ -482,6 +483,8 @@ export type InternalMastraMCPClientOptions = {
     clientInfo?: MCPClientInfo;
     /** Optional timeout in milliseconds */
     timeout?: number;
+    /** Webhook settings and receiver shared by the owning `MCPClient`'s servers. */
+    webhook?: EventsWebhookSetup;
 };
 /**
  * A fully serializable description of a single tool advertised by an MCP server.

package/dist/client/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/client/types.ts"],"names":[],"mappings":"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"}

package/dist/docs/SKILL.md

@@ -3,7 +3,7 @@ name: mastra-mcp
 description: Documentation for @mastra/mcp. Use when working with @mastra/mcp APIs, configuration, or implementation.
 metadata:
   package: "@mastra/mcp"
-  version: "2.5.0-alpha.1"
+  version: "2.5.0-alpha.3"
 ---
 
 ## When to use
@@ -20,6 +20,7 @@ Read the individual reference documents for detailed explanations and code examp
 - [MCP](references/docs-connections-mcp.md) - Connect Mastra agents to remote MCP servers, expose Mastra tools through MCPServer, manage approvals, and build interactive MCP Apps for Studio.
 - [Connections](references/docs-connections-overview.md) - Connect Mastra to remote agents, coding agents, SDK runtimes, MCP servers, and external tools by choosing the protocol that fits your application.
 - [MCP authentication and authorization](references/docs-guides-mcp-authentication-authorization.md) - Choose credentials for MCP connections, protect a Mastra MCP server, and separate delegated access from tool and data permissions.
+- [MCP events](references/docs-guides-mcp-events.md) - Publish events from a Mastra MCP server, subscribe to them with MCPClient, resume from a cursor, and start agent or workflow runs per occurrence.
 
 ### Reference
 

package/dist/docs/assets/SOURCE_MAP.json

@@ -1,5 +1,5 @@
 {
-  "version": "2.5.0-alpha.1",
+  "version": "2.5.0-alpha.3",
   "package": "@mastra/mcp",
   "exports": {},
   "modules": {}

package/dist/docs/references/docs-guides-mcp-authentication-authorization.md

@@ -47,7 +47,7 @@ A separate provider per MCP server does one thing and not another:
 
 The specification recommends support for **Client ID Metadata Documents (CIMD)**, which identify a client through an HTTPS metadata URL. It also defines pre-registration. Clients that support all registration options should prefer existing pre-registered information when available. Legacy Dynamic Client Registration (DCR) remains optional for compatibility but is deprecated for new implementations. See the versioned [client registration rules](https://modelcontextprotocol.io/specification/2026-07-28/basic/authorization/client-registration).
 
-Mastra's provider accepts pre-registered client information and supports a DCR-based flow. Don't infer CIMD support from the presence of OAuth support. Check the registration mechanism supported by your client integration and authorization server before choosing a deployment.
+`MCPOAuthClientProvider` never registers a client at runtime and doesn't support DCR. Configure exactly one client identity: `clientInformation` for a client pre-registered with the authorization server, or `clientMetadataUrl` for CIMD. Check that your authorization server supports the mechanism you choose before deploying. See the [OAuth client reference](https://mastra.ai/reference/tools/mcp-client) for configuration examples.
 
 Mastra's interactive `authenticate()` flow uses a local loopback callback server. It isn't a hosted multi-user login endpoint. A hosted application must own its callback endpoint and associate each authorization attempt with the correct user and provider. See [interactive browser authentication](https://mastra.ai/reference/tools/mcp-client).
 
@@ -97,7 +97,7 @@ Protecting Mastra routes with `server.auth` and providing interoperable OAuth di
 
 Alongside the MCP transport, Mastra registers REST routes used by Studio to list servers, inspect tools, execute tools, and read resources. See the [MCP routes reference](https://mastra.ai/reference/server/routes) for the full list. These paths use the default `/api` prefix.
 
-The `POST /api/mcp/:serverId/tools/:toolId/execute` route calls `executeTool()` directly, without a protocol client. With a Mastra FGA provider configured, `MCPServer.executeTool()` enforces tool execution permission using the user in `requestContext`. The REST tool list also filters tools through FGA. These permission checks don't replace route authentication.
+The `POST /api/mcp/:serverId/tools/:toolId/execute` route calls `executeTool()` directly, without a protocol client. With a Mastra FGA provider configured, `MCPServer.executeTool()` enforces tool execution permission using the user in `requestContext`. The REST tool list also filters tools through FGA, but these permission checks don't replace route authentication.
 
 Built-in authentication for these routes depends on `server.auth`. Without it, `requiresAuth: true` doesn't enforce authentication. Custom middleware that checks only the `/mcp` or `/sse` transport paths leaves the REST routes open. If you use custom middleware instead of `server.auth`, default-deny `/api/mcp/*` and allow access only after authentication.