@mastra/mcp-docs-server 1.2.24-alpha.9 → 1.2.25-alpha.1

package/.docs/models/providers/requesty.md

@@ -4,7 +4,7 @@
 
 # ![Requesty logo](https://models.dev/logos/requesty.svg)Requesty
 
-Access 152 Requesty models through Mastra's model router. Authentication is handled automatically using the `REQUESTY_API_KEY` environment variable.
+Access 153 Requesty models through Mastra's model router. Authentication is handled automatically using the `REQUESTY_API_KEY` environment variable.
 
 Learn more in the [Requesty documentation](https://requesty.ai/solution/llm-routing/models).
 
@@ -62,9 +62,9 @@ for await (const chunk of stream) {
 | `requesty/claude-sonnet-4@eu`                     | 1.0M    |       |           |       |       |       | $3         | $15         |
 | `requesty/claude-sonnet-5`                        | 1.0M    |       |           |       |       |       | $2         | $10         |
 | `requesty/claude-sonnet-5@eu`                     | 1.0M    |       |           |       |       |       | $2         | $11         |
-| `requesty/deepseek-v4-flash`                      | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
-| `requesty/deepseek-v4-flash-0731`                 | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
-| `requesty/deepseek-v4-flash-0731@eu`              | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
+| `requesty/deepseek-v4-flash`                      | 1.0M    |       |           |       |       |       | $0.28      | $0.56       |
+| `requesty/deepseek-v4-flash-0731`                 | 1.0M    |       |           |       |       |       | $0.28      | $0.56       |
+| `requesty/deepseek-v4-flash-0731@eu`              | 1.0M    |       |           |       |       |       | $0.28      | $0.56       |
 | `requesty/deepseek-v4-pro`                        | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `requesty/deepseek-v4-pro-0813`                   | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `requesty/deepseek-v4-pro-0813@eu`                | 1.0M    |       |           |       |       |       | $2         | $4          |
@@ -97,8 +97,8 @@ for await (const chunk of stream) {
 | `requesty/glm-5.2-fast`                           | 1.0M    |       |           |       |       |       | $2         | $7          |
 | `requesty/glm-5.2@eu`                             | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `requesty/glm-5.3`                                | 1.0M    |       |           |       |       |       | $1         | $4          |
-| `requesty/glm-5.3-flash`                          | 1.0M    |       |           |       |       |       | $0.20      | $0.50       |
-| `requesty/glm-5.3-flash@eu`                       | 1.0M    |       |           |       |       |       | $0.20      | $0.50       |
+| `requesty/glm-5.3-flash`                          | 1.0M    |       |           |       |       |       | $0.20      | $0.60       |
+| `requesty/glm-5.3-flash@eu`                       | 1.0M    |       |           |       |       |       | $0.20      | $0.60       |
 | `requesty/glm-5.3@eu`                             | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `requesty/gpt-4.1-mini@eu`                        | 1.0M    |       |           |       |       |       | $0.44      | $2          |
 | `requesty/gpt-4.1-nano@eu`                        | 1.0M    |       |           |       |       |       | $0.11      | $0.44       |
@@ -123,6 +123,7 @@ for await (const chunk of stream) {
 | `requesty/gpt-5.6-terra`                          | 1.1M    |       |           |       |       |       | $2         | $12         |
 | `requesty/gpt-5.6-terra@eu`                       | 1.1M    |       |           |       |       |       | $2         | $13         |
 | `requesty/gpt-5@eu`                               | 400K    |       |           |       |       |       | $1         | $11         |
+| `requesty/gpt-6-astra`                            | 1.1M    |       |           |       |       |       | $10        | $50         |
 | `requesty/grok-4.2-beta`                          | 2.0M    |       |           |       |       |       | $2         | $6          |
 | `requesty/grok-4.3`                               | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `requesty/grok-4.5`                               | 500K    |       |           |       |       |       | $2         | $6          |
@@ -136,8 +137,8 @@ for await (const chunk of stream) {
 | `requesty/kimi-k2.6@eu`                           | 256K    |       |           |       |       |       | $0.95      | $4          |
 | `requesty/kimi-k2.7-code`                         | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `requesty/kimi-k2.7-code@eu`                      | 262K    |       |           |       |       |       | $1         | $5          |
-| `requesty/kimi-k3`                                | 1.0M    |       |           |       |       |       | $2         | $11         |
-| `requesty/kimi-k3@eu`                             | 1.0M    |       |           |       |       |       | $2         | $11         |
+| `requesty/kimi-k3`                                | 1.0M    |       |           |       |       |       | $3         | $15         |
+| `requesty/kimi-k3@eu`                             | 1.0M    |       |           |       |       |       | $3         | $15         |
 | `requesty/laguna-m.1`                             | 33K     |       |           |       |       |       | —          | —           |
 | `requesty/laguna-xs.2`                            | 33K     |       |           |       |       |       | —          | —           |
 | `requesty/leanstral-1-5`                          | 262K    |       |           |       |       |       | —          | —           |

package/.docs/models/providers/sensenova.md

@@ -4,7 +4,7 @@
 
 # ![SenseNova (China) logo](https://models.dev/logos/sensenova.svg)SenseNova (China)
 
-Access 3 SenseNova (China) models through Mastra's model router. Authentication is handled automatically using the `SENSENOVA_API_KEY` environment variable.
+Access 5 SenseNova (China) models through Mastra's model router. Authentication is handled automatically using the `SENSENOVA_API_KEY` environment variable.
 
 Learn more in the [SenseNova (China) documentation](https://platform.sensenova.cn/docs).
 
@@ -39,7 +39,9 @@ for await (const chunk of stream) {
 | Model                                | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | ------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `sensenova/deepseek-v4-flash`        | 1.0M    |       |           |       |       |       | —          | —           |
+| `sensenova/deepseek-v4-pro`          | 1.0M    |       |           |       |       |       | —          | —           |
 | `sensenova/glm-5.2`                  | 1.0M    |       |           |       |       |       | —          | —           |
+| `sensenova/kimi-k3`                  | 1.0M    |       |           |       |       |       | —          | —           |
 | `sensenova/sensenova-6.8-flash-lite` | 262K    |       |           |       |       |       | —          | —           |
 
 Model availability, capabilities, context windows, and pricing are sourced from [models.dev](https://models.dev) and may change.

package/.docs/models/providers/subconscious.md

@@ -75,32 +75,4 @@ const agent = new Agent({
       : "subconscious/subconscious/glm-5.2";
   }
 });
-```
-
-## Direct provider installation
-
-This provider can also be installed directly as a standalone package, which can be used instead of the Mastra model router string. View the [package documentation](https://www.npmjs.com/package/@ai-sdk/anthropic) for more details.
-
-**npm**:
-
-```bash
-npm install @ai-sdk/anthropic
-```
-
-**pnpm**:
-
-```bash
-pnpm add @ai-sdk/anthropic
-```
-
-**Yarn**:
-
-```bash
-yarn add @ai-sdk/anthropic
-```
-
-**Bun**:
-
-```bash
-bun add @ai-sdk/anthropic
 ```

package/.docs/models/providers/thinkingmachines.md

@@ -75,32 +75,4 @@ const agent = new Agent({
       : "thinkingmachines/thinkingmachines/Inkling";
   }
 });
-```
-
-## Direct provider installation
-
-This provider can also be installed directly as a standalone package, which can be used instead of the Mastra model router string. View the [package documentation](https://www.npmjs.com/package/@ai-sdk/anthropic) for more details.
-
-**npm**:
-
-```bash
-npm install @ai-sdk/anthropic
-```
-
-**pnpm**:
-
-```bash
-pnpm add @ai-sdk/anthropic
-```
-
-**Yarn**:
-
-```bash
-yarn add @ai-sdk/anthropic
-```
-
-**Bun**:
-
-```bash
-bun add @ai-sdk/anthropic
 ```

package/.docs/models/providers/togetherai.md

@@ -96,34 +96,4 @@ const agent = new Agent({
       : "togetherai/LiquidAI/LFM2-24B-A2B";
   }
 });
-```
-
-## Direct provider installation
-
-This provider can also be installed directly as a standalone package, which can be used instead of the Mastra model router string. View the [package documentation](https://www.npmjs.com/package/@ai-sdk/togetherai) for more details.
-
-**npm**:
-
-```bash
-npm install @ai-sdk/togetherai
-```
-
-**pnpm**:
-
-```bash
-pnpm add @ai-sdk/togetherai
-```
-
-**Yarn**:
-
-```bash
-yarn add @ai-sdk/togetherai
-```
-
-**Bun**:
-
-```bash
-bun add @ai-sdk/togetherai
-```
-
-For detailed provider-specific documentation, see the [AI SDK Together AI provider docs](https://ai-sdk.dev/providers/ai-sdk-providers/togetherai).
+```

package/.docs/models/providers/vivgrid.md

@@ -4,7 +4,7 @@
 
 # ![Vivgrid logo](https://models.dev/logos/vivgrid.svg)Vivgrid
 
-Access 22 Vivgrid models through Mastra's model router. Authentication is handled automatically using the `VIVGRID_API_KEY` environment variable.
+Access 27 Vivgrid models through Mastra's model router. Authentication is handled automatically using the `VIVGRID_API_KEY` environment variable.
 
 Learn more in the [Vivgrid documentation](https://docs.vivgrid.com/models).
 
@@ -19,7 +19,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "vivgrid/deepseek-v3.2"
+  model: "vivgrid/claude-fable-5"
 });
 
 // Generate a response
@@ -38,12 +38,16 @@ for await (const chunk of stream) {
 
 | Model                                   | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | --------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `vivgrid/claude-fable-5`                | 1.0M    |       |           |       |       |       | $10        | $50         |
+| `vivgrid/claude-fable-5-1`              | 1.0M    |       |           |       |       |       | $10        | $50         |
 | `vivgrid/deepseek-v3.2`                 | 128K    |       |           |       |       |       | $0.28      | $0.42       |
 | `vivgrid/deepseek-v4-flash`             | 1.0M    |       |           |       |       |       | $0.15      | $0.30       |
 | `vivgrid/deepseek-v4-pro`               | 1.0M    |       |           |       |       |       | $0.43      | $0.87       |
+| `vivgrid/deepseek-v4-pro-0813`          | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `vivgrid/gemini-3.1-flash-lite-preview` | 1.0M    |       |           |       |       |       | $0.25      | $2          |
 | `vivgrid/gemini-3.1-pro-preview`        | 1.0M    |       |           |       |       |       | $2         | $12         |
 | `vivgrid/gemini-3.7-flash`              | 1.0M    |       |           |       |       |       | $0.75      | $4          |
+| `vivgrid/gemini-3.8-flash`              | 1.0M    |       |           |       |       |       | $0.75      | $4          |
 | `vivgrid/glm-5.2`                       | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `vivgrid/glm-5.3`                       | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `vivgrid/glm-5.3-flash`                 | 1.0M    |       |           |       |       |       | $0.15      | $0.50       |
@@ -59,6 +63,7 @@ for await (const chunk of stream) {
 | `vivgrid/gpt-5.6-luna`                  | 1.1M    |       |           |       |       |       | $1         | $6          |
 | `vivgrid/gpt-5.6-sol`                   | 1.1M    |       |           |       |       |       | $5         | $30         |
 | `vivgrid/gpt-5.6-terra`                 | 1.1M    |       |           |       |       |       | $3         | $15         |
+| `vivgrid/gpt-6-astra`                   | 1.1M    |       |           |       |       |       | $10        | $50         |
 | `vivgrid/kimi-k3`                       | 1.0M    |       |           |       |       |       | $3         | $15         |
 
 Model availability, capabilities, context windows, and pricing are sourced from [models.dev](https://models.dev) and may change.
@@ -73,7 +78,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://api.vivgrid.com/v1",
-    id: "vivgrid/deepseek-v3.2",
+    id: "vivgrid/claude-fable-5",
     apiKey: process.env.VIVGRID_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -92,35 +97,7 @@ const agent = new Agent({
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
       ? "vivgrid/kimi-k3"
-      : "vivgrid/deepseek-v3.2";
+      : "vivgrid/claude-fable-5";
   }
 });
-```
-
-## Direct provider installation
-
-This provider can also be installed directly as a standalone package, which can be used instead of the Mastra model router string. View the [package documentation](https://www.npmjs.com/package/@ai-sdk/openai) for more details.
-
-**npm**:
-
-```bash
-npm install @ai-sdk/openai
-```
-
-**pnpm**:
-
-```bash
-pnpm add @ai-sdk/openai
-```
-
-**Yarn**:
-
-```bash
-yarn add @ai-sdk/openai
-```
-
-**Bun**:
-
-```bash
-bun add @ai-sdk/openai
 ```

package/.docs/models/providers/xai.md

@@ -108,34 +108,4 @@ const response = await agent.generate("Hello!", {
 
 **parallel\_function\_calling** (`boolean | undefined`)
 
-**searchParameters** (`{ mode: "off" | "auto" | "on"; returnCitations?: boolean | undefined; fromDate?: string | undefined; toDate?: string | undefined; maxSearchResults?: number | undefined; sources?: ({ ...; } | ... 2 more ... | { ...; })[] | undefined; } | undefined`)
-
-## Direct provider installation
-
-This provider can also be installed directly as a standalone package, which can be used instead of the Mastra model router string. View the [package documentation](https://www.npmjs.com/package/@ai-sdk/xai) for more details.
-
-**npm**:
-
-```bash
-npm install @ai-sdk/xai
-```
-
-**pnpm**:
-
-```bash
-pnpm add @ai-sdk/xai
-```
-
-**Yarn**:
-
-```bash
-yarn add @ai-sdk/xai
-```
-
-**Bun**:
-
-```bash
-bun add @ai-sdk/xai
-```
-
-For detailed provider-specific documentation, see the [AI SDK xAI provider docs](https://ai-sdk.dev/providers/ai-sdk-providers/xai).
+**searchParameters** (`{ mode: "off" | "auto" | "on"; returnCitations?: boolean | undefined; fromDate?: string | undefined; toDate?: string | undefined; maxSearchResults?: number | undefined; sources?: ({ ...; } | ... 2 more ... | { ...; })[] | undefined; } | undefined`)

package/.docs/reference/agent-controller/session.md

@@ -105,6 +105,8 @@ await session.sendMessage({
 })
 ```
 
+When `requestContext` carries `MASTRA_MESSAGE_AUTHOR_KEY`, the stored message names that sender under `content.providerMetadata.mastra.author`. See [Reserved keys](https://mastra.ai/docs/server/request-context).
+
 #### `steer({ content, requestContext? })`
 
 Queue steering content into an active run.

package/.docs/reference/agents/durable-agent.md

@@ -43,7 +43,7 @@ cleanup()
 
 ### Using the `durable` config flag
 
-Set `durable: true` on `AgentConfig` and the agent is automatically wrapped with `createDurableAgent` when it's attached to a `Mastra` instance. Use an object to forward advanced options such as `cache`, `pubsub`, `maxSteps`, or `cleanupTimeoutMs`.
+Set `durable: true` on `AgentConfig` and the agent is automatically wrapped with `createDurableAgent` when it's attached to a `Mastra` instance. Use an object to forward advanced options such as `cache`, `pubsub`, `maxSteps`, `cleanupTimeoutMs`, or `shouldCache`.
 
 ```typescript
 import { Mastra } from '@mastra/core'
@@ -90,6 +90,8 @@ Returns: `DurableAgent`
 
 **maxSteps** (`number`): Maximum number of steps for the agentic loop.
 
+**shouldCache** (`(topic: string) => boolean`): Per-topic opt-out of the replay cache. Return false to publish a topic straight to the underlying PubSub without recording it; subscribers of that topic receive live events only and cannot resume from an offset. Useful for trading replay for minimum publish latency on hot topics when the cache is remote (for example, cross-region Redis). Run-local topics are always excluded, regardless of this option.
+
 ## `createEventedAgent(options)`
 
 Wraps an `Agent` with fire-and-forget durable execution on the built-in workflow engine. Like `createDurableAgent`, it returns a result you stream from, but the underlying workflow runs non-blocking (via `startAsync`) instead of running to completion before the stream is wired up. Use it when you want the run to progress independently of the caller. It doesn't accept `id` or `name` overrides.
@@ -112,6 +114,8 @@ Returns: `EventedAgent` (a subclass of `DurableAgent`)
 
 **maxSteps** (`number`): Maximum number of steps for the agentic loop.
 
+**shouldCache** (`(topic: string) => boolean`): Per-topic opt-out of the replay cache. Return false to publish a topic straight to the underlying PubSub without recording it; subscribers of that topic receive live events only and cannot resume from an offset. Useful for trading replay for minimum publish latency on hot topics when the cache is remote (for example, cross-region Redis). Run-local topics are always excluded, regardless of this option.
+
 ## Constructor parameters
 
 The `DurableAgent` class accepts the same options as `createDurableAgent`, plus `cleanupTimeoutMs`. Prefer the factory unless you need to subclass.
@@ -128,6 +132,8 @@ The `DurableAgent` class accepts the same options as `createDurableAgent`, plus
 
 **maxSteps** (`number`): Maximum number of steps for the agentic loop.
 
+**shouldCache** (`(topic: string) => boolean`): Per-topic opt-out of the replay cache. Return false to publish a topic straight to the underlying PubSub without recording it; subscribers of that topic receive live events only and cannot resume from an offset. Useful for trading replay for minimum publish latency on hot topics when the cache is remote (for example, cross-region Redis). Run-local topics are always excluded, regardless of this option.
+
 **cleanupTimeoutMs** (`number`): Grace period in milliseconds before registry entries are cleaned up automatically after a stream finishes or errors. Set to 0 to disable auto-cleanup and require a manual cleanup() call. Auto-cleanup does not fire on suspended events. (Default: `30000`)
 
 ## Methods

package/.docs/reference/agents/generate.md

@@ -166,7 +166,7 @@ const result = await agent.generate('message for agent')
 
 **options.modelSettings.frequencyPenalty** (`number`): Penalty for token frequency (-2 to 2). Reduces repetition of frequent tokens.
 
-**options.modelSettings.timeout** (`object`): Time-based execution budget for the run. Accepts totalMs, the maximum duration of the entire agent run across every loop iteration, tool call and retry, and stepMs, the maximum duration of a single model call including the time spent consuming its stream. Exceeding either budget fails with a MastraTimeoutError. A totalMs timeout ends the run and does not try fallback models, because it is a hard deadline for the whole run. A stepMs timeout is not retried against the same model but does advance to the next entry in models when fallback models are configured.
+**options.modelSettings.timeout** (`object`): Time-based execution budget for the run. Accepts totalMs, the maximum duration of the entire agent run across every loop iteration, tool call and retry, and stepMs, the maximum duration of a single model call including the time spent consuming its stream. Exceeding either budget fails with a MastraTimeoutError. A totalMs timeout ends the run and does not try fallback models, because it is a hard deadline for the whole run. A stepMs timeout is not retried against the same model but does advance to the next entry in models when fallback models are configured. Also accepts firstChunkMs, which only applies to streaming calls and is the maximum time the model may take to emit its first content-bearing chunk (text, reasoning, tool call, file or source; stream-start and metadata chunks do not count). A firstChunkMs timeout fails with timeoutType: 'firstChunk', behaves like stepMs for fallback, and is reset for each provider retry attempt. Nested timeout keys are merged across call-time and per-model settings.
 
 **options.modelSettings.stopSequences** (`string[]`): Stop sequences. If set, the model will stop generating text when one of the stop sequences is generated.
 

package/.docs/reference/agents/network.md

@@ -102,7 +102,7 @@ await agent.network(`
 
 **options.modelSettings.frequencyPenalty** (`number`): Penalty for token frequency (-2 to 2). Reduces repetition of frequent tokens.
 
-**options.modelSettings.timeout** (`object`): Time-based execution budget for the run. Accepts totalMs, the maximum duration of the entire agent run across every loop iteration, tool call and retry, and stepMs, the maximum duration of a single model call including the time spent consuming its stream. Exceeding either budget fails with a MastraTimeoutError. A totalMs timeout ends the run and does not try fallback models, because it is a hard deadline for the whole run. A stepMs timeout is not retried against the same model but does advance to the next entry in models when fallback models are configured.
+**options.modelSettings.timeout** (`object`): Time-based execution budget for the run. Accepts totalMs, the maximum duration of the entire agent run across every loop iteration, tool call and retry, and stepMs, the maximum duration of a single model call including the time spent consuming its stream. Exceeding either budget fails with a MastraTimeoutError. A totalMs timeout ends the run and does not try fallback models, because it is a hard deadline for the whole run. A stepMs timeout is not retried against the same model but does advance to the next entry in models when fallback models are configured. Also accepts firstChunkMs, which only applies to streaming calls and is the maximum time the model may take to emit its first content-bearing chunk (text, reasoning, tool call, file or source; stream-start and metadata chunks do not count). A firstChunkMs timeout fails with timeoutType: 'firstChunk', behaves like stepMs for fallback, and is reset for each provider retry attempt. Nested timeout keys are merged across call-time and per-model settings.
 
 **options.modelSettings.stopSequences** (`string[]`): Stop sequences. If set, the model will stop generating text when one of the stop sequences is generated.
 

package/.docs/reference/build-with-ai.md

@@ -87,9 +87,9 @@ Install by selecting the button below:
 
 [![Install MCP Server](https://cursor.com/deeplink/mcp-install-light.svg)](cursor://anysphere.cursor-deeplink/mcp/install?name=mastra\&config=eyJjb21tYW5kIjoibnB4IC15IEBtYXN0cmEvbWNwLWRvY3Mtc2VydmVyIn0%3D)
 
-If you followed the automatic installation, you'll see a popup when you open cursor in the bottom left corner to prompt you to enable the Mastra Docs MCP Server.
+After installation, open **Customize** > **MCPs** in Cursor and enable the **mastra** server.
 
-![Popup inside Cursor showing: \"New MCP server detected: mastra\". The user can \"Skip\" or \"Enable\" it as an action.](/assets/images/enable-mastra-docs-cursor-cd5872abdc36c0e10951a59a47f25e12.png)
+Cursor may also show a **New MCP server detected: mastra** popup. Select **Enable** as a shortcut, or select **Skip** and enable it later from **Customize** > **MCPs**.
 
 [More info on using MCP servers with Cursor](https://cursor.com/de/docs/context/mcp)
 
@@ -100,14 +100,10 @@ Google Antigravity is an agent-first development platform that supports MCP serv
 1. Open your Antigravity MCP configuration file:
 
    - Click on **Agent session** and select the **“…” dropdown** at the top of the editor’s side panel, then select **MCP Servers** to access the **MCP Store**.
-   - You can access it through the MCP Store interface in Antigravity
-
-   ![The Antigravity MCP store. At the top is a search bar and below a list of available MCP servers. On the very top right is a dropdown menu.](/assets/images/antigravity_mcp_server-689ea495d9c7139cc431f1f1b9827f9b.png)
+   - You can access it through the MCP Store interface in Antigravity.
 
 2. To add a custom MCP server, select **Manage MCP Servers** at the top of the MCP Store and select **View raw config** in the main tab.
 
-   ![The Antigravity MCP store showing the Manage MCP Servers option and the View raw config button.](/assets/images/antigravity_managed_mcp-b661e8c04b3219000f8d842e5eb26a1a.png)
-
 3. Add the Mastra MCP server configuration:
 
    ```json
@@ -123,8 +119,6 @@ Google Antigravity is an agent-first development platform that supports MCP serv
 
 4. Save the configuration and restart Antigravity
 
-   ![The UI shows that the MCP server is enabled. You can also toggle individual tools.](/assets/images/antigravity_final_interface_mcp-7fa132dbe76cdee9f61136a26d6e6615.png)
-
 Once configured, the Mastra MCP server exposes the following to Antigravity agents:
 
 - Indexed documentation and API schemas for Mastra, enabling programmatic retrieval of relevant context during code generation
@@ -154,23 +148,13 @@ The MCP server will appear in Antigravity's MCP Store, where you can manage its
    }
    ```
 
-Once you installed the MCP server, you can use it like so:
-
-1. Open VSCode settings.
-
-2. Navigate to MCP settings.
-
-3. Click "enable" on the Chat > MCP option.
-
-   ![Entry in VSCode\'s settings page. The option is called \"Chat \> MCP: Enabled (Preview)\". The description says: \"Enables integration with Model Context Protocol servers to provide additional tools and functionality.\"](/assets/images/vscode-mcp-setting-8d1eb4f3df1e33606503f8c5e937e9e3.png)
-
-MCP only works in Agent mode in VSCode. Once you are in agent mode, open the `mcp.json` file and select the "start" button. Note that the "start" button will only appear if the `.vscode` folder containing `mcp.json` is in your workspace root, or the highest level of the in-editor file explorer.
-
-![A screenshot of the mcp.json file showing the start button in the editor](/assets/images/vscode-start-mcp-26480d86080c4907cb497a325de106a4.png)
+After saving the configuration, enable the server:
 
-After starting the MCP server, select the tools button in the Copilot pane to see available tools.
+1. Open the Command Palette.
+2. Run **MCP: List Servers**.
+3. Select **mastra**, then select **Enable**.
 
-![Tools page of VSCode to see available tools](/assets/images/vscode-mcp-running-d92d6ed234d1148093dc804b0ead3515.png)
+MCP tools are available in Agent mode in Visual Studio Code. Select the tools button in the Copilot pane to see the available tools.
 
 [More info on using MCP servers with Visual Studio Code](https://code.visualstudio.com/docs/copilot/customization/mcp-servers)
 

package/.docs/reference/cli/mastra.md

@@ -1121,6 +1121,36 @@ mastra api --url https://observability.eu.mastra.ai trace list
 
 Use `--url` and `--header` when you need to override another target or its credentials.
 
+### Factory commands
+
+Use `mastra api factory` to manage Factory projects, work items, decisions, attention items, queue health, and supervisor sessions. These commands use the same JSON input, output, authentication, headers, timeout, and target resolution as other `mastra api` commands.
+
+List the Factory projects available to the current organization:
+
+```bash
+mastra api factory project list
+```
+
+Inspect the generated request schema before sending a governed work-item transition:
+
+```bash
+mastra api factory work-item transition --schema
+```
+
+Move a work item using its current revision:
+
+```bash
+mastra api factory work-item transition <project-id> <work-item-id> '{"board":"work","stage":"planning","requestId":"00000000-0000-4000-8000-000000000000","cause":"manual","expectedRevision":1}'
+```
+
+After you deploy the project with `mastra deploy`, the resulting non-secret `.mastra-project.json` lets the CLI find the hosted Factory instance, apply your Mastra CLI credentials, and select the deployed project's organization automatically. For an explicit hosted Factory `--url`, the CLI uses `MASTRA_ORG_ID` when set, then the organization selected by `mastra auth orgs switch`. An explicit `X-Mastra-Organization-Id` header takes precedence over both. Before deployment, or to target a specific local, remote, or self-hosted Factory server, pass `--url` instead:
+
+```bash
+mastra api --url http://localhost:4111 factory project list
+```
+
+Factory endpoints use their root-level `/web/factory/...` paths. `--server-api-prefix` still controls local target probing, but it isn't prepended to Factory requests.
+
 ### Flags
 
 #### `--url <url>`

package/.docs/reference/client-js/datasets.md

@@ -4,7 +4,7 @@
 
 # Datasets API
 
-The Datasets API exposes Mastra's dataset and experiment routes from `MastraClient`. This page covers the caller-driven experiment methods, which let an orchestrator you own (for example a Temporal workflow) drive the experiment loop while Mastra acts as the system of record. Create the experiment, then either have Mastra execute each item server-side with `runExperimentItem` or ingest results you computed yourself with `submitExperimentResult`, and call finalize when the run is done.
+The Datasets API exposes Mastra's dataset and experiment routes from `MastraClient`. It includes caller-driven experiment methods and experiment deletion methods. The caller-driven methods let an orchestrator you own (for example a Temporal workflow) drive the experiment loop while Mastra acts as the system of record. Create the experiment, then either have Mastra execute each item server-side with `runExperimentItem` or ingest results you computed yourself with `submitExperimentResult`, and call finalize when the run is done.
 
 Item runs, result submission, and finalization are safe to retry. Creation is safe to retry only when the request includes a caller-supplied `id`; without one, each retry creates a new experiment.
 
@@ -138,6 +138,61 @@ Marks a caller-driven experiment completed. The server computes per-item counts
 
 Returns `Promise<DatasetExperiment>`, the updated experiment record.
 
+## deleteDatasetExperiment()
+
+Deletes an experiment through its dataset. The server deletes the experiment's result records and attempts to delete its observability traces, including their spans and trace-linked signals, but unsupported storage leaves the traces in place and causes the server to log a warning. If trace cleanup fails after an earlier batch succeeds, the promise rejects and preserves the experiment and result records even though some traces may already have been removed.
+
+```typescript
+await client.deleteDatasetExperiment('dataset-id', 'experiment-id', {
+  organizationId: 'organization-id',
+  projectId: 'project-id',
+})
+```
+
+**datasetId** (`string`): ID of the dataset that owns the experiment.
+
+**experimentId** (`string`): ID of the experiment to delete.
+
+**tenancy.organizationId** (`string`): Organization ID used to scope the dataset lookup.
+
+**tenancy.projectId** (`string`): Project ID used to scope the dataset lookup.
+
+Returns `Promise<{ success: boolean }>`. A missing experiment, an experiment associated with another dataset, or a dataset outside the supplied tenancy returns a `404` response.
+
+## deleteExperiment()
+
+Deletes an experiment by ID without requiring a dataset reference. Use this method for experiments orphaned by dataset deletion. The server deletes the experiment's result records and attempts to delete its observability traces, but unsupported storage leaves the traces in place and causes the server to log a warning. If trace cleanup fails after an earlier batch succeeds, the promise rejects and preserves the experiment and result records even though some traces may already have been removed.
+
+```typescript
+await client.deleteExperiment('experiment-id', {
+  organizationId: 'organization-id',
+  projectId: 'project-id',
+})
+```
+
+**experimentId** (`string`): ID of the experiment to delete.
+
+**options.organizationId** (`string`): Organization ID used to scope the deletion.
+
+**options.projectId** (`string`): Project ID used to scope the deletion.
+
+Returns `Promise<{ success: boolean }>`. An unscoped request returns a `404` response when the experiment doesn't exist. A tenancy-scoped request that doesn't match the experiment returns success without deleting it.
+
+## purgeDatasetItem()
+
+Scrubs an item's content from existing dataset history and linked experiment results, including result tags and comments, while preserving version history, experiment counters, and review status. Later result submissions for the item are stored with redacted content, and later dataset item updates are rejected.
+
+```typescript
+await client.purgeDatasetItem('dataset-id', 'item-id', {
+  organizationId: 'organization-id',
+  projectId: 'project-id',
+})
+```
+
+The optional third argument scopes the purge to a tenant organization and project. The server returns `404` when the dataset doesn't belong to that scope.
+
+Returns `Promise<{ success: boolean }>`. The operation is idempotent and can't be undone. Don't run it concurrently with dataset item updates or deletions because a write that started before purge can commit a stale revision afterward. MongoDB storage requires a replica set or sharded deployment with transaction support. See [`dataset.purgeItem()`](https://mastra.ai/reference/datasets/purgeItem) for the complete purge behavior.
+
 ## Related
 
 - [Running experiments](https://mastra.ai/docs/evals/experiments)

package/.docs/reference/coding-agent/build-base-prompt.md

@@ -6,7 +6,7 @@
 
 `buildBasePrompt()` builds the shared base system prompt for a coding agent: the behavioral instructions that make the agent a good coding assistant. It takes a `PromptContext` describing the current environment (project, platform, git branch, mode, model) and returns the prompt as a string.
 
-Product-specific strings are parameterized through `productName`, `coAuthorName`, and `coAuthorEmail`, so you can rebrand the prompt and commit trailer without forking it. They default to `"Mastra Code"` / `"noreply@mastra.ai"`, so existing callers keep identical output.
+Product-specific strings are parameterized through `productName`, `coAuthorName`, and `coAuthorEmail`, so you can rebrand the prompt and commit trailer without forking it. The co-author defaults to `"mastra-platform[bot]"` and `"284800079+mastra-platform[bot]@users.noreply.github.com"`.
 
 Use this with [`createCodingAgent()`](https://mastra.ai/reference/coding-agent/create-coding-agent) when you build runtime-defined instructions for the agent.
 
@@ -58,7 +58,7 @@ const prompt = buildBasePrompt({
 
 **mode** (`string`): Active agent mode (for example, "build" or "plan").
 
-**modelId** (`string`): Identifier of the active model, included in the commit Co-Authored-By line when provided.
+**modelId** (`string`): Identifier of the active model.
 
 **activePlan** (`{ title: string; plan: string; approvedAt: string } | null`): The currently approved plan, if any.
 
@@ -66,9 +66,9 @@ const prompt = buildBasePrompt({
 
 **productName** (`string`): Display name used in the prompt header. (Default: `Mastra Code`)
 
-**coAuthorName** (`string`): Name used in the commit Co-Authored-By line. (Default: `Mastra Code`)
+**coAuthorName** (`string`): Name used in the commit Co-Authored-By line. (Default: `mastra-platform[bot]`)
 
-**coAuthorEmail** (`string`): Email used in the commit Co-Authored-By line. (Default: `noreply@mastra.ai`)
+**coAuthorEmail** (`string`): Email used in the commit Co-Authored-By line. (Default: `284800079+mastra-platform[bot]@users.noreply.github.com`)
 
 ## Returns
 

package/.docs/reference/datasets/dataset.md

@@ -78,5 +78,6 @@ For the full dataset record (name, description, schemas, version, timestamps), c
 
 - [DatasetsManager class](https://mastra.ai/reference/datasets/datasets-manager)
 - [dataset.startExperiment()](https://mastra.ai/reference/datasets/startExperiment)
+- [dataset.deleteExperiment()](https://mastra.ai/reference/datasets/deleteExperiment)
 - [dataset.addItems()](https://mastra.ai/reference/datasets/addItems)
 - [dataset.listVersions()](https://mastra.ai/reference/datasets/listVersions)

package/.docs/reference/datasets/datasets-manager.md

@@ -59,6 +59,20 @@ console.log(`Dataset: ${experiment.datasetId}`)
 console.log(`Status: ${experiment.status}`)
 ```
 
+### Delete experiment
+
+Deletes an experiment directly by ID, including experiments orphaned by dataset deletion. The experiment's results are deleted, and Mastra also attempts to delete its observability traces. Unsupported observability storage leaves the traces in place and logs a warning.
+
+```typescript
+await mastra.datasets.deleteExperiment({
+  experimentId: 'experiment-id',
+  organizationId: 'organization-id',
+  projectId: 'project-id',
+})
+```
+
+See [`DatasetsManager.deleteExperiment()`](https://mastra.ai/reference/datasets/deleteExperiment) for tenancy behavior and trace cascade details.
+
 ### Compare experiments
 
 ```typescript