@ai-sdk/mcp 1.0.40 → 1.0.42

package/dist/mcp-stdio/index.d.mts

@@ -62,6 +62,10 @@ interface MCPTransport {
      * Event handler for received messages
      */
     onmessage?: (message: JSONRPCMessage) => void;
+    /**
+     * The protocol version negotiated during initialization.
+     */
+    protocolVersion?: string;
 }
 
 interface StdioConfig {

package/dist/mcp-stdio/index.d.ts

@@ -62,6 +62,10 @@ interface MCPTransport {
      * Event handler for received messages
      */
     onmessage?: (message: JSONRPCMessage) => void;
+    /**
+     * The protocol version negotiated during initialization.
+     */
+    protocolVersion?: string;
 }
 
 interface StdioConfig {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ai-sdk/mcp",
-  "version": "1.0.40",
+  "version": "1.0.42",
   "license": "Apache-2.0",
   "sideEffects": false,
   "main": "./dist/index.js",
@@ -34,7 +34,7 @@
   "dependencies": {
     "pkce-challenge": "^5.0.0",
     "@ai-sdk/provider": "3.0.10",
-    "@ai-sdk/provider-utils": "4.0.26"
+    "@ai-sdk/provider-utils": "4.0.27"
   },
   "devDependencies": {
     "@types/node": "20.17.24",

package/src/tool/mcp-client.ts

@@ -132,6 +132,16 @@ export interface MCPClient {
    */
   readonly serverInfo: Configuration;
 
+  /**
+   * Optional instructions provided by the server during the initialize handshake.
+   *
+   * These describe how to use the server and its features, and can be used by clients
+   * to improve LLM interactions (e.g. by including them in the system prompt).
+   *
+   * @see https://modelcontextprotocol.io/specification/2025-11-25/schema#initializeresult
+   */
+  readonly instructions?: string;
+
   tools<TOOL_SCHEMAS extends ToolSchemas = 'automatic'>(options?: {
     schemas?: TOOL_SCHEMAS;
   }): Promise<McpToolSet<TOOL_SCHEMAS>>;
@@ -215,6 +225,7 @@ class DefaultMCPClient implements MCPClient {
   > = new Map();
   private serverCapabilities: ServerCapabilities = {};
   private _serverInfo: Configuration = { name: '', version: '' };
+  private _serverInstructions?: string;
   private isClosed = true;
   private elicitationRequestHandler?: (
     request: ElicitationRequest,
@@ -266,6 +277,10 @@ class DefaultMCPClient implements MCPClient {
     return this._serverInfo;
   }
 
+  get instructions(): string | undefined {
+    return this._serverInstructions;
+  }
+
   async init(): Promise<this> {
     try {
       await this.transport.start();
@@ -297,6 +312,8 @@ class DefaultMCPClient implements MCPClient {
 
       this.serverCapabilities = result.capabilities;
       this._serverInfo = result.serverInfo;
+      this._serverInstructions = result.instructions;
+      this.transport.protocolVersion = result.protocolVersion;
 
       // Complete initialization handshake:
       await this.notification({
@@ -620,8 +637,8 @@ class DefaultMCPClient implements MCPClient {
           ? dynamicTool({
               description,
               title: resolvedTitle,
-              providerMetadata: {
-                mcp: { clientName: this.clientInfo.name },
+              metadata: {
+                clientName: this.clientInfo.name,
               },
               inputSchema: jsonSchema({
                 ...inputSchema,
@@ -634,8 +651,8 @@ class DefaultMCPClient implements MCPClient {
           : tool({
               description,
               title: resolvedTitle,
-              providerMetadata: {
-                mcp: { clientName: this.clientInfo.name },
+              metadata: {
+                clientName: this.clientInfo.name,
               },
               inputSchema: schemas[name].inputSchema,
               ...(outputSchema != null ? { outputSchema } : {}),

package/src/tool/mcp-http-transport.ts

@@ -51,6 +51,7 @@ export class HttpMCPTransport implements MCPTransport {
   onclose?: () => void;
   onerror?: (error: unknown) => void;
   onmessage?: (message: JSONRPCMessage) => void;
+  protocolVersion?: string;
 
   constructor({
     url,
@@ -78,7 +79,7 @@ export class HttpMCPTransport implements MCPTransport {
     const headers: Record<string, string> = {
       ...this.headers,
       ...base,
-      'mcp-protocol-version': LATEST_PROTOCOL_VERSION,
+      'mcp-protocol-version': this.protocolVersion ?? LATEST_PROTOCOL_VERSION,
     };
 
     if (this.sessionId) {

package/src/tool/mcp-sse-transport.ts

@@ -33,6 +33,7 @@ export class SseMCPTransport implements MCPTransport {
   onclose?: () => void;
   onerror?: (error: unknown) => void;
   onmessage?: (message: JSONRPCMessage) => void;
+  protocolVersion?: string;
 
   constructor({
     url,
@@ -60,7 +61,7 @@ export class SseMCPTransport implements MCPTransport {
     const headers: Record<string, string> = {
       ...this.headers,
       ...base,
-      'mcp-protocol-version': LATEST_PROTOCOL_VERSION,
+      'mcp-protocol-version': this.protocolVersion ?? LATEST_PROTOCOL_VERSION,
     };
 
     if (this.authProvider) {

package/src/tool/mcp-transport.ts

@@ -40,6 +40,11 @@ export interface MCPTransport {
    * Event handler for received messages
    */
   onmessage?: (message: JSONRPCMessage) => void;
+
+  /**
+   * The protocol version negotiated during initialization.
+   */
+  protocolVersion?: string;
 }
 
 export type MCPTransportConfig = {

package/src/tool/mock-mcp-transport.ts

@@ -45,7 +45,7 @@ export class MockMCPTransport implements MCPTransport {
   onmessage?: (message: JSONRPCMessage) => void;
   onclose?: () => void;
   onerror?: (error: Error) => void;
-
+  protocolVersion?: string;
   constructor({
     overrideTools = DEFAULT_TOOLS,
     resources = [