@mastra/mcp 0.10.5-alpha.1 → 0.10.5

package/.turbo/turbo-build.log

@@ -1,23 +1,23 @@
 
-> @mastra/mcp@0.10.5-alpha.1 build /home/runner/work/mastra/mastra/packages/mcp
+> @mastra/mcp@0.10.5-alpha.2 build /home/runner/work/mastra/mastra/packages/mcp
 > tsup src/index.ts --format esm,cjs --experimental-dts --clean --treeshake=smallest --splitting
 
 CLI Building entry: src/index.ts
 CLI Using tsconfig: tsconfig.json
 CLI tsup v8.5.0
 TSC Build start
-TSC ⚡️ Build success in 21967ms
+TSC ⚡️ Build success in 21277ms
 DTS Build start
 CLI Target: es2022
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/packages/mcp/dist/_tsup-dts-rollup.d.ts
 Analysis will use the bundled TypeScript version 5.8.3
 Writing package typings: /home/runner/work/mastra/mastra/packages/mcp/dist/_tsup-dts-rollup.d.cts
-DTS ⚡️ Build success in 31326ms
+DTS ⚡️ Build success in 30216ms
 CLI Cleaning output folder
 ESM Build start
 CJS Build start
-ESM dist/index.js 87.77 KB
-ESM ⚡️ Build success in 1807ms
-CJS dist/index.cjs 88.45 KB
-CJS ⚡️ Build success in 2402ms
+ESM dist/index.js 88.67 KB
+ESM ⚡️ Build success in 2174ms
+CJS dist/index.cjs 89.35 KB
+CJS ⚡️ Build success in 2174ms

package/CHANGELOG.md

@@ -1,5 +1,43 @@
 # @mastra/mcp
 
+## 0.10.5
+
+### Patch Changes
+
+- ee93d96: dependencies updates:
+  - Updated dependency [`@modelcontextprotocol/sdk@^1.12.3` ↗︎](https://www.npmjs.com/package/@modelcontextprotocol/sdk/v/1.12.3) (from `^1.12.1`, in `dependencies`)
+- c00039d: dependencies updates:
+  - Updated dependency [`@modelcontextprotocol/sdk@^1.13.0` ↗︎](https://www.npmjs.com/package/@modelcontextprotocol/sdk/v/1.13.0) (from `^1.12.3`, in `dependencies`)
+- 4d21bf2: throw mastra errors for MCP
+- 07d6d88: Bump MCP SDK version and add tool output schema support to MCPServer and MCPClient
+- dc93062: Add elicitation support to MCPServer and MCPClient. Also fixes connectivity issues between multiple MCPClient instances and an MCPServer.
+- Updated dependencies [15e9d26]
+- Updated dependencies [d1baedb]
+- Updated dependencies [d8f2d19]
+- Updated dependencies [4d21bf2]
+- Updated dependencies [07d6d88]
+- Updated dependencies [9d52b17]
+- Updated dependencies [2097952]
+- Updated dependencies [792c4c0]
+- Updated dependencies [5d74aab]
+- Updated dependencies [a8b194f]
+- Updated dependencies [4fb0cc2]
+- Updated dependencies [d2a7a31]
+- Updated dependencies [502fe05]
+- Updated dependencies [144eb0b]
+- Updated dependencies [8ba1b51]
+- Updated dependencies [4efcfa0]
+- Updated dependencies [0e17048]
+  - @mastra/core@0.10.7
+
+## 0.10.5-alpha.2
+
+### Patch Changes
+
+- dc93062: Add elicitation support to MCPServer and MCPClient. Also fixes connectivity issues between multiple MCPClient instances and an MCPServer.
+- Updated dependencies [a8b194f]
+  - @mastra/core@0.10.7-alpha.4
+
 ## 0.10.5-alpha.1
 
 ### Patch Changes

package/dist/_tsup-dts-rollup.d.cts

@@ -1,9 +1,12 @@
 import type { Agent } from '@mastra/core/agent';
 import type { ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
 import type { ConvertedTool } from '@mastra/core/mcp';
+import type { ElicitRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { ElicitResult } from '@modelcontextprotocol/sdk/types.js';
 import type { GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
 import type * as http from 'node:http';
 import type { IMastraLogger } from '@mastra/core/logger';
+import type { InternalCoreTool } from '@mastra/core';
 import type { ListPromptsResult } from '@modelcontextprotocol/sdk/types.js';
 import { LoggingLevel } from '@modelcontextprotocol/sdk/types.js';
 import { MastraBase } from '@mastra/core/base';
@@ -52,6 +55,34 @@ declare type BaseServerOptions = {
     enableServerLogs?: boolean;
 };
 
+declare type ElicitationActions = {
+    sendRequest: (request: ElicitRequest['params']) => Promise<ElicitResult>;
+};
+export { ElicitationActions }
+export { ElicitationActions as ElicitationActions_alias_1 }
+export { ElicitationActions as ElicitationActions_alias_2 }
+
+export declare class ElicitationClientActions {
+    private readonly client;
+    private readonly logger;
+    constructor({ client, logger }: ElicitationClientActionsConfig);
+    /**
+     * Set a handler for elicitation requests.
+     * @param handler The callback function to handle the elicitation request.
+     */
+    onRequest(handler: (request: ElicitRequest['params']) => Promise<ElicitResult>): void;
+}
+
+declare interface ElicitationClientActionsConfig {
+    client: InternalMastraMCPClient;
+    logger: IMastraLogger;
+}
+
+declare type ElicitationHandler = (request: ElicitRequest['params']) => Promise<ElicitResult>;
+export { ElicitationHandler }
+export { ElicitationHandler as ElicitationHandler_alias_1 }
+export { ElicitationHandler as ElicitationHandler_alias_2 }
+
 declare type HttpServerDefinition = BaseServerOptions & {
     url: URL;
     command?: never;
@@ -74,6 +105,7 @@ export declare class InternalMastraMCPClient extends MastraBase {
     private currentOperationContext;
     readonly resources: ResourceClientActions;
     readonly prompts: PromptClientActions;
+    readonly elicitation: ElicitationClientActions;
     constructor({ name, version, server, capabilities, timeout, }: InternalMastraMCPClientOptions);
     /**
      * Log a message at the specified level
@@ -220,6 +252,7 @@ export declare class InternalMastraMCPClient extends MastraBase {
     setPromptListChangedNotificationHandler(handler: () => void): void;
     setResourceUpdatedNotificationHandler(handler: (params: z.infer<typeof ResourceUpdatedNotificationSchema>['params']) => void): void;
     setResourceListChangedNotificationHandler(handler: () => void): void;
+    setElicitationRequestHandler(handler: ElicitationHandler): void;
     private convertInputSchema;
     private convertOutputSchema;
     tools(): Promise<Record<string, any>>;
@@ -276,6 +309,9 @@ declare class MCPClient extends MastraBase {
     private mcpClientsById;
     private disconnectPromise;
     constructor(args: MCPClientOptions);
+    get elicitation(): {
+        onRequest: (serverName: string, handler: (request: ElicitRequest["params"]) => Promise<ElicitResult>) => Promise<void>;
+    };
     get resources(): {
         list: () => Promise<Record<string, Resource[]>>;
         templates: () => Promise<Record<string, ResourceTemplate[]>>;
@@ -338,7 +374,6 @@ declare class MCPClient extends MastraBase {
             [x: string]: unknown;
             messages: {
                 [x: string]: unknown;
-                role: "user" | "assistant";
                 content: {
                     [x: string]: unknown;
                     type: "text";
@@ -364,14 +399,14 @@ declare class MCPClient extends MastraBase {
                     } | undefined;
                 } | {
                     [x: string]: unknown;
-                    name: string;
                     type: "resource_link";
+                    name: string;
                     uri: string;
-                    title?: string | undefined;
-                    description?: string | undefined;
                     _meta?: {
                         [x: string]: unknown;
                     } | undefined;
+                    title?: string | undefined;
+                    description?: string | undefined;
                     mimeType?: string | undefined;
                 } | {
                     [x: string]: unknown;
@@ -397,11 +432,12 @@ declare class MCPClient extends MastraBase {
                         [x: string]: unknown;
                     } | undefined;
                 };
+                role: "user" | "assistant";
             }[];
-            description?: string | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
+            description?: string | undefined;
         }>;
         onListChanged: (serverName: string, handler: () => void) => Promise<void>;
     };
@@ -417,11 +453,11 @@ declare class MCPClient extends MastraBase {
         [x: string]: unknown;
         name: string;
         uri: string;
-        title?: string | undefined;
-        description?: string | undefined;
         _meta?: {
             [x: string]: unknown;
         } | undefined;
+        title?: string | undefined;
+        description?: string | undefined;
         mimeType?: string | undefined;
     }[]>>;
     /**
@@ -474,15 +510,7 @@ declare class MCPServer extends MCPServerBase {
     private sseTransport?;
     private sseHonoTransports;
     private streamableHTTPTransports;
-    private listToolsHandlerIsRegistered;
-    private callToolHandlerIsRegistered;
-    private listResourcesHandlerIsRegistered;
-    private readResourceHandlerIsRegistered;
-    private listResourceTemplatesHandlerIsRegistered;
-    private subscribeResourceHandlerIsRegistered;
-    private unsubscribeResourceHandlerIsRegistered;
-    private listPromptsHandlerIsRegistered;
-    private getPromptHandlerIsRegistered;
+    private httpServerInstances;
     private definedResources?;
     private definedResourceTemplates?;
     private resourceOptions?;
@@ -491,6 +519,7 @@ declare class MCPServer extends MCPServerBase {
     private subscriptions;
     readonly resources: ServerResourceActions;
     readonly prompts: ServerPromptActions;
+    readonly elicitation: ElicitationActions;
     /**
      * Get the current stdio transport.
      */
@@ -515,53 +544,44 @@ declare class MCPServer extends MCPServerBase {
         resources?: MCPServerResources;
         prompts?: MCPServerPrompts;
     });
-    private convertAgentsToTools;
-    private convertWorkflowsToTools;
-    /**
-     * Convert and validate all provided tools, logging registration status.
-     * Also converts agents and workflows into tools.
-     * @param tools Tool definitions
-     * @param agentsConfig Agent definitions to be converted to tools, expected from MCPServerConfig
-     * @param workflowsConfig Workflow definitions to be converted to tools, expected from MCPServerConfig
-     * @returns Converted tools registry
-     */
-    convertTools(tools: ToolsInput, agentsConfig?: Record<string, Agent>, workflowsConfig?: Record<string, Workflow>): Record<string, ConvertedTool>;
-    /**
-     * Register the ListTools handler for listing all available tools.
-     */
-    private registerListToolsHandler;
-    /**
-     * Register the CallTool handler for executing a tool by name.
-     */
-    private registerCallToolHandler;
     /**
-     * Register the ListResources handler for listing all available resources.
-     */
-    private registerListResourcesHandler;
-    /**
-     * Register the ReadResource handler for reading a resource by URI.
+     * Handle an elicitation request by sending it to the connected client.
+     * This method sends an elicitation/create request to the client and waits for the response.
+     *
+     * @param request - The elicitation request containing message and schema
+     * @param serverInstance - Optional server instance to use; defaults to main server for backward compatibility
+     * @returns Promise that resolves to the client's response
      */
-    private registerReadResourceHandler;
+    private handleElicitationRequest;
     /**
-     * Register the ListResourceTemplates handler.
+     * Creates a new Server instance configured with all handlers for HTTP sessions.
+     * Each HTTP client connection gets its own Server instance to avoid routing conflicts.
      */
-    private registerListResourceTemplatesHandler;
+    private createServerInstance;
     /**
-     * Register the SubscribeResource handler.
+     * Registers all MCP handlers on a given server instance.
+     * This allows us to create multiple server instances with identical functionality.
      */
-    private registerSubscribeResourceHandler;
+    private registerHandlersOnServer;
     /**
-     * Register the UnsubscribeResource handler.
+     * Registers resource-related handlers on a server instance.
      */
-    private registerUnsubscribeResourceHandler;
+    private registerResourceHandlersOnServer;
     /**
-     * Register the ListPrompts handler.
+     * Registers prompt-related handlers on a server instance.
      */
-    private registerListPromptsHandler;
+    private registerPromptHandlersOnServer;
+    private convertAgentsToTools;
+    private convertWorkflowsToTools;
     /**
-     * Register the GetPrompt handler.
+     * Convert and validate all provided tools, logging registration status.
+     * Also converts agents and workflows into tools.
+     * @param tools Tool definitions
+     * @param agentsConfig Agent definitions to be converted to tools, expected from MCPServerConfig
+     * @param workflowsConfig Workflow definitions to be converted to tools, expected from MCPServerConfig
+     * @returns Converted tools registry
      */
-    private registerGetPromptHandler;
+    convertTools(tools: ToolsInput, agentsConfig?: Record<string, Agent>, workflowsConfig?: Record<string, Workflow>): Record<string, ConvertedTool>;
     /**
      * Start the MCP server using stdio transport (for Windsurf integration).
      */
@@ -713,6 +733,19 @@ export { MCPServerResources }
 export { MCPServerResources as MCPServerResources_alias_1 }
 export { MCPServerResources as MCPServerResources_alias_2 }
 
+declare type MCPTool = {
+    id?: InternalCoreTool['id'];
+    description?: InternalCoreTool['description'];
+    parameters: InternalCoreTool['parameters'];
+    outputSchema?: InternalCoreTool['outputSchema'];
+    execute: (params: any, options: Parameters<NonNullable<InternalCoreTool['execute']>>[1] & {
+        elicitation: ElicitationActions;
+    }) => Promise<any>;
+};
+export { MCPTool }
+export { MCPTool as MCPTool_alias_1 }
+export { MCPTool as MCPTool_alias_2 }
+
 /**
  * Client-side prompt actions for listing, getting, and subscribing to prompt changes.
  */

package/dist/_tsup-dts-rollup.d.ts

@@ -1,9 +1,12 @@
 import type { Agent } from '@mastra/core/agent';
 import type { ClientCapabilities } from '@modelcontextprotocol/sdk/types.js';
 import type { ConvertedTool } from '@mastra/core/mcp';
+import type { ElicitRequest } from '@modelcontextprotocol/sdk/types.js';
+import type { ElicitResult } from '@modelcontextprotocol/sdk/types.js';
 import type { GetPromptResult } from '@modelcontextprotocol/sdk/types.js';
 import type * as http from 'node:http';
 import type { IMastraLogger } from '@mastra/core/logger';
+import type { InternalCoreTool } from '@mastra/core';
 import type { ListPromptsResult } from '@modelcontextprotocol/sdk/types.js';
 import { LoggingLevel } from '@modelcontextprotocol/sdk/types.js';
 import { MastraBase } from '@mastra/core/base';
@@ -52,6 +55,34 @@ declare type BaseServerOptions = {
     enableServerLogs?: boolean;
 };
 
+declare type ElicitationActions = {
+    sendRequest: (request: ElicitRequest['params']) => Promise<ElicitResult>;
+};
+export { ElicitationActions }
+export { ElicitationActions as ElicitationActions_alias_1 }
+export { ElicitationActions as ElicitationActions_alias_2 }
+
+export declare class ElicitationClientActions {
+    private readonly client;
+    private readonly logger;
+    constructor({ client, logger }: ElicitationClientActionsConfig);
+    /**
+     * Set a handler for elicitation requests.
+     * @param handler The callback function to handle the elicitation request.
+     */
+    onRequest(handler: (request: ElicitRequest['params']) => Promise<ElicitResult>): void;
+}
+
+declare interface ElicitationClientActionsConfig {
+    client: InternalMastraMCPClient;
+    logger: IMastraLogger;
+}
+
+declare type ElicitationHandler = (request: ElicitRequest['params']) => Promise<ElicitResult>;
+export { ElicitationHandler }
+export { ElicitationHandler as ElicitationHandler_alias_1 }
+export { ElicitationHandler as ElicitationHandler_alias_2 }
+
 declare type HttpServerDefinition = BaseServerOptions & {
     url: URL;
     command?: never;
@@ -74,6 +105,7 @@ export declare class InternalMastraMCPClient extends MastraBase {
     private currentOperationContext;
     readonly resources: ResourceClientActions;
     readonly prompts: PromptClientActions;
+    readonly elicitation: ElicitationClientActions;
     constructor({ name, version, server, capabilities, timeout, }: InternalMastraMCPClientOptions);
     /**
      * Log a message at the specified level
@@ -220,6 +252,7 @@ export declare class InternalMastraMCPClient extends MastraBase {
     setPromptListChangedNotificationHandler(handler: () => void): void;
     setResourceUpdatedNotificationHandler(handler: (params: z.infer<typeof ResourceUpdatedNotificationSchema>['params']) => void): void;
     setResourceListChangedNotificationHandler(handler: () => void): void;
+    setElicitationRequestHandler(handler: ElicitationHandler): void;
     private convertInputSchema;
     private convertOutputSchema;
     tools(): Promise<Record<string, any>>;
@@ -276,6 +309,9 @@ declare class MCPClient extends MastraBase {
     private mcpClientsById;
     private disconnectPromise;
     constructor(args: MCPClientOptions);
+    get elicitation(): {
+        onRequest: (serverName: string, handler: (request: ElicitRequest["params"]) => Promise<ElicitResult>) => Promise<void>;
+    };
     get resources(): {
         list: () => Promise<Record<string, Resource[]>>;
         templates: () => Promise<Record<string, ResourceTemplate[]>>;
@@ -338,7 +374,6 @@ declare class MCPClient extends MastraBase {
             [x: string]: unknown;
             messages: {
                 [x: string]: unknown;
-                role: "user" | "assistant";
                 content: {
                     [x: string]: unknown;
                     type: "text";
@@ -364,14 +399,14 @@ declare class MCPClient extends MastraBase {
                     } | undefined;
                 } | {
                     [x: string]: unknown;
-                    name: string;
                     type: "resource_link";
+                    name: string;
                     uri: string;
-                    title?: string | undefined;
-                    description?: string | undefined;
                     _meta?: {
                         [x: string]: unknown;
                     } | undefined;
+                    title?: string | undefined;
+                    description?: string | undefined;
                     mimeType?: string | undefined;
                 } | {
                     [x: string]: unknown;
@@ -397,11 +432,12 @@ declare class MCPClient extends MastraBase {
                         [x: string]: unknown;
                     } | undefined;
                 };
+                role: "user" | "assistant";
             }[];
-            description?: string | undefined;
             _meta?: {
                 [x: string]: unknown;
             } | undefined;
+            description?: string | undefined;
         }>;
         onListChanged: (serverName: string, handler: () => void) => Promise<void>;
     };
@@ -417,11 +453,11 @@ declare class MCPClient extends MastraBase {
         [x: string]: unknown;
         name: string;
         uri: string;
-        title?: string | undefined;
-        description?: string | undefined;
         _meta?: {
             [x: string]: unknown;
         } | undefined;
+        title?: string | undefined;
+        description?: string | undefined;
         mimeType?: string | undefined;
     }[]>>;
     /**
@@ -474,15 +510,7 @@ declare class MCPServer extends MCPServerBase {
     private sseTransport?;
     private sseHonoTransports;
     private streamableHTTPTransports;
-    private listToolsHandlerIsRegistered;
-    private callToolHandlerIsRegistered;
-    private listResourcesHandlerIsRegistered;
-    private readResourceHandlerIsRegistered;
-    private listResourceTemplatesHandlerIsRegistered;
-    private subscribeResourceHandlerIsRegistered;
-    private unsubscribeResourceHandlerIsRegistered;
-    private listPromptsHandlerIsRegistered;
-    private getPromptHandlerIsRegistered;
+    private httpServerInstances;
     private definedResources?;
     private definedResourceTemplates?;
     private resourceOptions?;
@@ -491,6 +519,7 @@ declare class MCPServer extends MCPServerBase {
     private subscriptions;
     readonly resources: ServerResourceActions;
     readonly prompts: ServerPromptActions;
+    readonly elicitation: ElicitationActions;
     /**
      * Get the current stdio transport.
      */
@@ -515,53 +544,44 @@ declare class MCPServer extends MCPServerBase {
         resources?: MCPServerResources;
         prompts?: MCPServerPrompts;
     });
-    private convertAgentsToTools;
-    private convertWorkflowsToTools;
-    /**
-     * Convert and validate all provided tools, logging registration status.
-     * Also converts agents and workflows into tools.
-     * @param tools Tool definitions
-     * @param agentsConfig Agent definitions to be converted to tools, expected from MCPServerConfig
-     * @param workflowsConfig Workflow definitions to be converted to tools, expected from MCPServerConfig
-     * @returns Converted tools registry
-     */
-    convertTools(tools: ToolsInput, agentsConfig?: Record<string, Agent>, workflowsConfig?: Record<string, Workflow>): Record<string, ConvertedTool>;
-    /**
-     * Register the ListTools handler for listing all available tools.
-     */
-    private registerListToolsHandler;
-    /**
-     * Register the CallTool handler for executing a tool by name.
-     */
-    private registerCallToolHandler;
     /**
-     * Register the ListResources handler for listing all available resources.
-     */
-    private registerListResourcesHandler;
-    /**
-     * Register the ReadResource handler for reading a resource by URI.
+     * Handle an elicitation request by sending it to the connected client.
+     * This method sends an elicitation/create request to the client and waits for the response.
+     *
+     * @param request - The elicitation request containing message and schema
+     * @param serverInstance - Optional server instance to use; defaults to main server for backward compatibility
+     * @returns Promise that resolves to the client's response
      */
-    private registerReadResourceHandler;
+    private handleElicitationRequest;
     /**
-     * Register the ListResourceTemplates handler.
+     * Creates a new Server instance configured with all handlers for HTTP sessions.
+     * Each HTTP client connection gets its own Server instance to avoid routing conflicts.
      */
-    private registerListResourceTemplatesHandler;
+    private createServerInstance;
     /**
-     * Register the SubscribeResource handler.
+     * Registers all MCP handlers on a given server instance.
+     * This allows us to create multiple server instances with identical functionality.
      */
-    private registerSubscribeResourceHandler;
+    private registerHandlersOnServer;
     /**
-     * Register the UnsubscribeResource handler.
+     * Registers resource-related handlers on a server instance.
      */
-    private registerUnsubscribeResourceHandler;
+    private registerResourceHandlersOnServer;
     /**
-     * Register the ListPrompts handler.
+     * Registers prompt-related handlers on a server instance.
      */
-    private registerListPromptsHandler;
+    private registerPromptHandlersOnServer;
+    private convertAgentsToTools;
+    private convertWorkflowsToTools;
     /**
-     * Register the GetPrompt handler.
+     * Convert and validate all provided tools, logging registration status.
+     * Also converts agents and workflows into tools.
+     * @param tools Tool definitions
+     * @param agentsConfig Agent definitions to be converted to tools, expected from MCPServerConfig
+     * @param workflowsConfig Workflow definitions to be converted to tools, expected from MCPServerConfig
+     * @returns Converted tools registry
      */
-    private registerGetPromptHandler;
+    convertTools(tools: ToolsInput, agentsConfig?: Record<string, Agent>, workflowsConfig?: Record<string, Workflow>): Record<string, ConvertedTool>;
     /**
      * Start the MCP server using stdio transport (for Windsurf integration).
      */
@@ -713,6 +733,19 @@ export { MCPServerResources }
 export { MCPServerResources as MCPServerResources_alias_1 }
 export { MCPServerResources as MCPServerResources_alias_2 }
 
+declare type MCPTool = {
+    id?: InternalCoreTool['id'];
+    description?: InternalCoreTool['description'];
+    parameters: InternalCoreTool['parameters'];
+    outputSchema?: InternalCoreTool['outputSchema'];
+    execute: (params: any, options: Parameters<NonNullable<InternalCoreTool['execute']>>[1] & {
+        elicitation: ElicitationActions;
+    }) => Promise<any>;
+};
+export { MCPTool }
+export { MCPTool as MCPTool_alias_1 }
+export { MCPTool as MCPTool_alias_2 }
+
 /**
  * Client-side prompt actions for listing, getting, and subscribing to prompt changes.
  */