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

package/.docs/raw/reference/storage/mssql.mdx

@@ -10,7 +10,7 @@ The MSSQL storage implementation provides a production-ready storage solution us
 ## Installation
 
 ```bash copy
-npm install @mastra/mssql@latest
+npm install @mastra/mssql@beta
 ```
 
 ## Usage
@@ -19,6 +19,7 @@ npm install @mastra/mssql@latest
 import { MSSQLStore } from "@mastra/mssql";
 
 const storage = new MSSQLStore({
+  id: 'mssql-storage',
   connectionString: process.env.DATABASE_URL,
 });
 ```
@@ -53,17 +54,20 @@ import { MSSQLStore } from "@mastra/mssql";
 
 // Using a connection string only
 const store1 = new MSSQLStore({
+  id: 'mssql-storage-1',
   connectionString: "Server=localhost,1433;Database=mydb;User Id=sa;Password=password;Encrypt=true;TrustServerCertificate=true",
 });
 
 // Using a connection string with a custom schema name
 const store2 = new MSSQLStore({
+  id: 'mssql-storage-2',
   connectionString: "Server=localhost,1433;Database=mydb;User Id=sa;Password=password;Encrypt=true;TrustServerCertificate=true",
   schemaName: "custom_schema", // optional
 });
 
 // Using individual connection parameters
 const store4 = new MSSQLStore({
+  id: 'mssql-storage-3',
   server: "localhost",
   port: 1433,
   database: "mydb",
@@ -73,6 +77,7 @@ const store4 = new MSSQLStore({
 
 // Individual parameters with schemaName
 const store5 = new MSSQLStore({
+  id: 'mssql-storage-4',
   server: "localhost",
   port: 1433,
   database: "mydb",

package/.docs/raw/reference/storage/postgresql.mdx

@@ -10,7 +10,7 @@ The PostgreSQL storage implementation provides a production-ready storage soluti
 ## Installation
 
 ```bash copy
-npm install @mastra/pg@latest
+npm install @mastra/pg@beta
 ```
 
 ## Usage
@@ -19,6 +19,7 @@ npm install @mastra/pg@latest
 import { PostgresStore } from "@mastra/pg";
 
 const storage = new PostgresStore({
+  id: 'pg-storage',
   connectionString: process.env.DATABASE_URL,
 });
 ```
@@ -53,17 +54,20 @@ import { PostgresStore } from "@mastra/pg";
 
 // Using a connection string only
 const store1 = new PostgresStore({
+  id: 'pg-storage-1',
   connectionString: "postgresql://user:password@localhost:5432/mydb",
 });
 
 // Using a connection string with a custom schema name
 const store2 = new PostgresStore({
+  id: 'pg-storage-2',
   connectionString: "postgresql://user:password@localhost:5432/mydb",
   schemaName: "custom_schema", // optional
 });
 
 // Using individual connection parameters
 const store4 = new PostgresStore({
+  id: 'pg-storage-3',
   host: "localhost",
   port: 5432,
   database: "mydb",
@@ -73,6 +77,7 @@ const store4 = new PostgresStore({
 
 // Individual parameters with schemaName
 const store5 = new PostgresStore({
+  id: 'pg-storage-4',
   host: "localhost",
   port: 5432,
   database: "mydb",
@@ -281,6 +286,7 @@ When using custom schemas, indexes are created with schema prefixes:
 
 ```typescript copy
 const storage = new PostgresStore({
+  id: 'pg-storage',
   connectionString: process.env.DATABASE_URL,
   schemaName: "custom_schema",
 });

package/.docs/raw/reference/storage/upstash.mdx

@@ -16,7 +16,7 @@ The Upstash storage implementation provides a serverless-friendly storage soluti
 ## Installation
 
 ```bash copy
-npm install @mastra/upstash@latest
+npm install @mastra/upstash@beta
 ```
 
 ## Usage
@@ -25,6 +25,7 @@ npm install @mastra/upstash@latest
 import { UpstashStore } from "@mastra/upstash";
 
 const storage = new UpstashStore({
+  id: 'upstash-storage',
   url: process.env.UPSTASH_URL,
   token: process.env.UPSTASH_TOKEN,
 });

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

@@ -118,7 +118,7 @@ const aiSdkStream = await agent.stream("message for agent", {
       name: "tracingContext",
       type: "TracingContext",
       isOptional: true,
-      description: "AI tracing context for span hierarchy and metadata.",
+      description: "Tracing context for span hierarchy and metadata.",
     },
     {
       name: "returnScorerData",
@@ -348,7 +348,7 @@ const aiSdkStream = await agent.stream("message for agent", {
       type: "TelemetrySettings",
       isOptional: true,
       description:
-        "Settings for OTLP telemetry collection during streaming (not AI tracing).",
+        "Settings for OTLP telemetry collection during streaming (not Tracing).",
       properties: [
         {
           parameters: [
@@ -616,27 +616,27 @@ const aiSdkStream = await agent.stream("message for agent", {
         "Unique ID for this generation run. Useful for tracking and debugging purposes.",
     },
     {
-      name: "runtimeContext",
-      type: "RuntimeContext",
+      name: "requestContext",
+      type: "RequestContext",
       isOptional: true,
       description:
-        "Runtime context for dependency injection and contextual information.",
+        "Request Context for dependency injection and contextual information.",
     },
     {
       name: "tracingContext",
       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.",
             },
           ],
         },
@@ -646,7 +646,7 @@ const aiSdkStream = await agent.stream("message for agent", {
       name: "tracingOptions",
       type: "TracingOptions",
       isOptional: true,
-      description: "Options for AI tracing configuration.",
+      description: "Options for Tracing configuration.",
       properties: [
         {
           parameters: [
@@ -686,7 +686,7 @@ const aiSdkStream = await agent.stream("message for agent", {
       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.",
     },
   ]}
 />
@@ -803,5 +803,5 @@ await agent.stream("message for agent", {
 
 ## Related
 
-- [Generating responses](/docs/agents/overview#generating-responses)
-- [Streaming responses](/docs/agents/overview#generating-responses)
+- [Generating responses](/docs/v1/agents/overview#generating-responses)
+- [Streaming responses](/docs/v1/agents/overview#generating-responses)

package/.docs/raw/reference/streaming/agents/streamLegacy.mdx

@@ -7,7 +7,7 @@ description: "Documentation for the legacy `Agent.streamLegacy()` method in Mast
 
 :::warning
 
-**Deprecated**: This method is deprecated and only works with V1 models. For V2 models, use the new [`.stream()`](./stream) method instead. See the [migration guide](../../../guides/migrations/vnext-to-standard-apis) for details on upgrading.
+**Deprecated**: This method is deprecated and only works with V1 models. For V2 models, use the new [`.stream()`](./stream) method instead. See the [migration guide](/guides/v1/migrations/vnext-to-standard-apis) for details on upgrading.
 
 :::
 
@@ -399,11 +399,11 @@ await agent.streamLegacy("message for agent");
         "Unique ID for this generation run. Useful for tracking and debugging purposes.",
     },
     {
-      name: "runtimeContext",
-      type: "RuntimeContext",
+      name: "requestContext",
+      type: "RequestContext",
       isOptional: true,
       description:
-        "Runtime context for dependency injection and contextual information.",
+        "Request Context for dependency injection and contextual information.",
     },
     {
       name: "maxTokens",
@@ -550,7 +550,7 @@ await agent.streamLegacy("message for agent", {
 
 :::info
 
-The new `.stream()` method offers enhanced capabilities including AI SDK v5 compatibility, better structured output handling, and improved callback system. See the [migration guide](../../../guides/migrations/vnext-to-standard-apis) for detailed migration instructions.
+The new `.stream()` method offers enhanced capabilities including AI SDK v5 compatibility, better structured output handling, and improved callback system. See the [migration guide](/guides/v1/migrations/vnext-to-standard-apis) for detailed migration instructions.
 
 :::
 
@@ -580,7 +580,7 @@ const result = await agent.stream("message", {
 
 ## Related
 
-- [Migration Guide](../../../guides/migrations/vnext-to-standard-apis)
+- [Migration Guide](/guides/v1/migrations/vnext-to-standard-apis)
 - [New .stream() method](./stream)
-- [Generating responses](/docs/agents/overview#generating-responses)
-- [Streaming responses](/docs/agents/overview#generating-responses)
+- [Generating responses](/docs/v1/agents/overview#generating-responses)
+- [Streaming responses](/docs/v1/agents/overview#generating-responses)

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

@@ -10,7 +10,7 @@ The `.observeStream()` method opens a new `ReadableStream` to a workflow run tha
 ## Usage example
 
 ```typescript showLineNumbers copy
-const run = await workflow.createRunAsync();
+const run = await workflow.createRun();
 
 run.stream({
   inputData: {
@@ -44,6 +44,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.stream()](./stream)

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

@@ -21,7 +21,7 @@ Mastra templates are pre-built project structures that demonstrate specific use
 Install a template using the `create-mastra` command:
 
 ```bash copy
-npx create-mastra@latest --template template-name
+npx create-mastra@beta --template template-name
 ```
 
 This creates a complete project with all necessary code and configuration.
@@ -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)