Use ai-sdk/mcp package for new mint mcp endpoint

Author: bigfluffycookie

package-lock.json

@@ -40,6 +40,7 @@
     "@ai-sdk/google": "2.0.38",
     "@ai-sdk/google-vertex": "^3.0.80",
     "@ai-sdk/groq": "2.0.7",
+    "@ai-sdk/mcp": "0.0.11",
     "@ai-sdk/mistral": "2.0.4",
     "@ai-sdk/openai": "2.0.68",
     "@ai-sdk/perplexity": "2.0.3",

package.json

@@ -1,31 +1,49 @@
+import { experimental_createMCPClient as createMCPClient } from '@ai-sdk/mcp';
 import { AppSystemProp, logger, system } from '@openops/server-shared';
-import { experimental_createMCPClient as createMCPClient, tool } from 'ai';
-import { Experimental_StdioMCPTransport as StdioMCPTransport } from 'ai/mcp-stdio';
+import { tool } from 'ai';
 import { z } from 'zod';
 import { MCPTool } from './types';
 
+type MCPSearchTool = {
+  execute: (
+    args: { query: string },
+    options: { toolCallId: string; messages: unknown[] },
+  ) => Promise<unknown>;
+};
+
 export async function getDocsTools(): Promise<MCPTool> {
-  const mcpServerPath = system.get<string>(AppSystemProp.DOCS_MCP_SERVER_PATH);
-  if (!mcpServerPath) {
+  const mcpServerUrl = system.get<string>(AppSystemProp.DOCS_MCP_SERVER_PATH);
+  if (!mcpServerUrl) {
     return {
       client: undefined,
       toolSet: {},
     };
   }
 
   logger.debug('Creating MCP client for docs', {
-    serverPath: mcpServerPath,
+    serverPath: mcpServerUrl,
   });
 
   const client = await createMCPClient({
-    transport: new StdioMCPTransport({
-      command: 'node',
-      args: [mcpServerPath],
-    }),
+    transport: {
+      type: 'http',
+      url: mcpServerUrl,
+    } as Parameters<typeof createMCPClient>[0]['transport'],
   });
 
   const tools = await client.tools();
-  const searchTool = tools['search'];
+  const toolEntries =
+    tools instanceof Map ? Array.from(tools.entries()) : Object.entries(tools);
+
+  const searchTool = toolEntries.find(([name]) =>
+    name.toLowerCase().includes('search'),
+  )?.[1] as MCPSearchTool | undefined;
+
+  if (!searchTool?.execute) {
+    logger.error('Docs MCP search tool not available', {
+      availableTools: toolEntries.map(([name]) => name),
+    });
+  }
 
   const toolSet = {
     OpenOps_Documentation: tool({
@@ -41,25 +59,21 @@ Use this tool to find accurate, verified information before answering OpenOps-sp
         query: z.string().describe('The search query'),
       }),
       execute: async ({ query }) => {
-        try {
-          if (!searchTool || typeof searchTool.execute !== 'function') {
-            return await Promise.resolve({
-              success: false,
-              error: 'search tool not available',
-            });
-          }
+        if (!searchTool?.execute) {
+          return { success: false, error: 'search tool not available' };
+        }
 
-          const result = await searchTool.execute(
+        try {
+          return await searchTool.execute(
             { query },
             { toolCallId: '', messages: [] },
           );
-          return result;
         } catch (error) {
           logger.error('OpenOps Documentation MCP client error:', { error });
-          return Promise.resolve({
+          return {
             success: false,
             error: error instanceof Error ? error.message : String(error),
-          });
+          };
         }
       },
     }),

packages/server/api/src/app/ai/mcp/docs-tools.ts

@@ -87,7 +87,7 @@ const systemPropDefaultValues: Partial<Record<SystemProp, string>> = {
   [AppSystemProp.AI_PROMPTS_LOCATION]:
     'https://raw.githubusercontent.com/openops-cloud/openops/main/ai-prompts',
   [AppSystemProp.SUPERSET_MCP_SERVER_PATH]: '/root/.mcp/superset',
-  [AppSystemProp.DOCS_MCP_SERVER_PATH]: '/root/.mcp/docs.openops.com',
+  [AppSystemProp.DOCS_MCP_SERVER_PATH]: 'https://docs.openops.com/mcp',
   [AppSystemProp.LOAD_EXPERIMENTAL_MCP_TOOLS]: 'false',
   [SharedSystemProp.AWS_ENABLE_IMPLICIT_ROLE]: 'false',
   [AppSystemProp.OPENOPS_MCP_SERVER_PATH]: '/root/.mcp/openops-mcp',