@mastra/mcp 1.18.1-alpha.3 → 2.0.0-alpha.4

package/dist/client/server-proxy.d.ts

@@ -1,65 +1,47 @@
 import type { ToolsInput } from '@mastra/core/agent';
 import { MCPServerBase } from '@mastra/core/mcp';
-import type { MCPServerConfig, MCPServerHonoSSEOptions, MCPServerHTTPOptions, MCPServerSSEOptions, MCPToolType, ServerDetailInfo, ServerInfo } from '@mastra/core/mcp';
+import type { MCPToolExecutionResultV2, MCPToolType, ServerDetailInfo, ServerInfo } from '@mastra/core/mcp';
 import type { InternalMastraMCPClient } from './client.js';
-type ToolListResult = {
-    tools: Array<{
-        id?: string;
-        name: string;
-        description?: string;
-        inputSchema: any;
-        outputSchema?: any;
-        toolType?: MCPToolType;
-        _meta?: Record<string, unknown>;
-    }>;
+type ToolInfo = {
+    id: string;
+    name: string;
+    description?: string;
+    inputSchema: unknown;
+    outputSchema?: unknown;
+    toolType?: MCPToolType;
+    _meta?: Record<string, unknown>;
 };
 /**
- * A lightweight proxy that wraps a single MCPClient server connection as an
- * MCPServerBase instance.  This allows external (non-Mastra) MCP servers
- * connected through MCPClient to be registered in Mastra's `mcpServers`
- * config and appear in Studio alongside native MCPServer instances.
+ * Wraps a single MCPClient server connection as an `MCPServerBase` so external
+ * (non-Mastra) MCP servers connected through MCPClient can be registered in Mastra's
+ * `mcpServers` config and appear in Studio alongside local MCPServer instances.
  *
- * Tool and resource operations are delegated lazily to the underlying
- * InternalMastraMCPClient connection.
+ * Tool and resource operations are delegated lazily to the underlying connection.
+ * The proxy has no transport of its own: it is not served over stdio or HTTP.
  */
 export declare class MCPClientServerProxy extends MCPServerBase {
+    readonly mcpVersion: 2;
     private clientGetter;
     private cachedClient;
-    private _cachedToolList;
+    private cachedToolList;
     constructor(config: {
         name: string;
         version?: string;
         id?: string;
         description?: string;
     }, clientGetter: () => Promise<InternalMastraMCPClient>);
+    /** The remote catalogue is fetched lazily; nothing is converted locally. */
+    convertTools(_tools: ToolsInput): {};
     private getClient;
     private convertSchema;
     private fetchToolList;
-    convertTools(_tools: ToolsInput, _agents?: MCPServerConfig['agents'], _workflows?: MCPServerConfig['workflows']): Record<string, any>;
-    /**
-     * Returns the cached tool list synchronously, or triggers an async fetch.
-     * The Studio API handlers are async and will auto-await a returned Promise.
-     */
-    getToolListInfo(): ToolListResult | Promise<ToolListResult>;
-    getToolInfo(toolId: string): {
-        name: string;
-        description?: string;
-        inputSchema: any;
-        outputSchema?: any;
-        toolType?: MCPToolType;
-        _meta?: Record<string, unknown>;
-    } | undefined | Promise<{
-        name: string;
-        description?: string;
-        inputSchema: any;
-        outputSchema?: any;
-        toolType?: MCPToolType;
-        _meta?: Record<string, unknown>;
-    } | undefined>;
-    executeTool(toolId: string, args: any, _executionContext?: {
-        messages?: any[];
-        toolCallId?: string;
-    }): Promise<any>;
+    getToolListInfo(): {
+        tools: ToolInfo[];
+    } | Promise<{
+        tools: ToolInfo[];
+    }>;
+    getToolInfo(toolId: string): ToolInfo | undefined | Promise<ToolInfo | undefined>;
+    executeTool(toolId: string, input: unknown, context?: Parameters<MCPServerBase['executeTool']>[2]): Promise<MCPToolExecutionResultV2>;
     listResources(): Promise<{
         resources: Array<{
             uri: string;
@@ -77,9 +59,7 @@ export declare class MCPClientServerProxy extends MCPServerBase {
         }>;
     }>;
     startStdio(): Promise<void>;
-    startSSE(_options: MCPServerSSEOptions): Promise<void>;
-    startHonoSSE(_options: MCPServerHonoSSEOptions): Promise<Response | undefined>;
-    startHTTP(_options: MCPServerHTTPOptions): Promise<void>;
+    startHTTP(): Promise<void>;
     close(): Promise<void>;
     getServerInfo(): ServerInfo;
     getServerDetail(): ServerDetailInfo;

package/dist/client/server-proxy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"server-proxy.d.ts","sourceRoot":"","sources":["../../src/client/server-proxy.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"server-proxy.d.ts","sourceRoot":"","sources":["../../src/client/server-proxy.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,KAAK,EAAE,wBAAwB,EAAE,WAAW,EAAE,gBAAgB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAI5G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,UAAU,CAAC;AAExD,KAAK,QAAQ,GAAG;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,OAAO,CAAC;IACrB,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC,CAAC;AAEF;;;;;;;GAOG;AACH,qBAAa,oBAAqB,SAAQ,aAAa;IACrD,SAAkB,UAAU,EAAG,CAAC,CAAU;IAC1C,OAAO,CAAC,YAAY,CAAyC;IAC7D,OAAO,CAAC,YAAY,CAAwC;IAC5D,OAAO,CAAC,cAAc,CAAsC;IAE5D,YACE,MAAM,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAC;QAAC,WAAW,CAAC,EAAE,MAAM,CAAA;KAAE,EAC7E,YAAY,EAAE,MAAM,OAAO,CAAC,uBAAuB,CAAC,EAUrD;IAED,4EAA4E;IAC5E,YAAY,CAAC,MAAM,EAAE,UAAU,MAE9B;YAEa,SAAS;IAOvB,OAAO,CAAC,aAAa;YAOP,aAAa;IAkBpB,eAAe,IAAI;QAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,QAAQ,EAAE,CAAA;KAAE,CAAC,CAG/E;IAEM,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC,QAAQ,GAAG,SAAS,CAAC,CAIvF;IAEY,WAAW,CACtB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,OAAO,EACd,OAAO,GAAE,UAAU,CAAC,aAAa,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAM,GACxD,OAAO,CAAC,wBAAwB,CAAC,CAYnC;IAEY,aAAa,IAAI,OAAO,CAAC;QACpC,SAAS,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,WAAW,CAAC,EAAE,MAAM,CAAC;YAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;YAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;SAAE,CAAC,CAAC;KAC3H,CAAC,CAYD;IAEY,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC;YAAE,GAAG,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAC;YAAC,IAAI,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC,CAAA;KAAE,CAAC,CAUlH;IAEY,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAEvC;IAEY,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC,CAEtC;IAEY,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAGlC;IAEM,aAAa,IAAI,UAAU,CAWjC;IAEM,eAAe,IAAI,gBAAgB,CAMzC;CACF"}

package/dist/client/types.d.ts

@@ -1,8 +1,24 @@
 import type { IOType } from 'node:child_process';
 import type { RequestContext } from '@mastra/core/di';
-import type { SSEClientTransportOptions, StreamableHTTPClientTransportOptions, ClientCapabilities, ElicitRequest, ElicitResult, LoggingLevel, ProgressNotification, ToolAnnotations, jsonSchemaValidator } from '@modelcontextprotocol/client';
+import type { StreamableHTTPClientTransportOptions, ClientCapabilities, ElicitRequestParams, ElicitResult, LoggingLevel, ProgressNotification, ToolAnnotations, jsonSchemaValidator } from '@modelcontextprotocol/client';
+import type { MCPTraceContext } from '../shared/trace-context.js';
 export type { FetchLike } from '@modelcontextprotocol/client';
 export type { ToolAnnotations } from '@modelcontextprotocol/client';
+export type { LoggingLevel } from '@modelcontextprotocol/client';
+/** The current protocol revision; the one `/mcp` servers speak. */
+export declare const MCP_CLIENT_PROTOCOL_VERSION: '2026-07-28';
+/**
+ * Which protocol revision to speak to a server.
+ *
+ * - `'2026-07-28'`: the current revision only. No probe, no fallback; a server
+ *   that does not offer it fails to connect.
+ * - `'legacy'`: the pre-2026 `initialize` handshake only. Use it for servers known
+ *   not to have upgraded, to skip the probe.
+ *
+ * When omitted the client probes with `server/discover` and speaks whichever
+ * revision the server offers.
+ */
+export type MCPClientProtocolVersion = typeof MCP_CLIENT_PROTOCOL_VERSION | 'legacy';
 /**
  * Extended fetch function type that receives the current request context as a third argument.
  *
@@ -32,7 +48,6 @@ export type { ToolAnnotations } from '@modelcontextprotocol/client';
  * ```
  */
 export type MastraFetchLike = (url: string | URL, init?: RequestInit, requestContext?: RequestContext | null) => Promise<Response>;
-export type { LoggingLevel } from '@modelcontextprotocol/client';
 /**
  * Log message structure for MCP client logging.
  */
@@ -53,13 +68,6 @@ export interface LogMessage {
  * Handler function for processing log messages from MCP servers.
  */
 export type LogHandler = (logMessage: LogMessage) => void;
-/**
- * Handler function for processing elicitation requests from MCP servers.
- *
- * @param request - The elicitation request parameters including message and schema
- * @returns Promise resolving to the user's response (accept/decline/cancel with optional content)
- */
-export type ElicitationHandler = (request: ElicitRequest['params']) => Promise<ElicitResult>;
 /**
  * Handler function for processing progress notifications from MCP servers.
  *
@@ -67,26 +75,37 @@ export type ElicitationHandler = (request: ElicitRequest['params']) => Promise<E
  */
 export type ProgressHandler = (params: ProgressNotification['params']) => void;
 /**
- * Represents a filesystem root that the client exposes to MCP servers.
- *
- * Per MCP spec (https://modelcontextprotocol.io/specification/2025-11-25/client/roots):
- * Roots define the boundaries of where servers can operate within the filesystem,
- * allowing them to understand which directories and files they have access to.
+ * One keyed input request embedded in an `input_required` result.
  *
- * @example
- * ```typescript
- * const root: Root = {
- *   uri: 'file:///home/user/projects/myproject',
- *   name: 'My Project'
- * };
- * ```
+ * Servers on the 2026-07-28 revision obtain user input by answering `tools/call`,
+ * `resources/read`, or `prompts/get` with `input_required` instead of pushing a request
+ * to the client. Every embedded request carries the server-chosen `key` it must be
+ * answered under; the client retries the originating call with the collected responses.
  */
-export interface Root {
-    /** Unique identifier for the root. Must be a file:// URI. */
-    uri: string;
-    /** Optional human-readable name for display purposes. */
-    name?: string;
+export interface MCPInputRequest {
+    /** Server-chosen key this response is filed under for the retry. */
+    key: string;
+    /** Elicitation parameters: form mode (`requestedSchema`) or url mode (`url`). */
+    params: ElicitRequestParams;
+    /** Aborted when the originating call is cancelled or times out. */
+    signal: AbortSignal;
 }
+/**
+ * Supplies the response for one embedded input request.
+ *
+ * Return `{ action: 'accept', content }` with content matching `params.requestedSchema`,
+ * or `{ action: 'decline' }` / `{ action: 'cancel' }`. The handler is called once per
+ * request per round; earlier rounds' responses are never re-sent.
+ */
+export type MCPInputRequestHandler = (request: MCPInputRequest) => Promise<ElicitResult>;
+/**
+ * Client capabilities a Mastra MCP client may advertise.
+ *
+ * `elicitation` is only accepted together with an `inputRequests` handler; it defaults to
+ * form support when a handler is configured. The deprecated roots and sampling
+ * capabilities are not supported.
+ */
+export type MCPClientCapabilities = Pick<ClientCapabilities, 'elicitation' | 'extensions'>;
 /**
  * Context passed to `requireToolApproval` when it's a function.
  * Provides information about the tool call and the current execution environment.
@@ -116,8 +135,6 @@ export interface RequireToolApprovalContext {
      * This field is `undefined` (not auto-defaulted) when the server omits
      * annotations entirely, so policies can distinguish "no annotations" from
      * "annotated as safe".
-     *
-     * @see https://modelcontextprotocol.io/specification/2025-11-25/server/tools#tool-annotations
      */
     annotations?: ToolAnnotations;
 }
@@ -140,16 +157,45 @@ export type RequireToolApproval = boolean | RequireToolApprovalFn;
 export type BaseServerOptions = {
     /** Optional handler for server log messages */
     logger?: LogHandler;
+    /**
+     * Pin the protocol revision instead of probing for it. See {@link MCPClientProtocolVersion}.
+     *
+     * Features the pre-2026 revisions lack (`subscriptions/listen`, embedded input
+     * requests) fail with an error naming the negotiated revision when the server
+     * turned out to be legacy.
+     */
+    protocolVersion?: MCPClientProtocolVersion;
     /** Optional timeout in milliseconds for server operations */
     timeout?: number;
     /** Optional client capabilities to advertise to the server */
-    capabilities?: ClientCapabilities;
-    /** Whether to enable server log forwarding (default: true) */
+    capabilities?: MCPClientCapabilities;
+    /**
+     * Whether to opt into per-request server logs (default: true).
+     *
+     * 2026-07-28 servers only emit `notifications/message` for requests that carry the
+     * `io.modelcontextprotocol/logLevel` metadata key; this option attaches it to every
+     * request and forwards delivered messages to `logger`.
+     */
     enableServerLogs?: boolean;
+    /**
+     * Minimum severity requested from the server for per-request logs.
+     *
+     * @default 'info'
+     */
+    serverLogLevel?: LoggingLevel;
     /** Whether to enable progress tracking (default: false) */
     enableProgressTracking?: boolean;
     /**
-     * Whether instructions returned by this MCP server during initialization should
+     * Returns the W3C `traceparent`, `tracestate` and `baggage` values to attach
+     * to each outgoing MCP request's `_meta`.
+     *
+     * The provider is called when the request is sent so consumers can read from
+     * their own request-local trace carrier without coupling MCP to a tracing SDK.
+     * Explicit `_meta` keys supplied for a tool call take precedence.
+     */
+    traceContext?: () => MCPTraceContext | undefined;
+    /**
+     * Whether instructions returned by this MCP server during discovery should
      * be forwarded to agents that use the server's tools.
      *
      * Disabled by default: forwarded instructions are injected into the agent's
@@ -206,8 +252,8 @@ export type BaseServerOptions = {
      *   by throwing a `MastraError` that carries the server's `content` text. Tool
      *   spans, stream chunks, scorers, and persisted message parts then reflect the
      *   failure, and the model sees the error text so it can self-correct.
-     * - `'return'`: preserve the legacy behaviour and resolve successfully with the
-     *   raw result (or `structuredContent`), ignoring `isError`.
+     * - `'return'`: resolve successfully with the raw result (or `structuredContent`),
+     *   ignoring `isError`.
      *
      * @default 'throw'
      */
@@ -221,74 +267,28 @@ export type BaseServerOptions = {
      * Cloudflare Workers / V8 isolates: the default `AjvJsonSchemaValidator`
      * compiles validators with `new Function(...)`, which workerd refuses to
      * evaluate when a tool advertises an `outputSchema`.
-     *
-     * @example
-     * ```typescript
-     * import { CfWorkerJsonSchemaValidator } from '@modelcontextprotocol/client/validators/cf-worker';
-     *
-     * const mcp = new MCPClient({
-     *   servers: {
-     *     upstream: {
-     *       url: new URL('https://example/mcp'),
-     *       jsonSchemaValidator: new CfWorkerJsonSchemaValidator(),
-     *     },
-     *   },
-     * });
-     * ```
      */
     jsonSchemaValidator?: jsonSchemaValidator;
     /**
-     * List of filesystem roots to expose to the MCP server.
-     *
-     * Per MCP spec (https://modelcontextprotocol.io/specification/2025-11-25/client/roots):
-     * Roots define the boundaries of where servers can operate within the filesystem.
+     * Answers embedded input requests (`input_required` results) from this server.
      *
-     * When configured, the client will:
-     * 1. Automatically advertise the `roots` capability to the server
-     * 2. Respond to `roots/list` requests with these roots
-     * 3. Send `notifications/roots/list_changed` when roots are updated via `setRoots()`
+     * Configuring a handler advertises form elicitation support; widen it with
+     * `capabilities.elicitation` to accept url-mode requests too. Without a handler
+     * an `input_required` result is surfaced as a typed error.
      *
      * @example
      * ```typescript
      * {
-     *   command: 'npx',
-     *   args: ['-y', '@modelcontextprotocol/server-filesystem', '/tmp'],
-     *   roots: [
-     *     { uri: 'file:///tmp', name: 'Temp Directory' }
-     *   ]
-     * }
-     * ```
-     */
-    roots?: Root[];
-    /**
-     * Opt-in MCP protocol version negotiation.
-     *
-     * - Omitted (default): the plain legacy (2025-era) connect sequence,
-     *   byte-identical to a client without this option.
-     * - `'auto'`: probe the server with `server/discover` at connect time and use
-     *   the stateless `2026-07-28` revision when the server supports it, with a
-     *   conservative fallback to the legacy `initialize` handshake.
-     * - `'2026-07-28'`: pin to that revision exactly. Connecting to a server that
-     *   does not offer it fails loudly with a typed error — no fallback.
-     *
-     * Elicitation handlers work on both eras: on a negotiated `2026-07-28`
-     * connection, embedded elicitation requests from `input_required` results are
-     * dispatched through the same registered handler and the originating call is
-     * retried automatically.
-     *
-     * @example
-     * ```typescript
-     * const mcp = new MCPClient({
-     *   servers: {
-     *     weather: {
-     *       url: new URL('https://example/mcp'),
-     *       protocolVersion: 'auto',
-     *     },
+     *   url: new URL('https://example/mcp'),
+     *   inputRequests: async ({ key, params }) => {
+     *     if (params.mode === 'url') return { action: 'decline' };
+     *     const content = await promptUser(key, params.requestedSchema);
+     *     return { action: 'accept', content };
      *   },
-     * });
+     * }
      * ```
      */
-    protocolVersion?: 'auto' | '2026-07-28';
+    inputRequests?: MCPInputRequestHandler;
 };
 /**
  * Configuration for MCP servers using stdio (subprocess) transport.
@@ -335,22 +335,16 @@ export type StdioServerDefinition = BaseServerOptions & {
     cwd?: string;
     url?: never;
     requestInit?: never;
-    eventSourceInit?: never;
     authProvider?: never;
-    reconnectionOptions?: never;
-    sessionId?: never;
     connectTimeout?: never;
     fetch?: never;
     allowedHosts?: never;
 };
 /**
- * Configuration for MCP servers using HTTP-based transport (Streamable HTTP or SSE fallback).
- *
- * Used when connecting to remote MCP servers over HTTP. The client will attempt Streamable HTTP
- * transport first and fall back to SSE if that fails.
+ * Configuration for MCP servers using the Streamable HTTP transport.
  *
- * When `fetch` is provided, all other HTTP-related options (`requestInit`, `eventSourceInit`, `authProvider`)
- * become optional, as the custom fetch function can handle authentication and request customization.
+ * When `fetch` is provided, `requestInit` and `authProvider` become optional, as the custom
+ * fetch function can handle authentication and request customization.
  */
 export type HttpServerDefinition = BaseServerOptions & {
     /** URL of the MCP server endpoint */
@@ -372,10 +366,7 @@ export type HttpServerDefinition = BaseServerOptions & {
      *
      * The third `requestContext` parameter provides access to request-scoped data set by middleware
      * or passed during agent/tool execution. It is `null` when no context is available (e.g.,
-     * during the initial connection handshake).
-     *
-     * When `fetch` is provided, `requestInit`, `eventSourceInit`, and `authProvider` become optional,
-     * as you can handle these concerns within your custom fetch function.
+     * during the initial connection).
      *
      * @example
      * ```typescript
@@ -398,10 +389,9 @@ export type HttpServerDefinition = BaseServerOptions & {
      * Optional allowlist of hosts this server's HTTP requests may target.
      *
      * When set, every outgoing request made on behalf of this server (initial
-     * connect, Streamable HTTP POSTs, the SSE fallback and its event stream,
-     * OAuth discovery/token requests routed through the transport fetch, and
-     * every redirect hop) is checked against this list. When unset, no
-     * restriction applies (current behavior).
+     * connect, Streamable HTTP POSTs, OAuth discovery/token requests routed
+     * through the transport fetch, and every redirect hop) is checked against
+     * this list. When unset, no restriction applies.
      *
      * Matching semantics:
      * - Entries are host values matched against `URL.host` — the hostname plus
@@ -420,13 +410,12 @@ export type HttpServerDefinition = BaseServerOptions & {
      * - On the default path (no custom `fetch`), requests to disallowed hosts —
      *   including redirect hops, via manual redirect following — are blocked
      *   BEFORE being sent.
-     * - When a custom `fetch` (or a caller-supplied `eventSourceInit.fetch`) is
-     *   in play, the initial URL is checked before the request, but redirect
-     *   hops are validated post-hoc via `response.url`: the outbound hop may
-     *   occur, but the response never reaches the caller or the model. A
-     *   hand-built `Response` with an empty `response.url` skips the post-hoc
-     *   check (documented limitation — custom fetches legitimately construct
-     *   such responses).
+     * - When a custom `fetch` is in play, the initial URL is checked before the
+     *   request, but redirect hops are validated post-hoc via `response.url`:
+     *   the outbound hop may occur, but the response never reaches the caller
+     *   or the model. A hand-built `Response` with an empty `response.url` skips
+     *   the post-hoc check (documented limitation — custom fetches legitimately
+     *   construct such responses).
      *
      * OAuth note: the SDK routes OAuth discovery and token requests through the
      * transport's fetch, so when using an `authProvider` whose authorization
@@ -435,18 +424,9 @@ export type HttpServerDefinition = BaseServerOptions & {
     allowedHosts?: string[];
     /** Optional request configuration for HTTP requests (optional when `fetch` is provided) */
     requestInit?: StreamableHTTPClientTransportOptions['requestInit'];
-    /** Optional configuration for SSE fallback (required when using custom headers with SSE, optional when `fetch` is provided) */
-    eventSourceInit?: SSEClientTransportOptions['eventSourceInit'];
     /** Optional authentication provider for HTTP requests (optional when `fetch` is provided) */
     authProvider?: StreamableHTTPClientTransportOptions['authProvider'];
-    /** Optional reconnection configuration for Streamable HTTP */
-    reconnectionOptions?: StreamableHTTPClientTransportOptions['reconnectionOptions'];
-    /** Optional session ID for Streamable HTTP */
-    sessionId?: StreamableHTTPClientTransportOptions['sessionId'];
-    /** Optional timeout in milliseconds for the connection phase (default: 3000ms).
-     * This timeout allows the system to switch MCP streaming protocols during the setup phase.
-     * The default is set to 3s because the long default timeout would be extremely slow for SSE backwards compat (60s).
-     */
+    /** Optional timeout in milliseconds for the connection phase (default: 3000ms). */
     connectTimeout?: number;
 };
 /**
@@ -471,21 +451,6 @@ export type HttpServerDefinition = BaseServerOptions & {
  *     headers: { Authorization: 'Bearer token' }
  *   }
  * };
- *
- * // HTTP server with custom fetch for dynamic auth
- * const httpServerWithFetch: MastraMCPServerDefinition = {
- *   url: new URL('http://localhost:8080/mcp'),
- *   fetch: async (url, init) => {
- *     const token = await getAuthToken(); // Refresh token on each request
- *     return fetch(url, {
- *       ...init,
- *       headers: {
- *         ...init?.headers,
- *         Authorization: `Bearer ${token}`,
- *       },
- *     });
- *   },
- * };
  * ```
  */
 export type MastraMCPServerDefinition = StdioServerDefinition | HttpServerDefinition;
@@ -499,8 +464,6 @@ export type InternalMastraMCPClientOptions = {
     name: string;
     /** Server connection configuration */
     server: MastraMCPServerDefinition;
-    /** Optional client capabilities to advertise to the server */
-    capabilities?: ClientCapabilities;
     /** Optional client version */
     version?: string;
     /** Optional timeout in milliseconds */
@@ -540,9 +503,9 @@ export type SerializableMCPToolDefinition = {
     server: {
         /** The name this server is configured under. */
         name: string;
-        /** Server version reported during the MCP handshake, if any. */
+        /** Server version reported during discovery, if any. */
         version?: string;
-        /** Instructions the server returned during initialization, if any. */
+        /** Instructions the server returned during discovery, if any. */
         instructions?: string;
     };
 };

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/conformance/fixture.d.ts

@@ -0,0 +1,3 @@
+import { MCPServer } from '../server/server.js';
+export declare function createConformanceServer(): MCPServer;
+//# sourceMappingURL=fixture.d.ts.map

package/dist/conformance/fixture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fixture.d.ts","sourceRoot":"","sources":["../../src/conformance/fixture.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAE7C,wBAAgB,uBAAuB,cAatC"}

package/dist/conformance/run.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=run.d.ts.map

package/dist/conformance/run.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run.d.ts","sourceRoot":"","sources":["../../src/conformance/run.ts"],"names":[],"mappings":""}

package/dist/conformance/stdio-server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=stdio-server.d.ts.map

package/dist/conformance/stdio-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-server.d.ts","sourceRoot":"","sources":["../../src/conformance/stdio-server.ts"],"names":[],"mappings":""}

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: "1.18.1-alpha.3"
+  version: "2.0.0-alpha.4"
 ---
 
 ## When to use
@@ -23,6 +23,7 @@ Read the individual reference documents for detailed explanations and code examp
 ### Reference
 
 - [Reference: Tool configuration](references/reference-editor-tools.md) - Configure Editor agent tools from Mastra, MCP, workspace, and provider sources, including descriptions, display conditions, and resolution order.
+- [Migration: @mastra/mcp v1 to v2](references/reference-migrations-mcp-v2.md) - @mastra/mcp 2.0 serves the MCP 2026-07-28 revision only: self-contained requests, suspend/resume carried as input_required, subscriptions/listen, per-request logging and pre-registered or URL-based OAuth clients. The client speaks 2026-07-28 and still connects to older servers.
 - [MCP](references/reference-migrations-upgrade-to-v1-mcp.md) - MCP (Model Context Protocol) tool execution context has been reorganized, and deprecated client classes have been removed.
 - [Reference: MCPClient](references/reference-tools-mcp-client.md) - The MCPClient class provides a way to manage multiple MCP server connections and their tools in a Mastra application.
 - [Reference: MCPServer](references/reference-tools-mcp-server.md) - The MCPServer class provides the functionality to expose your existing Mastra tools and Agents as a Model Context Protocol (MCP) server.

package/dist/docs/assets/SOURCE_MAP.json

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