@ai-sdk/anthropic 3.0.0-beta.27 → 3.0.0-beta.28

package/CHANGELOG.md

@@ -1,5 +1,14 @@
 # @ai-sdk/anthropic
 
+## 3.0.0-beta.28
+
+### Patch Changes
+
+- 81d4308: feat(provider/anthropic): mcp connector support
+- Updated dependencies [81d4308]
+  - @ai-sdk/provider@3.0.0-beta.7
+  - @ai-sdk/provider-utils@4.0.0-beta.18
+
 ## 3.0.0-beta.27
 
 ### Patch Changes

package/dist/index.d.mts

@@ -15,6 +15,16 @@ declare const anthropicProviderOptions: z.ZodObject<{
         type: z.ZodLiteral<"ephemeral">;
         ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"5m">, z.ZodLiteral<"1h">]>>;
     }, z.core.$strip>>;
+    mcpServers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"url">;
+        name: z.ZodString;
+        url: z.ZodString;
+        authorizationToken: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        toolConfiguration: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            allowedTools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 type AnthropicProviderOptions = z.infer<typeof anthropicProviderOptions>;
 

package/dist/index.d.ts

@@ -15,6 +15,16 @@ declare const anthropicProviderOptions: z.ZodObject<{
         type: z.ZodLiteral<"ephemeral">;
         ttl: z.ZodOptional<z.ZodUnion<readonly [z.ZodLiteral<"5m">, z.ZodLiteral<"1h">]>>;
     }, z.core.$strip>>;
+    mcpServers: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodLiteral<"url">;
+        name: z.ZodString;
+        url: z.ZodString;
+        authorizationToken: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        toolConfiguration: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+            enabled: z.ZodOptional<z.ZodNullable<z.ZodBoolean>>;
+            allowedTools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString>>>;
+        }, z.core.$strip>>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 type AnthropicProviderOptions = z.infer<typeof anthropicProviderOptions>;
 

package/dist/index.js

@@ -31,7 +31,7 @@ var import_provider4 = require("@ai-sdk/provider");
 var import_provider_utils20 = require("@ai-sdk/provider-utils");
 
 // src/version.ts
-var VERSION = true ? "3.0.0-beta.27" : "0.0.0-test";
+var VERSION = true ? "3.0.0-beta.28" : "0.0.0-test";
 
 // src/anthropic-messages-language-model.ts
 var import_provider3 = require("@ai-sdk/provider");
@@ -119,6 +119,24 @@ var anthropicMessagesResponseSchema = (0, import_provider_utils2.lazySchema)(
             name: import_v42.z.string(),
             input: import_v42.z.record(import_v42.z.string(), import_v42.z.unknown()).nullish()
           }),
+          import_v42.z.object({
+            type: import_v42.z.literal("mcp_tool_use"),
+            id: import_v42.z.string(),
+            name: import_v42.z.string(),
+            input: import_v42.z.unknown(),
+            server_name: import_v42.z.string()
+          }),
+          import_v42.z.object({
+            type: import_v42.z.literal("mcp_tool_result"),
+            tool_use_id: import_v42.z.string(),
+            is_error: import_v42.z.boolean(),
+            content: import_v42.z.array(
+              import_v42.z.union([
+                import_v42.z.string(),
+                import_v42.z.object({ type: import_v42.z.literal("text"), text: import_v42.z.string() })
+              ])
+            )
+          }),
           import_v42.z.object({
             type: import_v42.z.literal("web_fetch_tool_result"),
             tool_use_id: import_v42.z.string(),
@@ -291,6 +309,24 @@ var anthropicMessagesChunkSchema = (0, import_provider_utils2.lazySchema)(
             name: import_v42.z.string(),
             input: import_v42.z.record(import_v42.z.string(), import_v42.z.unknown()).nullish()
           }),
+          import_v42.z.object({
+            type: import_v42.z.literal("mcp_tool_use"),
+            id: import_v42.z.string(),
+            name: import_v42.z.string(),
+            input: import_v42.z.unknown(),
+            server_name: import_v42.z.string()
+          }),
+          import_v42.z.object({
+            type: import_v42.z.literal("mcp_tool_result"),
+            tool_use_id: import_v42.z.string(),
+            is_error: import_v42.z.boolean(),
+            content: import_v42.z.array(
+              import_v42.z.union([
+                import_v42.z.string(),
+                import_v42.z.object({ type: import_v42.z.literal("text"), text: import_v42.z.string() })
+              ])
+            )
+          }),
           import_v42.z.object({
             type: import_v42.z.literal("web_fetch_tool_result"),
             tool_use_id: import_v42.z.string(),
@@ -543,7 +579,19 @@ var anthropicProviderOptions = import_v43.z.object({
   cacheControl: import_v43.z.object({
     type: import_v43.z.literal("ephemeral"),
     ttl: import_v43.z.union([import_v43.z.literal("5m"), import_v43.z.literal("1h")]).optional()
-  }).optional()
+  }).optional(),
+  mcpServers: import_v43.z.array(
+    import_v43.z.object({
+      type: import_v43.z.literal("url"),
+      name: import_v43.z.string(),
+      url: import_v43.z.string(),
+      authorizationToken: import_v43.z.string().nullish(),
+      toolConfiguration: import_v43.z.object({
+        enabled: import_v43.z.boolean().nullish(),
+        allowedTools: import_v43.z.array(import_v43.z.string()).nullish()
+      }).nullish()
+    })
+  ).optional()
 });
 
 // src/anthropic-prepare-tools.ts
@@ -1064,7 +1112,7 @@ async function convertToAnthropicMessagesPrompt({
   sendReasoning,
   warnings
 }) {
-  var _a, _b, _c, _d, _e, _f;
+  var _a, _b, _c, _d, _e, _f, _g, _h, _i, _j;
   const betas = /* @__PURE__ */ new Set();
   const blocks = groupIntoBlocks(prompt);
   let system = void 0;
@@ -1282,6 +1330,7 @@ async function convertToAnthropicMessagesPrompt({
       }
       case "assistant": {
         const anthropicContent = [];
+        const mcpToolUseIds = /* @__PURE__ */ new Set();
         for (let j = 0; j < block.messages.length; j++) {
           const message = block.messages[j];
           const isLastMessage = j === block.messages.length - 1;
@@ -1347,7 +1396,29 @@ async function convertToAnthropicMessagesPrompt({
               }
               case "tool-call": {
                 if (part.providerExecuted) {
-                  if (part.toolName === "code_execution" && part.input != null && typeof part.input === "object" && "type" in part.input && typeof part.input.type === "string" && (part.input.type === "bash_code_execution" || part.input.type === "text_editor_code_execution")) {
+                  const isMcpToolUse = ((_h = (_g = part.providerOptions) == null ? void 0 : _g.anthropic) == null ? void 0 : _h.type) === "mcp-tool-use";
+                  if (isMcpToolUse) {
+                    mcpToolUseIds.add(part.toolCallId);
+                    const serverName = (_j = (_i = part.providerOptions) == null ? void 0 : _i.anthropic) == null ? void 0 : _j.serverName;
+                    if (serverName == null || typeof serverName !== "string") {
+                      warnings.push({
+                        type: "other",
+                        message: "mcp tool use server name is required and must be a string"
+                      });
+                      break;
+                    }
+                    anthropicContent.push({
+                      type: "mcp_tool_use",
+                      id: part.toolCallId,
+                      name: part.toolName,
+                      input: part.input,
+                      server_name: serverName,
+                      cache_control: cacheControl
+                    });
+                  } else if (
+                    // code execution 20250825:
+                    part.toolName === "code_execution" && part.input != null && typeof part.input === "object" && "type" in part.input && typeof part.input.type === "string" && (part.input.type === "bash_code_execution" || part.input.type === "text_editor_code_execution")
+                  ) {
                     anthropicContent.push({
                       type: "server_tool_use",
                       id: part.toolCallId,
@@ -1383,7 +1454,23 @@ async function convertToAnthropicMessagesPrompt({
                 break;
               }
               case "tool-result": {
-                if (part.toolName === "code_execution") {
+                if (mcpToolUseIds.has(part.toolCallId)) {
+                  const output = part.output;
+                  if (output.type !== "json" && output.type !== "error-json") {
+                    warnings.push({
+                      type: "other",
+                      message: `provider executed tool result output type ${output.type} for tool ${part.toolName} is not supported`
+                    });
+                    break;
+                  }
+                  anthropicContent.push({
+                    type: "mcp_tool_result",
+                    tool_use_id: part.toolCallId,
+                    is_error: output.type === "error-json",
+                    content: output.value,
+                    cache_control: cacheControl
+                  });
+                } else if (part.toolName === "code_execution") {
                   const output = part.output;
                   if (output.type !== "json") {
                     warnings.push({
@@ -1698,7 +1785,7 @@ var AnthropicMessagesLanguageModel = class {
       providerOptions,
       schema: anthropicProviderOptions
     });
-    const { prompt: messagesPrompt, betas: messagesBetas } = await convertToAnthropicMessagesPrompt({
+    const { prompt: messagesPrompt, betas } = await convertToAnthropicMessagesPrompt({
       prompt,
       sendReasoning: (_a = anthropicOptions == null ? void 0 : anthropicOptions.sendReasoning) != null ? _a : true,
       warnings
@@ -1720,6 +1807,19 @@ var AnthropicMessagesLanguageModel = class {
       ...isThinking && {
         thinking: { type: "enabled", budget_tokens: thinkingBudget }
       },
+      // mcp servers:
+      ...(anthropicOptions == null ? void 0 : anthropicOptions.mcpServers) && anthropicOptions.mcpServers.length > 0 && {
+        mcp_servers: anthropicOptions.mcpServers.map((server) => ({
+          type: server.type,
+          name: server.name,
+          url: server.url,
+          authorization_token: server.authorizationToken,
+          tool_configuration: server.toolConfiguration ? {
+            allowed_tools: server.toolConfiguration.allowedTools,
+            enabled: server.toolConfiguration.enabled
+          } : void 0
+        }))
+      },
       // prompt:
       system: messagesPrompt.system,
       messages: messagesPrompt.messages
@@ -1761,11 +1861,14 @@ var AnthropicMessagesLanguageModel = class {
         warnings.push({
           type: "unsupported-setting",
           setting: "maxOutputTokens",
-          details: `${maxTokens} (maxOutputTokens + thinkingBudget) is greater than ${this.modelId} ${maxOutputTokensForModel} max output tokens. The max output tokens have been limited to ${maxOutputTokensForModel}.`
+          details: `${baseArgs.max_tokens} (maxOutputTokens + thinkingBudget) is greater than ${this.modelId} ${maxOutputTokensForModel} max output tokens. The max output tokens have been limited to ${maxOutputTokensForModel}.`
         });
       }
       baseArgs.max_tokens = maxOutputTokensForModel;
     }
+    if ((anthropicOptions == null ? void 0 : anthropicOptions.mcpServers) && anthropicOptions.mcpServers.length > 0) {
+      betas.add("mcp-client-2025-04-04");
+    }
     const {
       tools: anthropicTools2,
       toolChoice: anthropicToolChoice,
@@ -1789,7 +1892,7 @@ var AnthropicMessagesLanguageModel = class {
         tool_choice: anthropicToolChoice
       },
       warnings: [...warnings, ...toolWarnings],
-      betas: /* @__PURE__ */ new Set([...messagesBetas, ...toolsBetas]),
+      betas: /* @__PURE__ */ new Set([...betas, ...toolsBetas]),
       usesJsonResponseTool: jsonResponseTool != null
     };
   }
@@ -1854,6 +1957,7 @@ var AnthropicMessagesLanguageModel = class {
       fetch: this.config.fetch
     });
     const content = [];
+    const mcpToolCalls = {};
     for (const part of response.content) {
       switch (part.type) {
         case "text": {
@@ -1933,6 +2037,37 @@ var AnthropicMessagesLanguageModel = class {
           }
           break;
         }
+        case "mcp_tool_use": {
+          mcpToolCalls[part.id] = {
+            type: "tool-call",
+            toolCallId: part.id,
+            toolName: part.name,
+            input: JSON.stringify(part.input),
+            providerExecuted: true,
+            dynamic: true,
+            providerMetadata: {
+              anthropic: {
+                type: "mcp-tool-use",
+                serverName: part.server_name
+              }
+            }
+          };
+          content.push(mcpToolCalls[part.id]);
+          break;
+        }
+        case "mcp_tool_result": {
+          content.push({
+            type: "tool-result",
+            toolCallId: part.tool_use_id,
+            toolName: mcpToolCalls[part.tool_use_id].toolName,
+            isError: part.is_error,
+            result: part.content,
+            providerExecuted: true,
+            dynamic: true,
+            providerMetadata: mcpToolCalls[part.tool_use_id].providerMetadata
+          });
+          break;
+        }
         case "web_fetch_tool_result": {
           if (part.content.type === "web_fetch_result") {
             content.push({
@@ -2113,6 +2248,7 @@ var AnthropicMessagesLanguageModel = class {
       totalTokens: void 0
     };
     const contentBlocks = {};
+    const mcpToolCalls = {};
     let rawUsage = void 0;
     let cacheCreationInputTokens = null;
     let stopSequence = null;
@@ -2139,7 +2275,8 @@ var AnthropicMessagesLanguageModel = class {
                 return;
               }
               case "content_block_start": {
-                const contentBlockType = value.content_block.type;
+                const part = value.content_block;
+                const contentBlockType = part.type;
                 blockType = contentBlockType;
                 switch (contentBlockType) {
                   case "text": {
@@ -2165,7 +2302,7 @@ var AnthropicMessagesLanguageModel = class {
                       id: String(value.index),
                       providerMetadata: {
                         anthropic: {
-                          redactedData: value.content_block.data
+                          redactedData: part.data
                         }
                       }
                     });
@@ -2174,16 +2311,16 @@ var AnthropicMessagesLanguageModel = class {
                   case "tool_use": {
                     contentBlocks[value.index] = usesJsonResponseTool ? { type: "text" } : {
                       type: "tool-call",
-                      toolCallId: value.content_block.id,
-                      toolName: value.content_block.name,
+                      toolCallId: part.id,
+                      toolName: part.name,
                       input: "",
                       firstDelta: true
                     };
                     controller.enqueue(
                       usesJsonResponseTool ? { type: "text-start", id: String(value.index) } : {
                         type: "tool-input-start",
-                        id: value.content_block.id,
-                        toolName: value.content_block.name
+                        id: part.id,
+                        toolName: part.name
                       }
                     );
                     return;
@@ -2198,19 +2335,19 @@ var AnthropicMessagesLanguageModel = class {
                       "text_editor_code_execution",
                       // code execution 20250825 bash:
                       "bash_code_execution"
-                    ].includes(value.content_block.name)) {
+                    ].includes(part.name)) {
                       contentBlocks[value.index] = {
                         type: "tool-call",
-                        toolCallId: value.content_block.id,
-                        toolName: value.content_block.name,
+                        toolCallId: part.id,
+                        toolName: part.name,
                         input: "",
                         providerExecuted: true,
                         firstDelta: true
                       };
-                      const mappedToolName = value.content_block.name === "text_editor_code_execution" || value.content_block.name === "bash_code_execution" ? "code_execution" : value.content_block.name;
+                      const mappedToolName = part.name === "text_editor_code_execution" || part.name === "bash_code_execution" ? "code_execution" : part.name;
                       controller.enqueue({
                         type: "tool-input-start",
-                        id: value.content_block.id,
+                        id: part.id,
                         toolName: mappedToolName,
                         providerExecuted: true
                       });
@@ -2218,7 +2355,6 @@ var AnthropicMessagesLanguageModel = class {
                     return;
                   }
                   case "web_fetch_tool_result": {
-                    const part = value.content_block;
                     if (part.content.type === "web_fetch_result") {
                       controller.enqueue({
                         type: "tool-result",
@@ -2256,7 +2392,6 @@ var AnthropicMessagesLanguageModel = class {
                     return;
                   }
                   case "web_search_tool_result": {
-                    const part = value.content_block;
                     if (Array.isArray(part.content)) {
                       controller.enqueue({
                         type: "tool-result",
@@ -2305,7 +2440,6 @@ var AnthropicMessagesLanguageModel = class {
                   }
                   // code execution 20250522:
                   case "code_execution_tool_result": {
-                    const part = value.content_block;
                     if (part.content.type === "code_execution_result") {
                       controller.enqueue({
                         type: "tool-result",
@@ -2337,7 +2471,6 @@ var AnthropicMessagesLanguageModel = class {
                   // code execution 20250825:
                   case "bash_code_execution_tool_result":
                   case "text_editor_code_execution_tool_result": {
-                    const part = value.content_block;
                     controller.enqueue({
                       type: "tool-result",
                       toolCallId: part.tool_use_id,
@@ -2347,6 +2480,37 @@ var AnthropicMessagesLanguageModel = class {
                     });
                     return;
                   }
+                  case "mcp_tool_use": {
+                    mcpToolCalls[part.id] = {
+                      type: "tool-call",
+                      toolCallId: part.id,
+                      toolName: part.name,
+                      input: JSON.stringify(part.input),
+                      providerExecuted: true,
+                      dynamic: true,
+                      providerMetadata: {
+                        anthropic: {
+                          type: "mcp-tool-use",
+                          serverName: part.server_name
+                        }
+                      }
+                    };
+                    controller.enqueue(mcpToolCalls[part.id]);
+                    return;
+                  }
+                  case "mcp_tool_result": {
+                    controller.enqueue({
+                      type: "tool-result",
+                      toolCallId: part.tool_use_id,
+                      toolName: mcpToolCalls[part.tool_use_id].toolName,
+                      isError: part.is_error,
+                      result: part.content,
+                      providerExecuted: true,
+                      dynamic: true,
+                      providerMetadata: mcpToolCalls[part.tool_use_id].providerMetadata
+                    });
+                    return;
+                  }
                   default: {
                     const _exhaustiveCheck = contentBlockType;
                     throw new Error(