@mastra/mcp-docs-server 1.0.0-beta.9 → 1.0.1

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

@@ -7,7 +7,7 @@
     "@mastra/core": "latest",
     "@mastra/mcp": "latest",
     "@mastra/memory": "latest",
-    "@modelcontextprotocol/sdk": "^1.13.0",
+    "@modelcontextprotocol/sdk": "^1.24.0",
     "chalk": "^5.4.1",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6"

package/.docs/organized/code-examples/mcp-server-adapters.md

@@ -13,7 +13,7 @@
     "@mastra/auth-auth0": "latest",
     "@mastra/auth-workos": "latest",
     "@mastra/auth-clerk": "latest",
-    "hono": "^4.10.4",
+    "hono": "^4.11.3",
     "@hono/node-server": "^1.19.6",
     "express": "^5.1.0",
     "mastra": "latest",
@@ -23,7 +23,7 @@
     "@types/express": "^5.0.5",
     "@types/node": "22.13.17",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }
 ```

package/.docs/organized/code-examples/memory-per-resource-example.md

@@ -8,13 +8,13 @@
     "@mastra/memory": "latest",
     "@mastra/libsql": "latest",
     "chalk": "^5.3.0",
-    "dotenv": "^16.4.7",
-    "ora": "^8.1.1",
+    "dotenv": "^17.2.3",
+    "ora": "^9.0.0",
     "tsx": "^4.19.2"
   },
   "devDependencies": {
     "@types/node": "22.13.17",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }
 ```

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

@@ -8,7 +8,7 @@
     "@mastra/memory": "latest",
     "ai": "latest",
     "chalk": "^5.4.1",
-    "ora": "^8.2.0"
+    "ora": "^9.0.0"
   }
 }
 ```

package/.docs/organized/code-examples/memory-with-context.md

@@ -7,7 +7,7 @@
     "@mastra/core": "latest",
     "@mastra/memory": "latest",
     "chalk": "^5.4.1",
-    "ora": "^8.2.0"
+    "ora": "^9.0.0"
   }
 }
 ```

package/.docs/organized/code-examples/memory-with-processors.md

@@ -8,7 +8,7 @@
     "@mastra/memory": "latest",
     "ai": "^4.3.19",
     "chalk": "^5.4.1",
-    "dotenv": "^16.3.1",
+    "dotenv": "^17.2.3",
     "js-tiktoken": "^1.0.13",
     "tiktoken": "^1.0.13",
     "tsx": "^4.6.2",

package/.docs/organized/code-examples/openapi-spec-writer.md

@@ -16,7 +16,7 @@
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.454.0",
-    "next": "15.4.7",
+    "next": "15.4.9",
     "react": "^19.1.1",
     "react-dom": "^19.1.1",
     "react-syntax-highlighter": "^15.6.1",
@@ -34,10 +34,10 @@
     "@types/react-dom": "^19.1.7",
     "@types/react-syntax-highlighter": "^15.5.13",
     "eslint": "^9.37.0",
-    "eslint-config-next": "15.5.6",
+    "eslint-config-next": "16.1.1",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   },
   "peerDependencies": {
     "react": ">= 0.14.0 || 19",

package/.docs/organized/code-examples/quick-start.md

@@ -5,7 +5,7 @@
   "devDependencies": {
     "@types/node": "22.13.17",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.3",
+    "typescript": "^5.9.3",
     "zod": "^3.25.76"
   },
   "dependencies": {
@@ -75,14 +75,10 @@ export const catOne = new Agent({
 import { Mastra } from '@mastra/core/mastra';
 import { PinoLogger } from '@mastra/loggers';
 import { catOne } from './agents/agent';
-import { logCatWorkflow as legacy_catWorkflow } from './legacy-workflows';
 import { logCatWorkflow } from './workflows';
 
 export const mastra = new Mastra({
   agents: { catOne },
-  legacy_workflows: {
-    legacy_catWorkflow,
-  },
   workflows: {
     logCatWorkflow,
   },

package/.docs/organized/code-examples/server-app-access.md

@@ -5,13 +5,13 @@
   "dependencies": {
     "@mastra/core": "latest",
     "@mastra/hono": "latest",
-    "hono": "^4.10.4",
+    "hono": "^4.11.3",
     "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/node": "22.13.17",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }
 ```

package/.docs/organized/code-examples/server-express-adapter.md

@@ -13,7 +13,7 @@
     "@types/express": "^5.0.5",
     "@types/node": "22.13.17",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }
 ```

package/.docs/organized/code-examples/server-fastify-adapter.md

@@ -0,0 +1,83 @@
+### package.json
+```json
+{
+  "name": "examples-server-fastify-adapter",
+  "dependencies": {
+    "@ai-sdk/openai": "latest",
+    "@mastra/core": "latest",
+    "@mastra/fastify": "latest",
+    "fastify": "^5.6.2",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "22.13.17",
+    "tsx": "^4.19.3",
+    "typescript": "^5.9.3"
+  }
+}
+```
+
+### mastra/agents/assistant.ts
+```typescript
+import { Agent } from '@mastra/core/agent';
+import { openai } from '@ai-sdk/openai';
+
+export const assistantAgent = new Agent({
+  id: 'assistantAgent',
+  name: 'Assistant',
+  instructions: 'You are a helpful assistant. Answer questions concisely.',
+  model: openai('gpt-4o-mini'),
+});
+
+```
+
+### mastra/index.ts
+```typescript
+import { Mastra } from '@mastra/core/mastra';
+
+import { assistantAgent } from './agents/assistant';
+
+export const mastra = new Mastra({
+  agents: { assistantAgent },
+});
+
+```
+
+### server.ts
+```typescript
+/**
+ * Fastify Server Adapter Example
+ *
+ * This demonstrates how to use @mastra/fastify to run Mastra with Fastify.
+ *
+ * Features shown:
+ * - Basic server setup with MastraServer
+ * - Custom routes added after init()
+ * - Accessing Mastra context via request.mastra
+ */
+
+import Fastify from 'fastify';
+import { MastraServer } from '@mastra/fastify';
+
+import { mastra } from './mastra';
+
+const app = Fastify();
+const server = new MastraServer({ app, mastra });
+
+await server.init();
+
+// Custom route with access to Mastra context via request.mastra
+app.get('/health', async request => {
+  const mastraInstance = request.mastra;
+  const agents = Object.keys(mastraInstance.listAgents());
+  return { status: 'ok', agents };
+});
+
+const port = 4111;
+
+app.listen({ port }, () => {
+  console.log(`Server running on http://localhost:${port}`);
+  console.log(`Try: curl http://localhost:${port}/api/agents`);
+});
+
+```

package/.docs/organized/code-examples/server-hono-adapter.md

@@ -7,13 +7,13 @@
     "@mastra/core": "latest",
     "@mastra/hono": "latest",
     "@hono/node-server": "^1.14.3",
-    "hono": "^4.10.4",
+    "hono": "^4.11.3",
     "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/node": "22.13.17",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.3"
+    "typescript": "^5.9.3"
   }
 }
 ```

package/.docs/organized/code-examples/server-koa-adapter.md

@@ -0,0 +1,94 @@
+### package.json
+```json
+{
+  "name": "examples-server-koa-adapter",
+  "dependencies": {
+    "@ai-sdk/openai": "latest",
+    "@mastra/core": "latest",
+    "@mastra/koa": "latest",
+    "koa": "^3.1.1",
+    "koa-bodyparser": "^4.4.1",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/koa": "^2.15.0",
+    "@types/koa-bodyparser": "^4.3.13",
+    "@types/node": "22.13.17",
+    "tsx": "^4.19.3",
+    "typescript": "^5.9.3"
+  }
+}
+```
+
+### mastra/agents/assistant.ts
+```typescript
+import { Agent } from '@mastra/core/agent';
+import { openai } from '@ai-sdk/openai';
+
+export const assistantAgent = new Agent({
+  id: 'assistantAgent',
+  name: 'Assistant',
+  instructions: 'You are a helpful assistant. Answer questions concisely.',
+  model: openai('gpt-4o-mini'),
+});
+
+```
+
+### mastra/index.ts
+```typescript
+import { Mastra } from '@mastra/core/mastra';
+
+import { assistantAgent } from './agents/assistant';
+
+export const mastra = new Mastra({
+  agents: { assistantAgent },
+});
+
+```
+
+### server.ts
+```typescript
+/**
+ * Koa Server Adapter Example
+ *
+ * This demonstrates how to use @mastra/koa to run Mastra with Koa.
+ *
+ * Features shown:
+ * - Basic server setup with MastraServer
+ * - Required koa-bodyparser middleware for JSON parsing
+ * - Custom routes added after init()
+ * - Accessing Mastra context via ctx.state.mastra
+ */
+
+import Koa from 'koa';
+import bodyParser from 'koa-bodyparser';
+import { MastraServer } from '@mastra/koa';
+
+import { mastra } from './mastra';
+
+const app = new Koa();
+app.use(bodyParser()); // Required for body parsing
+
+const server = new MastraServer({ app, mastra });
+
+await server.init();
+
+// Custom route with access to Mastra context via ctx.state.mastra
+app.use(async (ctx, next) => {
+  if (ctx.path === '/health' && ctx.method === 'GET') {
+    const mastraInstance = ctx.state.mastra;
+    const agents = Object.keys(mastraInstance.listAgents());
+    ctx.body = { status: 'ok', agents };
+    return;
+  }
+  await next();
+});
+
+const port = 4111;
+
+app.listen(port, () => {
+  console.log(`Server running on http://localhost:${port}`);
+  console.log(`Try: curl http://localhost:${port}/api/agents`);
+});
+
+```

package/.docs/organized/code-examples/stock-price-tool.md

@@ -70,7 +70,26 @@ import { createTool } from '@mastra/core/tools';
 import { z } from 'zod';
 
 export const getStockPrice = async (symbol: string) => {
-  const data = await fetch(`https://mastra-stock-data.vercel.app/api/stock-data?symbol=${symbol}`).then(r => r.json());
+  const response = await fetch(`https://mastra-stock-data.vercel.app/api/stock-data?symbol=${symbol}`);
+
+  if (!response.ok) {
+    const errorText = await response.text();
+    throw new Error(`Failed to fetch stock price for ${symbol}: ${response.status} ${errorText}`);
+  }
+
+  let data;
+  try {
+    data = await response.json();
+  } catch (error) {
+    throw new Error(
+      `Failed to parse JSON response for ${symbol}: ${error instanceof Error ? error.message : String(error)}`,
+    );
+  }
+
+  if (!data.prices || !data.prices['4. close']) {
+    throw new Error(`Invalid response format for symbol ${symbol}: ${JSON.stringify(data)}`);
+  }
+
   return data.prices['4. close'];
 };
 
@@ -80,7 +99,7 @@ export const stockPrices = createTool({
     symbol: z.string(),
   }),
   description: `Fetches the last day's closing stock price for a given symbol`,
-  execute: async input => {
+  execute: async (inputData, context) => {
     console.log('Using tool to fetch stock price for', inputData.symbol);
     return {
       symbol: inputData.symbol,

package/.docs/organized/code-examples/workflow-ai-recruiter.md

@@ -6,7 +6,7 @@
     "@types/node": "22.13.17",
     "mastra": "latest",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.3",
+    "typescript": "^5.9.3",
     "zod": "^3.25.76"
   },
   "dependencies": {

package/.docs/organized/code-examples/workflow-with-inline-steps.md

@@ -6,7 +6,7 @@
     "@types/node": "22.13.17",
     "mastra": "latest",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.3",
+    "typescript": "^5.9.3",
     "zod": "^3.25.76"
   },
   "dependencies": {

package/.docs/organized/code-examples/workflow-with-memory.md

@@ -5,7 +5,7 @@
   "devDependencies": {
     "@types/node": "22.13.17",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.3",
+    "typescript": "^5.9.3",
     "zod": "^3.25.76"
   },
   "dependencies": {

package/.docs/organized/code-examples/workflow-with-separate-steps.md

@@ -6,7 +6,7 @@
     "@types/node": "22.13.17",
     "mastra": "latest",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.3",
+    "typescript": "^5.9.3",
     "zod": "^3.25.76"
   },
   "dependencies": {

package/.docs/organized/code-examples/workflow-with-suspend-resume.md

@@ -6,7 +6,7 @@
     "@types/node": "22.13.17",
     "mastra": "latest",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.3",
+    "typescript": "^5.9.3",
     "zod": "^3.25.76"
   },
   "dependencies": {

package/.docs/raw/agents/adding-voice.mdx

@@ -1,8 +1,22 @@
 ---
-title: "Adding Voice to Agents | Agents"
+title: "Voice | Agents"
+packages:
+  - "@mastra/core"
+  - "@mastra/node-audio"
+  - "@mastra/voice-azure"
+  - "@mastra/voice-cloudflare"
+  - "@mastra/voice-deepgram"
+  - "@mastra/voice-elevenlabs"
+  - "@mastra/voice-google"
+  - "@mastra/voice-murf"
+  - "@mastra/voice-openai"
+  - "@mastra/voice-openai-realtime"
+  - "@mastra/voice-playai"
+  - "@mastra/voice-sarvam"
+  - "@mastra/voice-speechify"
 ---
 
-# Adding Voice to Agents
+# Voice
 
 Mastra agents can be enhanced with voice capabilities, allowing them to speak responses and listen to user input. You can configure an agent to use either a single voice provider or combine multiple providers for different operations.
 
@@ -168,7 +182,7 @@ The following files are created:
 - **hybrid-question.mp3** – Hybrid agent's spoken question.
 - **unified-response.mp3** – Unified agent's spoken response.
 
-```typescript title="src/test-voice-agents.ts" showLineNumbers copy
+```typescript title="src/test-voice-agents.ts"
 import "dotenv/config";
 
 import path from "path";
@@ -232,7 +246,6 @@ export const unifiedVoiceAgent = new Agent({
 });
 
 export const mastra = new Mastra({
-  // ...
   agents: { hybridVoiceAgent, unifiedVoiceAgent },
 });
 
@@ -297,7 +310,7 @@ export const agent = new Agent({
   id: "aisdk-voice-agent",
   name: "AI SDK Voice Agent",
   instructions: `You are a helpful assistant with voice capabilities.`,
-  model: openai("gpt-5.1"),
+  model: "openai/gpt-5.1",
 
   // Pass AI SDK models directly to CompositeVoice
   voice: new CompositeVoice({
@@ -349,4 +362,9 @@ Mastra supports multiple voice providers for text-to-speech (TTS) and speech-to-
 | Azure           | `@mastra/voice-azure`           | TTS, STT                  | [Documentation](/reference/v1/voice/mastra-voice)    |
 | Cloudflare      | `@mastra/voice-cloudflare`      | TTS                       | [Documentation](/reference/v1/voice/mastra-voice)    |
 
-For more details on voice capabilities, see the [Voice API Reference](/reference/v1/voice/mastra-voice).
+## Next Steps
+
+- [Voice API Reference](/reference/v1/voice/mastra-voice) - Detailed API documentation for voice capabilities
+- [Text to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/text-to-speech) - Interactive story generator and other TTS implementations
+- [Speech to Text Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-text) - Voice memo app and other STT implementations
+- [Speech to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-speech) - Real-time voice conversation with call analysis