@mastra/mcp-docs-server 0.13.37 → 0.13.38

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

@@ -1,9 +1,10 @@
 ---
-title: "MastraAuthAuth0 Class"
+title: "MastraAuthAuth0 Class | Auth | Mastra Docs"
 description: "Documentation for the MastraAuthAuth0 class, which authenticates Mastra applications using Auth0 authentication."
 ---
 
-import { Tabs, Tab } from "@/components/tabs";
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
 
 # MastraAuthAuth0 Class
 
@@ -18,7 +19,7 @@ This example uses Auth0 authentication. Make sure to:
 3. Configure an API in your Auth0 Dashboard with an identifier (audience)
 4. Configure your application's allowed callback URLs, web origins, and logout URLs
 
-```env filename=".env" copy
+```env title=".env" copy
 AUTH0_DOMAIN=your-tenant.auth0.com
 AUTH0_AUDIENCE=your-api-identifier
 ```
@@ -39,9 +40,9 @@ npm install @mastra/auth-auth0@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 { MastraAuthAuth0 } from '@mastra/auth-auth0';
+import { MastraAuthAuth0 } from "@mastra/auth-auth0";
 
 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 { MastraAuthAuth0 } from '@mastra/auth-auth0';
+import { MastraAuthAuth0 } from "@mastra/auth-auth0";
 
 export const mastra = new Mastra({
   // ..
   server: {
     experimental_auth: new MastraAuthAuth0({
       domain: process.env.AUTH0_DOMAIN,
-      audience: process.env.AUTH0_AUDIENCE
+      audience: process.env.AUTH0_AUDIENCE,
     }),
   },
 });
@@ -81,18 +82,18 @@ By default, `MastraAuthAuth0` allows all authenticated users who have valid Auth
 
 To customize user authorization, provide a custom `authorizeUser` function:
 
-```typescript filename="src/mastra/auth.ts" showLineNumbers copy
-import { MastraAuthAuth0 } from '@mastra/auth-auth0';
+```typescript title="src/mastra/auth.ts" showLineNumbers copy
+import { MastraAuthAuth0 } from "@mastra/auth-auth0";
 
 const auth0Provider = new MastraAuthAuth0({
   authorizeUser: async (user) => {
     // Custom authorization logic
-    return user.email?.endsWith('@yourcompany.com') || false;
-  }
+    return user.email?.endsWith("@yourcompany.com") || false;
+  },
 });
 ```
 
-> See the [MastraAuthAuth0](/reference/auth/auth0.mdx) API reference for all available configuration options.
+> See the [MastraAuthAuth0](/reference/auth/auth0) API reference for all available configuration options.
 
 ## Client-side setup
 
@@ -106,7 +107,7 @@ First, install and configure the Auth0 React SDK in your application:
 npm install @auth0/auth0-react
 ```
 
-```typescript filename="src/auth0-provider.tsx" showLineNumbers copy
+```typescript title="src/auth0-provider.tsx" showLineNumbers copy
 import React from 'react';
 import { Auth0Provider } from '@auth0/auth0-react';
 
@@ -133,8 +134,8 @@ export default Auth0ProviderWithHistory;
 
 Use the Auth0 React SDK to authenticate users and retrieve their access tokens:
 
-```typescript filename="lib/auth.ts" showLineNumbers copy
-import { useAuth0 } from '@auth0/auth0-react';
+```typescript title="lib/auth.ts" showLineNumbers copy
+import { useAuth0 } from "@auth0/auth0-react";
 
 export const useAuth0Token = () => {
   const { getAccessTokenSilently } = useAuth0();
@@ -154,30 +155,30 @@ export const useAuth0Token = () => {
 
 When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid Auth0 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}`,
+    },
   });
 };
 ```
 
 > **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 Auth0 access token, you can send authenticated requests:
 
-<Tabs items={["React Component", "curl"]}>
-  <Tab>
-    ```tsx filename="src/components/mastra-api-test.tsx" showLineNumbers copy
+<Tabs>
+  <TabItem value="react" label="React">
+    ```tsx title="src/components/mastra-api-test.tsx" showLineNumbers copy
     import React, { useState } from 'react';
     import { useAuth0 } from '@auth0/auth0-react';
     import { MastraClient } from '@mastra/client-js';
@@ -220,8 +221,9 @@ Once `MastraClient` is configured with the Auth0 access token, you can send auth
       );
     };
     ```
-  </Tab>
-  <Tab>
+
+  </TabItem>
+  <TabItem value="curl" label="cURL">
     ```bash copy
     curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
       -H "Content-Type: application/json" \
@@ -230,6 +232,5 @@ Once `MastraClient` is configured with the Auth0 access token, you can send auth
         "messages": "Weather in London"
       }'
     ```
-  </Tab>
+  </TabItem>
 </Tabs>
-

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

@@ -1,9 +1,10 @@
 ---
-title: "MastraAuthClerk Class"
+title: "MastraAuthClerk Class | Auth | Mastra Docs"
 description: "Documentation for the MastraAuthClerk class, which authenticates Mastra applications using Clerk authentication."
 ---
 
-import { Tabs, Tab } from "@/components/tabs";
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
 
 # MastraAuthClerk Class
 
@@ -13,7 +14,7 @@ The `MastraAuthClerk` class provides authentication for Mastra using Clerk. It v
 
 This example uses Clerk authentication. Make sure to add your Clerk credentials to your `.env` file and ensure your Clerk project is properly configured.
 
-```env filename=".env" copy
+```env title=".env" copy
 CLERK_PUBLISHABLE_KEY=pk_test_...
 CLERK_SECRET_KEY=sk_test_...
 CLERK_JWKS_URI=https://your-clerk-domain.clerk.accounts.dev/.well-known/jwks.json
@@ -31,9 +32,9 @@ npm install @mastra/auth-clerk@latest
 
 ## Usage example
 
-```typescript {2,7-11} filename="src/mastra/index.ts" showLineNumbers copy
+```typescript {2,7-11} title="src/mastra/index.ts" showLineNumbers copy
 import { Mastra } from "@mastra/core/mastra";
-import { MastraAuthClerk } from '@mastra/auth-clerk';
+import { MastraAuthClerk } from "@mastra/auth-clerk";
 
 export const mastra = new Mastra({
   // ..
@@ -41,7 +42,7 @@ export const mastra = new Mastra({
     experimental_auth: new MastraAuthClerk({
       publishableKey: process.env.CLERK_PUBLISHABLE_KEY,
       secretKey: process.env.CLERK_SECRET_KEY,
-      jwksUri: process.env.CLERK_JWKS_URI
+      jwksUri: process.env.CLERK_JWKS_URI,
     }),
   },
 });
@@ -49,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.mdx) API reference for all available configuration options.
+> See the [MastraAuthClerk](/reference/auth/clerk) API reference for all available configuration options.
 
 ## Client-side setup
 
@@ -59,17 +60,17 @@ When using Clerk auth, you'll need to retrieve the access token from Clerk on th
 
 Use the Clerk React hooks to authenticate users and retrieve their access token:
 
-```typescript filename="lib/auth.ts" showLineNumbers copy
+```typescript title="lib/auth.ts" showLineNumbers copy
 import { useAuth } from "@clerk/nextjs";
 
 export const useClerkAuth = () => {
   const { getToken } = useAuth();
-  
+
   const getAccessToken = async () => {
     const token = await getToken();
     return token;
   };
-  
+
   return { getAccessToken };
 };
 ```
@@ -80,27 +81,27 @@ export const useClerkAuth = () => {
 
 When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid Clerk 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 Clerk access token, you can send authenticated requests:
 
-<Tabs items={["MastraClient", "curl"]}>
-  <Tab>
-    ```tsx filename="src/components/test-agent.tsx" showLineNumbers copy
+<Tabs>
+  <TabItem value="react" label="React">
+    ```tsx title="src/components/test-agent.tsx" showLineNumbers copy
     "use client";
 
     import { useAuth } from "@clerk/nextjs";
@@ -128,8 +129,9 @@ Once `MastraClient` is configured with the Clerk access token, you can send auth
       return <button onClick={handleClick}>Test Agent</button>;
     };
     ```
-  </Tab>
-  <Tab>
+
+  </TabItem>
+  <TabItem value="curl" label="cURL">
     ```bash copy
     curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
       -H "Content-Type: application/json" \
@@ -138,5 +140,5 @@ Once `MastraClient` is configured with the Clerk access token, you can send auth
         "messages": "Weather in London"
       }'
     ```
-  </Tab>
+  </TabItem>
 </Tabs>

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

@@ -1,9 +1,10 @@
 ---
-title: "MastraAuthFirebase Class"
+title: "MastraAuthFirebase Class | Auth | Mastra Docs"
 description: "Documentation for the MastraAuthFirebase class, which authenticates Mastra applications using Firebase Authentication."
 ---
 
-import { Tabs, Tab } from "@/components/tabs";
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
 
 # MastraAuthFirebase Class
 
@@ -18,7 +19,7 @@ This example uses Firebase Authentication. Make sure to:
 3. Generate a service account key from Project Settings > Service Accounts
 4. Download the service account JSON file
 
-```env filename=".env" copy
+```env title=".env" copy
 FIREBASE_SERVICE_ACCOUNT=/path/to/your/service-account-key.json
 FIRESTORE_DATABASE_ID=(default)
 # Alternative environment variable names:
@@ -41,9 +42,9 @@ 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} filename="src/mastra/index.ts" showLineNumbers copy
+```typescript {2,7} title="src/mastra/index.ts" showLineNumbers copy
 import { Mastra } from "@mastra/core/mastra";
-import { MastraAuthFirebase } from '@mastra/auth-firebase';
+import { MastraAuthFirebase } from "@mastra/auth-firebase";
 
 // Automatically uses FIREBASE_SERVICE_ACCOUNT and FIRESTORE_DATABASE_ID env vars
 export const mastra = new Mastra({
@@ -56,16 +57,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 { MastraAuthFirebase } from '@mastra/auth-firebase';
+import { MastraAuthFirebase } from "@mastra/auth-firebase";
 
 export const mastra = new Mastra({
   // ..
   server: {
     experimental_auth: new MastraAuthFirebase({
-      serviceAccount: '/path/to/service-account.json',
-      databaseId: 'your-database-id'
+      serviceAccount: "/path/to/service-account.json",
+      databaseId: "your-database-id",
     }),
   },
 });
@@ -86,7 +87,7 @@ The `MastraAuthFirebase` class can be configured through constructor options or
 
 By default, `MastraAuthFirebase` uses Firestore to manage user access. It expects a collection named `user_access` with documents keyed by user UIDs. The presence of a document in this collection determines whether a user is authorized.
 
-```typescript filename="firestore-structure.txt" copy
+```typescript title="firestore-structure.txt" copy
 user_access/
   {user_uid_1}/     // Document exists = user authorized
   {user_uid_2}/     // Document exists = user authorized
@@ -94,18 +95,18 @@ user_access/
 
 To customize user authorization, provide a custom `authorizeUser` function:
 
-```typescript filename="src/mastra/auth.ts" showLineNumbers copy
-import { MastraAuthFirebase } from '@mastra/auth-firebase';
+```typescript title="src/mastra/auth.ts" showLineNumbers copy
+import { MastraAuthFirebase } from "@mastra/auth-firebase";
 
 const firebaseAuth = new MastraAuthFirebase({
   authorizeUser: async (user) => {
     // Custom authorization logic
-    return user.email?.endsWith('@yourcompany.com') || false;
-  }
+    return user.email?.endsWith("@yourcompany.com") || false;
+  },
 });
 ```
 
-> See the [MastraAuthFirebase](/reference/auth/firebase.mdx) API reference for all available configuration options.
+> See the [MastraAuthFirebase](/reference/auth/firebase) API reference for all available configuration options.
 
 ## Client-side setup
 
@@ -115,9 +116,9 @@ When using Firebase auth, you'll need to initialize Firebase on the client side,
 
 First, initialize Firebase in your client application:
 
-```typescript filename="lib/firebase.ts" showLineNumbers copy
-import { initializeApp } from 'firebase/app';
-import { getAuth, GoogleAuthProvider } from 'firebase/auth';
+```typescript title="lib/firebase.ts" showLineNumbers copy
+import { initializeApp } from "firebase/app";
+import { getAuth, GoogleAuthProvider } from "firebase/auth";
 
 const firebaseConfig = {
   apiKey: process.env.NEXT_PUBLIC_FIREBASE_API_KEY,
@@ -134,16 +135,16 @@ export const googleProvider = new GoogleAuthProvider();
 
 Use Firebase authentication to sign in users and retrieve their ID tokens:
 
-```typescript filename="lib/auth.ts" showLineNumbers copy
-import { signInWithPopup, signOut, User } from 'firebase/auth';
-import { auth, googleProvider } from './firebase';
+```typescript title="lib/auth.ts" showLineNumbers copy
+import { signInWithPopup, signOut, User } from "firebase/auth";
+import { auth, googleProvider } from "./firebase";
 
 export const signInWithGoogle = async () => {
   try {
     const result = await signInWithPopup(auth, googleProvider);
     return result.user;
   } catch (error) {
-    console.error('Error signing in:', error);
+    console.error("Error signing in:", error);
     throw error;
   }
 };
@@ -153,7 +154,7 @@ export const getIdToken = async (user: User) => {
     const idToken = await user.getIdToken();
     return idToken;
   } catch (error) {
-    console.error('Error getting ID token:', error);
+    console.error("Error getting ID token:", error);
     throw error;
   }
 };
@@ -162,7 +163,7 @@ export const signOutUser = async () => {
   try {
     await signOut(auth);
   } catch (error) {
-    console.error('Error signing out:', error);
+    console.error("Error signing out:", error);
     throw error;
   }
 };
@@ -174,30 +175,30 @@ export const signOutUser = async () => {
 
 When `experimental_auth` is enabled, all requests made with `MastraClient` must include a valid Firebase ID 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 createMastraClient = (idToken: string) => {
   return new MastraClient({
     baseUrl: "https://<mastra-api-url>",
     headers: {
-      Authorization: `Bearer ${idToken}`
-    }
+      Authorization: `Bearer ${idToken}`,
+    },
   });
 };
 ```
 
 > **Note:** The ID 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 Firebase ID token, you can send authenticated requests:
 
-<Tabs items={["React Component", "Node.js Server", "curl"]}>
-  <Tab>
-    ```tsx filename="src/components/test-agent.tsx" showLineNumbers copy
+<Tabs>
+  <TabItem value="react" label="React">
+    ```tsx title="src/components/test-agent.tsx" showLineNumbers copy
     "use client";
 
     import { useAuthState } from 'react-firebase-hooks/auth';
@@ -229,9 +230,10 @@ Once `MastraClient` is configured with the Firebase ID token, you can send authe
       );
     };
     ```
-  </Tab>
-  <Tab>
-    ```typescript filename="server.js" showLineNumbers copy
+
+  </TabItem>
+  <TabItem value="nodejs" label="Node.js">
+    ```typescript title="server.js" showLineNumbers copy
     const express = require('express');
     const admin = require('firebase-admin');
     const { MastraClient } = require('@mastra/client-js');
@@ -249,7 +251,7 @@ Once `MastraClient` is configured with the Firebase ID token, you can send authe
     app.post('/generate', async (req, res) => {
       try {
         const { idToken } = req.body;
-        
+
         // Verify the token
         await admin.auth().verifyIdToken(idToken);
 
@@ -271,8 +273,9 @@ Once `MastraClient` is configured with the Firebase ID token, you can send authe
       }
     });
     ```
-  </Tab>
-  <Tab>
+
+  </TabItem>
+  <TabItem value="curl" label="cURL">
     ```bash copy
     curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
       -H "Content-Type: application/json" \
@@ -281,5 +284,5 @@ Once `MastraClient` is configured with the Firebase ID token, you can send authe
         "messages": "Weather in London"
       }'
     ```
-  </Tab>
-</Tabs>
+  </TabItem>
+</Tabs>

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

@@ -1,5 +1,5 @@
 ---
-title: Auth Overview
+title: "Auth Overview | Auth | Mastra Docs"
 description: Learn about different Auth options for your Mastra applications
 ---
 

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

@@ -1,9 +1,10 @@
 ---
-title: "MastraJwtAuth Class"
+title: "MastraJwtAuth Class | Auth | Mastra Docs"
 description: "Documentation for the MastraJwtAuth class, which authenticates Mastra applications using JSON Web Tokens."
 ---
 
-import { Tabs, Tab } from "@/components/tabs";
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
 
 # MastraJwtAuth Class
 
@@ -19,46 +20,46 @@ npm install @mastra/auth@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 { MastraJwtAuth } from '@mastra/auth';
+import { MastraJwtAuth } from "@mastra/auth";
 
 export const mastra = new Mastra({
   // ..
   server: {
     experimental_auth: new MastraJwtAuth({
-        secret: process.env.MASTRA_JWT_SECRET
+      secret: process.env.MASTRA_JWT_SECRET,
     }),
   },
 });
 ```
 
-> See the [MastraJwtAuth](/reference/auth/jwt.mdx) API reference for all available configuration options.
+> See the [MastraJwtAuth](/reference/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:
 
-```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 ${process.env.MASTRA_JWT_TOKEN}`
-  }
+    Authorization: `Bearer ${process.env.MASTRA_JWT_TOKEN}`,
+  },
 });
 ```
 
-> 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, you can send authenticated requests from your frontend application, or use `curl` for quick local testing:
 
-<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 = () => {
@@ -75,8 +76,9 @@ Once `MastraClient` is configured, you can send authenticated requests from your
       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" \
@@ -85,7 +87,7 @@ Once `MastraClient` is configured, you can send authenticated requests from your
         "messages": "Weather in London"
       }'
     ```
-  </Tab>
+  </TabItem>
 </Tabs>
 
 ## Creating a JWT