@mastra/mcp-docs-server 1.1.14 → 1.1.15-alpha.2

package/.docs/docs/deployment/studio.md

@@ -64,6 +64,8 @@ The command uses Node's built-in `http` module and [`serve-handler`](https://www
 Running `mastra studio` as a long-running process is no different from running any other Node.js service. All the best practices, tools, and options for deployment apply here as well. You can use process managers like PM2, use Docker, or cloud services that support Node.js applications. You'll need to ensure CORS is configured correctly and errors are monitored, as with any web service.
 
 > **Warning:** Once Studio is connected to your Mastra server, it has full access to your agents, workflows, and tools. Be sure to secure it properly in production (e.g. behind authentication, VPN, etc.) to prevent unauthorized access.
+>
+> Visit the [Authentication](https://mastra.ai/docs/server/auth) docs to learn more.
 
 ### Alongside your API
 

package/.docs/docs/server/auth/auth0.md

@@ -1,6 +1,6 @@
-# MastraAuthAuth0 class
+# Auth0
 
-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.
+The `@mastra/auth-auth0` package 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
 
@@ -24,10 +24,30 @@ AUTH0_AUDIENCE=your-api-identifier
 
 Before you can use the `MastraAuthAuth0` class you have to install the `@mastra/auth-auth0` package.
 
+**npm**:
+
 ```bash
 npm install @mastra/auth-auth0@latest
 ```
 
+**pnpm**:
+
+```bash
+pnpm add @mastra/auth-auth0@latest
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/auth-auth0@latest
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/auth-auth0@latest
+```
+
 ## Usage examples
 
 ### Basic usage with environment variables
@@ -93,10 +113,30 @@ When using Auth0 auth, you'll need to set up the Auth0 React SDK, authenticate u
 
 First, install and configure the Auth0 React SDK in your application:
 
+**npm**:
+
 ```bash
 npm install @auth0/auth0-react
 ```
 
+**pnpm**:
+
+```bash
+pnpm add @auth0/auth0-react
+```
+
+**Yarn**:
+
+```bash
+yarn add @auth0/auth0-react
+```
+
+**Bun**:
+
+```bash
+bun add @auth0/auth0-react
+```
+
 ```typescript
 import React from 'react'
 import { Auth0Provider } from '@auth0/auth0-react'

package/.docs/docs/server/auth/better-auth.md

@@ -1,6 +1,6 @@
-# MastraAuthBetterAuth Class
+# Better Auth
 
-The `MastraAuthBetterAuth` class provides authentication for Mastra using Better Auth. It verifies incoming requests using your Better Auth instance and integrates with the Mastra server via the `server.auth` option.
+The `@mastra/auth-better-auth` package provides authentication for Mastra using Better Auth. It verifies incoming requests using your Better Auth instance and integrates with the Mastra server via the `server.auth` option.
 
 ## Prerequisites
 

package/.docs/docs/server/auth/clerk.md

@@ -1,6 +1,6 @@
-# MastraAuthClerk class
+# Clerk
 
-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.
+The `@mastra/auth-clerk` package 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
 
@@ -18,10 +18,30 @@ 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.
 
+**npm**:
+
 ```bash
 npm install @mastra/auth-clerk@latest
 ```
 
+**pnpm**:
+
+```bash
+pnpm add @mastra/auth-clerk@latest
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/auth-clerk@latest
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/auth-clerk@latest
+```
+
 ## Usage example
 
 ```typescript

package/.docs/docs/server/auth/composite-auth.md

@@ -1,4 +1,4 @@
-# CompositeAuth class
+# Composite Auth
 
 The `CompositeAuth` class allows you to combine multiple authentication providers into a single auth handler. It tries each provider in order until one succeeds.
 

package/.docs/docs/server/auth/custom-auth-provider.md

@@ -1,4 +1,4 @@
-# Custom auth providers
+# Custom auth provider
 
 Custom auth providers allow you to implement authentication for identity systems that aren't covered by the built-in providers. Extend the `MastraAuthProvider` base class to integrate with any authentication system.
 

package/.docs/docs/server/auth/firebase.md

@@ -1,6 +1,6 @@
-# MastraAuthFirebase class
+# Firebase
 
-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.
+The `@mastra/auth-firebase` package 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
 
@@ -24,10 +24,30 @@ FIRESTORE_DATABASE_ID=(default)
 
 Before you can use the `MastraAuthFirebase` class you have to install the `@mastra/auth-firebase` package.
 
+**npm**:
+
 ```bash
 npm install @mastra/auth-firebase@latest
 ```
 
+**pnpm**:
+
+```bash
+pnpm add @mastra/auth-firebase@latest
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/auth-firebase@latest
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/auth-firebase@latest
+```
+
 ## Usage examples
 
 ### Basic usage with environment variables

package/.docs/docs/server/auth/jwt.md

@@ -1,4 +1,4 @@
-# MastraJwtAuth class
+# JSON Web Token
 
 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.
 
@@ -30,8 +30,22 @@ yarn add @mastra/auth@latest
 bun add @mastra/auth@latest
 ```
 
+## 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.
+
 ## Usage example
 
+Take your generated JWT and use it to configure `MastraJwtAuth` in your Mastra server:
+
 ```typescript
 import { Mastra } from '@mastra/core'
 import { MastraJwtAuth } from '@mastra/auth'
@@ -47,6 +61,8 @@ export const mastra = new Mastra({
 
 > **Info:** Visit [MastraJwtAuth](https://mastra.ai/reference/auth/jwt) for all available configuration options.
 
+Inside [Studio](https://mastra.ai/docs/getting-started/studio), go to **Settings** and under **Headers** select the **"Add Header"** button. Enter `Authorization` as the header name and `Bearer <your-jwt>` as the value.
+
 ## Configuring `MastraClient`
 
 When `auth` is enabled, all requests made with `MastraClient` must include a valid JWT in the `Authorization` header:
@@ -95,16 +111,4 @@ curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
   -d '{
     "messages": "Weather in London"
   }'
-```
-
-## 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/docs/server/auth/simple-auth.md

@@ -1,4 +1,4 @@
-# SimpleAuth class
+# Simple Auth
 
 The `SimpleAuth` class provides token-based authentication using a basic token-to-user mapping. It's included in `@mastra/core/server` and is useful for development, testing, and basic API key authentication scenarios.
 
@@ -11,7 +11,7 @@ The `SimpleAuth` class provides token-based authentication using a basic token-t
 
 ## Installation
 
-SimpleAuth is included in `@mastra/core`, no additional packages required.
+`SimpleAuth` is included in `@mastra/core`, no additional packages required.
 
 ```typescript
 import { SimpleAuth } from '@mastra/core/server'

package/.docs/docs/server/auth/supabase.md

@@ -1,6 +1,6 @@
-# MastraAuthSupabase class
+# Supabase
 
-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.
+The `@mastra/auth-supabase` package 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
 
@@ -17,10 +17,30 @@ SUPABASE_ANON_KEY=your-anon-key
 
 Before you can use the `MastraAuthSupabase` class you have to install the `@mastra/auth-supabase` package.
 
+**npm**:
+
 ```bash
 npm install @mastra/auth-supabase@latest
 ```
 
+**pnpm**:
+
+```bash
+pnpm add @mastra/auth-supabase@latest
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/auth-supabase@latest
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/auth-supabase@latest
+```
+
 ## Usage example
 
 ```typescript

package/.docs/docs/server/auth/workos.md

@@ -1,6 +1,6 @@
-# MastraAuthWorkos class
+# WorkOS
 
-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.
+The `@mastra/auth-workos` package 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
 
@@ -24,10 +24,30 @@ WORKOS_CLIENT_ID=client_...
 
 Before you can use the `MastraAuthWorkos` class you have to install the `@mastra/auth-workos` package.
 
+**npm**:
+
 ```bash
 npm install @mastra/auth-workos@latest
 ```
 
+**pnpm**:
+
+```bash
+pnpm add @mastra/auth-workos@latest
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/auth-workos@latest
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/auth-workos@latest
+```
+
 ## Usage examples
 
 ### Basic usage with environment variables
@@ -94,10 +114,30 @@ When using WorkOS auth, you'll need to implement the WorkOS authentication flow
 
 First, install the WorkOS SDK in your application:
 
+**npm**:
+
 ```bash
 npm install @workos-inc/node
 ```
 
+**pnpm**:
+
+```bash
+pnpm add @workos-inc/node
+```
+
+**Yarn**:
+
+```bash
+yarn add @workos-inc/node
+```
+
+**Bun**:
+
+```bash
+bun add @workos-inc/node
+```
+
 ### Exchanging code for access token
 
 After users complete the WorkOS authentication flow and return with an authorization code, exchange it for an access token:

package/.docs/docs/server/auth.md

@@ -15,12 +15,14 @@ Authentication is optional. If no auth is configured, all routes and Studio are
 
 See [Custom API Routes](https://mastra.ai/docs/server/custom-api-routes) for controlling authentication on custom endpoints.
 
+> **Note:** Authentication for Studio is currently supported by the following providers: Simple Auth, JWT, WorkOS, and Better Auth.
+
 ## Available providers
 
 ### Built-in
 
-- [Simple Auth](https://mastra.ai/docs/server/auth/simple-auth) - Token-to-user mapping for development and API keys
-- [JSON Web Token (JWT)](https://mastra.ai/docs/server/auth/jwt) - HMAC-signed JWT verification
+- [Simple Auth](https://mastra.ai/docs/server/auth/simple-auth): Token-to-user mapping for development and API keys
+- [JSON Web Token (JWT)](https://mastra.ai/docs/server/auth/jwt): HMAC-signed JWT verification
 
 ### Third-party integrations
 
@@ -33,5 +35,5 @@ See [Custom API Routes](https://mastra.ai/docs/server/custom-api-routes) for con
 
 ### Advanced
 
-- [Composite Auth](https://mastra.ai/docs/server/auth/composite-auth) - Combine multiple auth providers
-- [Custom Auth Provider](https://mastra.ai/docs/server/auth/custom-auth-provider) - Build your own provider
+- [Composite Auth](https://mastra.ai/docs/server/auth/composite-auth): Combine multiple auth providers
+- [Custom Auth Provider](https://mastra.ai/docs/server/auth/custom-auth-provider): Build your own provider

package/.docs/guides/build-your-ui/ai-sdk-ui.md

@@ -133,6 +133,8 @@ If you don't want to run Mastra's server and instead use frameworks like Next.js
 
 They return a `ReadableStream` that you can wrap with [`createUIMessageStreamResponse()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/create-ui-message-stream-response).
 
+> **AI SDK v6 compatibility:** The framework-agnostic handlers keep the existing AI SDK v5/default behavior. If your app is typed against AI SDK v6, pass `version: 'v6'`. For best TypeScript inference with `handleChatStream()` and `handleNetworkStream()`, pass `messages` as `UIMessage[]` from your installed `ai` version.
+
 The examples below show you how to use them with Next.js App Router.
 
 **handleChatStream()**:
@@ -874,6 +876,15 @@ For live examples of Custom UI patterns, visit [Mastra's UI Dojo](https://ui-doj
 
 To manually transform Mastra's streams to AI SDK-compatible format, use the [`toAISdkStream()`](https://mastra.ai/reference/ai-sdk/to-ai-sdk-stream) utility. See the [examples](https://mastra.ai/reference/ai-sdk/to-ai-sdk-stream) for concrete usage patterns.
 
+`toAISdkStream()` keeps the existing AI SDK v5/default behavior. If your app is typed against AI SDK v6, pass `version: 'v6'`.
+
+```typescript
+import { toAISdkStream } from '@mastra/ai-sdk'
+
+const v5Stream = toAISdkStream(mastraStream, { from: 'agent' })
+const v6Stream = toAISdkStream(mastraStream, { from: 'agent', version: 'v6' })
+```
+
 ### Loading historical messages
 
 When loading messages from Mastra's memory to display in a chat UI, use [`toAISdkV5Messages()`](https://mastra.ai/reference/ai-sdk/to-ai-sdk-v5-messages) or [`toAISdkV4Messages()`](https://mastra.ai/reference/ai-sdk/to-ai-sdk-v4-messages) to convert them to the appropriate AI SDK format for `useChat()`'s `initialMessages`.

package/.docs/guides/guide/docs-manager.md

@@ -61,7 +61,7 @@ Quick start guide for the project.
 
 ## Installation
 
-```bash
+```bash npm2yarn
 npm install example-package
 ```
 
@@ -176,7 +176,7 @@ Learn how to add authentication to your application.
 
 Install the auth package:
 
-```bash
+```bash npm2yarn
 npm install @example/auth
 ```
 

package/.docs/models/index.md

@@ -1,6 +1,6 @@
 # Model Providers
 
-Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 3371 models from 94 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 3381 models from 94 providers through a single API.
 
 ## Features
 

package/.docs/models/providers/minimax-cn-coding-plan.md

@@ -1,6 +1,6 @@
 # ![MiniMax Coding Plan (minimaxi.com) logo](https://models.dev/logos/minimax-cn-coding-plan.svg)MiniMax Coding Plan (minimaxi.com)
 
-Access 4 MiniMax Coding Plan (minimaxi.com) models through Mastra's model router. Authentication is handled automatically using the `MINIMAX_API_KEY` environment variable.
+Access 6 MiniMax Coding Plan (minimaxi.com) models through Mastra's model router. Authentication is handled automatically using the `MINIMAX_API_KEY` environment variable.
 
 Learn more in the [MiniMax Coding Plan (minimaxi.com) documentation](https://platform.minimaxi.com/docs/coding-plan/intro).
 
@@ -38,6 +38,8 @@ for await (const chunk of stream) {
 | `minimax-cn-coding-plan/MiniMax-M2.1`           | 205K    |       |           |       |       |       | —          | —           |
 | `minimax-cn-coding-plan/MiniMax-M2.5`           | 205K    |       |           |       |       |       | —          | —           |
 | `minimax-cn-coding-plan/MiniMax-M2.5-highspeed` | 205K    |       |           |       |       |       | —          | —           |
+| `minimax-cn-coding-plan/MiniMax-M2.7`           | 205K    |       |           |       |       |       | —          | —           |
+| `minimax-cn-coding-plan/MiniMax-M2.7-highspeed` | 205K    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration
 
@@ -67,7 +69,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "minimax-cn-coding-plan/MiniMax-M2.5-highspeed"
+      ? "minimax-cn-coding-plan/MiniMax-M2.7-highspeed"
       : "minimax-cn-coding-plan/MiniMax-M2";
   }
 });

package/.docs/models/providers/minimax-cn.md

@@ -1,6 +1,6 @@
 # ![MiniMax (minimaxi.com) logo](https://models.dev/logos/minimax-cn.svg)MiniMax (minimaxi.com)
 
-Access 4 MiniMax (minimaxi.com) models through Mastra's model router. Authentication is handled automatically using the `MINIMAX_API_KEY` environment variable.
+Access 6 MiniMax (minimaxi.com) models through Mastra's model router. Authentication is handled automatically using the `MINIMAX_API_KEY` environment variable.
 
 Learn more in the [MiniMax (minimaxi.com) documentation](https://platform.minimaxi.com/docs/guides/quickstart).
 
@@ -38,6 +38,8 @@ for await (const chunk of stream) {
 | `minimax-cn/MiniMax-M2.1`           | 205K    |       |           |       |       |       | $0.30      | $1          |
 | `minimax-cn/MiniMax-M2.5`           | 205K    |       |           |       |       |       | $0.30      | $1          |
 | `minimax-cn/MiniMax-M2.5-highspeed` | 205K    |       |           |       |       |       | $0.60      | $2          |
+| `minimax-cn/MiniMax-M2.7`           | 205K    |       |           |       |       |       | $0.30      | $1          |
+| `minimax-cn/MiniMax-M2.7-highspeed` | 205K    |       |           |       |       |       | $0.60      | $2          |
 
 ## Advanced configuration
 
@@ -67,7 +69,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "minimax-cn/MiniMax-M2.5-highspeed"
+      ? "minimax-cn/MiniMax-M2.7-highspeed"
       : "minimax-cn/MiniMax-M2";
   }
 });

package/.docs/models/providers/minimax-coding-plan.md

@@ -1,6 +1,6 @@
 # ![MiniMax Coding Plan (minimax.io) logo](https://models.dev/logos/minimax-coding-plan.svg)MiniMax Coding Plan (minimax.io)
 
-Access 4 MiniMax Coding Plan (minimax.io) models through Mastra's model router. Authentication is handled automatically using the `MINIMAX_API_KEY` environment variable.
+Access 6 MiniMax Coding Plan (minimax.io) models through Mastra's model router. Authentication is handled automatically using the `MINIMAX_API_KEY` environment variable.
 
 Learn more in the [MiniMax Coding Plan (minimax.io) documentation](https://platform.minimax.io/docs/coding-plan/intro).
 
@@ -38,6 +38,8 @@ for await (const chunk of stream) {
 | `minimax-coding-plan/MiniMax-M2.1`           | 205K    |       |           |       |       |       | —          | —           |
 | `minimax-coding-plan/MiniMax-M2.5`           | 205K    |       |           |       |       |       | —          | —           |
 | `minimax-coding-plan/MiniMax-M2.5-highspeed` | 205K    |       |           |       |       |       | —          | —           |
+| `minimax-coding-plan/MiniMax-M2.7`           | 205K    |       |           |       |       |       | —          | —           |
+| `minimax-coding-plan/MiniMax-M2.7-highspeed` | 205K    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration
 
@@ -67,7 +69,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "minimax-coding-plan/MiniMax-M2.5-highspeed"
+      ? "minimax-coding-plan/MiniMax-M2.7-highspeed"
       : "minimax-coding-plan/MiniMax-M2";
   }
 });

package/.docs/models/providers/minimax.md

@@ -1,6 +1,6 @@
 # ![MiniMax (minimax.io) logo](https://models.dev/logos/minimax.svg)MiniMax (minimax.io)
 
-Access 4 MiniMax (minimax.io) models through Mastra's model router. Authentication is handled automatically using the `MINIMAX_API_KEY` environment variable.
+Access 6 MiniMax (minimax.io) models through Mastra's model router. Authentication is handled automatically using the `MINIMAX_API_KEY` environment variable.
 
 Learn more in the [MiniMax (minimax.io) documentation](https://platform.minimax.io/docs/guides/quickstart).
 
@@ -38,6 +38,8 @@ for await (const chunk of stream) {
 | `minimax/MiniMax-M2.1`           | 205K    |       |           |       |       |       | $0.30      | $1          |
 | `minimax/MiniMax-M2.5`           | 205K    |       |           |       |       |       | $0.30      | $1          |
 | `minimax/MiniMax-M2.5-highspeed` | 205K    |       |           |       |       |       | $0.60      | $2          |
+| `minimax/MiniMax-M2.7`           | 205K    |       |           |       |       |       | $0.30      | $1          |
+| `minimax/MiniMax-M2.7-highspeed` | 205K    |       |           |       |       |       | $0.60      | $2          |
 
 ## Advanced configuration
 
@@ -67,7 +69,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "minimax/MiniMax-M2.5-highspeed"
+      ? "minimax/MiniMax-M2.7-highspeed"
       : "minimax/MiniMax-M2";
   }
 });

package/.docs/models/providers/opencode.md

@@ -1,6 +1,6 @@
 # ![OpenCode Zen logo](https://models.dev/logos/opencode.svg)OpenCode Zen
 
-Access 30 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
+Access 32 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
 
 Learn more in the [OpenCode Zen documentation](https://opencode.ai/docs/zen).
 
@@ -58,6 +58,8 @@ for await (const chunk of stream) {
 | `opencode/gpt-5.3-codex`         | 400K    |       |           |       |       |       | $2         | $14         |
 | `opencode/gpt-5.3-codex-spark`   | 128K    |       |           |       |       |       | $2         | $14         |
 | `opencode/gpt-5.4`               | 1.1M    |       |           |       |       |       | $3         | $15         |
+| `opencode/gpt-5.4-mini`          | 400K    |       |           |       |       |       | $0.75      | $5          |
+| `opencode/gpt-5.4-nano`          | 400K    |       |           |       |       |       | $0.20      | $1          |
 | `opencode/gpt-5.4-pro`           | 1.1M    |       |           |       |       |       | $30        | $180        |
 | `opencode/kimi-k2.5`             | 262K    |       |           |       |       |       | $0.60      | $3          |
 | `opencode/mimo-v2-flash-free`    | 262K    |       |           |       |       |       | —          | —           |

package/.docs/reference/ai-sdk/chat-route.md

@@ -4,6 +4,8 @@ Creates a chat route handler for streaming agent conversations using the AI SDK
 
 Use [`handleChatStream()`](https://mastra.ai/reference/ai-sdk/handle-chat-stream) if you need a framework-agnostic handler.
 
+`chatRoute()` keeps the existing AI SDK v5/default behavior. If your app is typed against AI SDK v6, pass `version: 'v6'`.
+
 > **Disconnect behavior:** `chatRoute()` forwards the incoming request's `AbortSignal` to `agent.stream()`. If the client disconnects, Mastra aborts the in-flight generation.
 >
 > If you want the server to continue generation and persist the final response after disconnect, build a [custom API route](https://mastra.ai/docs/server/custom-api-routes) around `agent.stream()` and call `consumeStream()` on the returned `MastraModelOutput`.
@@ -47,6 +49,8 @@ export const mastra = new Mastra({
 
 ## Parameters
 
+**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass \`'v5'\` for the existing default behavior. Pass \`'v6'\` when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+
 **path** (`string`): The route path (e.g., \`/chat\` or \`/chat/:agentId\`). Include \`:agentId\` for dynamic agent routing. (Default: `'/chat/:agentId'`)
 
 **agent** (`string`): The ID of the agent to use for this chat route. Required if the path doesn't include \`:agentId\`.

package/.docs/reference/ai-sdk/handle-chat-stream.md

@@ -4,6 +4,8 @@ Framework-agnostic handler for streaming agent chat in AI SDK-compatible format.
 
 `handleChatStream()` returns a `ReadableStream` that you can wrap with [`createUIMessageStreamResponse()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/create-ui-message-stream-response).
 
+`handleChatStream()` keeps the existing AI SDK v5/default behavior. If your app is typed against AI SDK v6, pass `version: 'v6'`.
+
 Use [`chatRoute()`](https://mastra.ai/reference/ai-sdk/chat-route) if you want to create a chat route inside a Mastra server.
 
 ## Usage example
@@ -28,6 +30,8 @@ export async function POST(req: Request) {
 
 ## Parameters
 
+**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass \`'v5'\` for the existing default behavior. Pass \`'v6'\` when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+
 **mastra** (`Mastra`): The Mastra instance containing registered agents.
 
 **agentId** (`string`): The ID of the agent to use for chat.

package/.docs/reference/ai-sdk/handle-network-stream.md

@@ -6,6 +6,8 @@ Framework-agnostic handler for streaming network execution in AI SDK-compatible
 
 `handleNetworkStream()` returns a `ReadableStream` that you can wrap with [`createUIMessageStreamResponse()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/create-ui-message-stream-response).
 
+`handleNetworkStream()` keeps the existing AI SDK v5/default behavior. If your app is typed against AI SDK v6, pass `version: 'v6'`.
+
 Use [`networkRoute()`](https://mastra.ai/reference/ai-sdk/network-route) if you want to create a network route inside a Mastra server.
 
 ## Usage example
@@ -30,6 +32,8 @@ export async function POST(req: Request) {
 
 ## Parameters
 
+**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass \`'v5'\` for the existing default behavior. Pass \`'v6'\` when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+
 **mastra** (`Mastra`): The Mastra instance to use for agent lookup and execution.
 
 **agentId** (`string`): The ID of the routing agent to execute as a network.

package/.docs/reference/ai-sdk/handle-workflow-stream.md

@@ -4,6 +4,8 @@ Framework-agnostic handler for streaming workflow execution in AI SDK-compatible
 
 `handleWorkflowStream()` returns a `ReadableStream` that you can wrap with [`createUIMessageStreamResponse()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/create-ui-message-stream-response).
 
+`handleWorkflowStream()` keeps the existing AI SDK v5/default behavior. If your app is typed against AI SDK v6, pass `version: 'v6'`.
+
 Use [`workflowRoute()`](https://mastra.ai/reference/ai-sdk/workflow-route) if you want to create a workflow route inside a Mastra server.
 
 > **Agent streaming in workflows:** When a workflow step pipes an agent's stream to the workflow writer (e.g., `await response.fullStream.pipeTo(writer)`), the agent's text chunks and tool calls are forwarded to the UI stream in real time, even when the agent runs inside workflow steps.
@@ -32,6 +34,8 @@ export async function POST(req: Request) {
 
 ## Parameters
 
+**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass \`'v5'\` for the existing default behavior. Pass \`'v6'\` when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+
 **mastra** (`Mastra`): The Mastra instance containing registered workflows.
 
 **workflowId** (`string`): The ID of the workflow to execute.

package/.docs/reference/ai-sdk/network-route.md

@@ -6,6 +6,8 @@ Creates a network route handler for streaming network execution using the AI SDK
 
 Use [`handleNetworkStream()`](https://mastra.ai/reference/ai-sdk/handle-network-stream) if you need a framework-agnostic handler.
 
+`networkRoute()` keeps the existing AI SDK v5/default behavior. If your app is typed against AI SDK v6, pass `version: 'v6'`.
+
 ## Usage example
 
 This example shows how to set up a network route at the `/network` endpoint that uses an agent with the ID `weatherAgent`.
@@ -45,6 +47,8 @@ export const mastra = new Mastra({
 
 ## Parameters
 
+**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass \`'v5'\` for the existing default behavior. Pass \`'v6'\` when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+
 **path** (`string`): The route path (e.g., \`/network\` or \`/network/:agentId\`). Include \`:agentId\` for dynamic agent routing. (Default: `'/network/:agentId'`)
 
 **agent** (`string`): The ID of the routing agent to use for this network route. Required if the path doesn't include \`:agentId\`.

package/.docs/reference/ai-sdk/to-ai-sdk-stream.md

@@ -4,6 +4,8 @@ Converts Mastra streams (agent, network, or workflow) to AI SDK-compatible strea
 
 This is useful when building custom streaming endpoints outside Mastra's provided route helpers such as [`chatRoute()`](https://mastra.ai/reference/ai-sdk/chat-route) or [`workflowRoute()`](https://mastra.ai/reference/ai-sdk/workflow-route).
 
+`toAISdkStream()` keeps the existing AI SDK v5/default behavior. If your app is typed against AI SDK v6, pass `version: 'v6'` in the options object.
+
 ## Usage example
 
 Next.js App Router example:
@@ -45,6 +47,8 @@ The first parameter is the Mastra stream to convert. It can be one of:
 
 The second parameter is an options object:
 
+**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass \`'v5'\` for the existing default behavior. Pass \`'v6'\` when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+
 **from** (`'agent' | 'network' | 'workflow'`): The type of Mastra stream being converted. (Default: `'agent'`)
 
 **lastMessageId** (`string`): (Agent only) The ID of the last message in the conversation.
@@ -152,6 +156,36 @@ export async function POST(req: Request) {
 }
 ```
 
+### Converting an agent stream for AI SDK v6
+
+```typescript
+import { mastra } from '../../mastra'
+import { createUIMessageStream, createUIMessageStreamResponse } from 'ai'
+import { toAISdkStream } from '@mastra/ai-sdk'
+
+export async function POST(req: Request) {
+  const { messages } = await req.json()
+  const myAgent = mastra.getAgent('weatherAgent')
+  const stream = await myAgent.stream(messages)
+
+  const uiMessageStream = createUIMessageStream({
+    originalMessages: messages,
+    execute: async ({ writer }) => {
+      for await (const part of toAISdkStream(stream, {
+        from: 'agent',
+        version: 'v6',
+      })) {
+        await writer.write(part)
+      }
+    },
+  })
+
+  return createUIMessageStreamResponse({
+    stream: uiMessageStream,
+  })
+}
+```
+
 ### Using `messageMetadata`
 
 ```typescript

package/.docs/reference/ai-sdk/workflow-route.md

@@ -4,6 +4,8 @@ Creates a workflow route handler for streaming workflow execution using the AI S
 
 Use [`handleWorkflowStream()`](https://mastra.ai/reference/ai-sdk/handle-workflow-stream) if you need a framework-agnostic handler.
 
+`workflowRoute()` keeps the existing AI SDK v5/default behavior. If your app is typed against AI SDK v6, pass `version: 'v6'`.
+
 > **Agent streaming in workflows:** When a workflow step pipes an agent's stream to the workflow writer (e.g., `await response.fullStream.pipeTo(writer)`), the agent's text chunks and tool calls are forwarded to the UI stream in real time, even when the agent runs inside workflow steps.
 >
 > See [Workflow Streaming](https://mastra.ai/docs/streaming/workflow-streaming) for more details.
@@ -47,6 +49,8 @@ export const mastra = new Mastra({
 
 ## Parameters
 
+**version** (`'v5' | 'v6'`): Selects the AI SDK stream contract to emit. Omit it or pass \`'v5'\` for the existing default behavior. Pass \`'v6'\` when your app is typed against AI SDK v6 response helpers. (Default: `'v5'`)
+
 **path** (`string`): The route path (e.g., \`/workflow\` or \`/workflow/:workflowId\`). Include \`:workflowId\` for dynamic workflow routing. (Default: `'/api/workflows/:workflowId/stream'`)
 
 **workflow** (`string`): Fixed workflow ID when not using dynamic routing. (Default: `undefined`)

package/.docs/reference/auth/jwt.md

@@ -23,4 +23,4 @@ export const mastra = new Mastra({
 
 ## Related
 
-[MastraJwtAuth](https://mastra.ai/docs/server/auth/jwt)
+- [JSON Web Token](https://mastra.ai/docs/server/auth/jwt)

package/.docs/reference/server/routes.md

@@ -4,14 +4,34 @@ Server adapters register these routes when you call `server.init()`. All routes
 
 ## Agents
 
-| Method | Path                                         | Description             |
-| ------ | -------------------------------------------- | ----------------------- |
-| `GET`  | `/api/agents`                                | List all agents         |
-| `GET`  | `/api/agents/:agentId`                       | Get agent by ID         |
-| `POST` | `/api/agents/:agentId/generate`              | Generate agent response |
-| `POST` | `/api/agents/:agentId/stream`                | Stream agent response   |
-| `GET`  | `/api/agents/:agentId/tools`                 | List agent tools        |
-| `POST` | `/api/agents/:agentId/tools/:toolId/execute` | Execute agent tool      |
+| Method | Path                                         | Description                                     |
+| ------ | -------------------------------------------- | ----------------------------------------------- |
+| `GET`  | `/api/agents`                                | List all agents                                 |
+| `GET`  | `/api/agents/:agentId`                       | Get agent by ID (supports version query params) |
+| `POST` | `/api/agents/:agentId/generate`              | Generate agent response                         |
+| `POST` | `/api/agents/:agentId/stream`                | Stream agent response                           |
+| `GET`  | `/api/agents/:agentId/tools`                 | List agent tools                                |
+| `POST` | `/api/agents/:agentId/tools/:toolId/execute` | Execute agent tool                              |
+
+### Get agent query parameters
+
+`GET /api/agents/:agentId` accepts optional query parameters to control which stored config version is applied as overrides to code-defined agents:
+
+| Parameter   | Type                     | Default   | Description                                                                                                            |
+| ----------- | ------------------------ | --------- | ---------------------------------------------------------------------------------------------------------------------- |
+| `status`    | `'draft' \| 'published'` | `'draft'` | Which stored version to resolve. `draft` returns the latest version, `published` returns the active published version. |
+| `versionId` | `string`                 | —         | A specific version ID to resolve. Takes precedence over `status`.                                                      |
+
+```bash
+# Get agent with latest draft overrides (default)
+GET /api/agents/my-agent
+
+# Get agent with published overrides
+GET /api/agents/my-agent?status=published
+
+# Get agent with a specific version's overrides
+GET /api/agents/my-agent?versionId=abc123
+```
 
 ### Generate request body
 

package/CHANGELOG.md

@@ -1,5 +1,13 @@
 # @mastra/mcp-docs-server
 
+## 1.1.15-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [[`cb611a1`](https://github.com/mastra-ai/mastra/commit/cb611a1e89a4f4cf74c97b57e0c27bb56f2eceb5), [`62d1d3c`](https://github.com/mastra-ai/mastra/commit/62d1d3cc08fe8182e7080237fd975de862ec8c91), [`56c9ad9`](https://github.com/mastra-ai/mastra/commit/56c9ad9c871d258af9da4d6e50065b01d339bf34), [`0773d08`](https://github.com/mastra-ai/mastra/commit/0773d089859210217702d3175ad4b2f3d63d267e), [`8681ecb`](https://github.com/mastra-ai/mastra/commit/8681ecb86184d5907267000e4576cc442a9a83fc), [`28d0249`](https://github.com/mastra-ai/mastra/commit/28d0249295782277040ad1e0d243e695b7ab1ce4), [`bb0f09d`](https://github.com/mastra-ai/mastra/commit/bb0f09dbac58401b36069f483acf5673202db5b5), [`6a8f1e6`](https://github.com/mastra-ai/mastra/commit/6a8f1e66272d2928351db334da091ee27e304c23), [`5f7e9d0`](https://github.com/mastra-ai/mastra/commit/5f7e9d0db664020e1f3d97d7d18c6b0b9d4843d0)]:
+  - @mastra/core@1.15.0-alpha.0
+  - @mastra/mcp@1.3.1-alpha.0
+
 ## 1.1.14
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.14",
+  "version": "1.1.15-alpha.2",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,8 +29,8 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.3.6",
-    "@mastra/core": "1.14.0",
-    "@mastra/mcp": "^1.3.0"
+    "@mastra/core": "1.15.0-alpha.0",
+    "@mastra/mcp": "^1.3.1-alpha.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -47,8 +47,8 @@
     "typescript": "^5.9.3",
     "vitest": "4.0.18",
     "@internal/lint": "0.0.72",
-    "@mastra/core": "1.14.0",
-    "@internal/types-builder": "0.0.47"
+    "@internal/types-builder": "0.0.47",
+    "@mastra/core": "1.15.0-alpha.0"
   },
   "homepage": "https://mastra.ai",
   "repository": {