@mastra/mcp-docs-server 0.13.2-alpha.0 → 0.13.2-alpha.2

package/.docs/organized/code-examples/agent-network.md

@@ -17,14 +17,18 @@
     "@ai-sdk/openai": "^1.3.22",
     "@mastra/client-js": "latest",
     "@mastra/core": "latest",
+    "@mastra/libsql": "latest",
     "@mastra/loggers": "latest",
-    "zod": "^3.25.56"
+    "@mastra/memory": "latest",
+    "zod": "^3.25.67"
   },
   "pnpm": {
     "overrides": {
       "@mastra/client-js": "link:../../client-sdks/client-js",
       "@mastra/core": "link:../../packages/core",
-      "@mastra/loggers": "link:../../packages/loggers"
+      "@mastra/libsql": "link:../../stores/libsql",
+      "@mastra/loggers": "link:../../packages/loggers",
+      "@mastra/memory": "link:../../packages/memory"
     }
   },
   "packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39"
@@ -198,19 +202,28 @@ export const dataAnalysisAgent = new Agent({
 ```typescript
 import { Mastra } from '@mastra/core';
 import { PinoLogger } from '@mastra/loggers';
-import { researchNetwork } from './network';
+// import { researchNetwork } from './network';
 import { webSearchAgent } from './agents';
-import { agentWorkflow } from './workflows';
+// import { agentWorkflow } from './workflows';
+import { v_nextNetwork } from './network/v-next';
+import { LibSQLStore } from '@mastra/libsql';
+import { workflow1 } from './network/v-next';
 
 export const mastra = new Mastra({
   agents: {
     webSearchAgent,
   },
-  networks: {
-    researchNetwork,
+  // networks: {
+  //   researchNetwork,
+  // },
+  vnext_networks: {
+    v_nextNetwork,
   },
+  storage: new LibSQLStore({
+    url: 'file:../mastra.db', // Or your database URL
+  }),
   workflows: {
-    agentWorkflow,
+    workflow1,
   },
   logger: new PinoLogger({ name: 'Chef', level: 'info' }),
   serverMiddleware: [
@@ -263,6 +276,111 @@ export const researchNetwork = new AgentNetwork({
 
 ```
 
+### mastra/network/v-next.ts
+```typescript
+import { openai } from '@ai-sdk/openai';
+import { NewAgentNetwork } from '@mastra/core/network/vNext';
+import { Agent } from '@mastra/core/agent';
+import { createStep, createWorkflow } from '@mastra/core/workflows';
+import { LibSQLStore } from '@mastra/libsql';
+import { Memory } from '@mastra/memory';
+import { z } from 'zod';
+
+const memory = new Memory({
+  storage: new LibSQLStore({
+    url: 'file:../mastra.db', // Or your database URL
+  }),
+});
+
+const agent1 = new Agent({
+  name: 'agent1',
+  instructions:
+    'This agent is used to do research, but not create full responses. Answer in bullet points only and be concise.',
+  description:
+    'This agent is used to do research, but not create full responses. Answer in bullet points only and be concise.',
+  model: openai('gpt-4o'),
+});
+
+const agent2 = new Agent({
+  name: 'agent2',
+  description: 'This agent is used to do text synthesis on researched material. It writes articles in full paragraphs.',
+  instructions:
+    'This agent is used to do text synthesis on researched material. Write a full report based on the researched material. Do not use bullet points. Write full paragraphs. There should not be a single bullet point in the final report. You write articles.',
+  model: openai('gpt-4o'),
+});
+
+const agentStep1 = createStep({
+  id: 'agent-workflow-step-1',
+  description: 'This step is used to do research and text synthesis.',
+  inputSchema: z.object({
+    city: z.string().describe('The city to research'),
+  }),
+  outputSchema: z.object({
+    text: z.string(),
+  }),
+  execute: async ({ inputData }) => {
+    const resp = await agent1.generate(inputData.city, {
+      output: z.object({
+        text: z.string(),
+      }),
+    });
+
+    return { text: resp.object.text };
+  },
+});
+
+const agentStep2 = createStep({
+  id: 'agent-workflow-step-2',
+  description: 'This step is used to do research and text synthesis.',
+  inputSchema: z.object({
+    text: z.string().describe('The city to research'),
+  }),
+  outputSchema: z.object({
+    text: z.string(),
+  }),
+  execute: async ({ inputData }) => {
+    const resp = await agent2.generate(inputData.text, {
+      output: z.object({
+        text: z.string(),
+      }),
+    });
+
+    return { text: resp.object.text };
+  },
+});
+
+export const workflow1 = createWorkflow({
+  id: 'workflow1',
+  description: 'This workflow is perfect for researching a specific city.',
+  inputSchema: z.object({
+    city: z.string(),
+  }),
+  outputSchema: z.object({
+    text: z.string(),
+  }),
+})
+  .then(agentStep1)
+  .then(agentStep2)
+  .commit();
+
+export const v_nextNetwork = new NewAgentNetwork({
+  id: 'test-network',
+  name: 'Test Network',
+  instructions:
+    'You can research cities. You can also synthesize research material. You can also write a full report based on the researched material.',
+  model: openai('gpt-4o'),
+  agents: {
+    agent1,
+    agent2,
+  },
+  workflows: {
+    workflow1,
+  },
+  memory: memory,
+});
+
+```
+
 ### mastra/workflows/index.ts
 ```typescript
 import { Workflow } from '@mastra/core/workflows';

package/.docs/organized/code-examples/agent.md

@@ -19,7 +19,7 @@
     "ai": "^4.3.16",
     "fetch-to-node": "^2.1.0",
     "mastra": "latest",
-    "zod": "^3.25.56"
+    "zod": "^3.25.67"
   },
   "pnpm": {
     "overrides": {
@@ -50,21 +50,147 @@
 ### client.ts
 ```typescript
 import { MCPClient } from '@mastra/mcp';
+// import type { ElicitationHandler } from '@mastra/mcp';
+import { createInterface } from 'readline';
+
+// Create readline interface for user input
+const readline = createInterface({
+  input: process.stdin,
+  output: process.stdout,
+});
+
+// Helper function to prompt user for input
+function askQuestion(question: string): Promise<string> {
+  return new Promise(resolve => {
+    readline.question(question, answer => {
+      resolve(answer.trim());
+    });
+  });
+}
+
+// Elicitation handler that prompts the user for input
+const elicitationHandler = async request => {
+  console.log('\n🔔 Elicitation Request Received:');
+  console.log(`Message: ${request.message}`);
+  console.log('Requested Schema:');
+  console.log(JSON.stringify(request.requestedSchema, null, 2));
+
+  const schema = request.requestedSchema;
+  const properties = schema.properties;
+  const required = schema.required || [];
+
+  console.log('\nPlease provide the following information:');
+
+  const content: Record<string, unknown> = {};
+
+  // Collect input for each field
+  for (const [fieldName, fieldSchema] of Object.entries(properties)) {
+    const field = fieldSchema as {
+      type?: string;
+      title?: string;
+      description?: string;
+      format?: string;
+    };
+
+    const isRequired = required.includes(fieldName);
+    let prompt = `${field.title || fieldName}`;
+
+    // Add helpful information to the prompt
+    if (field.description) {
+      prompt += ` (${field.description})`;
+    }
+    if (field.format) {
+      prompt += ` [format: ${field.format}]`;
+    }
+    if (isRequired) {
+      prompt += ' *required*';
+    }
+
+    prompt += ': ';
+
+    const answer = await askQuestion(prompt);
+
+    // Check for cancellation
+    if (answer.toLowerCase() === 'cancel' || answer.toLowerCase() === 'c') {
+      return { action: 'cancel' as const };
+    }
+
+    // Handle empty responses
+    if (answer === '' && isRequired) {
+      console.log(`❌ Error: ${fieldName} is required`);
+      return { action: 'reject' as const };
+    } else if (answer !== '') {
+      content[fieldName] = answer;
+    }
+  }
+
+  // Show the collected data and ask for confirmation
+  console.log('\n✅ Collected data:');
+  console.log(JSON.stringify(content, null, 2));
+
+  const confirmAnswer = await askQuestion('\nSubmit this information? (yes/no/cancel): ');
+
+  if (confirmAnswer.toLowerCase() === 'yes' || confirmAnswer.toLowerCase() === 'y') {
+    return {
+      action: 'accept' as const,
+      content,
+    };
+  } else if (confirmAnswer.toLowerCase() === 'cancel' || confirmAnswer.toLowerCase() === 'c') {
+    return { action: 'cancel' as const };
+  } else {
+    return { action: 'reject' as const };
+  }
+};
 
 async function main() {
   const mcpClient = new MCPClient({
     servers: {
-      myMcpServer: {
-        url: new URL('http://localhost:4111/api/mcp/myMcpServer/mcp'),
+      myMcpServerTwo: {
+        url: new URL('http://localhost:4111/api/mcp/myMcpServerTwo/mcp'),
       },
     },
   });
 
-  const tools = await mcpClient.getTools();
-  console.log('Tools:', tools);
+  mcpClient.elicitation.onRequest('myMcpServerTwo', elicitationHandler);
+
+  try {
+    console.log('Connecting to MCP server...');
+    const tools = await mcpClient.getTools();
+    console.log('Available tools:', Object.keys(tools));
+
+    // Test the elicitation functionality
+    console.log('\n🧪 Testing elicitation functionality...');
+
+    // Find the collectContactInfo tool
+    const collectContactInfoTool = tools['myMcpServerTwo_collectContactInfo'];
+    if (collectContactInfoTool) {
+      console.log('\nCalling collectContactInfo tool...');
+
+      try {
+        const result = await collectContactInfoTool.execute({
+          context: {
+            reason: 'We need your contact information to send you updates about our service.',
+          },
+        });
+
+        console.log('\n📋 Tool Result:');
+        console.log(result);
+      } catch (error) {
+        console.error('❌ Error calling collectContactInfo tool:', error);
+      }
+    } else {
+      console.log('❌ collectContactInfo tool not found');
+      console.log('Available tools:', Object.keys(tools));
+    }
+  } catch (error) {
+    console.error('❌ Error:', error);
+  } finally {
+    readline.close();
+    await mcpClient.disconnect();
+  }
 }
 
-main();
+main().catch(console.error);
 
 ```
 
@@ -664,6 +790,57 @@ export const myMcpServerTwo = new MCPServer({
         return `Hello, ${context.name}! Welcome to the MCP server.`;
       },
     }),
+    collectContactInfo: createTool({
+      id: 'collectContactInfo',
+      description: 'Collects user contact information through elicitation.',
+      inputSchema: z.object({
+        reason: z.string().optional().describe('Optional reason for collecting contact info'),
+      }),
+      execute: async ({ context }, options) => {
+        const { reason } = context;
+
+        try {
+          // Use the session-aware elicitation functionality
+          const result = await options.elicitation.sendRequest({
+            message: reason
+              ? `Please provide your contact information. ${reason}`
+              : 'Please provide your contact information',
+            requestedSchema: {
+              type: 'object',
+              properties: {
+                name: {
+                  type: 'string',
+                  title: 'Full Name',
+                  description: 'Your full name',
+                },
+                email: {
+                  type: 'string',
+                  title: 'Email Address',
+                  description: 'Your email address',
+                  format: 'email',
+                },
+                phone: {
+                  type: 'string',
+                  title: 'Phone Number',
+                  description: 'Your phone number (optional)',
+                },
+              },
+              required: ['name', 'email'],
+            },
+          });
+
+          if (result.action === 'accept') {
+            return `Thank you! Contact information collected: ${JSON.stringify(result.content, null, 2)}`;
+          } else if (result.action === 'reject') {
+            return 'Contact information collection was declined by the user.';
+          } else {
+            return 'Contact information collection was cancelled by the user.';
+          }
+        } catch (error) {
+          return `Error collecting contact information: ${error}`;
+        }
+      },
+    }),
   },
 });
 

package/.docs/organized/code-examples/agui.md

@@ -26,7 +26,7 @@
     "mastra": "latest",
     "react": "^19.1.0",
     "react-dom": "^19.1.0",
-    "zod": "^3.25.57"
+    "zod": "^3.25.67"
   },
   "pnpm": {
     "overrides": {
@@ -40,12 +40,12 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.25.0",
-    "@types/react": "^19.1.2",
-    "@types/react-dom": "^19.1.2",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
     "@typescript-eslint/eslint-plugin": "^8.32.0",
     "@typescript-eslint/parser": "^8.32.0",
     "@vitejs/plugin-react": "^4.4.1",
-    "eslint": "^9.28.0",
+    "eslint": "^9.29.0",
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-react-refresh": "^0.4.20",
     "globals": "^16.0.0",

package/.docs/organized/code-examples/ai-sdk-useChat.md

@@ -15,9 +15,9 @@
     "@ai-sdk/react": "^1.2.12",
     "@mastra/core": "latest",
     "next": "^15.3.1",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "zod": "^3.25.56"
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "zod": "^3.25.67"
   },
   "pnpm": {
     "overrides": {
@@ -27,9 +27,9 @@
   "devDependencies": {
     "@eslint/eslintrc": "^3.3.0",
     "@types/node": "^20.17.57",
-    "@types/react": "^19.0.10",
-    "@types/react-dom": "^19.0.4",
-    "eslint": "^9.28.0",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "eslint": "^9.29.0",
     "eslint-config-next": "15.3.3",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",

package/.docs/organized/code-examples/assistant-ui.md

@@ -16,10 +16,10 @@
     "@assistant-ui/react-ui": "^0.1.8",
     "@mastra/client-js": "latest",
     "next": "^15.3.1",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
     "tailwindcss-animate": "^1.0.7",
-    "zod": "^3.25.56"
+    "zod": "^3.25.67"
   },
   "pnpm": {
     "overrides": {
@@ -28,9 +28,9 @@
   },
   "devDependencies": {
     "@types/node": "^20.17.57",
-    "@types/react": "^19.0.10",
-    "@types/react-dom": "^19.0.4",
-    "eslint": "^8.57.1",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "eslint": "^9.29.0",
     "eslint-config-next": "15.3.3",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",

package/.docs/organized/code-examples/bird-checker-with-express.md

@@ -28,7 +28,7 @@
     "@ai-sdk/anthropic": "latest",
     "@mastra/core": "latest",
     "ai": "latest",
-    "zod": "^3.25.56"
+    "zod": "^3.25.67"
   },
   "pnpm": {
     "overrides": {

package/.docs/organized/code-examples/bird-checker-with-nextjs-and-eval.md

@@ -23,12 +23,12 @@
     "next": "^15.3.1",
     "next-themes": "^0.4.5",
     "nuqs": "^2.4.1",
-    "react": "19.0.0-rc-02c0e824-20241028",
-    "react-dom": "19.0.0-rc-02c0e824-20241028",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
     "sonner": "^1.7.4",
     "tailwind-merge": "^2.6.0",
     "tailwindcss-animate": "^1.0.7",
-    "zod": "^3.25.56"
+    "zod": "^3.25.67"
   },
   "pnpm": {
     "overrides": {
@@ -37,9 +37,9 @@
   },
   "devDependencies": {
     "@types/node": "^20.17.57",
-    "@types/react": "^18.3.18",
-    "@types/react-dom": "^18.3.5",
-    "eslint": "^8.57.1",
+    "@types/react": "^18.3.23",
+    "@types/react-dom": "^18.3.7",
+    "eslint": "^9.29.0",
     "eslint-config-next": "15.3.3",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",

package/.docs/organized/code-examples/bird-checker-with-nextjs.md

@@ -20,12 +20,12 @@
     "next": "^15.3.1",
     "next-themes": "^0.4.5",
     "nuqs": "^2.4.1",
-    "react": "19.0.0-rc-02c0e824-20241028",
-    "react-dom": "19.0.0-rc-02c0e824-20241028",
+    "react": "19.1.0",
+    "react-dom": "19.1.0",
     "sonner": "^1.7.4",
     "tailwind-merge": "^2.6.0",
     "tailwindcss-animate": "^1.0.7",
-    "zod": "^3.25.56"
+    "zod": "^3.25.67"
   },
   "pnpm": {
     "overrides": {
@@ -36,9 +36,9 @@
   "devDependencies": {
     "@libsql/client": "^0.15.4",
     "@types/node": "^20.17.57",
-    "@types/react": "^19.0.10",
-    "@types/react-dom": "^19.0.4",
-    "eslint": "^8.57.1",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
+    "eslint": "^9.29.0",
     "eslint-config-next": "15.3.3",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",

package/.docs/organized/code-examples/client-side-tools.md

@@ -15,9 +15,9 @@
     "@ai-sdk/openai": "^1.3.22",
     "@mastra/client-js": "latest",
     "@mastra/core": "latest",
-    "react": "^19.0.0",
-    "react-dom": "^19.0.0",
-    "zod": "^3.25.56"
+    "react": "^19.1.0",
+    "react-dom": "^19.1.0",
+    "zod": "^3.25.67"
   },
   "pnpm": {
     "overrides": {
@@ -27,10 +27,10 @@
   },
   "devDependencies": {
     "@eslint/js": "^9.21.0",
-    "@types/react": "^19.0.10",
-    "@types/react-dom": "^19.0.4",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
     "@vitejs/plugin-react": "^4.3.4",
-    "eslint": "^9.28.0",
+    "eslint": "^9.29.0",
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-react-refresh": "^0.4.20",
     "globals": "^15.15.0",

package/.docs/organized/code-examples/crypto-chatbot.md

@@ -70,7 +70,7 @@
     "tailwind-merge": "^2.6.0",
     "tailwindcss-animate": "^1.0.7",
     "usehooks-ts": "^3.1.1",
-    "zod": "^3.25.56"
+    "zod": "^3.25.67"
   },
   "pnpm": {
     "overrides": {
@@ -86,13 +86,13 @@
     "@types/d3-scale": "^4.0.9",
     "@types/node": "^22.15.29",
     "@types/pdf-parse": "^1.1.4",
-    "@types/react": "^19.1",
-    "@types/react-dom": "^19.1",
+    "@types/react": "^19.1.8",
+    "@types/react-dom": "^19.1.6",
     "drizzle-kit": "^0.31.0",
-    "eslint": "^9.28.0",
+    "eslint": "^9.29.0",
     "eslint-config-next": "15.3.3",
-    "eslint-config-prettier": "^9.1.0",
-    "eslint-import-resolver-typescript": "^3.10.1",
+    "eslint-config-prettier": "^10.1.5",
+    "eslint-import-resolver-typescript": "^4.4.3",
     "eslint-plugin-import": "^2.31.0",
     "eslint-plugin-tailwindcss": "^3.18.0",
     "postcss": "^8.5.3",

package/.docs/organized/code-examples/experimental-auth-weather-agent.md

@@ -23,7 +23,7 @@
     "@mastra/auth-auth0": "latest",
     "@mastra/auth-workos": "latest",
     "@mastra/auth-clerk": "latest",
-    "zod": "^3.25.56"
+    "zod": "^3.25.67"
   },
   "devDependencies": {
     "dotenv-cli": "^8.0.0"

package/.docs/organized/code-examples/fireworks-r1.md

@@ -23,7 +23,7 @@
     "gradient-string": "^3.0.0",
     "ora": "^8.2.0",
     "tinycolor2": "^1.6.0",
-    "zod": "^3.25.56"
+    "zod": "^3.25.67"
   },
   "devDependencies": {
     "@types/node": "^20.17.57",

package/.docs/organized/code-examples/mcp-configuration.md

@@ -19,9 +19,9 @@
     "@mastra/core": "latest",
     "@mastra/mcp": "latest",
     "@mastra/memory": "latest",
-    "@modelcontextprotocol/sdk": "^1.9.0",
+    "@modelcontextprotocol/sdk": "^1.13.0",
     "chalk": "^5.4.1",
-    "zod": "^3.25.56",
+    "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.5"
   },
   "devDependencies": {

package/.docs/organized/code-examples/mcp-registry-registry.md

@@ -19,7 +19,7 @@
     "@mastra/core": "latest",
     "@mastra/mcp": "latest",
     "@mastra/mcp-registry-registry": "latest",
-    "zod": "^3.25.56"
+    "zod": "^3.25.67"
   },
   "pnpm": {
     "overrides": {