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

package/.docs/raw/reference/streaming/workflows/observeStreamVNext.mdx

@@ -10,7 +10,7 @@ The `.observeStreamVNext()` method opens a new `ReadableStream` to a workflow ru
 ## Usage example
 
 ```typescript showLineNumbers copy
-const run = await workflow.createRunAsync();
+const run = await workflow.createRun();
 
 run.streamVNext({
   inputData: {
@@ -41,7 +41,7 @@ The stream emits various event types during workflow execution. Each event has a
 
 ## Related
 
-- [Workflows overview](/docs/workflows/overview#running-workflows)
-- [Workflow.createRunAsync()](/reference/workflows/workflow-methods/create-run)
+- [Workflows overview](/docs/v1/workflows/overview#running-workflows)
+- [Workflow.createRun()](/reference/v1/workflows/workflow-methods/create-run)
 - [Run.streamVNext()](./streamVNext)
 - [Run.resumeStreamVNext()](./resumeStreamVNext)

package/.docs/raw/reference/streaming/workflows/resumeStreamVNext.mdx

@@ -14,7 +14,7 @@ The `.resumeStreamVNext()` method resumes a suspended workflow run with new data
 ## Usage example
 
 ```typescript showLineNumbers copy
-const run = await workflow.createRunAsync();
+const run = await workflow.createRun();
 
 const stream = run.streamVNext({
   inputData: {
@@ -44,8 +44,8 @@ if (result!.status === "suspended") {
       isOptional: true,
     },
     {
-      name: "runtimeContext",
-      type: "RuntimeContext",
+      name: "requestContext",
+      type: "RequestContext",
       description: "Request Context data to use during workflow execution",
       isOptional: true,
     },
@@ -59,7 +59,7 @@ if (result!.status === "suspended") {
       name: "tracingOptions",
       type: "TracingOptions",
       isOptional: true,
-      description: "Options for AI tracing configuration.",
+      description: "Options for Tracing configuration.",
       properties: [
         {
           parameters: [
@@ -117,6 +117,6 @@ The stream emits various event types during workflow execution. Each event has a
 
 ## Related
 
-- [Workflows overview](/docs/workflows/overview#running-workflows)
-- [Workflow.createRunAsync()](/reference/workflows/workflow-methods/create-run)
+- [Workflows overview](/docs/v1/workflows/overview#running-workflows)
+- [Workflow.createRun()](/reference/v1/workflows/workflow-methods/create-run)
 - [Run.streamVNext()](./streamVNext)

package/.docs/raw/reference/streaming/workflows/stream.mdx

@@ -10,7 +10,7 @@ The `.stream()` method allows you to monitor the execution of a workflow run, pr
 ## Usage example
 
 ```typescript showLineNumbers copy
-const run = await workflow.createRunAsync();
+const run = await workflow.createRun();
 
 const { stream } = await run.stream({
   inputData: {
@@ -30,8 +30,8 @@ const { stream } = await run.stream({
       isOptional: true,
     },
     {
-      name: "runtimeContext",
-      type: "RuntimeContext",
+      name: "requestContext",
+      type: "RequestContext",
       description: "Request Context data to use during workflow execution",
       isOptional: true,
     },
@@ -40,16 +40,16 @@ const { stream } = await run.stream({
       type: "TracingContext",
       isOptional: true,
       description:
-        "AI tracing context for creating child spans and adding metadata. Automatically injected when using Mastra's tracing system.",
+        "Tracing context for creating child spans and adding metadata. Automatically injected when using Mastra's tracing system.",
       properties: [
         {
           parameters: [
             {
               name: "currentSpan",
-              type: "AISpan",
+              type: "Span",
               isOptional: true,
               description:
-                "Current AI span for creating child spans and adding metadata. Use this to create custom child spans or update span attributes during execution.",
+                "Current span for creating child spans and adding metadata. Use this to create custom child spans or update span attributes during execution.",
             },
           ],
         },
@@ -59,7 +59,7 @@ const { stream } = await run.stream({
       name: "tracingOptions",
       type: "TracingOptions",
       isOptional: true,
-      description: "Options for AI tracing configuration.",
+      description: "Options for Tracing configuration.",
       properties: [
         {
           parameters: [
@@ -98,7 +98,7 @@ const { stream } = await run.stream({
       type: "string",
       isOptional: true,
       description:
-        "The trace ID associated with this execution when AI tracing is enabled. Use this to correlate logs and debug execution flow.",
+        "The trace ID associated with this execution when Tracing is enabled. Use this to correlate logs and debug execution flow.",
     },
   ]}
 />
@@ -130,5 +130,5 @@ The stream emits various event types during workflow execution. Each event has a
 
 ## Related
 
-- [Workflows overview](/docs/workflows/overview#running-workflows)
-- [Workflow.createRunAsync()](/reference/workflows/workflow-methods/create-run)
+- [Workflows overview](/docs/v1/workflows/overview#running-workflows)
+- [Workflow.createRun()](/reference/v1/workflows/workflow-methods/create-run)

package/.docs/raw/reference/streaming/workflows/streamVNext.mdx

@@ -14,7 +14,7 @@ The `.streamVNext()` method enables real-time streaming of responses from a work
 ## Usage example
 
 ```typescript showLineNumbers copy
-const run = await workflow.createRunAsync();
+const run = await workflow.createRun();
 
 const stream = run.streamVNext({
   inputData: {
@@ -34,8 +34,8 @@ const stream = run.streamVNext({
       isOptional: true,
     },
     {
-      name: "runtimeContext",
-      type: "RuntimeContext",
+      name: "requestContext",
+      type: "RequestContext",
       description: "Request Context data to use during workflow execution",
       isOptional: true,
     },
@@ -44,16 +44,16 @@ const stream = run.streamVNext({
       type: "TracingContext",
       isOptional: true,
       description:
-        "AI tracing context for creating child spans and adding metadata.",
+        "Tracing context for creating child spans and adding metadata.",
       properties: [
         {
           parameters: [
             {
               name: "currentSpan",
-              type: "AISpan",
+              type: "Span",
               isOptional: true,
               description:
-                "Current AI span for creating child spans and adding metadata.",
+                "Current span for creating child spans and adding metadata.",
             },
           ],
         },
@@ -63,7 +63,7 @@ const stream = run.streamVNext({
       name: "tracingOptions",
       type: "TracingOptions",
       isOptional: true,
-      description: "Options for AI tracing configuration.",
+      description: "Options for Tracing configuration.",
       properties: [
         {
           parameters: [
@@ -117,7 +117,7 @@ const stream = run.streamVNext({
       type: "string",
       isOptional: true,
       description:
-        "The trace ID associated with this execution when AI tracing is enabled.",
+        "The trace ID associated with this execution when Tracing is enabled.",
     },
   ]}
 />
@@ -125,7 +125,7 @@ const stream = run.streamVNext({
 ## Extended usage example
 
 ```typescript showLineNumbers copy
-const run = await workflow.createRunAsync();
+const run = await workflow.createRun();
 
 const stream = run.streamVNext({
   inputData: {
@@ -148,6 +148,6 @@ The stream emits various event types during workflow execution. Each event has a
 
 ## Related
 
-- [Workflows overview](/docs/workflows/overview#running-workflows)
-- [Workflow.createRunAsync()](/reference/workflows/workflow-methods/create-run)
+- [Workflows overview](/docs/v1/workflows/overview#running-workflows)
+- [Workflow.createRun()](/reference/v1/workflows/workflow-methods/create-run)
 - [Run.resumeStreamVNext()](./resumeStreamVNext)

package/.docs/raw/reference/templates/overview.mdx

@@ -138,7 +138,7 @@ Templates must be:
 - **Framework-free** - No Next.js, Express, or other web framework boilerplate
 - **Mastra-focused** - Demonstrate Mastra functionality without additional layers
 - **Mergeable** - Structure code for easy integration into existing projects
-- **Node.js compatible** - Support Node.js 18 and higher
+- **Node.js compatible** - Support Node.js v22.13.0 and later
 - **ESM modules** - Use ES modules (`"type": "module"` in package.json)
 
 ### Documentation Requirements
@@ -196,7 +196,7 @@ Templates must demonstrate:
 - **Type safety** - Full TypeScript typing with Zod validation
 - **Testing** - Verified functionality with fresh installations
 
-For information on contributing your own templates to the Mastra ecosystem, see the [Contributing Templates](/docs/community/contributing-templates) guide in the community section.
+For information on contributing your own templates to the Mastra ecosystem, see the [Contributing Templates](/docs/v1/community/contributing-templates) guide in the community section.
 
 :::info
 

package/.docs/raw/reference/tools/create-tool.mdx

@@ -22,9 +22,8 @@ export const tool = createTool({
   outputSchema: z.object({
     output: z.string(),
   }),
-  execute: async ({ context }) => {
-    const { input } = context;
-    const reversed = input.split("").reverse().join("");
+  execute: async (inputData) => {
+    const reversed = inputData.input.split("").reverse().join("");
 
     return {
       output: reversed,
@@ -68,47 +67,65 @@ export const tool = createTool({
       name: "execute",
       type: "function",
       description:
-        "The function that contains the tool's logic. It receives an object with `context` (the parsed input based on `inputSchema`), `runtimeContext`, `tracingContext`, and an object containing `abortSignal`.",
+        "The function that contains the tool's logic. It receives two parameters: the validated input data (first parameter) and an optional execution context object (second parameter) containing `requestContext`, `tracingContext`, `abortSignal`, and other execution metadata.",
       isOptional: false,
       properties: [
         {
           parameters: [
             {
-              name: "context",
+              name: "input",
               type: "z.infer<TInput>",
-              description: "The parsed input based on inputSchema",
-            },
-          ],
-        },
-        {
-          parameters: [
-            {
-              name: "runtimeContext",
-              type: "RuntimeContext",
-              isOptional: true,
-              description:
-                "Runtime context for accessing shared state and dependencies",
+              description: "The validated input data based on inputSchema",
             },
           ],
         },
         {
           parameters: [
             {
-              name: "tracingContext",
-              type: "TracingContext",
-              isOptional: true,
-              description:
-                "AI tracing context for creating child spans and adding metadata. Automatically injected when the tool is called within a traced operation.",
-            },
-          ],
-        },
-        {
-          parameters: [
-            {
-              name: "abortSignal",
-              type: "AbortSignal",
+              name: "context",
+              type: "ToolExecutionContext",
               isOptional: true,
-              description: "Signal for aborting the tool execution",
+              description: "Optional execution context containing metadata",
+              properties: [
+                {
+                  name: "requestContext",
+                  type: "RequestContext",
+                  isOptional: true,
+                  description:
+                    "Request Context for accessing shared state and dependencies",
+                },
+                {
+                  name: "tracingContext",
+                  type: "TracingContext",
+                  isOptional: true,
+                  description:
+                    "Tracing context for creating child spans and adding metadata",
+                },
+                {
+                  name: "abortSignal",
+                  type: "AbortSignal",
+                  isOptional: true,
+                  description: "Signal for aborting the tool execution",
+                },
+                {
+                  name: "agent",
+                  type: "AgentToolExecutionContext",
+                  isOptional: true,
+                  description: "Agent-specific context (messages, suspend, resumeData, etc.)",
+                },
+                {
+                  name: "workflow",
+                  type: "WorkflowToolExecutionContext",
+                  isOptional: true,
+                  description: "Workflow-specific context (state, setState, suspend, etc.)",
+                },
+                {
+                  name: "mcp",
+                  type: "MCPToolExecutionContext",
+                  isOptional: true,
+                  description: "MCP-specific context (elicitation, etc.)",
+                },
+              ],
             },
           ],
         },
@@ -134,7 +151,7 @@ The `createTool()` function returns a `Tool` object.
 
 ## Related
 
-- [Tools Overview](/docs/tools-mcp/overview)
-- [Using Tools with Agents](/docs/agents/using-tools)
-- [Tool Runtime Context](/docs/tools-mcp/overview#using-runtimecontext)
-- [Advanced Tool Usage](/docs/tools-mcp/advanced-usage)
+- [Tools Overview](/docs/v1/tools-mcp/overview)
+- [Using Tools with Agents](/docs/v1/agents/using-tools)
+- [Tool Request Context](/docs/v1/tools-mcp/overview#using-requestcontext)
+- [Advanced Tool Usage](/docs/v1/tools-mcp/advanced-usage)

package/.docs/raw/reference/tools/graph-rag-tool.mdx

@@ -31,7 +31,7 @@ const graphTool = createGraphRAGTool({
 :::note
 
 **Parameter Requirements:** Most fields can be set at creation as defaults.
-Some fields can be overridden at runtime via the runtime context or input. If
+Some fields can be overridden at runtime via the request context or input. If
 a required field is missing from both creation and runtime, an error will be
 thrown. Note that `model`, `id`, and `description` can only be set at creation
 time.
@@ -79,7 +79,7 @@ time.
       name: "enableFilter",
       type: "boolean",
       description:
-        "Enable filtering of results based on metadata. (Set at creation only, but will be automatically enabled if a filter is provided in the runtime context.)",
+        "Enable filtering of results based on metadata. (Set at creation only, but will be automatically enabled if a filter is provided in the request context.)",
       isOptional: true,
       defaultValue: "false",
     },
@@ -217,7 +217,7 @@ const graphTool = createGraphRAGTool({
 
 This example shows how to customize the tool description for a specific use case while maintaining its core purpose of relationship analysis.
 
-## Example: Using Runtime Context
+## Example: Using Request Context
 
 ```typescript
 const graphTool = createGraphRAGTool({
@@ -227,34 +227,34 @@ const graphTool = createGraphRAGTool({
 });
 ```
 
-When using runtime context, provide required parameters at execution time via the runtime context:
+When using request context, provide required parameters at execution time via the request context:
 
 ```typescript
-const runtimeContext = new RuntimeContext<{
+const requestContext = new RequestContext<{
   vectorStoreName: string;
   indexName: string;
   topK: number;
   filter: any;
 }>();
-runtimeContext.set("vectorStoreName", "my-store");
-runtimeContext.set("indexName", "my-index");
-runtimeContext.set("topK", 5);
-runtimeContext.set("filter", { category: "docs" });
-runtimeContext.set("randomWalkSteps", 100);
-runtimeContext.set("restartProb", 0.15);
+requestContext.set("vectorStoreName", "my-store");
+requestContext.set("indexName", "my-index");
+requestContext.set("topK", 5);
+requestContext.set("filter", { category: "docs" });
+requestContext.set("randomWalkSteps", 100);
+requestContext.set("restartProb", 0.15);
 
 const response = await agent.generate(
   "Find documentation from the knowledge base.",
   {
-    runtimeContext,
+    requestContext,
   },
 );
 ```
 
-For more information on runtime context, please see:
+For more information on request context, please see:
 
-- [Agent Runtime Context](/docs/server-db/runtime-context)
-- [Tool Runtime Context](/docs/tools-mcp/overview#using-runtimecontext)
+- [Agent Request Context](/docs/v1/server-db/request-context)
+- [Tool Request Context](/docs/v1/tools-mcp/overview#using-requestcontext)
 
 ## Related
 

package/.docs/raw/reference/tools/mcp-client.mdx

@@ -7,7 +7,7 @@ description: API Reference for MCPClient - A class for managing multiple Model C
 
 The `MCPClient` class provides a way to manage multiple MCP server connections and their tools in a Mastra application. It handles connection lifecycle, tool namespacing, and provides access to tools across all configured servers.
 
-This class replaces the deprecated [`MastraMCPClient`](/reference/tools/client).
+This class replaces the deprecated [`MastraMCPClient`](/reference/v1/tools/client).
 
 ## Constructor