@ai-sdk/mcp 1.0.41 → 1.0.42

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @ai-sdk/mcp
 
+## 1.0.42
+
+### Patch Changes
+
+- 725f2ed: feat(mcp): expose server instructions to be accessible through client
+- 7281592: fix(mcp): use negotiated protocol version in transport request headers
+
 ## 1.0.41
 
 ### Patch Changes

package/dist/index.d.mts

@@ -228,6 +228,10 @@ interface MCPTransport {
      * Event handler for received messages
      */
     onmessage?: (message: JSONRPCMessage) => void;
+    /**
+     * The protocol version negotiated during initialization.
+     */
+    protocolVersion?: string;
 }
 type MCPTransportConfig = {
     type: 'sse' | 'http';
@@ -508,6 +512,15 @@ interface MCPClient {
      * @see https://modelcontextprotocol.io/specification/2025-11-25/schema#implementation
      */
     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>>;

package/dist/index.d.ts

@@ -228,6 +228,10 @@ interface MCPTransport {
      * Event handler for received messages
      */
     onmessage?: (message: JSONRPCMessage) => void;
+    /**
+     * The protocol version negotiated during initialization.
+     */
+    protocolVersion?: string;
 }
 type MCPTransportConfig = {
     type: 'sse' | 'http';
@@ -508,6 +512,15 @@ interface MCPClient {
      * @see https://modelcontextprotocol.io/specification/2025-11-25/schema#implementation
      */
     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>>;

package/dist/index.js

@@ -1115,10 +1115,11 @@ var SseMCPTransport = class {
     this.fetchFn = fetchFn != null ? fetchFn : globalThis.fetch;
   }
   async commonHeaders(base) {
+    var _a3;
     const headers = {
       ...this.headers,
       ...base,
-      "mcp-protocol-version": LATEST_PROTOCOL_VERSION
+      "mcp-protocol-version": (_a3 = this.protocolVersion) != null ? _a3 : LATEST_PROTOCOL_VERSION
     };
     if (this.authProvider) {
       const tokens = await this.authProvider.tokens();
@@ -1329,10 +1330,11 @@ var HttpMCPTransport = class {
     this.fetchFn = fetchFn != null ? fetchFn : globalThis.fetch;
   }
   async commonHeaders(base) {
+    var _a3;
     const headers = {
       ...this.headers,
       ...base,
-      "mcp-protocol-version": LATEST_PROTOCOL_VERSION
+      "mcp-protocol-version": (_a3 = this.protocolVersion) != null ? _a3 : LATEST_PROTOCOL_VERSION
     };
     if (this.sessionId) {
       headers["mcp-session-id"] = this.sessionId;
@@ -1721,6 +1723,9 @@ var DefaultMCPClient = class {
   get serverInfo() {
     return this._serverInfo;
   }
+  get instructions() {
+    return this._serverInstructions;
+  }
   async init() {
     try {
       await this.transport.start();
@@ -1748,6 +1753,8 @@ var DefaultMCPClient = class {
       }
       this.serverCapabilities = result.capabilities;
       this._serverInfo = result.serverInfo;
+      this._serverInstructions = result.instructions;
+      this.transport.protocolVersion = result.protocolVersion;
       await this.notification({
         method: "notifications/initialized"
       });