@mastra/mcp-docs-server 0.13.6 → 0.13.7-alpha.0

package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md

@@ -1,5 +1,30 @@
 # @mastra/voice-openai
 
+## 0.10.6-alpha.0
+
+### Patch Changes
+
+- 063cd46: dependencies updates:
+  - Updated dependency [`openai@^5.10.1` ↗︎](https://www.npmjs.com/package/openai/v/5.10.1) (from `^4.104.0`, in `dependencies`)
+- Updated dependencies [510e2c8]
+- Updated dependencies [2f72fb2]
+- Updated dependencies [3f89307]
+- Updated dependencies [9eda7d4]
+- Updated dependencies [9d49408]
+- Updated dependencies [2ecf658]
+- Updated dependencies [7a7754f]
+- Updated dependencies [fc92d80]
+- Updated dependencies [23a6a7c]
+- Updated dependencies [09bca64]
+  - @mastra/core@0.12.0-alpha.0
+
+## 0.10.5
+
+### Patch Changes
+
+- ce088f5: Update all peerdeps to latest core
+  - @mastra/core@0.11.1
+
 ## 0.10.4
 
 ### Patch Changes
@@ -274,29 +299,4 @@
 - Updated dependencies [edf1e88]
   - @mastra/core@0.9.4-alpha.1
 
-## 0.1.19-alpha.0
-
-### Patch Changes
-
-- Updated dependencies [daf942f]
-- Updated dependencies [0b8b868]
-  - @mastra/core@0.9.4-alpha.0
-
-## 0.1.18
-
-### Patch Changes
-
-- Updated dependencies [e450778]
-- Updated dependencies [8902157]
-- Updated dependencies [ca0dc88]
-- Updated dependencies [526c570]
-- Updated dependencies [d7a6a33]
-- Updated dependencies [9cd1a46]
-- Updated dependencies [b5d2de0]
-- Updated dependencies [644f8ad]
-- Updated dependencies [70dbf51]
-  - @mastra/core@0.9.3
-
-## 0.1.18-alpha.1
-
-... 993 more lines hidden. See full changelog in package directory.
+... 1018 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md

@@ -1,5 +1,12 @@
 # @mastra/voice-playai
 
+## 0.10.5
+
+### Patch Changes
+
+- ce088f5: Update all peerdeps to latest core
+  - @mastra/core@0.11.1
+
 ## 0.10.4
 
 ### Patch Changes
@@ -291,12 +298,5 @@
 - Updated dependencies [70dbf51]
   - @mastra/core@0.9.3-alpha.1
 
-## 0.1.17-alpha.0
-
-### Patch Changes
-
-- Updated dependencies [526c570]
-- Updated dependencies [b5d2de0]
-- Updated dependencies [644f8ad]
 
-... 982 more lines hidden. See full changelog in package directory.
+... 989 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md

@@ -1,5 +1,12 @@
 # @mastra/voice-sarvam
 
+## 0.10.5
+
+### Patch Changes
+
+- ce088f5: Update all peerdeps to latest core
+  - @mastra/core@0.11.1
+
 ## 0.10.4
 
 ### Patch Changes
@@ -291,12 +298,5 @@
 - Updated dependencies [70dbf51]
   - @mastra/core@0.9.3-alpha.1
 
-## 0.1.12-alpha.0
-
-### Patch Changes
-
-- Updated dependencies [526c570]
-- Updated dependencies [b5d2de0]
-- Updated dependencies [644f8ad]
 
-... 632 more lines hidden. See full changelog in package directory.
+... 639 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md

@@ -1,5 +1,12 @@
 # @mastra/voice-speechify
 
+## 0.10.5
+
+### Patch Changes
+
+- ce088f5: Update all peerdeps to latest core
+  - @mastra/core@0.11.1
+
 ## 0.10.4
 
 ### Patch Changes
@@ -291,12 +298,5 @@
 - Updated dependencies [ca0dc88]
 - Updated dependencies [526c570]
 - Updated dependencies [d7a6a33]
-- Updated dependencies [9cd1a46]
-- Updated dependencies [b5d2de0]
-- Updated dependencies [644f8ad]
-- Updated dependencies [70dbf51]
-  - @mastra/core@0.9.3
-
-## 0.1.17-alpha.1
 
-... 986 more lines hidden. See full changelog in package directory.
+... 993 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/create-mastra.md

@@ -1,5 +1,13 @@
 # create-mastra
 
+## 0.10.14-alpha.0
+
+### Patch Changes
+
+- f442224: speech to text using voice config
+- d8dec5e: add a cta to invite to deploy to cloud
+- 89d2f4e: add TTS to the playground
+
 ## 0.10.13
 
 ### Patch Changes
@@ -291,12 +299,4 @@
 
 ## 0.10.3-alpha.1
 
-### Patch Changes
-
-- e719504: don't start posthog when the browser is Brave
-
-## 0.10.3-alpha.0
-
-### Patch Changes
-
-... 1116 more lines hidden. See full changelog in package directory.
+... 1124 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/mastra.md

@@ -1,5 +1,36 @@
 # mastra
 
+## 0.10.16-alpha.0
+
+### Patch Changes
+
+- bc6b44a: Extract tools import from `createHonoServer`; the function now receives tools via a prop on the `options` parameter.
+- f442224: speech to text using voice config
+- 7a7754f: Fast follow scorers fixing input types, improve llm scorer reliability, fix ui to display scores that are 0
+- d8dec5e: add a cta to invite to deploy to cloud
+- 89d2f4e: add TTS to the playground
+- Updated dependencies [510e2c8]
+- Updated dependencies [2f72fb2]
+- Updated dependencies [832691b]
+- Updated dependencies [557bb9d]
+- Updated dependencies [3f89307]
+- Updated dependencies [9eda7d4]
+- Updated dependencies [9d49408]
+- Updated dependencies [bc6b44a]
+- Updated dependencies [2ecf658]
+- Updated dependencies [7a7754f]
+- Updated dependencies [fc92d80]
+- Updated dependencies [23a6a7c]
+- Updated dependencies [09bca64]
+  - @mastra/core@0.12.0-alpha.0
+  - @mastra/deployer@0.12.0-alpha.0
+
+## 0.10.15
+
+### Patch Changes
+
+- 1a45f3a: Fix peerdeps
+
 ## 0.10.14
 
 ### Patch Changes
@@ -267,36 +298,5 @@
 - 2873c7f: dependencies updates:
   - Updated dependency [`dotenv@^16.6.1` ↗︎](https://www.npmjs.com/package/dotenv/v/16.6.1) (from `^16.5.0`, in `dependencies`)
 - a9f51e4: Fix plaground get tools not including x-mastra-dev-header"
-- 3322d00: Fix tools watcher in dev
-- b790fd1: Use SerializedStepFlowEntry in playground
-- a7a836a: Highlight send event button
-- Updated dependencies [2873c7f]
-- Updated dependencies [1c1c6a1]
-- Updated dependencies [bc40cdd]
-- Updated dependencies [2873c7f]
-- Updated dependencies [1c1c6a1]
-- Updated dependencies [d9b26b5]
-- Updated dependencies [f5ec3a4]
-- Updated dependencies [f8ce2cc]
-- Updated dependencies [ab3bbff]
-- Updated dependencies [8c846b6]
-- Updated dependencies [c7bbf1e]
-- Updated dependencies [8722d53]
-- Updated dependencies [565cc0c]
-- Updated dependencies [b790fd1]
-- Updated dependencies [132027f]
-- Updated dependencies [0c85311]
-- Updated dependencies [d7ed04d]
-- Updated dependencies [c0ba5e2]
-- Updated dependencies [18ca936]
-- Updated dependencies [cb16baf]
-- Updated dependencies [40cd025]
-- Updated dependencies [f36e4f1]
-- Updated dependencies [7f6e403]
-  - @mastra/core@0.10.11
-  - @mastra/deployer@0.10.11
-  - @mastra/mcp@0.10.6
-
-## 0.10.11-alpha.3
-
-... 4532 more lines hidden. See full changelog in package directory.
+
+... 4563 more lines hidden. See full changelog in package directory.

package/.docs/organized/code-examples/a2a.md

@@ -13,7 +13,7 @@
   "devDependencies": {
     "mastra": "latest",
     "tsx": "^4.7.0",
-    "typescript": "^5.3.3"
+    "typescript": "^5.8.3"
   }
 }
 ```

package/.docs/organized/code-examples/agui.md

@@ -21,8 +21,8 @@
     "@eslint/js": "^9.25.0",
     "@types/react": "^19.1.8",
     "@types/react-dom": "^19.1.6",
-    "@typescript-eslint/eslint-plugin": "^8.32.0",
-    "@typescript-eslint/parser": "^8.32.0",
+    "@typescript-eslint/eslint-plugin": "^8.38.0",
+    "@typescript-eslint/parser": "^8.38.0",
     "@vitejs/plugin-react": "^4.4.1",
     "eslint": "^9.30.1",
     "eslint-plugin-react-hooks": "^5.2.0",

package/.docs/organized/code-examples/ai-sdk-useChat.md

@@ -20,7 +20,7 @@
     "eslint-config-next": "15.3.5",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.3"
   }
 }
 ```

package/.docs/organized/code-examples/ai-sdk-v5.md

@@ -28,7 +28,7 @@
     "mastra": "0.0.0-ai-v5-20250625173645",
     "postcss": "^8",
     "tailwindcss": "^3.4.1",
-    "typescript": "^5"
+    "typescript": "^5.8.3"
   }
 }
 ```

package/.docs/organized/code-examples/assistant-ui.md

@@ -22,7 +22,7 @@
     "eslint-config-next": "15.3.5",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.3"
   }
 }
 ```

package/.docs/organized/code-examples/bird-checker-with-express.md

@@ -11,7 +11,7 @@
     "nodemon": "^3.1.9",
     "ts-node": "^10.9.2",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.3"
   },
   "dependencies": {
     "@ai-sdk/anthropic": "latest",

package/.docs/organized/code-examples/bird-checker-with-nextjs-and-eval.md

@@ -27,7 +27,7 @@
     "eslint-config-next": "15.3.5",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.3"
   }
 }
 ```

package/.docs/organized/code-examples/bird-checker-with-nextjs.md

@@ -27,7 +27,7 @@
     "eslint-config-next": "15.3.5",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.3"
   }
 }
 ```

package/.docs/organized/code-examples/client-side-tools.md

@@ -19,8 +19,8 @@
     "eslint-plugin-react-hooks": "^5.2.0",
     "eslint-plugin-react-refresh": "^0.4.20",
     "globals": "^15.15.0",
-    "typescript": "~5.7.2",
-    "typescript-eslint": "^8.24.1",
+    "typescript": "~5.8.3",
+    "typescript-eslint": "^8.38.0",
     "vite": "^6.2.0"
   }
 }

package/.docs/organized/code-examples/crypto-chatbot.md

@@ -20,7 +20,7 @@
     "@radix-ui/react-slot": "^1.2.3",
     "@radix-ui/react-tooltip": "^1.2.7",
     "@radix-ui/react-visually-hidden": "^1.2.3",
-    "@typescript-eslint/parser": "^8.31.0",
+    "@typescript-eslint/parser": "^8.38.0",
     "@vercel/analytics": "^1.5.0",
     "@vercel/blob": "^1.0.0",
     "@vercel/postgres": "^0.10.0",

package/.docs/organized/code-examples/fireworks-r1.md

@@ -20,7 +20,7 @@
     "dotenv": "^17.0.0",
     "mastra": "latest",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.3"
   }
 }
 ```

package/.docs/organized/code-examples/memory-with-mem0.md

@@ -11,7 +11,7 @@
   "devDependencies": {
     "@types/node": "^22.15.29",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.3"
   }
 }
 ```

package/.docs/organized/code-examples/memory-with-pg.md

@@ -176,6 +176,7 @@ export const memory = new Memory({
       messageRange: 2,
     },
   },
+  embedder: openai.embedding('text-embedding-3-small'),
 });
 
 export const chefAgent = new Agent({

package/.docs/organized/code-examples/openapi-spec-writer.md

@@ -37,7 +37,7 @@
     "eslint-config-next": "15.3.5",
     "postcss": "^8.5.3",
     "tailwindcss": "^3.4.17",
-    "typescript": "^5.8.2"
+    "typescript": "^5.8.3"
   },
   "peerDependencies": {
     "react": ">= 0.14.0 || 19",

package/.docs/organized/code-examples/quick-start.md

@@ -5,7 +5,7 @@
   "devDependencies": {
     "@types/node": "^20.17.57",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.2",
+    "typescript": "^5.8.3",
     "zod": "^3.25.67"
   },
   "dependencies": {

package/.docs/organized/code-examples/workflow-ai-recruiter.md

@@ -6,7 +6,7 @@
     "@types/node": "^20.17.57",
     "mastra": "latest",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.2",
+    "typescript": "^5.8.3",
     "zod": "^3.25.67"
   },
   "dependencies": {

package/.docs/organized/code-examples/workflow-with-inline-steps.md

@@ -6,7 +6,7 @@
     "@types/node": "^20.17.57",
     "mastra": "latest",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.2",
+    "typescript": "^5.8.3",
     "zod": "^3.25.67"
   },
   "dependencies": {

package/.docs/organized/code-examples/workflow-with-memory.md

@@ -5,7 +5,7 @@
   "devDependencies": {
     "@types/node": "^20.17.57",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.2",
+    "typescript": "^5.8.3",
     "zod": "^3.25.67"
   },
   "dependencies": {

package/.docs/organized/code-examples/workflow-with-separate-steps.md

@@ -6,7 +6,7 @@
     "@types/node": "^20.17.57",
     "mastra": "latest",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.2",
+    "typescript": "^5.8.3",
     "zod": "^3.25.67"
   },
   "dependencies": {

package/.docs/organized/code-examples/workflow-with-suspend-resume.md

@@ -6,7 +6,7 @@
     "@types/node": "^20.17.57",
     "mastra": "latest",
     "tsx": "^4.19.3",
-    "typescript": "^5.8.2",
+    "typescript": "^5.8.3",
     "zod": "^3.25.67"
   },
   "dependencies": {

package/.docs/raw/agents/runtime-variables.mdx

@@ -23,7 +23,7 @@ const agent = mastra.getAgent("weatherAgent");
 
 // Define your runtimeContext's type structure
 type WeatherRuntimeContext = {
-  "temperature-scale": "celsius" | "fahrenheit"; // Fixed typo in "fahrenheit"
+  "temperature-scale": "celsius" | "fahrenheit";
 };
 
 const runtimeContext = new RuntimeContext<WeatherRuntimeContext>();

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

@@ -0,0 +1,24 @@
+---
+title: Auth Overview
+description: Learn about different Auth options for your Mastra applications
+---
+
+# Auth Overview
+
+Mastra lets you choose how you handle authentication, so you can secure access to your application's endpoints using the identity system that fits your stack.
+
+You can start with simple shared secret JWT authentication and switch to providers like Supabase, Firebase Auth, Auth0, Clerk, or WorkOS when you need more advanced identity features.
+
+## Available providers
+
+- [JSON Web Token (JWT)](/docs/auth/jwt)
+
+### Coming soon
+
+The following providers will be available soon:
+
+- Supabase Auth
+- Firebase Auth
+- Auth0
+- Clerk
+- WorkOS

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

@@ -0,0 +1,99 @@
+---
+title: "MastraJwtAuth"
+description: "Documentation for the MastraJwtAuth class, which authenticates Mastra applications using JSON Web Tokens."
+---
+
+import { Tabs, Tab } from "@/components/tabs";
+
+# MastraJwtAuth
+
+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.
+
+## Installation
+
+```bash copy
+npm install @mastra/auth
+```
+
+## Usage example
+
+```typescript {2,7-9} filename="src/mastra/index.ts" showLineNumbers copy
+import { Mastra } from "@mastra/core/mastra";
+import { MastraJwtAuth } from '@mastra/auth';
+
+export const mastra = new Mastra({
+  // ..
+  server: {
+    experimental_auth: new MastraJwtAuth({
+        secret: process.env.MASTRA_JWT_SECRET
+    }),
+  },
+});
+```
+
+> See the [MastraJwtAuth](/reference/auth/jwt.mdx) 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
+import { MastraClient } from "@mastra/client-js";
+
+export const mastraClient = new MastraClient({
+  baseUrl: "https://<mastra-api-url>",
+  headers: {
+    Authorization: `Bearer ${process.env.MASTRA_JWT_TOKEN}`
+  }
+});
+```
+
+> See [Mastra Client SDK](/docs/server-db/mastra-client.mdx) 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
+    import { mastraClient } from "../../lib/mastra-client";
+
+    export const TestAgent = () => {
+      async function handleClick() {
+        const agent = mastraClient.getAgent("weatherAgent");
+
+        const response = await agent.generate({
+          messages: "Weather in London"
+        });
+
+        console.log(response);
+      }
+
+      return <button onClick={handleClick}>Test Agent</button>;
+    };
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
+      -H "Content-Type: application/json" \
+      -H "Authorization: Bearer <your-jwt>" \
+      -d '{
+        "messages": "Weather in London"
+      }'
+    ```
+  </Tab>
+</Tabs>
+
+## Creating a JWT
+
+To authenticate requests to your Mastra server, you'll need a valid JSON Web Token (JWT) signed with your `MASTRA_JWT_SECRET`.
+
+The easiest way to generate one is using [jwt.io](https://www.jwt.io/):
+
+1. Select **JWT Encoder**.
+2. Scroll down to the **Sign JWT: Secret** section.
+3. Enter your secret (for example: `supersecretdevkeythatishs256safe!`).
+4. Click **Generate example** to create a valid JWT.
+5. Copy the generated token and set it as `MASTRA_JWT_TOKEN` in your `.env` file.

package/.docs/raw/deployment/cloud-providers/azure-app-services.mdx

@@ -18,8 +18,8 @@ Deploy your Mastra applications to Azure App Services.
 
 ### Prerequisites
 
-- An Azure account with an active subscription
-- A GitHub repository containing your Mastra application
+- An [Azure account](https://azure.microsoft.com/) with an active subscription
+- A [GitHub repository](https://github.com/) containing your Mastra application
 - Your Mastra application should be created using `npx create-mastra@latest`
 
 ### Deployment Steps
@@ -29,7 +29,7 @@ Deploy your Mastra applications to Azure App Services.
 #### Create a new App Service
 
 - Log in to the [Azure Portal](https://portal.azure.com)
-- Navigate to **App Services** or search for it in the top search bar
+- Navigate to **[App Services](https://docs.microsoft.com/en-us/azure/app-service/)** or search for it in the top search bar
 - Click **Create** to create a new App Service
 - In the drop-down, select **Web App**
 
@@ -67,7 +67,7 @@ Before setting up deployment, configure your environment variables:
 - Navigate to **Deployment Center** in the left sidebar
 - Select **GitHub** as your source
 - Sign in to GitHub if you're not already authenticated with Azure
-- In this example, we will keep GitHub Actions as our provider.
+- In this example, we will keep [GitHub Actions](https://docs.github.com/en/actions) as our provider
 - Select your organization, repository, and branch
 - Azure will generate a GitHub workflow file and you can preview it before proceeding
 - Click **Save** (the save button is located at the top of the page)
@@ -84,7 +84,7 @@ Pull the latest changes to your local repository and modify the generated workfl
 
 1. **Update the build step**: Find the step named "npm install, build, and test" and:
    - Change the step name to "npm install and build"
-   - Remove the `npm test` command from the run section
+   - If you haven't set up proper tests in your Mastra application, remove the `npm test` command from the run section as the default test script will fail and disrupt deployment. If you have working tests, you can keep the test command.
 
 2. **Update the zip artifact step**: Find the "Zip artifact for deployment" step and replace the zip command with:
 
@@ -133,4 +133,5 @@ such as `LibSQLStore` with a file URL. Consider using cloud-based storage soluti
 - [Mastra Client SDK](/docs/client-js/overview)
 - [Configure custom domains](https://docs.microsoft.com/en-us/azure/app-service/app-service-web-tutorial-custom-domain)
 - [Enable HTTPS](https://docs.microsoft.com/en-us/azure/app-service/configure-ssl-bindings)
+- [Azure App Service documentation](https://docs.microsoft.com/en-us/azure/app-service/)