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

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

@@ -31,7 +31,7 @@ An introduction to agents, and how they compare to workflows on [YouTube (7 minu
 Add the Mastra core package to your project:
 
 ```bash
-npm install @mastra/core
+npm install @mastra/core@beta
 ```
 
 </StepItem>
@@ -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",
 });
@@ -78,7 +79,7 @@ export const testAgent = new Agent({
 Include the Mastra core package alongside the Vercel AI SDK provider you want to use:
 
 ```bash
-npm install @mastra/core @ai-sdk/openai
+npm install @mastra/core@beta @ai-sdk/openai
 ```
 
 </StepItem>
@@ -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)

package/.docs/raw/auth/auth0.mdx

@@ -8,7 +8,7 @@ import TabItem from "@theme/TabItem";
 
 # MastraAuthAuth0 Class
 
-The `MastraAuthAuth0` class provides authentication for Mastra using Auth0. It verifies incoming requests using Auth0-issued JWT tokens and integrates with the Mastra server using the `experimental_auth` option.
+The `MastraAuthAuth0` class provides authentication for Mastra using Auth0. It verifies incoming requests using Auth0-issued JWT tokens and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -33,7 +33,7 @@ AUTH0_AUDIENCE=your-api-identifier
 Before you can use the `MastraAuthAuth0` class you have to install the `@mastra/auth-auth0` package.
 
 ```bash copy
-npm install @mastra/auth-auth0@latest
+npm install @mastra/auth-auth0@beta
 ```
 
 ## Usage examples
@@ -41,13 +41,13 @@ npm install @mastra/auth-auth0@latest
 ### Basic usage with environment variables
 
 ```typescript {2,7} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthAuth0 } from "@mastra/auth-auth0";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthAuth0(),
+    auth: new MastraAuthAuth0(),
   },
 });
 ```
@@ -55,13 +55,13 @@ export const mastra = new Mastra({
 ### Custom configuration
 
 ```typescript {2,7-10} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthAuth0 } from "@mastra/auth-auth0";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthAuth0({
+    auth: new MastraAuthAuth0({
       domain: process.env.AUTH0_DOMAIN,
       audience: process.env.AUTH0_AUDIENCE,
     }),
@@ -93,7 +93,7 @@ const auth0Provider = new MastraAuthAuth0({
 });
 ```
 
-> See the [MastraAuthAuth0](/reference/auth/auth0) API reference for all available configuration options.
+> See the [MastraAuthAuth0](/reference/v1/auth/auth0) API reference for all available configuration options.
 
 ## Client-side setup
 
@@ -153,7 +153,7 @@ export const useAuth0Token = () => {
 
 ## Configuring `MastraClient`
 
-When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid Auth0 access token in the `Authorization` header:
+When `auth` is enabled, all requests made with `MastraClient` must include a valid Auth0 access token in the `Authorization` header:
 
 ```typescript title="lib/mastra/mastra-client.ts" showLineNumbers copy
 import { MastraClient } from "@mastra/client-js";
@@ -170,7 +170,7 @@ export const createMastraClient = (accessToken: string) => {
 
 > **Note:** The access token must be prefixed with `Bearer` in the Authorization header.
 
-> See [Mastra Client SDK](/docs/server-db/mastra-client) for more configuration options.
+> See [Mastra Client SDK](/docs/v1/server-db/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 

package/.docs/raw/auth/clerk.mdx

@@ -8,7 +8,7 @@ import TabItem from "@theme/TabItem";
 
 # MastraAuthClerk Class
 
-The `MastraAuthClerk` class provides authentication for Mastra using Clerk. It verifies incoming requests using Clerk's authentication system and integrates with the Mastra server using the `experimental_auth` option.
+The `MastraAuthClerk` class provides authentication for Mastra using Clerk. It verifies incoming requests using Clerk's authentication system and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -27,19 +27,19 @@ CLERK_JWKS_URI=https://your-clerk-domain.clerk.accounts.dev/.well-known/jwks.jso
 Before you can use the `MastraAuthClerk` class you have to install the `@mastra/auth-clerk` package.
 
 ```bash copy
-npm install @mastra/auth-clerk@latest
+npm install @mastra/auth-clerk@beta
 ```
 
 ## Usage example
 
 ```typescript {2,7-11} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthClerk } from "@mastra/auth-clerk";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthClerk({
+    auth: new MastraAuthClerk({
       publishableKey: process.env.CLERK_PUBLISHABLE_KEY,
       secretKey: process.env.CLERK_SECRET_KEY,
       jwksUri: process.env.CLERK_JWKS_URI,
@@ -50,7 +50,7 @@ export const mastra = new Mastra({
 
 > **Note:** The default `authorizeUser` method allows all authenticated users. To customize user authorization, provide a custom `authorizeUser` function when constructing the provider.
 
-> See the [MastraAuthClerk](/reference/auth/clerk) API reference for all available configuration options.
+> See the [MastraAuthClerk](/reference/v1/auth/clerk) API reference for all available configuration options.
 
 ## Client-side setup
 
@@ -79,7 +79,7 @@ export const useClerkAuth = () => {
 
 ## Configuring `MastraClient`
 
-When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid Clerk access token in the `Authorization` header:
+When `auth` is enabled, all requests made with `MastraClient` must include a valid Clerk access token in the `Authorization` header:
 
 ```typescript {6} title="lib/mastra/mastra-client.ts" showLineNumbers copy
 import { MastraClient } from "@mastra/client-js";
@@ -93,7 +93,7 @@ export const mastraClient = new MastraClient({
 ```
 
 > **Note:** The access token must be prefixed with `Bearer` in the Authorization header.
-> See [Mastra Client SDK](/docs/server-db/mastra-client) for more configuration options.
+> See [Mastra Client SDK](/docs/v1/server-db/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 

package/.docs/raw/auth/firebase.mdx

@@ -8,7 +8,7 @@ import TabItem from "@theme/TabItem";
 
 # MastraAuthFirebase Class
 
-The `MastraAuthFirebase` class provides authentication for Mastra using Firebase Authentication. It verifies incoming requests using Firebase ID tokens and integrates with the Mastra server using the `experimental_auth` option.
+The `MastraAuthFirebase` class provides authentication for Mastra using Firebase Authentication. It verifies incoming requests using Firebase ID tokens and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -33,7 +33,7 @@ FIRESTORE_DATABASE_ID=(default)
 Before you can use the `MastraAuthFirebase` class you have to install the `@mastra/auth-firebase` package.
 
 ```bash copy
-npm install @mastra/auth-firebase@latest
+npm install @mastra/auth-firebase@beta
 ```
 
 ## Usage examples
@@ -43,14 +43,14 @@ npm install @mastra/auth-firebase@latest
 If you set the required environment variables (`FIREBASE_SERVICE_ACCOUNT` and `FIRESTORE_DATABASE_ID`), you can initialize `MastraAuthFirebase` without any constructor arguments. The class will automatically read these environment variables as configuration:
 
 ```typescript {2,7} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthFirebase } from "@mastra/auth-firebase";
 
 // Automatically uses FIREBASE_SERVICE_ACCOUNT and FIRESTORE_DATABASE_ID env vars
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthFirebase(),
+    auth: new MastraAuthFirebase(),
   },
 });
 ```
@@ -58,13 +58,13 @@ export const mastra = new Mastra({
 ### Custom configuration
 
 ```typescript {2,7-10} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthFirebase } from "@mastra/auth-firebase";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthFirebase({
+    auth: new MastraAuthFirebase({
       serviceAccount: "/path/to/service-account.json",
       databaseId: "your-database-id",
     }),
@@ -106,7 +106,7 @@ const firebaseAuth = new MastraAuthFirebase({
 });
 ```
 
-> See the [MastraAuthFirebase](/reference/auth/firebase) API reference for all available configuration options.
+> See the [MastraAuthFirebase](/reference/v1/auth/firebase) API reference for all available configuration options.
 
 ## Client-side setup
 
@@ -173,7 +173,7 @@ export const signOutUser = async () => {
 
 ## Configuring `MastraClient`
 
-When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid Firebase ID token in the `Authorization` header:
+When `auth` is enabled, all requests made with `MastraClient` must include a valid Firebase ID token in the `Authorization` header:
 
 ```typescript {6} title="lib/mastra/mastra-client.ts" showLineNumbers copy
 import { MastraClient } from "@mastra/client-js";
@@ -190,7 +190,7 @@ export const createMastraClient = (idToken: string) => {
 
 > **Note:** The ID token must be prefixed with `Bearer` in the Authorization header.
 
-> See [Mastra Client SDK](/docs/server-db/mastra-client) for more configuration options.
+> See [Mastra Client SDK](/docs/v1/server-db/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 

package/.docs/raw/auth/index.mdx

@@ -11,9 +11,9 @@ You can start with simple shared secret JWT authentication and switch to provide
 
 ## Available providers
 
-- [JSON Web Token (JWT)](/docs/auth/jwt)
-- [Clerk](/docs/auth/clerk)
-- [Supabase](/docs/auth/supabase)
-- [Firebase](/docs/auth/firebase)
-- [WorkOS](/docs/auth/workos)
-- [Auth0](/docs/auth/auth0)
+- [JSON Web Token (JWT)](/docs/v1/auth/jwt)
+- [Clerk](/docs/v1/auth/clerk)
+- [Supabase](/docs/v1/auth/supabase)
+- [Firebase](/docs/v1/auth/firebase)
+- [WorkOS](/docs/v1/auth/workos)
+- [Auth0](/docs/v1/auth/auth0)

package/.docs/raw/auth/jwt.mdx

@@ -8,37 +8,37 @@ import TabItem from "@theme/TabItem";
 
 # MastraJwtAuth Class
 
-The `MastraJwtAuth` class provides a lightweight authentication mechanism for Mastra using JSON Web Tokens (JWTs). It verifies incoming requests based on a shared secret and integrates with the Mastra server using the `experimental_auth` option.
+The `MastraJwtAuth` class provides a lightweight authentication mechanism for Mastra using JSON Web Tokens (JWTs). It verifies incoming requests based on a shared secret and integrates with the Mastra server using the `auth` option.
 
 ## Installation
 
 Before you can use the `MastraJwtAuth` class you have to install the `@mastra/auth` package.
 
 ```bash copy
-npm install @mastra/auth@latest
+npm install @mastra/auth@beta
 ```
 
 ## Usage example
 
 ```typescript {2,7-9} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraJwtAuth } from "@mastra/auth";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraJwtAuth({
+    auth: new MastraJwtAuth({
       secret: process.env.MASTRA_JWT_SECRET,
     }),
   },
 });
 ```
 
-> See the [MastraJwtAuth](/reference/auth/jwt) API reference for all available configuration options.
+> See the [MastraJwtAuth](/reference/v1/auth/jwt) API reference for all available configuration options.
 
 ## Configuring `MastraClient`
 
-When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid JWT in the `Authorization` header:
+When `auth` is enabled, all requests made with `MastraClient` must include a valid JWT in the `Authorization` header:
 
 ```typescript {6} title="lib/mastra/mastra-client.ts" showLineNumbers copy
 import { MastraClient } from "@mastra/client-js";
@@ -51,7 +51,7 @@ export const mastraClient = new MastraClient({
 });
 ```
 
-> See [Mastra Client SDK](/docs/server-db/mastra-client) for more configuration options.
+> See [Mastra Client SDK](/docs/v1/server-db/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 

package/.docs/raw/auth/supabase.mdx

@@ -8,7 +8,7 @@ import TabItem from "@theme/TabItem";
 
 # MastraAuthSupabase Class
 
-The `MastraAuthSupabase` class provides authentication for Mastra using Supabase Auth. It verifies incoming requests using Supabase's authentication system and integrates with the Mastra server using the `experimental_auth` option.
+The `MastraAuthSupabase` class provides authentication for Mastra using Supabase Auth. It verifies incoming requests using Supabase's authentication system and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -26,19 +26,19 @@ SUPABASE_ANON_KEY=your-anon-key
 Before you can use the `MastraAuthSupabase` class you have to install the `@mastra/auth-supabase` package.
 
 ```bash copy
-npm install @mastra/auth-supabase@latest
+npm install @mastra/auth-supabase@beta
 ```
 
 ## Usage example
 
 ```typescript {2,7-9} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthSupabase } from "@mastra/auth-supabase";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthSupabase({
+    auth: new MastraAuthSupabase({
       url: process.env.SUPABASE_URL,
       anonKey: process.env.SUPABASE_ANON_KEY,
     }),
@@ -48,7 +48,7 @@ export const mastra = new Mastra({
 
 > **Note:** The default `authorizeUser` method checks the `isAdmin` column in the `users` table in the `public` schema. To customize user authorization, provide a custom `authorizeUser` function when constructing the provider.
 
-> See the [MastraAuthSupabase](/reference/auth/supabase) API reference for all available configuration options.
+> See the [MastraAuthSupabase](/reference/v1/auth/supabase) API reference for all available configuration options.
 
 ## Client-side setup
 
@@ -75,7 +75,7 @@ const accessToken = authTokenResponse.data?.session?.access_token;
 
 ## Configuring `MastraClient`
 
-When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid Supabase access token in the `Authorization` header:
+When `auth` is enabled, all requests made with `MastraClient` must include a valid Supabase access token in the `Authorization` header:
 
 ```typescript {6} title="lib/mastra/mastra-client.ts" showLineNumbers copy
 import { MastraClient } from "@mastra/client-js";
@@ -90,14 +90,14 @@ export const mastraClient = new MastraClient({
 
 > **Note:** The access token must be prefixed with `Bearer` in the Authorization header.
 
-> See [Mastra Client SDK](/docs/server-db/mastra-client) for more configuration options.
+> See [Mastra Client SDK](/docs/v1/server-db/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 
 Once `MastraClient` is configured with the Supabase access token, you can send authenticated requests:
 
 <Tabs>
-  <TabItem value="react" label="React">
+    <TabItem value="react" label="React">
     ```tsx title="src/components/test-agent.tsx" showLineNumbers copy
     import { mastraClient } from "../../lib/mastra-client";
 

package/.docs/raw/auth/workos.mdx

@@ -8,7 +8,7 @@ import TabItem from "@theme/TabItem";
 
 # MastraAuthWorkos Class
 
-The `MastraAuthWorkos` class provides authentication for Mastra using WorkOS. It verifies incoming requests using WorkOS access tokens and integrates with the Mastra server using the `experimental_auth` option.
+The `MastraAuthWorkos` class provides authentication for Mastra using WorkOS. It verifies incoming requests using WorkOS access tokens and integrates with the Mastra server using the `auth` option.
 
 ## Prerequisites
 
@@ -33,7 +33,7 @@ WORKOS_CLIENT_ID=client_...
 Before you can use the `MastraAuthWorkos` class you have to install the `@mastra/auth-workos` package.
 
 ```bash copy
-npm install @mastra/auth-workos@latest
+npm install @mastra/auth-workos@beta
 ```
 
 ## Usage examples
@@ -41,13 +41,13 @@ npm install @mastra/auth-workos@latest
 ### Basic usage with environment variables
 
 ```typescript {2,7} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthWorkos } from "@mastra/auth-workos";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthWorkos(),
+    auth: new MastraAuthWorkos(),
   },
 });
 ```
@@ -55,13 +55,13 @@ export const mastra = new Mastra({
 ### Custom configuration
 
 ```typescript {2,7-10} title="src/mastra/index.ts" showLineNumbers copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { MastraAuthWorkos } from "@mastra/auth-workos";
 
 export const mastra = new Mastra({
   // ..
   server: {
-    experimental_auth: new MastraAuthWorkos({
+    auth: new MastraAuthWorkos({
       apiKey: process.env.WORKOS_API_KEY,
       clientId: process.env.WORKOS_CLIENT_ID,
     }),
@@ -94,7 +94,7 @@ const workosAuth = new MastraAuthWorkos({
 });
 ```
 
-> See the [MastraAuthWorkos](/reference/auth/workos) API reference for all available configuration options.
+> See the [MastraAuthWorkos](/reference/v1/auth/workos) API reference for all available configuration options.
 
 ## Client-side setup
 
@@ -135,7 +135,7 @@ export const authenticateWithWorkos = async (
 
 ## Configuring `MastraClient`
 
-When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid WorkOS access token in the `Authorization` header:
+When `auth` is enabled, all requests made with `MastraClient` must include a valid WorkOS access token in the `Authorization` header:
 
 ```typescript title="lib/mastra/mastra-client.ts" showLineNumbers copy
 import { MastraClient } from "@mastra/client-js";
@@ -152,7 +152,7 @@ export const createMastraClient = (accessToken: string) => {
 
 > **Note:** The access token must be prefixed with `Bearer` in the Authorization header.
 
-> See [Mastra Client SDK](/docs/server-db/mastra-client) for more configuration options.
+> See [Mastra Client SDK](/docs/v1/server-db/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 

package/.docs/raw/community/contributing-templates.mdx

@@ -13,8 +13,8 @@ The Mastra community plays a vital role in creating templates that showcase inno
 
 Before creating a template, ensure you understand:
 
-- [Templates Reference](/reference/templates/overview) - Technical requirements and conventions
-- [Project Structure](/docs/getting-started/project-structure) - Standard Mastra project organization
+- [Templates Reference](/reference/v1/templates/overview) - Technical requirements and conventions
+- [Project Structure](/docs/v1/getting-started/project-structure) - Standard Mastra project organization
 - Community guidelines and quality standards
 
 ### 2. Develop Your Template
@@ -56,7 +56,7 @@ Templates must meet these quality benchmarks:
 
 ### 1. Prepare Your Template
 
-Ensure your template meets all requirements outlined in the [Templates Reference](/reference/templates/overview):
+Ensure your template meets all requirements outlined in the [Templates Reference](/reference/v1/templates/overview):
 
 - Proper project structure in `src/mastra/` directory
 - Standard TypeScript configuration

package/.docs/raw/community/discord.mdx

@@ -9,4 +9,4 @@ The Discord server has over 1000 members and serves as the main discussion forum
 
 ## Discord MCP Bot
 
-In addition to community members, we have an (experimental!) Discord bot that can also help answer questions. It uses [Model Context Protocol (MCP)](/docs/tools-mcp/mcp-overview). You can ask it a question with `/ask` (either in public channels or DMs) and clear history (in DMs only) with `/cleardm`.
+In addition to community members, we have an (experimental!) Discord bot that can also help answer questions. It uses [Model Context Protocol (MCP)](/docs/v1/tools-mcp/mcp-overview). You can ask it a question with `/ask` (either in public channels or DMs) and clear history (in DMs only) with `/cleardm`.

package/.docs/raw/course/01-first-agent/03-verifying-installation.md

@@ -7,7 +7,7 @@ Then, let's check if @mastra/core is in the package.json and there is a src/mast
 If you haven't installed Mastra yet, you can do so by running:
 
 ```bash
-npm -y create mastra@latest
+npm -y create mastra@beta
 ```
 
 If you do need to install mastra, follow the on-screen prompts and make sure to: