@mastra/mcp-docs-server 0.13.39-alpha.0 → 1.0.0-beta.0

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

@@ -22,7 +22,8 @@ const voice = new OpenAIVoice();
 
 // Create an agent with voice capabilities
 export const agent = new Agent({
-  name: "Agent",
+  id: "voice-agent",
+  name: "Voice Agent",
   instructions: `You are a helpful assistant with both STT and TTS capabilities.`,
   model: openai("gpt-4o"),
   voice,
@@ -110,7 +111,8 @@ const voice = new OpenAIRealtimeVoice({
 
 // Create an agent with speech-to-speech voice capabilities
 export const agent = new Agent({
-  name: "Agent",
+  id: "speech-to-speech-agent",
+  name: "Speech-to-Speech Agent",
   instructions: `You are a helpful assistant with speech-to-speech capabilities.`,
   model: openai("gpt-4o"),
   tools: {
@@ -175,7 +177,7 @@ 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 { Mastra } from "@mastra/core";
 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.
@@ -206,14 +208,15 @@ export const convertToText = async (
 
   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")));
+    inputData.on("data", (chunk) => chunks.push(Buffer.from(chunk)));
+    inputData.on("error", reject);
+    inputData.on("end", () => resolve(Buffer.concat(chunks).toString("utf-8")));
   });
 };
 
 export const hybridVoiceAgent = new Agent({
-  name: "hybrid-voice-agent",
+  id: "hybrid-voice-agent",
+  name: "Hybrid Voice Agent",
   model: openai("gpt-4o"),
   instructions: "You can speak and listen using different providers.",
   voice: new CompositeVoice({
@@ -223,7 +226,8 @@ export const hybridVoiceAgent = new Agent({
 });
 
 export const unifiedVoiceAgent = new Agent({
-  name: "unified-voice-agent",
+  id: "unified-voice-agent",
+  name: "Unified Voice Agent",
   instructions: "You are an agent with both STT and TTS capabilities.",
   model: openai("gpt-4o"),
   voice: new OpenAIVoice(),
@@ -268,7 +272,8 @@ import { PlayAIVoice } from "@mastra/voice-playai";
 import { openai } from "@ai-sdk/openai";
 
 export const agent = new Agent({
-  name: "Agent",
+  id: "voice-agent",
+  name: "Voice Agent",
   instructions: `You are a helpful assistant with both STT and TTS capabilities.`,
   model: openai("gpt-4o"),
 
@@ -286,16 +291,16 @@ Mastra supports multiple voice providers for text-to-speech (TTS) and speech-to-
 
 | Provider        | Package                         | Features                  | Reference                                         |
 | --------------- | ------------------------------- | ------------------------- | ------------------------------------------------- |
-| OpenAI          | `@mastra/voice-openai`          | TTS, STT                  | [Documentation](/reference/voice/openai)          |
-| OpenAI Realtime | `@mastra/voice-openai-realtime` | Realtime speech-to-speech | [Documentation](/reference/voice/openai-realtime) |
-| ElevenLabs      | `@mastra/voice-elevenlabs`      | High-quality TTS          | [Documentation](/reference/voice/elevenlabs)      |
-| PlayAI          | `@mastra/voice-playai`          | TTS                       | [Documentation](/reference/voice/playai)          |
-| Google          | `@mastra/voice-google`          | TTS, STT                  | [Documentation](/reference/voice/google)          |
-| Deepgram        | `@mastra/voice-deepgram`        | STT                       | [Documentation](/reference/voice/deepgram)        |
-| Murf            | `@mastra/voice-murf`            | TTS                       | [Documentation](/reference/voice/murf)            |
-| Speechify       | `@mastra/voice-speechify`       | TTS                       | [Documentation](/reference/voice/speechify)       |
-| Sarvam          | `@mastra/voice-sarvam`          | TTS, STT                  | [Documentation](/reference/voice/sarvam)          |
-| Azure           | `@mastra/voice-azure`           | TTS, STT                  | [Documentation](/reference/voice/mastra-voice)    |
-| Cloudflare      | `@mastra/voice-cloudflare`      | TTS                       | [Documentation](/reference/voice/mastra-voice)    |
-
-For more details on voice capabilities, see the [Voice API Reference](/reference/voice/mastra-voice).
+| OpenAI          | `@mastra/voice-openai`          | TTS, STT                  | [Documentation](/reference/v1/voice/openai)          |
+| OpenAI Realtime | `@mastra/voice-openai-realtime` | Realtime speech-to-speech | [Documentation](/reference/v1/voice/openai-realtime) |
+| ElevenLabs      | `@mastra/voice-elevenlabs`      | High-quality TTS          | [Documentation](/reference/v1/voice/elevenlabs)      |
+| PlayAI          | `@mastra/voice-playai`          | TTS                       | [Documentation](/reference/v1/voice/playai)          |
+| Google          | `@mastra/voice-google`          | TTS, STT                  | [Documentation](/reference/v1/voice/google)          |
+| Deepgram        | `@mastra/voice-deepgram`        | STT                       | [Documentation](/reference/v1/voice/deepgram)        |
+| Murf            | `@mastra/voice-murf`            | TTS                       | [Documentation](/reference/v1/voice/murf)            |
+| Speechify       | `@mastra/voice-speechify`       | TTS                       | [Documentation](/reference/v1/voice/speechify)       |
+| Sarvam          | `@mastra/voice-sarvam`          | TTS, STT                  | [Documentation](/reference/v1/voice/sarvam)          |
+| 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).

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

@@ -26,7 +26,7 @@ npm install @mastra/memory@latest @mastra/libsql@latest
 
 ## Storage providers
 
-Memory requires a storage provider to persist conversation history, including user messages and agent responses. For more details on available providers and how storage works in Mastra, see the [Storage](/docs/server-db/storage) documentation.
+Memory requires a storage provider to persist conversation history, including user messages and agent responses. For more details on available providers and how storage works in Mastra, see the [Storage](/docs/v1/server-db/storage) documentation.
 
 ## Configuring memory
 
@@ -40,6 +40,8 @@ import { Agent } from "@mastra/core/agent";
 import { Memory } from "@mastra/memory";
 
 export const memoryAgent = new Agent({
+  id: 'memory-agent',
+  name: 'Memory Agent',
   // ...
   memory: new Memory({
     options: {
@@ -51,7 +53,7 @@ export const memoryAgent = new Agent({
 
 :::note
 
-See the [Memory Class](/reference/memory/memory-class) docs for a full list of configuration options.
+See the [Memory Class](/reference/v1/memory/memory-class) docs for a full list of configuration options.
 
 :::
 
@@ -62,12 +64,13 @@ See the [Memory Class](/reference/memory/memory-class) docs for a full list of c
 Add a storage provider to your main Mastra instance to enable memory across all configured agents.
 
 ```typescript {6-8} title="src/mastra/index.ts" copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { LibSQLStore } from "@mastra/libsql";
 
 export const mastra = new Mastra({
   // ..
   storage: new LibSQLStore({
+    id: 'mastra-storage',
     url: ":memory:",
   }),
 });
@@ -75,7 +78,7 @@ export const mastra = new Mastra({
 
 :::note
 
-See the [LibSQL Storage](/reference/storage/libsql) docs for a full list of configuration options.
+See the [LibSQL Storage](/reference/v1/storage/libsql) docs for a full list of configuration options.
 
 :::
 
@@ -90,9 +93,12 @@ import { Memory } from "@mastra/memory";
 import { LibSQLStore } from "@mastra/libsql";
 
 export const memoryAgent = new Agent({
+  id: 'memory-agent',
+  name: 'Memory Agent',
   // ...
   memory: new Memory({
     storage: new LibSQLStore({
+      id: 'mastra-storage',
       url: ":memory:",
     }),
   }),
@@ -108,13 +114,13 @@ Include a `memory` object with both `resource` and `thread` to track conversatio
 
 These fields tell the agent where to store and retrieve context, enabling persistent, thread-aware memory across a conversation.
 
-```typescript {3-4}
+```typescript {5-6}
 const response = await memoryAgent.generate(
   "Remember my favorite color is blue.",
   {
     memory: {
-      thread: "user-123",
-      resource: "test-123",
+      resource: "user-123",
+      thread: "conversation-123",
     },
   },
 );
@@ -125,17 +131,17 @@ To recall information stored in memory, call the agent with the same `resource`
 ```typescript {3-4}
 const response = await memoryAgent.generate("What's my favorite color?", {
   memory: {
-    thread: "user-123",
-    resource: "test-123",
+    resource: "user-123",
+    thread: "conversation-123",
   },
 });
 ```
 
 To learn more about memory see the [Memory](../memory/overview) documentation.
 
-## Using `RuntimeContext`
+## Using `RequestContext`
 
-Use [RuntimeContext](/docs/server-db/runtime-context) to access request-specific values. This lets you conditionally select different memory or storage configurations based on the context of the request.
+Use [RequestContext](/docs/v1/server-db/request-context) to access request-specific values. This lets you conditionally select different memory or storage configurations based on the context of the request.
 
 ```typescript title="src/mastra/agents/memory-agent.ts" showLineNumbers
 export type UserTier = {
@@ -151,9 +157,11 @@ const standardMemory = new Memory({
 });
 
 export const memoryAgent = new Agent({
+  id: 'memory-agent',
+  name: 'Memory Agent',
   // ...
-  memory: ({ runtimeContext }) => {
-    const userTier = runtimeContext.get("user-tier") as UserTier["user-tier"];
+  memory: ({ requestContext }) => {
+    const userTier = requestContext.get("user-tier") as UserTier["user-tier"];
 
     return userTier === "enterprise" ? premiumMemory : standardMemory;
   },
@@ -162,7 +170,7 @@ export const memoryAgent = new Agent({
 
 :::note
 
-See [Runtime Context](/docs/server-db/runtime-context) docs for more information.
+See [Request Context](/docs/v1/server-db/request-context) docs for more information.
 
 :::
 
@@ -171,4 +179,4 @@ See [Runtime Context](/docs/server-db/runtime-context) docs for more information
 - [Working Memory](../memory/working-memory)
 - [Semantic Recall](../memory/semantic-recall)
 - [Threads and Resources](../memory/threads-and-resources)
-- [Runtime Context](/docs/server-db/runtime-context)
+- [Request Context](/docs/v1/server-db/request-context)

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

@@ -28,7 +28,8 @@ import { Agent } from "@mastra/core/agent";
 import { ModerationProcessor } from "@mastra/core/processors";
 
 export const moderatedAgent = new Agent({
-  name: "moderated-agent",
+  id: "moderated-agent",
+  name: "Moderated Agent",
   instructions: "You are a helpful assistant",
   model: openai("gpt-4o-mini"),
   inputProcessors: [
@@ -55,6 +56,8 @@ The `UnicodeNormalizer` is an input processor that cleans and normalizes user in
 import { UnicodeNormalizer } from "@mastra/core/processors";
 
 export const normalizedAgent = new Agent({
+  id: "normalized-agent",
+  name: "Normalized Agent",
   // ...
   inputProcessors: [
     new UnicodeNormalizer({
@@ -65,7 +68,7 @@ export const normalizedAgent = new Agent({
 });
 ```
 
-> See [UnicodeNormalizer](/reference/processors/unicode-normalizer) for a full list of configuration options.
+> See [UnicodeNormalizer](/reference/v1/processors/unicode-normalizer) for a full list of configuration options.
 
 ### Preventing prompt injection
 
@@ -75,6 +78,8 @@ The `PromptInjectionDetector` is an input processor that scans user messages for
 import { PromptInjectionDetector } from "@mastra/core/processors";
 
 export const secureAgent = new Agent({
+  id: "secure-agent",
+  name: "Secure Agent",
   // ...
   inputProcessors: [
     new PromptInjectionDetector({
@@ -87,7 +92,7 @@ export const secureAgent = new Agent({
 });
 ```
 
-> See [PromptInjectionDetector](/reference/processors/prompt-injection-detector) for a full list of configuration options.
+> See [PromptInjectionDetector](/reference/v1/processors/prompt-injection-detector) for a full list of configuration options.
 
 ### Detecting and translating language
 
@@ -97,6 +102,8 @@ The `LanguageDetector` is an input processor that detects and translates user me
 import { LanguageDetector } from "@mastra/core/processors";
 
 export const multilingualAgent = new Agent({
+  id: "multilingual-agent",
+  name: "Multilingual Agent",
   // ...
   inputProcessors: [
     new LanguageDetector({
@@ -109,7 +116,7 @@ export const multilingualAgent = new Agent({
 });
 ```
 
-> See [LanguageDetector](/reference/processors/language-detector) for a full list of configuration options.
+> See [LanguageDetector](/reference/v1/processors/language-detector) for a full list of configuration options.
 
 ## Output processors
 
@@ -123,6 +130,8 @@ The `BatchPartsProcessor` is an output processor that combines multiple stream p
 import { BatchPartsProcessor } from "@mastra/core/processors";
 
 export const batchedAgent = new Agent({
+  id: "batched-agent",
+  name: "Batched Agent",
   // ...
   outputProcessors: [
     new BatchPartsProcessor({
@@ -134,7 +143,7 @@ export const batchedAgent = new Agent({
 });
 ```
 
-> See [BatchPartsProcessor](/reference/processors/batch-parts-processor) for a full list of configuration options.
+> See [BatchPartsProcessor](/reference/v1/processors/batch-parts-processor) for a full list of configuration options.
 
 ### Limiting token usage
 
@@ -144,6 +153,8 @@ The `TokenLimiterProcessor` is an output processor that limits the number of tok
 import { TokenLimiterProcessor } from "@mastra/core/processors";
 
 export const limitedAgent = new Agent({
+  id: "limited-agent",
+  name: "Limited Agent",
   // ...
   outputProcessors: [
     new TokenLimiterProcessor({
@@ -155,7 +166,7 @@ export const limitedAgent = new Agent({
 });
 ```
 
-> See [TokenLimiterProcessor](/reference/processors/token-limiter-processor) for a full list of configuration options.
+> See [TokenLimiterProcessor](/reference/v1/processors/token-limiter-processor) for a full list of configuration options.
 
 ### Scrubbing system prompts
 
@@ -165,6 +176,8 @@ The `SystemPromptScrubber` is an output processor that detects and redacts syste
 import { SystemPromptScrubber } from "@mastra/core/processors";
 
 const scrubbedAgent = new Agent({
+  id: "scrubbed-agent",
+  name: "Scrubbed Agent",
   outputProcessors: [
     new SystemPromptScrubber({
       model: openai("gpt-4.1-nano"),
@@ -180,7 +193,7 @@ const scrubbedAgent = new Agent({
 });
 ```
 
-> See [SystemPromptScrubber](/reference/processors/system-prompt-scrubber) for a full list of configuration options.
+> See [SystemPromptScrubber](/reference/v1/processors/system-prompt-scrubber) for a full list of configuration options.
 
 ## Hybrid processors
 
@@ -194,6 +207,8 @@ The `ModerationProcessor` is a hybrid processor that detects inappropriate or ha
 import { ModerationProcessor } from "@mastra/core/processors";
 
 export const moderatedAgent = new Agent({
+  id: "moderated-agent",
+  name: "Moderated Agent",
   // ...
   inputProcessors: [
     new ModerationProcessor({
@@ -211,7 +226,7 @@ export const moderatedAgent = new Agent({
 });
 ```
 
-> See [ModerationProcessor](/reference/processors/moderation-processor) for a full list of configuration options.
+> See [ModerationProcessor](/reference/v1/processors/moderation-processor) for a full list of configuration options.
 
 ### Detecting and redacting PII
 
@@ -221,6 +236,8 @@ The `PIIDetector` is a hybrid processor that detects and removes personally iden
 import { PIIDetector } from "@mastra/core/processors";
 
 export const privateAgent = new Agent({
+  id: "private-agent",
+  name: "Private Agent",
   // ...
   inputProcessors: [
     new PIIDetector({
@@ -240,7 +257,7 @@ export const privateAgent = new Agent({
 });
 ```
 
-> See [PIIDetector](/reference/processors/pii-detector) for a full list of configuration options.
+> See [PIIDetector](/reference/v1/processors/pii-detector) for a full list of configuration options.
 
 ## Applying multiple processors
 
@@ -263,6 +280,8 @@ import {
 } from "@mastra/core/processors";
 
 export const testAgent = new Agent({
+  id: "test-agent",
+  name: "Test Agent",
   // ...
   inputProcessors: [
     new UnicodeNormalizer({
@@ -291,6 +310,8 @@ Most strategies allow the request to continue without interruption. When `block`
 import { PIIDetector } from "@mastra/core/processors";
 
 export const privateAgent = new Agent({
+  id: "private-agent",
+  name: "Private Agent",
   // ...
   inputProcessors: [
     new PIIDetector({
@@ -344,6 +365,6 @@ If the built-in processors don’t cover your needs, you can create your own by
 
 Available examples:
 
-- [Message Length Limiter](../../examples/processors/message-length-limiter)
-- [Response Length Limiter](../../examples/processors/response-length-limiter)
-- [Response Validator](../../examples/processors/response-validator)
+- [Message Length Limiter](/examples/v1/processors/message-length-limiter)
+- [Response Length Limiter](/examples/v1/processors/response-length-limiter)
+- [Response Validator](/examples/v1/processors/response-validator)

package/.docs/raw/agents/networks.mdx

@@ -36,7 +36,8 @@ import { cityWorkflow } from "../workflows/city-workflow";
 import { weatherTool } from "../tools/weather-tool";
 
 export const routingAgent = new Agent({
-  name: "routing-agent",
+  id: "routing-agent",
+  name: "Routing Agent",
   instructions: `
       You are a network of writers and researchers.
       The user will ask you to research a topic.
@@ -56,6 +57,7 @@ export const routingAgent = new Agent({
   },
   memory: new Memory({
     storage: new LibSQLStore({
+      id: 'mastra-storage',
       url: "file:../mastra.db",
     }),
   }),
@@ -72,7 +74,8 @@ Each agent in a network should include a clear `description` that explains what
 
 ```typescript title="src/mastra/agents/research-agent.ts" showLineNumbers
 export const researchAgent = new Agent({
-  name: "research-agent",
+  id: "research-agent",
+  name: "Research Agent",
   description: `This agent gathers concise research insights in bullet-point form.
     It's designed to extract key facts without generating full
     responses or narrative content.`,
@@ -82,7 +85,8 @@ export const researchAgent = new Agent({
 
 ```typescript title="src/mastra/agents/writing-agent.ts" showLineNumbers
 export const writingAgent = new Agent({
-  name: "writing-agent",
+  id: "writing-agent",
+  name: "Writing Agent",
   description: `This agent turns researched material into well-structured
     written content. It produces full-paragraph reports with no bullet points,
     suitable for use in articles, summaries, or blog posts.`,
@@ -236,4 +240,4 @@ network-execution-event-step-finish
 
 - [Agent Memory](./agent-memory)
 - [Workflows Overview](../workflows/overview)
-- [Runtime Context](/docs/server-db/runtime-context)
+- [Request Context](/docs/v1/server-db/request-context)

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

@@ -46,7 +46,7 @@ OPENAI_API_KEY=<your-api-key>
 
 :::note
 
-Mastra supports more than 600 models. Choose from the [full list](/models).
+Mastra supports more than 600 models. Choose from the [full list](/models/v1).
 
 :::
 
@@ -60,7 +60,8 @@ Create an agent by instantiating the `Agent` class with system `instructions` an
 import { Agent } from "@mastra/core/agent";
 
 export const testAgent = new Agent({
-  name: "test-agent",
+  id: "test-agent",
+  name: "Test Agent",
   instructions: "You are a helpful assistant.",
   model: "openai/gpt-4o-mini",
 });
@@ -108,7 +109,8 @@ import { openai } from "@ai-sdk/openai";
 import { Agent } from "@mastra/core/agent";
 
 export const testAgent = new Agent({
-  name: "test-agent",
+  id: "test-agent",
+  name: "Test Agent",
   instructions: "You are a helpful assistant.",
   model: openai("gpt-4o-mini"),
 });
@@ -161,14 +163,14 @@ instructions: {
 }
 ```
 
-> See the [Agent reference doc](/reference/agents/agent) for more information.
+> See the [Agent reference doc](/reference/v1/agents/agent) for more information.
 
 ### Registering an agent
 
 Register your agent in the Mastra instance to make it available throughout your application. Once registered, it can be called from workflows, tools, or other agents, and has access to shared resources such as memory, logging, and observability features:
 
 ```typescript {6} showLineNumbers title="src/mastra/index.ts" copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { testAgent } from "./agents/test-agent";
 
 export const mastra = new Mastra({
@@ -189,7 +191,7 @@ const testAgent = mastra.getAgent("testAgent");
 
 `mastra.getAgent()` is preferred over a direct import, since it provides access to the Mastra instance configuration (logger, telemetry, storage, registered agents, and vector stores).
 
-See [Calling agents](/examples/agents/calling-agents) for more information.
+See [Calling agents](/examples/v1/agents/calling-agents) for more information.
 
 :::
 
@@ -259,7 +261,7 @@ for await (const chunk of stream.textStream) {
   </TabItem>
 </Tabs>
 
-> See [.generate()](/reference/agents/generate) or [.stream()](/reference/streaming/agents/stream) for more information.
+> See [.generate()](/reference/v1/agents/generate) or [.stream()](/reference/v1/streaming/agents/stream) for more information.
 
 ## Structured output
 
@@ -420,6 +422,8 @@ Agents can use tools to go beyond language generation, enabling structured inter
 
 ```typescript title="src/mastra/agents/test-agent.ts" showLineNumbers
 export const testAgent = new Agent({
+  id: "test-agent",
+  name: "Test Agent",
   // ...
   tools: { testTool },
 });
@@ -427,9 +431,9 @@ export const testAgent = new Agent({
 
 > See [Using Tools](./using-tools) for more information.
 
-## Using `RuntimeContext`
+## Using `RequestContext`
 
-Use `RuntimeContext` to access request-specific values. This lets you conditionally adjust behavior based on the context of the request.
+Use `RequestContext` to access request-specific values. This lets you conditionally adjust behavior based on the context of the request.
 
 ```typescript title="src/mastra/agents/test-agent.ts" showLineNumbers
 export type UserTier = {
@@ -437,9 +441,11 @@ export type UserTier = {
 };
 
 export const testAgent = new Agent({
+  id: "test-agent",
+  name: "Test Agent",
   // ...
-  model: ({ runtimeContext }) => {
-    const userTier = runtimeContext.get("user-tier") as UserTier["user-tier"];
+  model: ({ requestContext }) => {
+    const userTier = requestContext.get("user-tier") as UserTier["user-tier"];
 
     return userTier === "enterprise"
       ? openai("gpt-4o-mini")
@@ -448,15 +454,15 @@ export const testAgent = new Agent({
 });
 ```
 
-> See [Runtime Context](/docs/server-db/runtime-context) for more information.
+> See [Request Context](/docs/v1/server-db/request-context) for more information.
 
 ## Testing with Studio
 
-Use [Studio](/docs/getting-started/studio) to test agents with different messages, inspect tool calls and responses, and debug agent behavior.
+Use [Studio](/docs/v1/getting-started/studio) to test agents with different messages, inspect tool calls and responses, and debug agent behavior.
 
 ## Related
 
 - [Using Tools](./using-tools)
 - [Agent Memory](./agent-memory)
-- [Runtime Context](/examples/agents/runtime-context)
-- [Calling Agents](/examples/agents/calling-agents)
+- [Request Context](/examples/v1/agents/request-context)
+- [Calling Agents](/examples/v1/agents/calling-agents)

package/.docs/raw/agents/using-tools.mdx

@@ -13,9 +13,9 @@ Use tools when an agent needs additional context or information from remote reso
 
 ## Creating a tool
 
-This example shows how to create a tool that fetches weather data from an API. When the agent calls the tool, it provides the required input as defined by the tool’s `inputSchema`. The tool accesses this data through its `context` argument, which in this example includes the `location` used in the weather API query.
+This example shows how to create a tool that fetches weather data from an API. When the agent calls the tool, it provides the required input as defined by the tool's `inputSchema`. The tool accesses this data through its `inputData` parameter, which in this example includes the `location` used in the weather API query.
 
-```typescript {14,16} title="src/mastra/tools/weather-tool.ts" showLineNumbers copy
+```typescript {14} title="src/mastra/tools/weather-tool.ts" showLineNumbers copy
 import { createTool } from "@mastra/core/tools";
 import { z } from "zod";
 
@@ -28,8 +28,8 @@ export const weatherTool = createTool({
   outputSchema: z.object({
     weather: z.string(),
   }),
-  execute: async ({ context }) => {
-    const { location } = context;
+  execute: async (inputData) => {
+    const { location } = inputData;
 
     const response = await fetch(`https://wttr.in/${location}?format=3`);
     const weather = await response.text();
@@ -49,7 +49,8 @@ import { Agent } from "@mastra/core/agent";
 import { weatherTool } from "../tools/weather-tool";
 
 export const weatherAgent = new Agent({
-  name: "weather-agent",
+  id: "weather-agent",
+  name: "Weather Agent",
   instructions: `
       You are a helpful weather assistant.
       Use the weatherTool to fetch current weather data.`,
@@ -60,7 +61,7 @@ export const weatherAgent = new Agent({
 
 ## Calling an agent
 
-The agent uses the tool’s `inputSchema` to infer what data the tool expects. In this case, it extracts `London` as the `location` from the message and makes it available to the tool’s context.
+The agent uses the tool's `inputSchema` to infer what data the tool expects. In this case, it extracts `London` as the `location` from the message and passes it to the tool's inputData parameter.
 
 ```typescript {5} title="src/test-tool.ts" showLineNumbers copy
 import { mastra } from "./mastra";
@@ -81,6 +82,8 @@ import { weatherTool } from "../tools/weather-tool";
 import { activitiesTool } from "../tools/activities-tool";
 
 export const weatherAgent = new Agent({
+  id: "weather-agent",
+  name: "Weather Agent",
   // ..
   tools: { weatherTool, activitiesTool },
 });
@@ -90,5 +93,5 @@ export const weatherAgent = new Agent({
 
 - [Tools Overview](../tools-mcp/overview)
 - [Agent Memory](./agent-memory)
-- [Runtime Context](/docs/server-db/runtime-context)
-- [Calling Agents](/examples/agents/calling-agents)
+- [Request Context](/docs/v1/server-db/request-context)
+- [Calling Agents](/examples/v1/agents/calling-agents)