@mastra/mcp 1.17.0-alpha.1 → 1.17.0

package/dist/server/mrtrElicitation.d.ts

@@ -0,0 +1,39 @@
+import type { MCPServerContext } from '@mastra/core/tools';
+import type { ElicitRequest, ElicitResult, InputRequiredResult } from '@modelcontextprotocol/server';
+import type { ElicitationActions } from './types.js';
+/**
+ * Thrown by the replay-based `sendRequest` when the current round carries no
+ * answer for the elicitation. Never surfaces to tools or clients: the
+ * `tools/call` handler converts it into an `input_required` result.
+ */
+export declare class ElicitationReplayInterrupt extends Error {
+    readonly key: string;
+    readonly params: ElicitRequest['params'];
+    readonly answered: Record<string, ElicitResult>;
+    constructor(key: string, params: ElicitRequest['params'], answered: Record<string, ElicitResult>);
+}
+/**
+ * Whether this request is served on the 2026-07-28 era. Modern clients always
+ * attach the reserved per-request `_meta` envelope (the 2026 codec enforces the
+ * required keys at dispatch); legacy requests never carry it.
+ */
+export declare const isModernEraRequest: (extra: MCPServerContext) => boolean;
+/**
+ * Builds the replay-based {@link ElicitationActions} for one modern-era tool
+ * execution. Answers already provided by the client resolve immediately; the
+ * first unanswered elicitation throws {@link ElicitationReplayInterrupt}.
+ *
+ * The interrupt is also reported through `onInterrupt` before it is thrown:
+ * tool wrappers (e.g. Mastra's tool builder) re-wrap thrown errors, so the
+ * `tools/call` handler cannot rely on `instanceof` on whatever escapes the
+ * tool — the out-of-band capture is the authoritative signal.
+ */
+export declare const createReplayElicitation: (extra: MCPServerContext, onInterrupt: (interrupt: ElicitationReplayInterrupt) => void) => ElicitationActions;
+/**
+ * Converts a caught {@link ElicitationReplayInterrupt} into the
+ * `input_required` result the `tools/call` handler returns to the client.
+ * Prior answers travel in `requestState` because each retry only carries the
+ * current round's `inputResponses`.
+ */
+export declare const replayInterruptToInputRequired: (interrupt: ElicitationReplayInterrupt) => InputRequiredResult;
+//# sourceMappingURL=mrtrElicitation.d.ts.map

package/dist/server/mrtrElicitation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mrtrElicitation.d.ts","sourceRoot":"","sources":["../../src/server/mrtrElicitation.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,mBAAmB,EAAE,MAAM,8BAA8B,CAAC;AAErG,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AA6BlD;;;;GAIG;AACH,qBAAa,0BAA2B,SAAQ,KAAK;aAEjC,GAAG,EAAE,MAAM;aACX,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC;aAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;gBAFtC,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC/B,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC;CAKzD;AAyCD;;;;GAIG;AACH,eAAO,MAAM,kBAAkB,GAAI,OAAO,gBAAgB,KAAG,OAA8C,CAAC;AAE5G;;;;;;;;;GASG;AACH,eAAO,MAAM,uBAAuB,GAClC,OAAO,gBAAgB,EACvB,aAAa,CAAC,SAAS,EAAE,0BAA0B,KAAK,IAAI,KAC3D,kBAgBF,CAAC;AAEF;;;;;GAKG;AACH,eAAO,MAAM,8BAA8B,GAAI,WAAW,0BAA0B,KAAG,mBAStF,CAAC"}

package/dist/server/promptActions.d.ts

@@ -1,9 +1,15 @@
 import type { IMastraLogger } from '@mastra/core/logger';
-import type { Server } from '@modelcontextprotocol/server';
+import type { Server, ServerNotifier } from '@modelcontextprotocol/server';
 interface ServerPromptActionsDependencies {
     getLogger: () => IMastraLogger;
     getSdkServers: () => Server[];
     clearDefinedPrompts: () => void;
+    /**
+     * Publish-side facade of the 2026-07-28 handler's subscription bus, when the
+     * server is pinned to that revision and the handler exists. Modern clients
+     * receive change events via `subscriptions/listen` instead of server push.
+     */
+    getModernEraNotifier?: () => ServerNotifier | undefined;
 }
 /**
  * Server-side prompt actions for notifying clients about prompt changes.
@@ -20,6 +26,7 @@ export declare class ServerPromptActions {
     private readonly getLogger;
     private readonly getSdkServers;
     private readonly clearDefinedPrompts;
+    private readonly getModernEraNotifier?;
     /**
      * @internal
      */

package/dist/server/promptActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"promptActions.d.ts","sourceRoot":"","sources":["../../src/server/promptActions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAG3D,UAAU,+BAA+B;IACvC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,aAAa,EAAE,MAAM,MAAM,EAAE,CAAC;IAC9B,mBAAmB,EAAE,MAAM,IAAI,CAAC;CACjC;AAED;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAa;IAEjD;;OAEG;gBACS,YAAY,EAAE,+BAA+B;IAMzD;;;;;;;;;;;;;OAaG;IACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;CAWhD"}
+{"version":3,"file":"promptActions.d.ts","sourceRoot":"","sources":["../../src/server/promptActions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG3E,UAAU,+BAA+B;IACvC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,aAAa,EAAE,MAAM,MAAM,EAAE,CAAC;IAC9B,mBAAmB,EAAE,MAAM,IAAI,CAAC;IAChC;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,cAAc,GAAG,SAAS,CAAC;CACzD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,mBAAmB,CAAa;IACjD,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAmC;IAEzE;;OAEG;gBACS,YAAY,EAAE,+BAA+B;IAOzD;;;;;;;;;;;;;OAaG;IACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;CAahD"}

package/dist/server/resourceActions.d.ts

@@ -1,9 +1,15 @@
 import type { IMastraLogger } from '@mastra/core/logger';
-import type { Server } from '@modelcontextprotocol/server';
+import type { Server, ServerNotifier } from '@modelcontextprotocol/server';
 interface ServerResourceActionsDependencies {
     getSubscribedServers: (uri: string) => Server[];
     getLogger: () => IMastraLogger;
     getSdkServers: () => Server[];
+    /**
+     * Publish-side facade of the 2026-07-28 handler's subscription bus, when the
+     * server is pinned to that revision and the handler exists. Modern clients
+     * receive change events via `subscriptions/listen` instead of server push.
+     */
+    getModernEraNotifier?: () => ServerNotifier | undefined;
 }
 /**
  * Server-side resource actions for notifying clients about resource changes.
@@ -20,6 +26,7 @@ export declare class ServerResourceActions {
     private readonly getSubscribedServers;
     private readonly getLogger;
     private readonly getSdkServers;
+    private readonly getModernEraNotifier?;
     /**
      * @internal
      */

package/dist/server/resourceActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"resourceActions.d.ts","sourceRoot":"","sources":["../../src/server/resourceActions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAG3D,UAAU,iCAAiC;IACzC,oBAAoB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAChD,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,aAAa,EAAE,MAAM,MAAM,EAAE,CAAC;CAC/B;AAED;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA4B;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAE/C;;OAEG;gBACS,YAAY,EAAE,iCAAiC;IAM3D;;;;;;;;;;;;;;;;OAgBG;IACU,aAAa,CAAC,EAAE,GAAG,EAAE,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAiBnE;;;;;;;;;;;;;;OAcG;IACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;CAUhD"}
+{"version":3,"file":"resourceActions.d.ts","sourceRoot":"","sources":["../../src/server/resourceActions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG3E,UAAU,iCAAiC;IACzC,oBAAoB,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,EAAE,CAAC;IAChD,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,aAAa,EAAE,MAAM,MAAM,EAAE,CAAC;IAC9B;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,cAAc,GAAG,SAAS,CAAC;CACzD;AAED;;;;;;;;;;GAUG;AACH,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAA4B;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAmC;IAEzE;;OAEG;gBACS,YAAY,EAAE,iCAAiC;IAO3D;;;;;;;;;;;;;;;;OAgBG;IACU,aAAa,CAAC,EAAE,GAAG,EAAE,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBnE;;;;;;;;;;;;;;OAcG;IACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;CAYhD"}

package/dist/server/server.d.ts

@@ -15,7 +15,17 @@ import { SSETransport } from '../_types/hono-mcp-server-sse-transport/build/inde
 import { ServerPromptActions } from './promptActions.js';
 import { ServerResourceActions } from './resourceActions.js';
 import { ServerToolActions } from './toolActions.js';
-import type { MCPServerPrompts, MCPServerResources, ElicitationActions, AppResources } from './types.js';
+import type { MCPServerPrompts, MCPServerResources, ElicitationActions, AppResources, MCPServerProtocolVersion, MCPServerCacheHints } from './types.js';
+type MCPServerStreamableHTTPOptions = Partial<StreamableHTTPServerTransportOptions> & {
+    serverless?: boolean;
+    /**
+     * Opt into request-scoped SSE streaming for legacy serverless requests.
+     *
+     * The `2026-07-28` handler accepts `true` as a compatibility declaration because
+     * its automatic response mode already streams request-scoped messages when needed.
+     */
+    serverlessStreaming?: boolean;
+};
 /**
  * MCPServer exposes Mastra tools, agents, and workflows as a Model Context Protocol (MCP) server.
  *
@@ -62,6 +72,12 @@ export declare class MCPServer extends MCPServerBase {
     private fga?;
     private subscriptionsByInstance;
     private loggingLevels;
+    private protocolVersion?;
+    private cacheHints?;
+    private modernEraHandler?;
+    private modernEraNodeHandler?;
+    private stdioHandle?;
+    private stdioServerInstance?;
     /**
      * Provides methods to notify clients about resource changes.
      *
@@ -255,6 +271,44 @@ export declare class MCPServer extends MCPServerBase {
          * ```
          */
         jsonSchemaValidator?: jsonSchemaValidator;
+        /**
+         * Opt-in MCP protocol revision.
+         *
+         * Omitted (or `'2025-11-25'`) keeps today's behavior exactly. Set to
+         * `'2026-07-28'` to serve the stateless MCP revision: HTTP and serverless
+         * requests go through the SDK's dual-era handler (modern clients served
+         * natively, legacy clients via the built-in stateless fallback on the same
+         * endpoint), and stdio serves both eras via the `server/discover` probe.
+         *
+         * @example
+         * ```typescript
+         * const server = new MCPServer({
+         *   name: 'My Server',
+         *   version: '1.0.0',
+         *   tools: { ... },
+         *   protocolVersion: '2026-07-28',
+         * });
+         * ```
+         */
+        protocolVersion?: MCPServerProtocolVersion;
+        /**
+         * Cache hints (`ttlMs` / `cacheScope`) advertised on cacheable results of the
+         * `2026-07-28` protocol revision, keyed by operation (e.g. `'tools/list'`).
+         * Only applied when `protocolVersion: '2026-07-28'` is set; legacy responses
+         * are never affected.
+         *
+         * @example
+         * ```typescript
+         * const server = new MCPServer({
+         *   name: 'My Server',
+         *   version: '1.0.0',
+         *   tools: { ... },
+         *   protocolVersion: '2026-07-28',
+         *   cacheHints: { 'tools/list': { ttlMs: 60_000, cacheScope: 'private' } },
+         * });
+         * ```
+         */
+        cacheHints?: MCPServerCacheHints;
     });
     /**
      * Returns every connected SDK server instance: the main instance (stdio/SSE
@@ -266,6 +320,25 @@ export declare class MCPServer extends MCPServerBase {
      * cannot receive notifications.
      */
     private getAllSdkServers;
+    /**
+     * Whether the server is pinned to the `2026-07-28` protocol revision.
+     * When false (the default), all behavior is byte-identical to the legacy era.
+     */
+    private servesModernEra;
+    private assertModernEraHTTPOptions;
+    private validateHTTPRequestHeaders;
+    /**
+     * Lazily creates the dual-era HTTP handler used when `protocolVersion: '2026-07-28'`
+     * is set: modern (per-request envelope) clients are served natively and legacy
+     * clients are served through the SDK's built-in stateless fallback, both from the
+     * same endpoint. Each request gets a fresh server instance from
+     * `createServerInstance()`, so all registered handlers apply to both eras.
+     */
+    private getModernEraHandler;
+    /**
+     * Node `(req, res)` adapter over the dual-era handler's web-standard `fetch`.
+     */
+    private getModernEraNodeHandler;
     /**
      * Determines whether a log message at the given level should be sent to the
      * client connected to the given server instance, honoring the minimum level
@@ -535,22 +608,14 @@ export declare class MCPServer extends MCPServerBase {
         httpPath: string;
         req: http.IncomingMessage;
         res: http.ServerResponse<http.IncomingMessage>;
-        options?: Partial<StreamableHTTPServerTransportOptions> & {
-            serverless?: boolean;
-            /**
-             * Opt into request-scoped SSE streaming for serverless requests.
-             *
-             * When `true`, the transient serverless transport is created with
-             * `enableJsonResponse: false`, which allows in-request `notifications/progress`
-             * to stream back to the client before the final result. Defaults to `false`,
-             * preserving the JSON-response behavior that buffers only the final result.
-             *
-             * This only enables notifications scoped to the current request (e.g. progress).
-             * Elicitation, subscriptions, and out-of-request resource/list-change
-             * notifications still require a stateful session or another protocol model.
-             */
-            serverlessStreaming?: boolean;
-        };
+        /**
+         * Streamable HTTP transport options for the legacy protocol path.
+         *
+         * With `protocolVersion: '2026-07-28'`, stateless declarations and DNS rebinding
+         * protection remain supported. Session and response-mode options are rejected
+         * because they cannot configure the shared modern-era handler per request.
+         */
+        options?: MCPServerStreamableHTTPOptions;
     }): Promise<void>;
     /**
      * Handles a stateless, serverless HTTP request without session management.
@@ -791,4 +856,5 @@ export declare class MCPServer extends MCPServerBase {
         resources: Resource[];
     }>;
 }
+export {};
 //# sourceMappingURL=server.d.ts.map

package/dist/server/server.d.ts.map

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

package/dist/server/toolActions.d.ts

@@ -1,11 +1,17 @@
 import type { ToolsInput } from '@mastra/core/agent';
 import type { IMastraLogger } from '@mastra/core/logger';
-import type { Server } from '@modelcontextprotocol/server';
+import type { Server, ServerNotifier } from '@modelcontextprotocol/server';
 interface ServerToolActionsDependencies {
     getLogger: () => IMastraLogger;
     getSdkServers: () => Server[];
     addTools: (tools: ToolsInput) => void;
     removeTools: (toolIds: string[]) => string[];
+    /**
+     * Publish-side facade of the 2026-07-28 handler's subscription bus, when the
+     * server is pinned to that revision and the handler exists. Modern clients
+     * receive change events via `subscriptions/listen` instead of server push.
+     */
+    getModernEraNotifier?: () => ServerNotifier | undefined;
 }
 /**
  * Server-side tool actions for dynamic tool management and notifying clients
@@ -21,6 +27,7 @@ export declare class ServerToolActions {
     private readonly getSdkServers;
     private readonly addTools;
     private readonly removeTools;
+    private readonly getModernEraNotifier?;
     /**
      * @internal
      */

package/dist/server/toolActions.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"toolActions.d.ts","sourceRoot":"","sources":["../../src/server/toolActions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,8BAA8B,CAAC;AAG3D,UAAU,6BAA6B;IACrC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,aAAa,EAAE,MAAM,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;CAC9C;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAE9D;;OAEG;gBACS,YAAY,EAAE,6BAA6B;IAOvD;;;;;;;;;;;;;;OAcG;IACU,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD;;;;;;;;;;;;;;OAcG;IACU,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IASrD;;;;;;;;;;;;;OAaG;IACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;CAUhD"}
+{"version":3,"file":"toolActions.d.ts","sourceRoot":"","sources":["../../src/server/toolActions.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAG3E,UAAU,6BAA6B;IACrC,SAAS,EAAE,MAAM,aAAa,CAAC;IAC/B,aAAa,EAAE,MAAM,MAAM,EAAE,CAAC;IAC9B,QAAQ,EAAE,CAAC,KAAK,EAAE,UAAU,KAAK,IAAI,CAAC;IACtC,WAAW,EAAE,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,MAAM,EAAE,CAAC;IAC7C;;;;OAIG;IACH,oBAAoB,CAAC,EAAE,MAAM,cAAc,GAAG,SAAS,CAAC;CACzD;AAED;;;;;;;;GAQG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAsB;IAChD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAiB;IAC/C,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA8B;IACvD,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkC;IAC9D,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,CAAmC;IAEzE;;OAEG;gBACS,YAAY,EAAE,6BAA6B;IAQvD;;;;;;;;;;;;;;OAcG;IACU,GAAG,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD;;;;;;;;;;;;;;OAcG;IACU,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IASrD;;;;;;;;;;;;;OAaG;IACU,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;CAYhD"}

package/dist/server/types.d.ts

@@ -1,6 +1,34 @@
 import type { MCPServerContext } from '@mastra/core/tools';
 import type { McpUiResourceMeta } from '@modelcontextprotocol/ext-apps';
-import type { RequestOptions, ElicitRequest, ElicitResult, Prompt, PromptMessage, Resource, ResourceTemplateType } from '@modelcontextprotocol/server';
+import type { CacheHint, RequestOptions, ElicitRequest, ElicitResult, Prompt, PromptMessage, Resource, ResourceTemplateType } from '@modelcontextprotocol/server';
+/**
+ * MCP protocol revisions the server can be pinned to.
+ *
+ * - `'2025-11-25'` — the legacy (2025) protocol era. This is the default and matches
+ *   the server's behavior when the option is omitted: sessionful streamable HTTP,
+ *   `initialize` handshake, server→client push notifications.
+ * - `'2026-07-28'` — the stateless protocol revision. HTTP and serverless requests are
+ *   served through the SDK's dual-era handler: modern (per-request envelope) clients are
+ *   served natively, and legacy clients are served through the built-in stateless
+ *   fallback on the same endpoint. Stdio serves both eras via the `server/discover`
+ *   probe. List-changed/resource-updated notifications additionally reach modern
+ *   clients via `subscriptions/listen`, tool log emission honors the per-request
+ *   `logLevel` opt-in, and configured {@link MCPServerCacheHints} are advertised.
+ */
+export type MCPServerProtocolVersion = '2025-11-25' | '2026-07-28';
+/**
+ * The operations whose results are cacheable on the `2026-07-28` protocol revision.
+ */
+export type MCPServerCacheableMethod = 'tools/list' | 'prompts/list' | 'resources/list' | 'resources/templates/list' | 'resources/read' | 'server/discover';
+/**
+ * Cache hints (`ttlMs` / `cacheScope`) advertised on cacheable results of the
+ * `2026-07-28` protocol revision, keyed by operation.
+ *
+ * Only used when `protocolVersion: '2026-07-28'` is set. Absent hints keep the SDK's
+ * conservative defaults (`ttlMs: 0`, `cacheScope: 'private'`). Responses to legacy
+ * (2025-era) requests are never affected.
+ */
+export type MCPServerCacheHints = Partial<Record<MCPServerCacheableMethod, CacheHint>>;
 /**
  * Callback function to retrieve content for a specific resource.
  *

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

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp",
-  "version": "1.17.0-alpha.1",
+  "version": "1.17.0",
   "description": "",
   "type": "module",
   "main": "dist/index.js",
@@ -55,14 +55,14 @@
     "vitest": "4.1.10",
     "zod": "^4.4.3",
     "zod-to-json-schema": "^3.25.1",
-    "@internal/ai-sdk-v5": "0.0.70",
-    "@internal/lint": "0.0.123",
-    "@internal/test-utils": "0.0.59",
-    "@mastra/core": "1.60.0-alpha.8",
-    "@internal/llm-recorder": "0.0.59",
-    "@mastra/observability": "1.17.1-alpha.2",
-    "@mastra/schema-compat": "1.3.7",
-    "@internal/types-builder": "0.0.98"
+    "@internal/ai-sdk-v5": "0.0.71",
+    "@internal/test-utils": "0.0.60",
+    "@mastra/core": "1.60.0",
+    "@internal/llm-recorder": "0.0.60",
+    "@internal/types-builder": "0.0.99",
+    "@mastra/observability": "1.17.1",
+    "@internal/lint": "0.0.124",
+    "@mastra/schema-compat": "1.3.7"
   },
   "homepage": "https://mastra.ai",
   "repository": {