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

package/.docs/organized/changelogs/mastra.md

@@ -1,5 +1,31 @@
 # mastra
 
+## 0.16.0-alpha.1
+
+### Minor Changes
+
+- Update peer dependencies to match core package version bump (0.21.0) ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
+
+### Patch Changes
+
+- Create unified Sidebar component to use on Playground and Cloud ([#8655](https://github.com/mastra-ai/mastra/pull/8655))
+
+- Use only zod validation in dynamic form ([#8802](https://github.com/mastra-ai/mastra/pull/8802))
+
+- Add support for --debug options to build/dev commands to add more logging ([#8792](https://github.com/mastra-ai/mastra/pull/8792))
+
+- Add div wrapper around entity tables to fix table vertical position ([#8758](https://github.com/mastra-ai/mastra/pull/8758))
+
+- Customize AITraces type to seamlessly work on Cloud too ([#8759](https://github.com/mastra-ai/mastra/pull/8759))
+
+- Stream finalResult from network loop ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
+
+- Improve README ([#8819](https://github.com/mastra-ai/mastra/pull/8819))
+
+- Updated dependencies [[`1ed9670`](https://github.com/mastra-ai/mastra/commit/1ed9670d3ca50cb60dc2e517738c5eef3968ed27), [`ca5a01f`](https://github.com/mastra-ai/mastra/commit/ca5a01f0dd4dabdbfde3beeaf92c7333e0f9bb39), [`158381d`](https://github.com/mastra-ai/mastra/commit/158381d39335be934b81ef8a1947bccace492c25), [`fb703b9`](https://github.com/mastra-ai/mastra/commit/fb703b9634eeaff1a6eb2b5531ce0f9e8fb04727), [`dfe856f`](https://github.com/mastra-ai/mastra/commit/dfe856f7f60ff4765b75930e7b5d82dd0f0f7d89), [`37a2314`](https://github.com/mastra-ai/mastra/commit/37a23148e0e5a3b40d4f9f098b194671a8a49faf), [`05a9dee`](https://github.com/mastra-ai/mastra/commit/05a9dee3d355694d28847bfffb6289657fcf7dfa), [`e3c1077`](https://github.com/mastra-ai/mastra/commit/e3c107763aedd1643d3def5df450c235da9ff76c), [`1bccdb3`](https://github.com/mastra-ai/mastra/commit/1bccdb33eb90cbeba2dc5ece1c2561fb774b26b6), [`5ef944a`](https://github.com/mastra-ai/mastra/commit/5ef944a3721d93105675cac2b2311432ff8cc393), [`d6b186f`](https://github.com/mastra-ai/mastra/commit/d6b186fb08f1caf1b86f73d3a5ee88fb999ca3be), [`65493b3`](https://github.com/mastra-ai/mastra/commit/65493b31c36f6fdb78f9679f7e1ecf0c250aa5ee), [`a998b8f`](https://github.com/mastra-ai/mastra/commit/a998b8f858091c2ec47683e60766cf12d03001e4), [`8a37bdd`](https://github.com/mastra-ai/mastra/commit/8a37bddb6d8614a32c5b70303d583d80c620ea61), [`e0e1cf1`](https://github.com/mastra-ai/mastra/commit/e0e1cf1e37b9dc61099ab331a6d386e44b816310)]:
+  - @mastra/core@0.21.0-alpha.1
+  - @mastra/deployer@0.21.0-alpha.1
+
 ## 0.15.2-alpha.0
 
 ### Patch Changes
@@ -273,30 +299,4 @@
 
 - Add observe strean to get streans after workflow has been interrupted ([#8318](https://github.com/mastra-ai/mastra/pull/8318))
 
-- Updated dependencies [[`00cb6bd`](https://github.com/mastra-ai/mastra/commit/00cb6bdf78737c0fac14a5a0c7b532a11e38558a), [`869ba22`](https://github.com/mastra-ai/mastra/commit/869ba222e1d6b58fc1b65e7c9fd55ca4e01b8c2f), [`1b73665`](https://github.com/mastra-ai/mastra/commit/1b73665e8e23f5c09d49fcf3e7d709c75259259e), [`989a4db`](https://github.com/mastra-ai/mastra/commit/989a4dbbaf07a2794d0e1863714c6d10f1244d6b), [`f7d7475`](https://github.com/mastra-ai/mastra/commit/f7d747507341aef60ed39e4b49318db1f86034a6), [`084b77b`](https://github.com/mastra-ai/mastra/commit/084b77b2955960e0190af8db3f77138aa83ed65c), [`a93ff84`](https://github.com/mastra-ai/mastra/commit/a93ff84b5e1af07ee236ac8873dac9b49aa5d501), [`bc5aacb`](https://github.com/mastra-ai/mastra/commit/bc5aacb646d468d325327e36117129f28cd13bf6), [`03622f8`](https://github.com/mastra-ai/mastra/commit/03622f86e9d7342197f80f95333ea3ff65c783ae), [`6b5af12`](https://github.com/mastra-ai/mastra/commit/6b5af12ce9e09066e0c32e821c203a6954498bea), [`bf60e4a`](https://github.com/mastra-ai/mastra/commit/bf60e4a89c515afd9570b7b79f33b95e7d07c397), [`d41aee5`](https://github.com/mastra-ai/mastra/commit/d41aee526d124e35f42720a08e64043229193679), [`e8fe13c`](https://github.com/mastra-ai/mastra/commit/e8fe13c4b4c255a42520127797ec394310f7c919), [`3ca833d`](https://github.com/mastra-ai/mastra/commit/3ca833dc994c38e3c9b4f9b4478a61cd8e07b32a), [`1edb8d1`](https://github.com/mastra-ai/mastra/commit/1edb8d1cfb963e72a12412990fb9170936c9904c), [`fbf6e32`](https://github.com/mastra-ai/mastra/commit/fbf6e324946332d0f5ed8930bf9d4d4479cefd7a), [`4753027`](https://github.com/mastra-ai/mastra/commit/4753027ee889288775c6958bdfeda03ff909af67)]:
-  - @mastra/core@0.20.0-alpha.0
-  - @mastra/deployer@0.20.0-alpha.0
-  - @mastra/mcp@0.13.3-alpha.0
-  - @mastra/loggers@0.10.15-alpha.0
-
-## 0.13.4
-
-### Patch Changes
-
-- disable network label when memory is not enabled OR the agent has no subagents ([#8341](https://github.com/mastra-ai/mastra/pull/8341))
-
-- Added Mastra model router to Playground UI ([#8332](https://github.com/mastra-ai/mastra/pull/8332))
-
-- Updated dependencies [[`4a70ccc`](https://github.com/mastra-ai/mastra/commit/4a70ccc5cfa12ae9c2b36545a5814cd98e5a0ead), [`0992b8b`](https://github.com/mastra-ai/mastra/commit/0992b8bf0f4f1ba7ad9940883ec4bb8d867d3105), [`283bea0`](https://github.com/mastra-ai/mastra/commit/283bea07adbaf04a27fa3ad2df611095e0825195)]:
-  - @mastra/core@0.19.1
-  - @mastra/deployer@0.19.1
-
-## 0.13.4-alpha.1
-
-### Patch Changes
-
-- disable network label when memory is not enabled OR the agent has no subagents ([#8341](https://github.com/mastra-ai/mastra/pull/8341))
-
-- Updated dependencies [[`4a70ccc`](https://github.com/mastra-ai/mastra/commit/4a70ccc5cfa12ae9c2b36545a5814cd98e5a0ead)]:
-
-... 6120 more lines hidden. See full changelog in package directory.
+... 6146 more lines hidden. See full changelog in package directory.

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

@@ -703,7 +703,6 @@ import { Agent } from '@mastra/core/agent';
 import { openai, openai as openai_v5 } from '@ai-sdk/openai-v5';
 import { createTool } from '@mastra/core/tools';
 import { z } from 'zod';
-import { cookingTool } from '../tools';
 import { myWorkflow } from '../workflows';
 import { Memory } from '@mastra/memory';
 import { ModerationProcessor } from '@mastra/core/processors';

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

@@ -23,13 +23,13 @@
     "@types/react-dom": "^19.1.7",
     "@typescript-eslint/eslint-plugin": "^8.38.0",
     "@typescript-eslint/parser": "^8.38.0",
-    "@vitejs/plugin-react": "^4.4.1",
+    "@vitejs/plugin-react": "^5.0.4",
     "eslint": "^9.36.0",
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-react-refresh": "^0.4.22",
     "globals": "^16.0.0",
     "typescript": "^5.8.3",
-    "vite": "^6.3.5"
+    "vite": "^7.1.9"
   }
 }
 ```

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

@@ -14,14 +14,14 @@
     "@eslint/js": "^9.21.0",
     "@types/react": "^19.1.9",
     "@types/react-dom": "^19.1.7",
-    "@vitejs/plugin-react": "^4.3.4",
+    "@vitejs/plugin-react": "^5.0.4",
     "eslint": "^9.36.0",
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-react-refresh": "^0.4.22",
     "globals": "^15.15.0",
     "typescript": "~5.8.3",
     "typescript-eslint": "^8.38.0",
-    "vite": "^6.2.0"
+    "vite": "^7.1.9"
   }
 }
 ```

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

@@ -2,7 +2,7 @@
 
 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.
 
-## Using a Single Provider
+## Basic usage
 
 The simplest way to add voice to an agent is to use a single provider for both speaking and listening:
 
@@ -39,30 +39,6 @@ try {
 }
 ```
 
-## Using Multiple Providers
-
-For more flexibility, you can use different providers for speaking and listening using the CompositeVoice class:
-
-```typescript
-import { Agent } from "@mastra/core/agent";
-import { CompositeVoice } from "@mastra/core/voice";
-import { OpenAIVoice } from "@mastra/voice-openai";
-import { PlayAIVoice } from "@mastra/voice-playai";
-import { openai } from "@ai-sdk/openai";
-
-export const agent = new Agent({
-  name: "Agent",
-  instructions: `You are a helpful assistant with both STT and TTS capabilities.`,
-  model: openai("gpt-4o"),
-
-  // Create a composite voice using OpenAI for listening and PlayAI for speaking
-  voice: new CompositeVoice({
-    input: new OpenAIVoice(),
-    output: new PlayAIVoice(),
-  }),
-});
-```
-
 ## Working with Audio Streams
 
 The `speak()` and `listen()` methods work with Node.js streams. Here's how to save and load audio files:
@@ -176,6 +152,123 @@ agent.voice.on("error", (error) => {
 });
 ```
 
+## Examples
+
+### End-to-end voice interaction
+
+This example demonstrates a voice interaction between two agents. The hybrid voice agent, which uses multiple providers, speaks a question, which is saved as an audio file. The unified voice agent listens to that file, processes the question, generates a response, and speaks it back. Both audio outputs are saved to the `audio` directory.
+
+The following files are created:
+
+- **hybrid-question.mp3** – Hybrid agent's spoken question.
+- **unified-response.mp3** – Unified agent's spoken response.
+
+```typescript filename="src/test-voice-agents.ts" showLineNumbers copy
+import "dotenv/config";
+
+import path from "path";
+import { createReadStream } from "fs";
+import { Agent } from "@mastra/core/agent";
+import { CompositeVoice } from "@mastra/core/voice";
+import { OpenAIVoice } from "@mastra/voice-openai";
+import { Mastra } from "@mastra/core/mastra";
+import { openai } from "@ai-sdk/openai";
+
+// Saves an audio stream to a file in the audio directory, creating the directory if it doesn't exist.
+export const saveAudioToFile = async (audio: NodeJS.ReadableStream, filename: string): Promise<void> => {
+  const audioDir = path.join(process.cwd(), "audio");
+  const filePath = path.join(audioDir, filename);
+
+  await fs.promises.mkdir(audioDir, { recursive: true });
+
+  const writer = createWriteStream(filePath);
+  audio.pipe(writer);
+  return new Promise((resolve, reject) => {
+    writer.on("finish", resolve);
+    writer.on("error", reject);
+  });
+};
+
+// Saves an audio stream to a file in the audio directory, creating the directory if it doesn't exist.
+export const convertToText = async (input: string | NodeJS.ReadableStream): Promise<string> => {
+  if (typeof input === "string") {
+    return input;
+  }
+
+  const chunks: Buffer[] = [];
+  return new Promise((resolve, reject) => {
+    input.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
+    input.on("error", reject);
+    input.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
+  });
+};
+
+export const hybridVoiceAgent = new Agent({
+  name: "hybrid-voice-agent",
+  model: openai("gpt-4o"),
+  instructions: "You can speak and listen using different providers.",
+  voice: new CompositeVoice({
+    input: new OpenAIVoice(),
+    output: new OpenAIVoice()
+  })
+});
+ 
+export const unifiedVoiceAgent = new Agent({
+  name: "unified-voice-agent",
+  instructions: "You are an agent with both STT and TTS capabilities.",
+  model: openai("gpt-4o"),
+  voice: new OpenAIVoice()
+});
+
+export const mastra = new Mastra({
+  // ...
+  agents: { hybridVoiceAgent, unifiedVoiceAgent }
+});
+
+const hybridVoiceAgent = mastra.getAgent("hybridVoiceAgent");
+const unifiedVoiceAgent = mastra.getAgent("unifiedVoiceAgent");
+
+const question = "What is the meaning of life in one sentence?";
+
+const hybridSpoken = await hybridVoiceAgent.voice.speak(question);
+
+await saveAudioToFile(hybridSpoken!, "hybrid-question.mp3");
+
+const audioStream = createReadStream(path.join(process.cwd(), "audio", "hybrid-question.mp3"));
+const unifiedHeard = await unifiedVoiceAgent.voice.listen(audioStream);
+
+const inputText = await convertToText(unifiedHeard!);
+
+const unifiedResponse = await unifiedVoiceAgent.generate(inputText);
+const unifiedSpoken = await unifiedVoiceAgent.voice.speak(unifiedResponse.text);
+
+await saveAudioToFile(unifiedSpoken!, "unified-response.mp3");
+```
+
+### Using Multiple Providers
+
+For more flexibility, you can use different providers for speaking and listening using the CompositeVoice class:
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+import { CompositeVoice } from "@mastra/core/voice";
+import { OpenAIVoice } from "@mastra/voice-openai";
+import { PlayAIVoice } from "@mastra/voice-playai";
+import { openai } from "@ai-sdk/openai";
+
+export const agent = new Agent({
+  name: "Agent",
+  instructions: `You are a helpful assistant with both STT and TTS capabilities.`,
+  model: openai("gpt-4o"),
+
+  // Create a composite voice using OpenAI for listening and PlayAI for speaking
+  voice: new CompositeVoice({
+    input: new OpenAIVoice(),
+    output: new PlayAIVoice(),
+  }),
+});
+```
+
 ## Supported Voice Providers
 
 Mastra supports multiple voice providers for text-to-speech (TTS) and speech-to-text (STT) capabilities:

package/.docs/raw/agents/agent-memory.mdx

@@ -1,40 +1,80 @@
 ---
-title: "Using Agent Memory | Agents | Mastra Docs"
-description: Documentation on how agents in Mastra use memory to store conversation history and contextual information.
+title: "Agent Memory | Agents | Mastra Docs"
+description: Learn how to add memory to agents to store conversation history and maintain context across interactions.
 ---
 
+import { Callout } from "nextra/components";
+
 # Agent Memory
 
-Agents in Mastra can leverage a powerful memory system to store conversation history, recall relevant information, and maintain persistent context across interactions. This allows agents to have more natural, stateful conversations.
+Agents can use memory to store conversation history, recall relevant information, and maintain context across interactions. This enables more natural, stateful conversations throughout a user’s session.
+
+## When to use memory
+
+Use memory when an agent needs to retain information across multiple user interactions. This includes recalling user-specific details, facts, or tool calls and their results. Without memory, the agent handles each request in isolation, with no awareness of previous messages or responses.
+
+For more information about the different ways memory works in Mastra see the following pages.
+
+- [Working Memory](../memory/working-memory.mdx)
+- [Semantic Recall](../memory/semantic-recall.mdx)
+
+## Prerequisites
 
-## Enabling memory for an agent
+Memory requires a storage provider to persist conversation history, including user messages and agent responses. You can use **shared storage** to define a single provider for all agents, or **dedicated storage** to configure separate providers for individual agents.
 
-To enable memory, instantiate the `Memory` class and pass it to your agent's configuration using the `memory` parameter. You also need to install the memory package and a storage adapter:
+Install `@mastra/memory` and a storage provider.
 
 ```bash npm2yarn copy
 npm install @mastra/memory@latest @mastra/libsql@latest
 ```
 
-```typescript {2-3, 10-14} filename="src/mastra/agents/test-agent.ts" showLineNumbers copy
+### Storage providers
+
+Mastra supports multiple storage providers. Popular options include:
+
+- [LibSQL](../../reference/storage/libsql.mdx)
+- [PostgreSQL](../../reference/storage/postgresql.mdx)
+- [Cloudflare D1](../../reference/storage/cloudflare-d1.mdx)
+
+<Callout type="warning">
+`LibSQLStore` works well for local development and when deploying to [Mastra Cloud](../mastra-cloud/overview.mdx), but may not be supported by some [serverless platforms](../deployment/serverless-platforms/index.mdx) or [cloud providers](../deployment/cloud-providers/index.mdx).
+</Callout>
+
+### Shared storage
+
+Use shared storage for a simple, centralized setup across agents. Add the storage adapter to your main Mastra instance to make it available to all agents by default.
+
+```typescript {6-8} filename="src/mastra/index.ts" showLineNumbers copy
+import { Mastra } from "@mastra/core/mastra";
+import { LibSQLStore } from "@mastra/libsql";
+
+export const mastra = new Mastra({
+  // ..
+  storage: new LibSQLStore({
+    url: ":memory:"
+  }),
+});
+```
+
+### Dedicated storage
+
+Use dedicated storage when agents need to keep data separate, use different providers, or tailor storage requirements for specific users. Add the storage adapter directly to the agent’s `memory` configuration option.
+
+```typescript {7-10} filename="src/mastra/agents/memory-agent.ts" showLineNumbers copy
 import { Agent } from "@mastra/core/agent";
 import { Memory } from "@mastra/memory";
 import { LibSQLStore } from "@mastra/libsql";
-import { openai } from "@ai-sdk/openai";
 
-export const testAgent = new Agent({
-  name: "test-agent",
-  instructions: "You are a helpful assistant with memory.",
-  model: openai("gpt-4o"),
+export const memoryAgent = new Agent({
+  // ...
   memory: new Memory({
     storage: new LibSQLStore({
-      url: "file:../../memory.db"
+      url: "file:../../memory-agent.db"
     })
   })
 });
 ```
 
-This basic setup uses the default settings. Visit the [Memory documentation](../memory/overview.mdx) for more configuration info.
-
 ## Memory in agent calls
 
 When calling `.generate()` or `.stream()`, include a `memory` object with both `resource` and `thread` to enable memory.
@@ -45,10 +85,10 @@ When calling `.generate()` or `.stream()`, include a `memory` object with both `
 These fields tell the agent where to store and retrieve context, enabling persistent, thread-aware memory across interactions.
 
 ```typescript {3-4}
-const response = await testAgent.generate("Remember my favorite color is blue.", {
+const response = await memoryAgent.generate("Remember my favorite color is blue.", {
   memory: {
-    resource: "user_alice",
-    thread: "preferences_thread",
+    thread: "user-123",
+    resource: "test-123"
   }
 });
 ```
@@ -56,25 +96,22 @@ const response = await testAgent.generate("Remember my favorite color is blue.",
 To recall information stored in memory, call the agent with the same `resource` and `thread` values used in the original interaction.
 
 ```typescript {3-4}
-const response = await testAgent.generate("What's my favorite color?", {
+const response = await memoryAgent.generate("What's my favorite color?", {
   memory: {
-    resource: "user_alice",
-    thread: "preferences_thread",
+    thread: "user-123",
+    resource: "test-123"
   }
 });
 ```
 
-## Memory with `RuntimeContext`
+## Using `RuntimeContext`
 
-You can configure memory dynamically using [RuntimeContext](./runtime-context.mdx), just like `instructions`, `models`, and `tools`. This gives you fine-grained control over memory behavior. For example, you can select different memory systems per user, enable features conditionally, or adapt configurations across environments.
+Use `RuntimeContext` to access request-specific values. This lets you conditionally select different memory or storage configurations based on the context of the request.
 
-### Agent configuration
-
-```typescript {18-20} filename="src/mastra/agents/test-agent.ts" showLineNumbers copy
-import { Agent } from "@mastra/core/agent";
-import { Memory } from "@mastra/memory";
-import { LibSQLStore } from "@mastra/libsql";
-import { openai } from "@ai-sdk/openai";
+```typescript filename="src/mastra/agents/memory-agent.ts" showLineNumbers
+export type UserTier = {
+  "user-tier": "enterprise" | "pro";
+};
 
 const premiumMemory = new Memory({
  // ...
@@ -84,68 +121,14 @@ const standardMemory = new Memory({
   // ...
 });
 
-export const testAgent = new Agent({
-  name: "test-agent",
-  instructions: "You are a helpful assistant with tiered memory capabilities.",
-  model: openai("gpt-4o"),
-  memory: ({ runtimeContext }) => {
-    const userTier = runtimeContext.get("userTier");
-    return userTier === "premium" ? premiumMemory : standardMemory;
-  }
-});
-```
-
-### Agent usage
-
-Pass a configured `RuntimeContext` instance to an agent to enable conditional logic during execution. This allows the agent to adapt its behavior based on runtime values.
-
-```typescript {1,4,6, 13} showLineNumbers copy
-import { RuntimeContext } from "@mastra/core/runtime-context";
-
-const testAgent = mastra.getAgent("testAgent");
-const runtimeContext = new RuntimeContext();
-
-runtimeContext.set("userTier", "premium");
-
-const response = await testAgent.generate("Remember my favorite color is blue.", {
-  memory: {
-    resource: "user_alice",
-    thread: { id: "preferences_thread" }
-  },
-  runtimeContext
-});
-```
-
-
-## Async memory configuration
-
-Memory can be configured asynchronously to support use cases like fetching user-specific settings from a database, validating access with Auth, or loading additional data from a remote service.
-
-```typescript {18, 22} filename="src/mastra/agents/test-agent.ts" showLineNumbers copy
-import { Agent } from "@mastra/core/agent";
-import { Memory } from "@mastra/memory";
-import { LibSQLStore } from "@mastra/libsql";
-import { openai } from "@ai-sdk/openai";
-
-const premiumMemory = new Memory({
- // ...
-});
-
-const standardMemory = new Memory({
+export const memoryAgent = new Agent({
   // ...
-});
-
-export const testAgent = new Agent({
-  name: "test-agent",
-  instructions: "You are a helpful assistant with tiered memory capabilities.",
-  model: openai("gpt-4o"),
-  memory: async ({ runtimeContext }) => {
-    const userId = runtimeContext.get("userId");
-
-    // Example database lookup using `userId`
-    const userTier = await query(`SELECT user_tier FROM users WHERE userId = $1`, [userId]);
+  memory: ({ runtimeContext }) => {
+    const userTier = runtimeContext.get("user-tier") as UserTier["user-tier"];
 
-    return userTier === "premium" ? premiumMemory : standardMemory;
+    return userTier === "enterprise"
+      ? premiumMemory
+      : standardMemory;
   }
 });
 ```
@@ -155,3 +138,4 @@ export const testAgent = new Agent({
 - [Working Memory](../memory/working-memory.mdx)
 - [Semantic Recall](../memory/semantic-recall.mdx)
 - [Threads and Resources](../memory/threads-and-resources.mdx)
+- [Runtime Context](../server-db/runtime-context.mdx)

package/.docs/raw/agents/guardrails.mdx

@@ -20,7 +20,7 @@ Use processors for content moderation, prompt injection prevention, response san
 
 ## Adding processors to an agent
 
-Import and instantiate the relevant processor class, and pass it to your agent’s configuration using either the `inputProcessors` or `outputProcessors` parameter:
+Import and instantiate the relevant processor class, and pass it to your agent’s configuration using either the `inputProcessors` or `outputProcessors` option:
 
 ```typescript {3,9-17} filename="src/mastra/agents/moderated-agent.ts" showLineNumbers copy
 import { openai } from "@ai-sdk/openai";

package/.docs/raw/agents/overview.mdx

@@ -34,7 +34,7 @@ Mastra's model router auto-detects environment variables for your chosen provide
 OPENAI_API_KEY=<your-api-key>
 ```
 
-> Mastra supports more than 600 models. Choose from the full list [here](../getting-started/model-providers.mdx).
+> Mastra supports more than 600 models. Choose from the full list [here](/models).
 
 ### Create an agent
 
@@ -282,10 +282,6 @@ const response = await testAgent.generate([
 console.log(response.text);
 ```
 
-## Multi-step tool use
-
-Agents can be enhanced with tools, functions that extend their capabilities beyond text generation. Tools allow agents to perform calculations, access external systems, and process data. Agents not only decide whether to call tools they're given, they determine the parameters that should be given to that tool.
-
 For a detailed guide to creating and configuring tools, see the [Tools Overview](../tools-mcp/overview.mdx) page.
 
 ### Using `maxSteps`
@@ -314,6 +310,42 @@ const response = await testAgent.generate("Help me organize my day", {
 });
 ```
 
+## Using tools
+
+Agents can use tools to go beyond language generation, enabling structured interactions with external APIs and services. Tools allow agents to access data and perform clearly defined operations in a reliable, repeatable way.
+
+```typescript filename="src/mastra/agents/test-agent.ts" showLineNumbers
+export const testAgent = new Agent({
+  // ...
+  tools: { testTool }
+});
+```
+
+> See [Using Tools](./using-tools.mdx) for more information.
+
+## Using `RuntimeContext`
+
+Use `RuntimeContext` to access request-specific values. This lets you conditionally adjust behavior based on the context of the request.
+
+```typescript filename="src/mastra/agents/test-agent.ts" showLineNumbers
+export type UserTier = {
+  "user-tier": "enterprise" | "pro";
+};
+
+export const testAgent = new Agent({
+  // ...
+  model: ({ runtimeContext }) => {
+    const userTier = runtimeContext.get("user-tier") as UserTier["user-tier"];
+
+    return userTier === "enterprise"
+      ? openai("gpt-4o-mini")
+      : openai("gpt-4.1-nano");
+  }
+});
+```
+
+> See [Runtime Context](../server-db/runtime-context.mdx) for more information.
+
 ## Testing agents locally
 There are two ways to run and test agents.
 
@@ -353,7 +385,7 @@ npx tsx src/test-agent.ts
 
 ## Related
 
+- [Using Tools](./using-tools.mdx)
 - [Agent Memory](./agent-memory.mdx)
-- [Dynamic Agents](./dynamic-agents.mdx)
-- [Agent Tools and MCP](./using-tools-and-mcp.mdx)
+- [Runtime Context](../../examples/agents/runtime-context.mdx)
 - [Calling Agents](../../examples/agents/calling-agents.mdx)