@mastra/mcp-docs-server 1.2.17-alpha.13 → 1.2.17-alpha.14

package/.docs/models/providers/jalapeno.md

@@ -0,0 +1,89 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![Jalapeno Cloud logo](https://models.dev/logos/jalapeno.svg)Jalapeno Cloud
+
+Access 17 Jalapeno Cloud models through Mastra's model router. Authentication is handled automatically using the `JALAPENO_API_KEY` environment variable.
+
+Learn more in the [Jalapeno Cloud documentation](https://www.jalapeno-cloud.ai/docs/).
+
+```bash
+JALAPENO_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "jalapeno/DeepSeek-V4-Flash"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Note:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Jalapeno Cloud documentation](https://www.jalapeno-cloud.ai/docs/) for details.
+
+## Models
+
+| Model                                  | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| -------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `jalapeno/DeepSeek-V4-Flash`           | 1.0M    |       |           |       |       |       | $0.14      | $0.28       |
+| `jalapeno/DeepSeek-V4-Pro`             | 1.0M    |       |           |       |       |       | $2         | $3          |
+| `jalapeno/GLM-5.1`                     | 203K    |       |           |       |       |       | $1         | $4          |
+| `jalapeno/GLM-5.2`                     | 1.0M    |       |           |       |       |       | $1         | $4          |
+| `jalapeno/Hy3`                         | 203K    |       |           |       |       |       | $0.14      | $0.58       |
+| `jalapeno/Kimi-K2.5`                   | 262K    |       |           |       |       |       | $0.60      | $3          |
+| `jalapeno/Kimi-K2.7-Code`              | 271K    |       |           |       |       |       | $0.95      | $4          |
+| `jalapeno/Kimi-K3`                     | 1.0M    |       |           |       |       |       | $3         | $15         |
+| `jalapeno/MiniMax-M3`                  | 524K    |       |           |       |       |       | $0.30      | $1          |
+| `jalapeno/Qwen3-Next-80B-A3B-Instruct` | 129K    |       |           |       |       |       | $0.15      | $2          |
+| `jalapeno/Qwen3-Next-80B-A3B-Thinking` | 131K    |       |           |       |       |       | $0.15      | $2          |
+| `jalapeno/Qwen3-VL-235B-A22B-Instruct` | 129K    |       |           |       |       |       | $0.30      | $2          |
+| `jalapeno/Qwen3-VL-235B-A22B-Thinking` | 131K    |       |           |       |       |       | $0.98      | $4          |
+| `jalapeno/Qwen3.5-122B-A10B`           | 262K    |       |           |       |       |       | $0.40      | $3          |
+| `jalapeno/Qwen3.5-27B`                 | 262K    |       |           |       |       |       | $0.30      | $2          |
+| `jalapeno/Qwen3.5-35B-A3B`             | 262K    |       |           |       |       |       | $0.25      | $2          |
+| `jalapeno/Qwen3.5-397B-A17B`           | 262K    |       |           |       |       |       | $0.60      | $4          |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.jalapeno-cloud.ai/v1",
+    id: "jalapeno/DeepSeek-V4-Flash",
+    apiKey: process.env.JALAPENO_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "jalapeno/Qwen3.5-397B-A17B"
+      : "jalapeno/DeepSeek-V4-Flash";
+  }
+});
+```

package/.docs/models/providers/kilo.md

@@ -2,7 +2,7 @@
 
 # ![Kilo Gateway logo](https://models.dev/logos/kilo.svg)Kilo Gateway
 
-Access 359 Kilo Gateway models through Mastra's model router. Authentication is handled automatically using the `KILO_API_KEY` environment variable.
+Access 360 Kilo Gateway models through Mastra's model router. Authentication is handled automatically using the `KILO_API_KEY` environment variable.
 
 Learn more in the [Kilo Gateway documentation](https://kilo.ai).
 
@@ -40,11 +40,11 @@ for await (const chunk of stream) {
 | `kilo/~anthropic/claude-haiku-latest`                           | 200K    |       |           |       |       |       | $1         | $5          |
 | `kilo/~anthropic/claude-opus-latest`                            | 1.0M    |       |           |       |       |       | $5         | $25         |
 | `kilo/~anthropic/claude-sonnet-latest`                          | 1.0M    |       |           |       |       |       | $2         | $10         |
-| `kilo/~deepseek/deepseek-v4-flash-latest`                       | 262K    |       |           |       |       |       | $0.06      | $0.12       |
+| `kilo/~deepseek/deepseek-v4-flash-latest`                       | 262K    |       |           |       |       |       | $0.08      | $0.16       |
 | `kilo/~google/gemini-flash-latest`                              | 1.0M    |       |           |       |       |       | $0.38      | $2          |
 | `kilo/~google/gemini-pro-latest`                                | 1.0M    |       |           |       |       |       | $2         | $12         |
-| `kilo/~moonshotai/kimi-latest`                                  | 1.0M    |       |           |       |       |       | $3         | $14         |
-| `kilo/~openai/gpt-latest`                                       | 1.1M    |       |           |       |       |       | $5         | $30         |
+| `kilo/~moonshotai/kimi-latest`                                  | 975K    |       |           |       |       |       | $3         | $13         |
+| `kilo/~openai/gpt-latest`                                       | 1.1M    |       |           |       |       |       | $3         | $15         |
 | `kilo/~openai/gpt-mini-latest`                                  | 400K    |       |           |       |       |       | $0.75      | $5          |
 | `kilo/~x-ai/grok-latest`                                        | 500K    |       |           |       |       |       | $2         | $6          |
 | `kilo/ai21/jamba-large-1.7`                                     | 256K    |       |           |       |       |       | $2         | $8          |
@@ -332,7 +332,7 @@ for await (const chunk of stream) {
 | `kilo/qwen/qwen3.5-flash-02-23`                                 | 1.0M    |       |           |       |       |       | $0.07      | $0.26       |
 | `kilo/qwen/qwen3.5-plus-02-15`                                  | 1.0M    |       |           |       |       |       | $0.26      | $2          |
 | `kilo/qwen/qwen3.5-plus-20260420`                               | 1.0M    |       |           |       |       |       | $0.30      | $2          |
-| `kilo/qwen/qwen3.6-27b`                                         | 262K    |       |           |       |       |       | $0.45      | $3          |
+| `kilo/qwen/qwen3.6-27b`                                         | 131K    |       |           |       |       |       | $0.45      | $3          |
 | `kilo/qwen/qwen3.6-35b-a3b`                                     | 262K    |       |           |       |       |       | $0.14      | $1          |
 | `kilo/qwen/qwen3.6-flash`                                       | 1.0M    |       |           |       |       |       | $0.19      | $1          |
 | `kilo/qwen/qwen3.6-max-preview`                                 | 262K    |       |           |       |       |       | $1         | $6          |
@@ -362,7 +362,7 @@ for await (const chunk of stream) {
 | `kilo/stepfun/step-3.7-flash`                                   | 256K    |       |           |       |       |       | $0.20      | $1          |
 | `kilo/stepfun/step-3.7-flash:free`                              | 262K    |       |           |       |       |       | —          | —           |
 | `kilo/tencent/hunyuan-a13b-instruct`                            | 131K    |       |           |       |       |       | $0.14      | $0.57       |
-| `kilo/tencent/hy3`                                              | 262K    |       |           |       |       |       | $0.13      | $0.53       |
+| `kilo/tencent/hy3`                                              | 262K    |       |           |       |       |       | $0.14      | $0.58       |
 | `kilo/tencent/hy3-preview`                                      | 262K    |       |           |       |       |       | $0.18      | $0.60       |
 | `kilo/tencent/hy3:free`                                         | 262K    |       |           |       |       |       | —          | —           |
 | `kilo/thedrummer/cydonia-24b-v4.1`                              | 131K    |       |           |       |       |       | $0.30      | $0.50       |
@@ -386,7 +386,7 @@ for await (const chunk of stream) {
 | `kilo/z-ai/glm-4.5`                                             | 131K    |       |           |       |       |       | $0.60      | $2          |
 | `kilo/z-ai/glm-4.5-air`                                         | 131K    |       |           |       |       |       | $0.13      | $0.85       |
 | `kilo/z-ai/glm-4.5v`                                            | 66K     |       |           |       |       |       | $0.60      | $2          |
-| `kilo/z-ai/glm-4.6`                                             | 205K    |       |           |       |       |       | $0.55      | $2          |
+| `kilo/z-ai/glm-4.6`                                             | 203K    |       |           |       |       |       | $0.50      | $2          |
 | `kilo/z-ai/glm-4.6v`                                            | 131K    |       |           |       |       |       | $0.30      | $0.90       |
 | `kilo/z-ai/glm-4.7`                                             | 203K    |       |           |       |       |       | $0.40      | $2          |
 | `kilo/z-ai/glm-4.7-flash`                                       | 203K    |       |           |       |       |       | $0.06      | $0.40       |
@@ -394,6 +394,7 @@ for await (const chunk of stream) {
 | `kilo/z-ai/glm-5-turbo`                                         | 203K    |       |           |       |       |       | $1         | $4          |
 | `kilo/z-ai/glm-5.1`                                             | 200K    |       |           |       |       |       | $1         | $4          |
 | `kilo/z-ai/glm-5.2`                                             | 1.0M    |       |           |       |       |       | $1         | $4          |
+| `kilo/z-ai/glm-5.2:free`                                        | 128K    |       |           |       |       |       | —          | —           |
 | `kilo/z-ai/glm-5v-turbo`                                        | 203K    |       |           |       |       |       | $1         | $4          |
 
 ## Advanced configuration

package/.docs/models/providers/merge-gateway.md

@@ -2,7 +2,7 @@
 
 # ![Merge Gateway logo](https://models.dev/logos/merge-gateway.svg)Merge Gateway
 
-Access 169 Merge Gateway models through Mastra's model router. Authentication is handled automatically using the `MERGE_GATEWAY_API_KEY` environment variable.
+Access 171 Merge Gateway models through Mastra's model router. Authentication is handled automatically using the `MERGE_GATEWAY_API_KEY` environment variable.
 
 Learn more in the [Merge Gateway documentation](https://docs.merge.dev/merge-gateway).
 
@@ -164,6 +164,8 @@ for await (const chunk of stream) {
 | `merge-gateway/qwen/qwen3-max`                                 | 262K    |       |           |       |       |       | $0.36      | $1          |
 | `merge-gateway/qwen/qwen3-next-80b-a3b-instruct`               | 131K    |       |           |       |       |       | $0.14      | $0.57       |
 | `merge-gateway/qwen/qwen3-next-80b-a3b-thinking`               | 131K    |       |           |       |       |       | $0.15      | $1          |
+| `merge-gateway/qwen/qwen3-vl-235b-a22b-instruct`               | 131K    |       |           |       |       |       | $0.29      | $1          |
+| `merge-gateway/qwen/qwen3-vl-235b-a22b-thinking`               | 131K    |       |           |       |       |       | $0.29      | $3          |
 | `merge-gateway/qwen/qwen3-vl-plus`                             | 262K    |       |           |       |       |       | $0.14      | $1          |
 | `merge-gateway/qwen/qwen3.5-122b-a10b`                         | 256K    |       |           |       |       |       | $0.12      | $0.92       |
 | `merge-gateway/qwen/qwen3.5-27b`                               | 256K    |       |           |       |       |       | $0.09      | $0.69       |

package/.docs/models/providers/nano-gpt.md

@@ -2,7 +2,7 @@
 
 # ![NanoGPT logo](https://models.dev/logos/nano-gpt.svg)NanoGPT
 
-Access 601 NanoGPT models through Mastra's model router. Authentication is handled automatically using the `NANO_GPT_API_KEY` environment variable.
+Access 595 NanoGPT models through Mastra's model router. Authentication is handled automatically using the `NANO_GPT_API_KEY` environment variable.
 
 Learn more in the [NanoGPT documentation](https://docs.nano-gpt.com).
 
@@ -165,7 +165,6 @@ for await (const chunk of stream) {
 | `nano-gpt/doubao-1.5-vision-pro-32k`                             | 32K     |       |           |       |       |       | $0.46      | $1          |
 | `nano-gpt/doubao-seed-1-6-250615`                                | 256K    |       |           |       |       |       | $0.20      | $0.51       |
 | `nano-gpt/doubao-seed-1-6-flash-250615`                          | 256K    |       |           |       |       |       | $0.04      | $0.37       |
-| `nano-gpt/doubao-seed-1-8-251215`                                | 128K    |       |           |       |       |       | $0.61      | $6          |
 | `nano-gpt/doubao-seed-2-0-code-preview-260215`                   | 256K    |       |           |       |       |       | $0.78      | $4          |
 | `nano-gpt/doubao-seed-2-0-lite-260215`                           | 256K    |       |           |       |       |       | $0.15      | $0.87       |
 | `nano-gpt/doubao-seed-2-0-mini-260215`                           | 256K    |       |           |       |       |       | $0.05      | $0.48       |
@@ -312,8 +311,6 @@ for await (const chunk of stream) {
 | `nano-gpt/minimax/minimax-m3`                                    | 512K    |       |           |       |       |       | $0.30      | $1          |
 | `nano-gpt/minimax/minimax-m3:thinking`                           | 512K    |       |           |       |       |       | $0.30      | $1          |
 | `nano-gpt/MiniMaxAI/MiniMax-M1-80k`                              | 1.0M    |       |           |       |       |       | $0.61      | $2          |
-| `nano-gpt/mirothinker-1-7-deepresearch`                          | 262K    |       |           |       |       |       | $4         | $25         |
-| `nano-gpt/mirothinker-1-7-deepresearch-mini`                     | 262K    |       |           |       |       |       | $1         | $10         |
 | `nano-gpt/mistral-code-agent-latest`                             | 262K    |       |           |       |       |       | $0.40      | $2          |
 | `nano-gpt/mistral-code-latest`                                   | 256K    |       |           |       |       |       | $0.30      | $0.90       |
 | `nano-gpt/mistral-small-31-24b-instruct`                         | 128K    |       |           |       |       |       | $0.10      | $0.30       |
@@ -492,8 +489,8 @@ for await (const chunk of stream) {
 | `nano-gpt/qwen3.7-max:thinking`                                  | 1.0M    |       |           |       |       |       | $3         | $8          |
 | `nano-gpt/qwen3.7-plus`                                          | 992K    |       |           |       |       |       | $0.40      | $2          |
 | `nano-gpt/qwen3.7-plus:thinking`                                 | 984K    |       |           |       |       |       | $0.40      | $2          |
-| `nano-gpt/qwen3.8-27b`                                           | 262K    |       |           |       |       |       | $0.40      | $3          |
-| `nano-gpt/qwen3.8-27b:thinking`                                  | 262K    |       |           |       |       |       | $0.40      | $3          |
+| `nano-gpt/qwen3.8-27b`                                           | 262K    |       |           |       |       |       | $0.20      | $1          |
+| `nano-gpt/qwen3.8-27b:thinking`                                  | 262K    |       |           |       |       |       | $0.20      | $1          |
 | `nano-gpt/qwen3.8-max`                                           | 991K    |       |           |       |       |       | $2         | $6          |
 | `nano-gpt/qwen3.8-max:thinking`                                  | 991K    |       |           |       |       |       | $2         | $6          |
 | `nano-gpt/ReadyArt/MS3.2-The-Omega-Directive-24B-Unslop-v2.0`    | 16K     |       |           |       |       |       | $0.50      | $0.50       |
@@ -520,9 +517,6 @@ for await (const chunk of stream) {
 | `nano-gpt/Steelskull/L3.3-MS-Evayale-70B`                        | 16K     |       |           |       |       |       | $0.49      | $0.49       |
 | `nano-gpt/Steelskull/L3.3-MS-Nevoria-70b`                        | 16K     |       |           |       |       |       | $0.49      | $0.49       |
 | `nano-gpt/Steelskull/L3.3-Nevoria-R1-70b`                        | 16K     |       |           |       |       |       | $0.49      | $0.49       |
-| `nano-gpt/step-2-16k-exp`                                        | 16K     |       |           |       |       |       | $7         | $20         |
-| `nano-gpt/step-2-mini`                                           | 8K      |       |           |       |       |       | $0.20      | $0.41       |
-| `nano-gpt/step-3`                                                | 66K     |       |           |       |       |       | $0.25      | $0.65       |
 | `nano-gpt/step-r1-v-mini`                                        | 128K    |       |           |       |       |       | $3         | $11         |
 | `nano-gpt/stepfun-ai/step-3.5-flash`                             | 256K    |       |           |       |       |       | $0.10      | $0.30       |
 | `nano-gpt/stepfun-ai/step-3.5-flash-2603`                        | 256K    |       |           |       |       |       | $0.10      | $0.30       |

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

@@ -2,7 +2,7 @@
 
 # ![Vivgrid logo](https://models.dev/logos/vivgrid.svg)Vivgrid
 
-Access 19 Vivgrid models through Mastra's model router. Authentication is handled automatically using the `VIVGRID_API_KEY` environment variable.
+Access 20 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).
 
@@ -42,6 +42,7 @@ for await (const chunk of stream) {
 | `vivgrid/gemini-3.1-flash-lite-preview` | 1.0M    |       |           |       |       |       | $0.25      | $2          |
 | `vivgrid/gemini-3.1-pro-preview`        | 1.0M    |       |           |       |       |       | $2         | $12         |
 | `vivgrid/glm-5.2`                       | 1.0M    |       |           |       |       |       | $1         | $4          |
+| `vivgrid/glm-5.3`                       | 1.0M    |       |           |       |       |       | $1         | $4          |
 | `vivgrid/gpt-5-mini`                    | 272K    |       |           |       |       |       | $0.25      | $2          |
 | `vivgrid/gpt-5.1-codex`                 | 400K    |       |           |       |       |       | $1         | $10         |
 | `vivgrid/gpt-5.1-codex-max`             | 400K    |       |           |       |       |       | $1         | $10         |

package/.docs/models/providers.md

@@ -26,6 +26,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Ambient](https://mastra.ai/models/providers/ambient)
 - [AMD](https://mastra.ai/models/providers/amd)
 - [AnyAPI](https://mastra.ai/models/providers/anyapi)
+- [Arcee](https://mastra.ai/models/providers/arcee)
 - [Atomic Chat](https://mastra.ai/models/providers/atomic-chat)
 - [Auriko](https://mastra.ai/models/providers/auriko)
 - [Bailing](https://mastra.ai/models/providers/bailing)
@@ -74,6 +75,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [InferX](https://mastra.ai/models/providers/inferx)
 - [Infomaniak](https://mastra.ai/models/providers/infomaniak)
 - [IO.NET](https://mastra.ai/models/providers/io-net)
+- [Jalapeno Cloud](https://mastra.ai/models/providers/jalapeno)
 - [Jiekou.AI](https://mastra.ai/models/providers/jiekou)
 - [Kenari](https://mastra.ai/models/providers/kenari)
 - [Kilo Gateway](https://mastra.ai/models/providers/kilo)

package/.docs/reference/acp/acp-agent.md

@@ -224,9 +224,9 @@ Use this callback to enforce local policy or inspect the permission title. It ca
 
 ## Related
 
-- [Agent Client Protocol docs](https://mastra.ai/docs/agents/acp)
+- [Agent Client Protocol docs](https://mastra.ai/docs/connections/acp)
 - [createACPTool() reference](https://mastra.ai/reference/acp/create-acp-tool)
 - [Agent reference](https://mastra.ai/reference/agents/agent)
-- [Subagents](https://mastra.ai/docs/capabilities/subagents)
+- [Subagents](https://mastra.ai/docs/subagents)
 - [Agent Client Protocol introduction](https://agentclientprotocol.com/overview/introduction)
 - [Agent Client Protocol schema](https://agentclientprotocol.com/protocol/schema)

package/.docs/reference/acp/create-acp-tool.md

@@ -154,7 +154,7 @@ Return a fully custom `Client` implementation when you need to change the standa
 
 ## Related
 
-- [Agent Client Protocol docs](https://mastra.ai/docs/agents/acp)
+- [Agent Client Protocol docs](https://mastra.ai/docs/connections/acp)
 - [AcpAgent class reference](https://mastra.ai/reference/acp/acp-agent)
 - [Tool reference](https://mastra.ai/reference/tools/create-tool)
 - [Agent Client Protocol introduction](https://agentclientprotocol.com/overview/introduction)

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

@@ -497,5 +497,5 @@ await controller.stopIntervals()
 - [AgentController guide](https://mastra.ai/docs/harness/agent-controller)
 - [Session reference](https://mastra.ai/reference/agent-controller/session)
 - [Agents](https://mastra.ai/docs/agents/overview)
-- [Sandbox](https://mastra.ai/docs/workspace/sandbox)
-- [Channels](https://mastra.ai/docs/capabilities/channels)
+- [Sandbox](https://mastra.ai/docs/sandbox/overview)
+- [Channels](https://mastra.ai/docs/channels)

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

@@ -387,7 +387,7 @@ const result = await agent.sendNotificationSignal(
 
 Returns `{ record: NotificationRecord, decision: NotificationDeliveryDecision, runId?: string, signal?: CreatedAgentSignal, persisted?: Promise<void>, accepted?: Promise<SendAgentSignalAccepted> }`. `record` is the stored inbox record. `decision` is the delivery-policy result. `signal` and `runId` are present when ingress emits a signal immediately, including the immediate summary emitted for active high-priority notifications. `persisted` is present when the emitted signal is persisted without waking an idle thread. `accepted` is present when a signal is emitted and resolves at decision-time, once Mastra decides what to do with it: `{ action: 'wake', runId, output }` when this process runs the agent (it started or won the lease to start the run), `{ action: 'deliver', runId }` when the signal is forwarded onto an existing run, or `{ action: 'persist' }` / `{ action: 'discard' }` when nothing ran. `runId` on the accepted result is present only on `wake` and `deliver`. On the `wake` action, `output` is the agent stream for in-process consumption.
 
-Default delivery is priority-aware. `urgent` notifications deliver immediately. `high` notifications deliver immediately when the thread is idle. When the thread is active, Mastra emits a summary immediately and keeps `deliverAt` for later full delivery when the thread is idle. `medium` notifications deliver immediately when idle and batch into summaries when active. `low` notifications batch into summaries in both active and idle threads. Idle low-priority summaries reach subscribers without waking the model loop. For the full flow, visit [Signals](https://mastra.ai/docs/long-running-agents/signals).
+Default delivery is priority-aware. `urgent` notifications deliver immediately. `high` notifications deliver immediately when the thread is idle. When the thread is active, Mastra emits a summary immediately and keeps `deliverAt` for later full delivery when the thread is idle. `medium` notifications deliver immediately when idle and batch into summaries when active. `low` notifications batch into summaries in both active and idle threads. Idle low-priority summaries reach subscribers without waking the model loop. For the full flow, visit [Signals](https://mastra.ai/docs/harness/signals).
 
 Configure `notifications.deliveryPolicy` on the agent when some notifications should wait for a different dispatch window or summary rollup:
 
@@ -564,7 +564,7 @@ When you register the [`MastraEditor`](https://mastra.ai/reference/editor/mastra
 
 **editor** (`false | { instructions?: boolean; tools?: boolean | { description?: boolean } }`): Omit to allow editing instructions and tools. Set to false to lock the agent. Set instructions: true to allow instruction edits. Set tools: true to allow tool membership and description edits, or tools: { description: true } to allow only description edits.
 
-The agent's `id`, `name`, and `model` always come from code and can't be overridden through Editor. See [Editor](https://mastra.ai/docs/editor/overview) for usage.
+The agent's `id`, `name`, and `model` always come from code and can't be overridden through Editor. See [Editor](https://mastra.ai/docs/studio/editor) for usage.
 
 ## Returns
 

package/.docs/reference/agents/channels.md

@@ -4,7 +4,7 @@
 
 **Added in:** `@mastra/core@1.22.0`
 
-Channels connect agents to messaging platforms. Configure them via the `channels` property on the `Agent` constructor. The object you pass is a `ChannelConfig`. See the [Channels overview](https://mastra.ai/docs/capabilities/channels) for concepts and platform setup instructions.
+Channels connect agents to messaging platforms. Configure them via the `channels` property on the `Agent` constructor. The object you pass is a `ChannelConfig`. See the [Channels overview](https://mastra.ai/docs/channels) for concepts and platform setup instructions.
 
 ## Usage example
 
@@ -382,6 +382,6 @@ type InlineLinkEntry =
 
 ## Related
 
-- [Channels overview](https://mastra.ai/docs/capabilities/channels): Concepts, quickstart, and platform setup
+- [Channels overview](https://mastra.ai/docs/channels): Concepts, quickstart, and platform setup
 - [Agent class](https://mastra.ai/reference/agents/agent): Constructor parameters and methods
 - [Chat SDK adapters](https://chat-sdk.dev/adapters): Adapter configuration and platform setup

package/.docs/reference/agents/createSkill.md

@@ -74,7 +74,7 @@ createSkill({ name: '', description: 'test', instructions: 'test' })
 
 ## Related
 
-- [Agent skills](https://mastra.ai/docs/agents/skills)
-- [Workspace skills](https://mastra.ai/docs/workspace/skills)
+- [Agent skills](https://mastra.ai/docs/skills)
+- [Workspace skills](https://mastra.ai/docs/sandbox/skills)
 - [`.getSkill()` reference](https://mastra.ai/reference/agents/getSkill)
 - [`.listSkills()` reference](https://mastra.ai/reference/agents/listSkills)

package/.docs/reference/agents/getSkill.md

@@ -55,6 +55,6 @@ When both agent-level skills and workspace skills are configured, `.getSkill()`
 
 ## Related
 
-- [Agent skills](https://mastra.ai/docs/agents/skills)
+- [Agent skills](https://mastra.ai/docs/skills)
 - [`.listSkills()` reference](https://mastra.ai/reference/agents/listSkills)
 - [`createSkill()` reference](https://mastra.ai/reference/agents/createSkill)

package/.docs/reference/agents/listSkills.md

@@ -50,6 +50,6 @@ When both agent-level skills and workspace skills are configured, `.listSkills()
 
 ## Related
 
-- [Agent skills](https://mastra.ai/docs/agents/skills)
+- [Agent skills](https://mastra.ai/docs/skills)
 - [`.getSkill()` reference](https://mastra.ai/reference/agents/getSkill)
 - [`createSkill()` reference](https://mastra.ai/reference/agents/createSkill)

package/.docs/reference/agents/listSuspendedRuns.md

@@ -4,9 +4,9 @@
 
 **Added in:** `@mastra/core@1.43.0`
 
-The `.listSuspendedRuns()` method lists suspended agent runs from workflow snapshot storage: runs waiting on a tool call requiring [approval](https://mastra.ai/docs/agents/agent-approval), or on a tool that called `suspend()`. Because discovery is backed by storage rather than in-memory state, it works after a server restart and across multiple server instances.
+The `.listSuspendedRuns()` method lists suspended agent runs from workflow snapshot storage: runs waiting on a tool call requiring [approval](https://mastra.ai/docs/agents/human-in-the-loop), or on a tool that called `suspend()`. Because discovery is backed by storage rather than in-memory state, it works after a server restart and across multiple server instances.
 
-Pass the returned `runId` to [`resumeStream()`](https://mastra.ai/docs/agents/agent-approval), `approveToolCall()`, or `declineToolCall()` to continue the run.
+Pass the returned `runId` to [`resumeStream()`](https://mastra.ai/docs/agents/human-in-the-loop), `approveToolCall()`, or `declineToolCall()` to continue the run.
 
 The filter contract mirrors the workflow run listing APIs (`listWorkflowRuns`), plus the agent-level `threadId` filter.
 
@@ -83,11 +83,11 @@ interface AgentRunToolCall {
 
 ## Discovery scope
 
-Results are scoped to runs started by the agent you call `listSuspendedRuns()` on: snapshots persist the owning agent's id, so runs started by other agents on the same Mastra instance aren't returned. In [supervisor setups](https://mastra.ai/docs/agents/agent-approval) the supervisor sees its outer run (the one to resume), while a subagent's inner run is only visible from the subagent itself. Filter by `threadId` and `resourceId` to scope results to one conversation.
+Results are scoped to runs started by the agent you call `listSuspendedRuns()` on: snapshots persist the owning agent's id, so runs started by other agents on the same Mastra instance aren't returned. In [supervisor setups](https://mastra.ai/docs/agents/human-in-the-loop) the supervisor sees its outer run (the one to resume), while a subagent's inner run is only visible from the subagent itself. Filter by `threadId` and `resourceId` to scope results to one conversation.
 
-Run snapshots are only persisted while a run is waiting on input and are deleted when it finishes, so suspended runs are the only runs discoverable from storage. Suspended runs only survive restarts when the Mastra instance has a persistent [storage provider](https://mastra.ai/docs/storage/overview) configured. With the default in-memory store, snapshots are lost on restart.
+Run snapshots are only persisted while a run is waiting on input and are deleted when it finishes, so suspended runs are the only runs discoverable from storage. Suspended runs only survive restarts when the Mastra instance has a persistent [storage provider](https://mastra.ai/docs/storage) configured. With the default in-memory store, snapshots are lost on restart.
 
 ## Related
 
-- [Agent approval](https://mastra.ai/docs/agents/agent-approval)
-- [Storage](https://mastra.ai/docs/storage/overview)
+- [Agent approval](https://mastra.ai/docs/agents/human-in-the-loop)
+- [Storage](https://mastra.ai/docs/storage)

package/.docs/reference/agents/listTools.md

@@ -30,5 +30,5 @@ await agent.listTools({
 
 ## Related
 
-- [Using tools with agents](https://mastra.ai/docs/agents/using-tools)
-- [Creating tools](https://mastra.ai/docs/mcp/overview)
+- [Using tools with agents](https://mastra.ai/docs/agents/tools)
+- [Creating tools](https://mastra.ai/docs/connections/mcp)

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

@@ -4,7 +4,7 @@
 
 The `.network()` method enables multi-agent collaboration and routing. This method accepts messages and optional execution options.
 
-> **Deprecated:** The `.network()` primitive has been deprecated and will be removed in a future major release. Use [supervisor agents](https://mastra.ai/docs/capabilities/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
+> **Deprecated:** The `.network()` primitive has been deprecated and will be removed in a future major release. Use [supervisor agents](https://mastra.ai/docs/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
 
 ## Usage example
 

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

@@ -2,7 +2,7 @@
 
 # handleNetworkStream()
 
-> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use [supervisor agents](https://mastra.ai/docs/capabilities/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
+> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use [supervisor agents](https://mastra.ai/docs/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
 
 Framework-agnostic handler for streaming network execution in AI SDK-compatible format. Use this function directly when you need to handle network streaming outside Hono or Mastra's own [apiRoutes](https://mastra.ai/docs/server/custom-api-routes) feature.
 

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

@@ -2,7 +2,7 @@
 
 # networkRoute()
 
-> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use [supervisor agents](https://mastra.ai/docs/capabilities/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
+> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use [supervisor agents](https://mastra.ai/docs/subagents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/reference/migrations/network-to-supervisor) to upgrade.
 
 Creates a network route handler for streaming network execution using the AI SDK format. This function registers an HTTP `POST` endpoint that accepts messages, executes an agent network, and streams the response back to the client in AI SDK-compatible format. Agent networks allow a routing agent to delegate tasks to other agents. You have to use it inside a [custom API route](https://mastra.ai/docs/server/custom-api-routes).
 

package/.docs/reference/auth/fga.md

@@ -4,7 +4,7 @@
 
 The `IFGAProvider` interface defines a fine-grained authorization (FGA) provider. Mastra calls it to decide whether a user or a system actor may perform a permission on a specific resource. Implement it to connect Mastra to an FGA backend, such as WorkOS Authorization.
 
-For concepts, configuration, and the lifecycle points where Mastra enforces FGA, see [Fine-grained authorization](https://mastra.ai/docs/server/auth/fga).
+For concepts, configuration, and the lifecycle points where Mastra enforces FGA, see [Fine-grained authorization](https://mastra.ai/docs/auth/fga).
 
 ## Usage example
 
@@ -47,7 +47,7 @@ Returns: `Promise<boolean>`
 
 ### `require(user, params)`
 
-Throws `FGADeniedError` when `user` lacks the permission. Mastra calls this at its [enforcement points](https://mastra.ai/docs/server/auth/fga).
+Throws `FGADeniedError` when `user` lacks the permission. Mastra calls this at its [enforcement points](https://mastra.ai/docs/auth/fga).
 
 Returns: `Promise<void>`
 
@@ -63,7 +63,7 @@ Authorizes a non-user system actor, such as an autonomous or scheduled agent. Op
 
 System actors skip the user-centric `require()` path, so implement `requireActor` to enforce per-agent least privilege for them. Throw `FGADeniedError` to deny. When a provider doesn't implement `requireActor`, Mastra preserves the trusted-actor bypass (allow after the tenant-scope check), so adding the method remains backward compatible.
 
-Treat `actor.permissions` as an untrusted claim. Resolve the agent's authoritative grants from a trusted source keyed by `actor.agentId`, rather than trusting the inline values. See [System actors](https://mastra.ai/docs/server/auth/fga).
+Treat `actor.permissions` as an untrusted claim. Resolve the agent's authoritative grants from a trusted source keyed by `actor.agentId`, rather than trusting the inline values. See [System actors](https://mastra.ai/docs/auth/fga).
 
 ```typescript
 import { FGADeniedError } from '@mastra/core/auth/ee'
@@ -135,6 +135,6 @@ throw new FGADeniedError(user, { type: 'agent', id: 'reporter' }, 'agents:execut
 
 ## Related
 
-- [Fine-grained authorization](https://mastra.ai/docs/server/auth/fga)
-- [System actors](https://mastra.ai/docs/server/auth/fga)
+- [Fine-grained authorization](https://mastra.ai/docs/auth/fga)
+- [System actors](https://mastra.ai/docs/auth/fga)
 - [WorkOS authentication](https://mastra.ai/reference/auth/workos)

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

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

package/.docs/reference/browser/agent-browser.md

@@ -54,7 +54,7 @@ then interact with elements using their refs (e.g., @e5).`,
 
 `AgentBrowser` provides 16 deterministic tools for browser automation. All tools that interact with elements use refs from the accessibility tree snapshot.
 
-When `recording` is configured, `AgentBrowser` also adds the Beta `browser_record` and `browser_record_caption` tools. See [Browser recording (Beta)](https://mastra.ai/docs/browser/overview).
+When `recording` is configured, `AgentBrowser` also adds the Beta `browser_record` and `browser_record_caption` tools. See [Browser recording (Beta)](https://mastra.ai/docs/browser).
 
 ### Core tools
 
@@ -403,5 +403,5 @@ The `browser_snapshot` tool returns an accessibility tree with element refs like
 
 - [MastraBrowser](https://mastra.ai/reference/browser/mastra-browser): Base class reference
 - [StagehandBrowser](https://mastra.ai/reference/browser/stagehand-browser): AI-powered alternative
-- [Browser overview](https://mastra.ai/docs/browser/overview): Conceptual guide
+- [Browser overview](https://mastra.ai/docs/browser): Conceptual guide
 - [agent-browser guide](https://mastra.ai/integrations/browsers/agent-browser): Usage guide

package/.docs/reference/browser/browser-viewer.md

@@ -194,7 +194,7 @@ await viewer.injectKeyboardEvent({
 
 ## Supported CLIs
 
-Each CLI must be installed separately. Each also publishes a [skill](https://mastra.ai/docs/workspace/skills) that teaches the agent its commands and workflows. When a CLI command runs through `workspace_execute_command`, Mastra detects it and injects the CDP URL automatically using the correct flag.
+Each CLI must be installed separately. Each also publishes a [skill](https://mastra.ai/docs/sandbox/skills) that teaches the agent its commands and workflows. When a CLI command runs through `workspace_execute_command`, Mastra detects it and injects the CDP URL automatically using the correct flag.
 
 Unlike SDK providers, `BrowserViewer` doesn't provide agent tools. The agent uses CLI commands through `workspace_execute_command` instead.
 
@@ -229,4 +229,4 @@ browse skills install
 
 - [BrowserViewer guide](https://mastra.ai/integrations/browsers/browser-viewer): Setup and usage walkthrough
 - [MastraBrowser](https://mastra.ai/reference/browser/mastra-browser): Base class API reference
-- [Sandbox](https://mastra.ai/docs/workspace/sandbox): Workspace configuration
+- [Sandbox](https://mastra.ai/docs/sandbox/overview): Workspace configuration

package/.docs/reference/browser/firecrawl-browser.md

@@ -68,4 +68,4 @@ In both cases, `FirecrawlBrowser` deletes the remote Firecrawl session when the
 
 - [Firecrawl docs](https://mastra.ai/integrations/browsers/firecrawl)
 - [`AgentBrowser` reference](https://mastra.ai/reference/browser/agent-browser)
-- [Browser overview](https://mastra.ai/docs/browser/overview)
+- [Browser overview](https://mastra.ai/docs/browser)

package/.docs/reference/browser/mastra-browser.md

@@ -285,4 +285,4 @@ const browser = new AgentBrowser({
 
 - [AgentBrowser](https://mastra.ai/reference/browser/agent-browser): Deterministic browser automation
 - [StagehandBrowser](https://mastra.ai/reference/browser/stagehand-browser): AI-powered browser automation
-- [Browser overview](https://mastra.ai/docs/browser/overview): Conceptual guide to browser automation
+- [Browser overview](https://mastra.ai/docs/browser): Conceptual guide to browser automation

package/.docs/reference/browser/stagehand-browser.md

@@ -71,7 +71,7 @@ Use stagehand_extract to get data from pages.`,
 
 `StagehandBrowser` provides 7 AI-powered tools for browser automation.
 
-When `recording` is configured, `StagehandBrowser` also adds the Beta `browser_record` and `browser_record_caption` tools. See [Browser recording (Beta)](https://mastra.ai/docs/browser/overview).
+When `recording` is configured, `StagehandBrowser` also adds the Beta `browser_record` and `browser_record_caption` tools. See [Browser recording (Beta)](https://mastra.ai/docs/browser).
 
 Core tools:
 
@@ -316,5 +316,5 @@ Choose `AgentBrowser` for precise, reproducible automation. Choose `StagehandBro
 
 - [MastraBrowser](https://mastra.ai/reference/browser/mastra-browser): Base class reference
 - [AgentBrowser](https://mastra.ai/reference/browser/agent-browser): Deterministic alternative
-- [Browser overview](https://mastra.ai/docs/browser/overview): Conceptual guide
+- [Browser overview](https://mastra.ai/docs/browser): Conceptual guide
 - [Stagehand guide](https://mastra.ai/integrations/browsers/stagehand): Usage guide

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

@@ -2,7 +2,7 @@
 
 # Build with AI
 
-For everyday AI-assisted development with Mastra skills and the CLI, see [Develop](https://mastra.ai/docs/getting-started/develop). This page covers other ways to give coding agents access to Mastra documentation.
+For everyday AI-assisted development with Mastra skills and the CLI, see [Develop](https://mastra.ai/docs/develop). This page covers other ways to give coding agents access to Mastra documentation.
 
 ## Embedded package docs
 
@@ -29,7 +29,7 @@ Examples for the [introduction page](https://mastra.ai/docs):
 
 ## MCP docs server
 
-> **Warning:** The MCP docs server isn't recommended for everyday development. Use the [Mastra skill](https://mastra.ai/docs/getting-started/develop) instead because it's more up to date and performs better.
+> **Warning:** The MCP docs server isn't recommended for everyday development. Use the [Mastra skill](https://mastra.ai/docs/develop) instead because it's more up to date and performs better.
 
 The `@mastra/mcp-docs-server` package provides direct local access to Mastra’s full documentation via the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/docs/getting-started/intro). It works with Cursor, Windsurf, Cline, Claude Code, VS Code, Codex or any tool that supports MCP.
 

package/.docs/reference/channels/channel-provider.md

@@ -64,4 +64,4 @@ const all = mastra.getChannelProviders()
 ## Related
 
 - [SlackProvider](https://mastra.ai/reference/channels/slack-provider)
-- [Channels](https://mastra.ai/docs/capabilities/channels)
+- [Channels](https://mastra.ai/docs/channels)

package/.docs/reference/channels/slack-provider.md

@@ -226,5 +226,5 @@ const result = await slack.connect('support-agent')
 ## Related
 
 - [ChannelProvider](https://mastra.ai/reference/channels/channel-provider): the interface `SlackProvider` implements
-- [Channels](https://mastra.ai/docs/capabilities/channels): concepts, platform setup, and the `createSlackAdapter` path
+- [Channels](https://mastra.ai/docs/channels): concepts, platform setup, and the `createSlackAdapter` path
 - [Channels reference](https://mastra.ai/reference/agents/channels): the `channels` config on the `Agent` constructor

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

@@ -1771,6 +1771,8 @@ When a server started with `mastra dev` or `mastra start` has observability metr
 
 At server startup, Mastra also sends an anonymous project-surface snapshot: counts of registered agents, agent controllers, workflows, tools, processors, vector stores, scorers, workspaces, MCP servers, gateways, and channels, plus booleans for memory, voice, editor, and observability usage and the coarse storage backend category. It doesn't send names or identifiers. You can read the [source code](https://github.com/mastra-ai/mastra/blob/main/packages/core/src/telemetry/feature-telemetry.ts) to check what's collected.
 
+The Studio UI also collects anonymous browser-side usage analytics, such as page views and UI interactions. You can read the [source code](https://github.com/mastra-ai/mastra/blob/main/packages/playground/src/lib/analytics.tsx) to check what's collected. Setting `MASTRA_TELEMETRY_DISABLED` disables this too: the value is injected into the served page, so it applies to `mastra dev` and self-hosted builds alike.
+
 You can opt out of all CLI and usage analytics by setting an environment variable:
 
 ```bash