@mastra/mcp-docs-server 0.13.37 → 0.13.38

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

@@ -1,9 +1,10 @@
 ---
-title: "MastraAuthSupabase Class"
+title: "MastraAuthSupabase Class | Auth | Mastra Docs"
 description: "Documentation for the MastraAuthSupabase class, which authenticates Mastra applications using Supabase Auth."
 ---
 
-import { Tabs, Tab } from "@/components/tabs";
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
 
 # MastraAuthSupabase Class
 
@@ -13,7 +14,7 @@ The `MastraAuthSupabase` class provides authentication for Mastra using Supabase
 
 This example uses Supabase Auth. Make sure to add your Supabase credentials to your `.env` file and ensure your Supabase project is properly configured.
 
-```env filename=".env" copy
+```env title=".env" copy
 SUPABASE_URL=https://your-project.supabase.co
 SUPABASE_ANON_KEY=your-anon-key
 ```
@@ -30,16 +31,16 @@ npm install @mastra/auth-supabase@latest
 
 ## Usage example
 
-```typescript {2,7-9} filename="src/mastra/index.ts" showLineNumbers copy
+```typescript {2,7-9} title="src/mastra/index.ts" showLineNumbers copy
 import { Mastra } from "@mastra/core/mastra";
-import { MastraAuthSupabase } from '@mastra/auth-supabase';
+import { MastraAuthSupabase } from "@mastra/auth-supabase";
 
 export const mastra = new Mastra({
   // ..
   server: {
     experimental_auth: new MastraAuthSupabase({
       url: process.env.SUPABASE_URL,
-      anonKey: process.env.SUPABASE_ANON_KEY
+      anonKey: process.env.SUPABASE_ANON_KEY,
     }),
   },
 });
@@ -47,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.mdx) API reference for all available configuration options.
+> See the [MastraAuthSupabase](/reference/auth/supabase) API reference for all available configuration options.
 
 ## Client-side setup
 
@@ -57,7 +58,7 @@ When using Supabase auth, you'll need to retrieve the access token from Supabase
 
 Use the Supabase client to authenticate users and retrieve their access token:
 
-```typescript filename="lib/auth.ts" showLineNumbers copy
+```typescript title="lib/auth.ts" showLineNumbers copy
 import { createClient } from "@supabase/supabase-js";
 
 const supabase = createClient("<supabase-url>", "<supabase-key>");
@@ -76,28 +77,28 @@ const accessToken = authTokenResponse.data?.session?.access_token;
 
 When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid Supabase access token in the `Authorization` header:
 
-```typescript {6} filename="lib/mastra/mastra-client.ts" showLineNumbers copy
+```typescript {6} title="lib/mastra/mastra-client.ts" showLineNumbers copy
 import { MastraClient } from "@mastra/client-js";
 
 export const mastraClient = new MastraClient({
   baseUrl: "https://<mastra-api-url>",
   headers: {
-    Authorization: `Bearer ${accessToken}`
-  }
+    Authorization: `Bearer ${accessToken}`,
+  },
 });
 ```
 
 > **Note:** The access token must be prefixed with `Bearer` in the Authorization header.
 
-> See [Mastra Client SDK](/docs/server-db/mastra-client.mdx) for more configuration options.
+> See [Mastra Client SDK](/docs/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 items={["MastraClient", "curl"]}>
-  <Tab>
-    ```tsx filename="src/components/test-agent.tsx" showLineNumbers copy
+<Tabs>
+  <TabItem value="curl" label="cURL">
+    ```tsx title="src/components/test-agent.tsx" showLineNumbers copy
     import { mastraClient } from "../../lib/mastra-client";
 
     export const TestAgent = () => {
@@ -114,8 +115,9 @@ Once `MastraClient` is configured with the Supabase access token, you can send a
       return <button onClick={handleClick}>Test Agent</button>;
     };
     ```
-  </Tab>
-  <Tab>
+
+  </TabItem>
+  <TabItem value="react" label="React">
     ```bash copy
     curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
       -H "Content-Type: application/json" \
@@ -124,5 +126,5 @@ Once `MastraClient` is configured with the Supabase access token, you can send a
         "messages": "Weather in London"
       }'
     ```
-  </Tab>
+  </TabItem>
 </Tabs>

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

@@ -1,9 +1,10 @@
 ---
-title: "MastraAuthWorkos Class"
+title: "MastraAuthWorkos Class | Auth | Mastra Docs"
 description: "Documentation for the MastraAuthWorkos class, which authenticates Mastra applications using WorkOS authentication."
 ---
 
-import { Tabs, Tab } from "@/components/tabs";
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
 
 # MastraAuthWorkos Class
 
@@ -18,7 +19,7 @@ This example uses WorkOS authentication. Make sure to:
 3. Configure your redirect URIs and allowed origins
 4. Set up Organizations and configure user roles as needed
 
-```env filename=".env" copy
+```env title=".env" copy
 WORKOS_API_KEY=sk_live_...
 WORKOS_CLIENT_ID=client_...
 ```
@@ -39,9 +40,9 @@ npm install @mastra/auth-workos@latest
 
 ### Basic usage with environment variables
 
-```typescript {2,7} filename="src/mastra/index.ts" showLineNumbers copy
+```typescript {2,7} title="src/mastra/index.ts" showLineNumbers copy
 import { Mastra } from "@mastra/core/mastra";
-import { MastraAuthWorkos } from '@mastra/auth-workos';
+import { MastraAuthWorkos } from "@mastra/auth-workos";
 
 export const mastra = new Mastra({
   // ..
@@ -53,16 +54,16 @@ export const mastra = new Mastra({
 
 ### Custom configuration
 
-```typescript {2,7-10} filename="src/mastra/index.ts" showLineNumbers copy
+```typescript {2,7-10} title="src/mastra/index.ts" showLineNumbers copy
 import { Mastra } from "@mastra/core/mastra";
-import { MastraAuthWorkos } from '@mastra/auth-workos';
+import { MastraAuthWorkos } from "@mastra/auth-workos";
 
 export const mastra = new Mastra({
   // ..
   server: {
     experimental_auth: new MastraAuthWorkos({
       apiKey: process.env.WORKOS_API_KEY,
-      clientId: process.env.WORKOS_CLIENT_ID
+      clientId: process.env.WORKOS_CLIENT_ID,
     }),
   },
 });
@@ -81,8 +82,8 @@ By default, `MastraAuthWorkos` checks whether the authenticated user has an 'adm
 
 To customize user authorization, provide a custom `authorizeUser` function:
 
-```typescript filename="src/mastra/auth.ts" showLineNumbers copy
-import { MastraAuthWorkos } from '@mastra/auth-workos';
+```typescript title="src/mastra/auth.ts" showLineNumbers copy
+import { MastraAuthWorkos } from "@mastra/auth-workos";
 
 const workosAuth = new MastraAuthWorkos({
   apiKey: process.env.WORKOS_API_KEY,
@@ -111,16 +112,20 @@ npm install @workos-inc/node
 
 After users complete the WorkOS authentication flow and return with an authorization code, exchange it for an access token:
 
-```typescript filename="lib/auth.ts" showLineNumbers copy
-import { WorkOS } from '@workos-inc/node';
+```typescript title="lib/auth.ts" showLineNumbers copy
+import { WorkOS } from "@workos-inc/node";
 
 const workos = new WorkOS(process.env.WORKOS_API_KEY);
 
-export const authenticateWithWorkos = async (code: string, clientId: string) => {
-  const authenticationResponse = await workos.userManagement.authenticateWithCode({
-    code,
-    clientId,
-  });
+export const authenticateWithWorkos = async (
+  code: string,
+  clientId: string,
+) => {
+  const authenticationResponse =
+    await workos.userManagement.authenticateWithCode({
+      code,
+      clientId,
+    });
 
   return authenticationResponse.accessToken;
 };
@@ -132,15 +137,15 @@ export const authenticateWithWorkos = async (code: string, clientId: string) =>
 
 When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid WorkOS access token in the `Authorization` header:
 
-```typescript filename="lib/mastra/mastra-client.ts" showLineNumbers copy
+```typescript title="lib/mastra/mastra-client.ts" showLineNumbers copy
 import { MastraClient } from "@mastra/client-js";
 
 export const createMastraClient = (accessToken: string) => {
   return new MastraClient({
     baseUrl: "https://<mastra-api-url>",
     headers: {
-      Authorization: `Bearer ${accessToken}`
-    }
+      Authorization: `Bearer ${accessToken}`,
+    },
   });
 };
 ```
@@ -153,9 +158,9 @@ export const createMastraClient = (accessToken: string) => {
 
 Once `MastraClient` is configured with the WorkOS access token, you can send authenticated requests:
 
-<Tabs items={["JavaScript/Node.js", "curl"]}>
-  <Tab>
-    ```typescript filename="src/api/agents.ts" showLineNumbers copy
+<Tabs>
+  <TabItem value="curl" label="cURL">
+    ```typescript title="src/api/agents.ts" showLineNumbers copy
     import { WorkOS } from '@workos-inc/node';
     import { MastraClient } from '@mastra/client-js';
 
@@ -184,8 +189,9 @@ Once `MastraClient` is configured with the WorkOS access token, you can send aut
       return response.text;
     };
     ```
-  </Tab>
-  <Tab>
+
+  </TabItem>
+  <TabItem value="react" label="React">
     ```bash copy
     curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
       -H "Content-Type: application/json" \
@@ -194,5 +200,5 @@ Once `MastraClient` is configured with the WorkOS access token, you can send aut
         "messages": "Weather in London"
       }'
     ```
-  </Tab>
+  </TabItem>
 </Tabs>

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

@@ -1,10 +1,8 @@
 ---
-title: "Contributing Templates"
+title: "Contributing Templates | Community | Mastra Docs"
 description: "How to contribute your own templates to the Mastra ecosystem"
 ---
 
-import { Callout } from "nextra/components";
-
 # Contributing Templates
 
 The Mastra community plays a vital role in creating templates that showcase innovative application patterns. This guide explains how to contribute your own templates to the Mastra ecosystem.
@@ -15,7 +13,7 @@ The Mastra community plays a vital role in creating templates that showcase inno
 
 Before creating a template, ensure you understand:
 
-- [Templates Reference](/reference/templates) - Technical requirements and conventions
+- [Templates Reference](/reference/templates/overview) - Technical requirements and conventions
 - [Project Structure](/docs/getting-started/project-structure) - Standard Mastra project organization
 - Community guidelines and quality standards
 
@@ -58,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):
+Ensure your template meets all requirements outlined in the [Templates Reference](/reference/templates/overview):
 
 - Proper project structure in `src/mastra/` directory
 - Standard TypeScript configuration
@@ -188,6 +186,8 @@ Ready to contribute a template?
 4. **Build and test** - Create a working, well-documented template
 5. **Submit for review** - Use the contribution form to submit your template
 
-<Callout type="info">
+:::info
+
 Your contributions help grow the Mastra ecosystem and provide valuable resources for the entire community. We look forward to seeing your innovative templates!
-</Callout>
+
+:::

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

@@ -1,5 +1,5 @@
 ---
-title: "Discord Community and Bot | Documentation | Mastra"
+title: "Discord Community | Community | Mastra Docs"
 description: Information about the Mastra Discord community and MCP bot.
 ---
 
@@ -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/agents/mcp-guide). 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/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/community/licensing.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Licensing"
+title: "License | Community | Mastra Docs"
 description: "Mastra License"
 ---
 

package/.docs/raw/course/03-agent-memory/26-updating-mastra-export-comprehensive.md

@@ -1,32 +0,0 @@
-# Updating Your Mastra Export
-
-Make sure to update your `src/mastra/index.ts` file to include your new comprehensive memory agent:
-
-```typescript
-import { Mastra } from "@mastra/core";
-import { memoryMasterAgent } from "./agents/memory-agent";
-
-export const mastra: Mastra = new Mastra({
-  agents: {
-    memoryMasterAgent,
-  },
-});
-```
-
-This step is essential for making your comprehensive memory agent available in the Mastra playground. The `mastra` export is the main entry point for your Mastra application, and it needs to include all the agents you want to use.
-
-By adding your `memoryMasterAgent` to the `agents` object in the Mastra configuration, you're registering it with the Mastra system, making it available for use in the playground and other parts of your application.
-
-If you have multiple agents, you can include them all in the `agents` object:
-
-```typescript
-export const mastra: Mastra = new Mastra({
-  agents: {
-    memoryMasterAgent,
-    learningAssistantAgent,
-    // Other agents...
-  },
-});
-```
-
-This allows you to switch between different agents in the playground, each with its own specialized memory configuration and capabilities.

package/.docs/raw/deployment/cloud-providers/amazon-ec2.mdx

@@ -1,20 +1,23 @@
 ---
-title: "Amazon EC2"
+title: "Amazon EC2 | Deployment | Mastra Docs"
 description: "Deploy your Mastra applications to Amazon EC2."
 ---
 
-import { Callout, Steps, Tabs } from "nextra/components";
+import Steps from "@site/src/components/Steps";
+import StepItem from "@site/src/components/StepItem";
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
 
 # Amazon EC2
 
 Deploy your Mastra applications to Amazon EC2 (Elastic Cloud Compute).
 
-<Callout>
-  This guide assumes your Mastra application has been created using the default
-  `npx create-mastra@latest` command.
-  For more information on how to create a new Mastra application,
-  refer to our [getting started guide](/docs/getting-started/installation)
-</Callout>
+:::note
+This guide assumes your Mastra application has been created using the default
+`npx create-mastra@latest` command.
+For more information on how to create a new Mastra application,
+refer to our [getting started guide](/docs/getting-started/installation)
+:::
 
 ## Prerequisites
 
@@ -29,26 +32,26 @@ Deploy your Mastra applications to Amazon EC2 (Elastic Cloud Compute).
 
 <Steps>
 
-### Clone your Mastra application
+<StepItem>
 
 Connect to your EC2 instance and clone your repository:
 
-<Tabs items={["Public Repository", "Private Repository"]}>
-<Tabs.Tab>
+<Tabs>
+  <TabItem value="public" label="Public Repository">
 
 ```bash copy
 git clone https://github.com/<your-username>/<your-repository>.git
 ```
 
-</Tabs.Tab>
+  </TabItem>
 
-<Tabs.Tab>
+  <TabItem value="private" label="Private Repository">
 
 ```bash copy
 git clone https://<your-username>:<your-personal-access-token>@github.com/<your-username>/<your-repository>.git
 ```
 
-</Tabs.Tab>
+  </TabItem>
 </Tabs>
 
 Navigate to the repository directory:
@@ -57,13 +60,19 @@ Navigate to the repository directory:
 cd "<your-repository>"
 ```
 
-### Install dependencies
+</StepItem>
+
+<StepItem>
+
+Install dependencies:
 
 ```bash copy
 npm install
 ```
 
-### Set up environment variables
+</StepItem>
+
+<StepItem>
 
 Create a `.env` file and add your environment variables:
 
@@ -78,21 +87,31 @@ OPENAI_API_KEY=<your-openai-api-key>
 # Add other required environment variables
 ```
 
-### Build the application
+</StepItem>
+
+<StepItem>
+
+Build the application:
 
 ```bash copy
 npm run build
 ```
 
-### Run the application
+</StepItem>
+
+<StepItem>
+
+Run the application:
 
 ```bash copy
 node --import=./.mastra/output/instrumentation.mjs --env-file=".env" .mastra/output/index.mjs
 ```
 
-<Callout>
+:::note
 Your Mastra application will run on port 4111 by default. Ensure your reverse proxy is configured to forward requests to this port.
-</Callout>
+:::
+
+</StepItem>
 
 </Steps>
 
@@ -100,7 +119,7 @@ Your Mastra application will run on port 4111 by default. Ensure your reverse pr
 
 You can now connect to your Mastra server from your client application using a `MastraClient` from the `@mastra/client-js` package.
 
-Refer to the [`MastraClient` documentation](/docs/client-js/overview) for more information.
+Refer to the [`MastraClient` documentation](/reference/client-js/mastra-client) for more information.
 
 ```typescript copy showLineNumbers
 import { MastraClient } from "@mastra/client-js";
@@ -112,4 +131,4 @@ const mastraClient = new MastraClient({
 
 ## Next steps
 
-- [Mastra Client SDK](/docs/client-js/overview)
+- [Mastra Client SDK](/reference/client-js/mastra-client)