@mastra/mcp-docs-server 1.2.17-alpha.9 → 1.2.18-alpha.1

package/.docs/integrations/sandboxes/cloudflare-sandbox.md

@@ -0,0 +1,118 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# Cloudflare Sandbox
+
+`CloudflareSandbox` executes commands and manages files in a remote [Cloudflare Sandbox](https://developers.cloudflare.com/sandbox/) through the [Sandbox Bridge HTTP API](https://developers.cloudflare.com/sandbox/bridge/http-api/).
+
+> **Warning:** Deploy and secure a [Sandbox Bridge Worker](https://developers.cloudflare.com/sandbox/bridge/) before using this provider. The bridge can create and delete sandboxes, execute commands, and write files on behalf of its callers.
+
+## Installation
+
+**npm**:
+
+```bash
+npm install @mastra/cloudflare-sandbox
+```
+
+**pnpm**:
+
+```bash
+pnpm add @mastra/cloudflare-sandbox
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/cloudflare-sandbox
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/cloudflare-sandbox
+```
+
+## Usage
+
+Add `CloudflareSandbox` to a workspace and assign it to an agent:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { Workspace } from '@mastra/core/workspace'
+import { CloudflareSandbox } from '@mastra/cloudflare-sandbox'
+
+const workspace = new Workspace({
+  sandbox: new CloudflareSandbox({
+    baseUrl: process.env.CLOUDFLARE_SANDBOX_BRIDGE_URL!,
+    apiToken: process.env.CLOUDFLARE_SANDBOX_API_KEY,
+    workingDirectory: '/workspace',
+    commandTimeout: 300_000,
+  }),
+})
+
+export const agent = new Agent({
+  id: 'dev-agent',
+  name: 'Development agent',
+  instructions: 'You are a helpful development assistant.',
+  model: 'anthropic/claude-sonnet-4-6',
+  workspace,
+})
+```
+
+The provider creates a remote sandbox when the workspace starts. Pass `sandboxId` to reconnect to an existing sandbox instead.
+
+## Execute commands
+
+Pass command arguments, environment variables, a working directory, and streaming callbacks through `executeCommand()`. The provider sends the command as an `argv` array, so the bridge handles shell escaping:
+
+```typescript
+const result = await workspace.sandbox?.executeCommand?.('npm', ['test'], {
+  cwd: '/workspace/project',
+  env: {
+    NODE_ENV: 'test',
+  },
+  onStdout: chunk => process.stdout.write(chunk),
+  onStderr: chunk => process.stderr.write(chunk),
+})
+```
+
+## Write files
+
+Relative paths are resolved under `/workspace`. Absolute paths must also resolve within `/workspace`. Each file is sent as its own bridge request, and the bridge caps a single file at 32 MiB.
+
+```typescript
+await workspace.sandbox?.writeFiles?.([
+  { path: 'src/index.ts', content: "console.log('hello')\n" },
+  { path: '/workspace/package.json', content: JSON.stringify({ type: 'module' }) },
+])
+```
+
+## Constructor parameters
+
+**baseUrl** (`string`): URL of the deployed Cloudflare Sandbox Bridge Worker.
+
+**apiToken** (`string`): Bearer token matching the Worker's SANDBOX\_API\_KEY secret.
+
+**sandboxId** (`string`): Existing Cloudflare sandbox ID to reconnect to instead of creating a sandbox.
+
+**id** (`string`): Stable Mastra identifier. Defaults to a generated UUID-based value.
+
+**name** (`string`): Human-readable sandbox name. (Default: `Cloudflare Sandbox`)
+
+**env** (`Record<string, string>`): Environment variables applied to every command.
+
+**workingDirectory** (`string`): Working directory applied to every command.
+
+**commandTimeout** (`number`): Default command timeout in milliseconds. (Default: `300000`)
+
+**instructions** (`string | ((options) => string)`): Custom instructions returned by getInstructions().
+
+## Lifecycle behavior
+
+- `start()`: Reconnects to `sandboxId` or creates a remote sandbox.
+- `stop()`: Detaches the Mastra lifecycle without deleting the remote sandbox because the bridge doesn't expose a suspend operation.
+- `destroy()`: Deletes the remote sandbox.
+
+## Limitations
+
+The provider supports command execution, streamed output, and file writes. It doesn't currently expose the bridge's bucket mounts, sessions, PTY terminals, or workspace persistence routes, and it doesn't support background process management, stdin, snapshots, or port URLs.

package/.docs/integrations/sandboxes/daytona.md

@@ -503,4 +503,4 @@ Resources are only applied when `image` is set. Passing `resources` without `ima
 - [LocalSandbox reference](https://mastra.ai/reference/workspace/local-sandbox)
 - [S3Filesystem reference](https://mastra.ai/integrations/file-storage/amazon-s3)
 - [GCSFilesystem reference](https://mastra.ai/integrations/file-storage/google-cloud-storage)
-- [Sandbox](https://mastra.ai/docs/workspace/sandbox)
+- [Sandbox](https://mastra.ai/docs/sandbox/overview)

package/.docs/integrations/sandboxes/docker.md

@@ -135,10 +135,11 @@ const handle = await sandbox.processes.spawn('node server.js', {
   onStdout: data => console.log(data),
 })
 
-// Interact with the process
+// Interact with the process and signal EOF
 console.log(handle.stdout)
 await handle.sendStdin('input\n')
-await handle.kill()
+await handle.closeStdin()
+await handle.wait()
 ```
 
 See [`SandboxProcessManager` reference](https://mastra.ai/reference/workspace/process-manager) for the full API.
@@ -256,4 +257,4 @@ const sandbox = new DockerSandbox({
 - [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox)
 - [LocalSandbox reference](https://mastra.ai/reference/workspace/local-sandbox)
 - [E2BSandbox reference](https://mastra.ai/integrations/sandboxes/e2b)
-- [Sandbox](https://mastra.ai/docs/workspace/sandbox)
+- [Sandbox](https://mastra.ai/docs/sandbox/overview)

package/.docs/integrations/sandboxes/e2b.md

@@ -274,4 +274,4 @@ const { tool, instructions } = createCodeMode(
 - [S3Filesystem reference](https://mastra.ai/integrations/file-storage/amazon-s3)
 - [GCSFilesystem reference](https://mastra.ai/integrations/file-storage/google-cloud-storage)
 - [Azure Blob Filesystem reference](https://mastra.ai/integrations/file-storage/azure-blob)
-- [Sandbox](https://mastra.ai/docs/workspace/sandbox)
+- [Sandbox](https://mastra.ai/docs/sandbox/overview)

package/.docs/integrations/sandboxes/modal.md

@@ -165,4 +165,4 @@ See [`SandboxProcessManager` reference](https://mastra.ai/reference/workspace/pr
 - [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox)
 - [E2BSandbox reference](https://mastra.ai/integrations/sandboxes/e2b)
 - [DaytonaSandbox reference](https://mastra.ai/integrations/sandboxes/daytona)
-- [Sandbox](https://mastra.ai/docs/workspace/sandbox)
+- [Sandbox](https://mastra.ai/docs/sandbox/overview)

package/.docs/integrations/sandboxes/railway.md

@@ -141,6 +141,15 @@ const sandbox = new RailwaySandbox({
 
 `RailwaySandbox` refreshes the checkpoint shortly before the idle timeout. Recovery restores the latest successful checkpoint. It doesn't restore running processes or filesystem writes made after the last checkpoint.
 
+Set `seedCheckpointName` to provide a boot-only fallback when `checkpointName` doesn't exist yet. Railway restores `checkpointName` first when both checkpoints exist. Later snapshots write only to `checkpointName`, so each sandbox keeps an independent recovery history.
+
+```typescript
+const sandbox = new RailwaySandbox({
+  checkpointName: 'project-session-42',
+  seedCheckpointName: 'project-base',
+})
+```
+
 Call `snapshot()` after a filesystem update to capture the configured checkpoint immediately. It resolves without capturing when `checkpointName` isn't configured or the sandbox isn't running.
 
 ```typescript
@@ -202,6 +211,8 @@ const result = await sandbox.executeCommand('cat', ['/tmp/state.txt'])
 
 **checkpointName** (`string`): Named Railway checkpoint used to seed new sandboxes and preserve the filesystem before idle teardown. Use a unique stable name for each independent filesystem.
 
+**seedCheckpointName** (`string`): Boot-only fallback checkpoint used when checkpointName has no stored state. Later snapshots continue writing to checkpointName.
+
 **idleTimeoutMinutes** (`number`): How long the sandbox can sit idle (no exec interaction) before Railway destroys it automatically. The valid range and default depend on your Railway plan.
 
 **networkIsolation** (`'ISOLATED' | 'PRIVATE'`): Network access mode. 'ISOLATED' allows outbound internet only; 'PRIVATE' joins the environment's private network. (Default: `'ISOLATED'`)

package/.docs/integrations.md

@@ -36,6 +36,7 @@
 - [AgentCore](https://mastra.ai/integrations/sandboxes/agentcore)
 - [Apple Container](https://mastra.ai/integrations/sandboxes/apple-container)
 - [Blaxel](https://mastra.ai/integrations/sandboxes/blaxel)
+- [Cloudflare Sandbox](https://mastra.ai/integrations/sandboxes/cloudflare-sandbox)
 - [Daytona](https://mastra.ai/integrations/sandboxes/daytona)
 - [Docker](https://mastra.ai/integrations/sandboxes/docker)
 - [E2B](https://mastra.ai/integrations/sandboxes/e2b)
@@ -54,6 +55,7 @@
 - [Laminar](https://mastra.ai/integrations/observability/laminar)
 - [Langfuse](https://mastra.ai/integrations/observability/langfuse)
 - [LangSmith](https://mastra.ai/integrations/observability/langsmith)
+- [Mastra](https://mastra.ai/docs/mastra-platform/observability)
 - [OpenTelemetry](https://mastra.ai/integrations/observability/opentelemetry)
 - [PostHog](https://mastra.ai/integrations/observability/posthog)
 - [Sentry](https://mastra.ai/integrations/observability/sentry)
@@ -70,6 +72,7 @@
 - [Google Cloud Spanner](https://mastra.ai/integrations/databases/spanner)
 - [LanceDB](https://mastra.ai/integrations/databases/lancedb)
 - [libSQL](https://mastra.ai/integrations/databases/libsql)
+- [Mastra](https://mastra.ai/docs/mastra-platform/database)
 - [MongoDB](https://mastra.ai/integrations/databases/mongodb)
 - [MSSQL](https://mastra.ai/integrations/databases/mssql)
 - [Neon Postgres](https://mastra.ai/integrations/databases/neon)
@@ -90,6 +93,7 @@
 - [Kubernetes](https://mastra.ai/integrations/deploy/kubernetes)
 - [Mastra](https://mastra.ai/docs/mastra-platform/deploy)
 - [Netlify](https://mastra.ai/integrations/deploy/netlify)
+- [Render](https://mastra.ai/integrations/deploy/render)
 - [Temporal](https://mastra.ai/integrations/deploy/temporal)
 - [Vercel](https://mastra.ai/integrations/deploy/vercel)
 

package/.docs/models/environment-variables.md

@@ -19,8 +19,10 @@ List of required environment variables for each model provider and gateway suppo
 | [Alibaba Token Plan](https://mastra.ai/models/providers/alibaba-token-plan)                    | `alibaba-token-plan/*`     | `ALIBABA_TOKEN_PLAN_API_KEY`                                                                          |
 | [Alibaba Token Plan (China)](https://mastra.ai/models/providers/alibaba-token-plan-cn)         | `alibaba-token-plan-cn/*`  | `ALIBABA_TOKEN_PLAN_API_KEY`                                                                          |
 | [Ambient](https://mastra.ai/models/providers/ambient)                                          | `ambient/*`                | `AMBIENT_API_KEY`                                                                                     |
+| [AMD](https://mastra.ai/models/providers/amd)                                                  | `amd/*`                    | `AMD_API_KEY`                                                                                         |
 | [Anthropic](https://mastra.ai/models/providers/anthropic)                                      | `anthropic/*`              | `ANTHROPIC_API_KEY`                                                                                   |
 | [AnyAPI](https://mastra.ai/models/providers/anyapi)                                            | `anyapi/*`                 | `ANYAPI_API_KEY`                                                                                      |
+| [Arcee](https://mastra.ai/models/providers/arcee)                                              | `arcee/*`                  | `ARCEE_API_KEY`                                                                                       |
 | [Atomic Chat](https://mastra.ai/models/providers/atomic-chat)                                  | `atomic-chat/*`            | `ATOMIC_CHAT_API_KEY`                                                                                 |
 | [Auriko](https://mastra.ai/models/providers/auriko)                                            | `auriko/*`                 | `AURIKO_API_KEY`                                                                                      |
 | [Bailing](https://mastra.ai/models/providers/bailing)                                          | `bailing/*`                | `BAILING_API_TOKEN`                                                                                   |
@@ -48,6 +50,7 @@ List of required environment variables for each model provider and gateway suppo
 | [DigitalOcean](https://mastra.ai/models/providers/digitalocean)                                | `digitalocean/*`           | `DIGITALOCEAN_ACCESS_TOKEN`                                                                           |
 | [DInference](https://mastra.ai/models/providers/dinference)                                    | `dinference/*`             | `DINFERENCE_API_KEY`                                                                                  |
 | [EBCloud](https://mastra.ai/models/providers/ebcloud)                                          | `ebcloud/*`                | `EBCLOUD_API_KEY`                                                                                     |
+| [Echo](https://mastra.ai/models/providers/echo)                                                | `echo/*`                   | `ECHO_API_KEY`                                                                                        |
 | [Eden AI](https://mastra.ai/models/providers/edenai)                                           | `edenai/*`                 | `EDENAI_API_KEY`                                                                                      |
 | [EmpirioLabs AI](https://mastra.ai/models/providers/empiriolabs)                               | `empiriolabs/*`            | `EMPIRIOLABS_API_KEY`                                                                                 |
 | [evroc](https://mastra.ai/models/providers/evroc)                                              | `evroc/*`                  | `EVROC_API_KEY`                                                                                       |
@@ -72,10 +75,12 @@ List of required environment variables for each model provider and gateway suppo
 | [InferX](https://mastra.ai/models/providers/inferx)                                            | `inferx/*`                 | `INFERX_API_KEY`                                                                                      |
 | [Infomaniak](https://mastra.ai/models/providers/infomaniak)                                    | `infomaniak/*`             | `INFOMANIAK_PRODUCT_ID`, `INFOMANIAK_API_KEY`                                                         |
 | [IO.NET](https://mastra.ai/models/providers/io-net)                                            | `io-net/*`                 | `IOINTELLIGENCE_API_KEY`                                                                              |
+| [Jalapeno Cloud](https://mastra.ai/models/providers/jalapeno)                                  | `jalapeno/*`               | `JALAPENO_API_KEY`                                                                                    |
 | [Jiekou.AI](https://mastra.ai/models/providers/jiekou)                                         | `jiekou/*`                 | `JIEKOU_API_KEY`                                                                                      |
 | [Kenari](https://mastra.ai/models/providers/kenari)                                            | `kenari/*`                 | `KENARI_API_KEY`                                                                                      |
 | [Kilo Gateway](https://mastra.ai/models/providers/kilo)                                        | `kilo/*`                   | `KILO_API_KEY`                                                                                        |
 | [Kimi For Coding](https://mastra.ai/models/providers/kimi-for-coding)                          | `kimi-for-coding/*`        | `KIMI_API_KEY`                                                                                        |
+| [Kosmik Compute](https://mastra.ai/models/providers/kosmik)                                    | `kosmik/*`                 | `KOSMIK_API_KEY`                                                                                      |
 | [KUAE Cloud Coding Plan](https://mastra.ai/models/providers/kuae-cloud-coding-plan)            | `kuae-cloud-coding-plan/*` | `KUAE_API_KEY`                                                                                        |
 | [Lilac](https://mastra.ai/models/providers/lilac)                                              | `lilac/*`                  | `LILAC_API_KEY`                                                                                       |
 | [Llama](https://mastra.ai/models/providers/llama)                                              | `llama/*`                  | `LLAMA_API_KEY`                                                                                       |
@@ -86,7 +91,6 @@ List of required environment variables for each model provider and gateway suppo
 | [LucidQuery](https://mastra.ai/models/providers/lucidquery)                                    | `lucidquery/*`             | `LUCIDQUERY_API_KEY`                                                                                  |
 | [Lynkr](https://mastra.ai/models/providers/lynkr)                                              | `lynkr/*`                  | `LYNKR_API_KEY`                                                                                       |
 | [Meganova](https://mastra.ai/models/providers/meganova)                                        | `meganova/*`               | `MEGANOVA_API_KEY`                                                                                    |
-| [Merge Gateway](https://mastra.ai/models/providers/merge-gateway)                              | `merge-gateway/*`          | `MERGE_GATEWAY_API_KEY`                                                                               |
 | [Meta](https://mastra.ai/models/providers/meta)                                                | `meta/*`                   | `META_MODEL_API_KEY`                                                                                  |
 | [MiniMax (minimax.io)](https://mastra.ai/models/providers/minimax)                             | `minimax/*`                | `MINIMAX_API_KEY`                                                                                     |
 | [MiniMax (minimaxi.com)](https://mastra.ai/models/providers/minimax-cn)                        | `minimax-cn/*`             | `MINIMAX_API_KEY`                                                                                     |
@@ -127,10 +131,12 @@ List of required environment variables for each model provider and gateway suppo
 | [Regolo AI](https://mastra.ai/models/providers/regolo-ai)                                      | `regolo-ai/*`              | `REGOLO_API_KEY`                                                                                      |
 | [Requesty](https://mastra.ai/models/providers/requesty)                                        | `requesty/*`               | `REQUESTY_API_KEY`                                                                                    |
 | [routing.run](https://mastra.ai/models/providers/routing-run)                                  | `routing-run/*`            | `ROUTING_RUN_API_KEY`                                                                                 |
+| [RunInfra](https://mastra.ai/models/providers/runinfra)                                        | `runinfra/*`               | `RUNINFRA_GATEWAY_KEY`                                                                                |
 | [Sakana AI](https://mastra.ai/models/providers/sakana)                                         | `sakana/*`                 | `SAKANA_API_KEY`                                                                                      |
 | [Sarvam AI](https://mastra.ai/models/providers/sarvam)                                         | `sarvam/*`                 | `SARVAM_API_KEY`                                                                                      |
 | [Scaleway](https://mastra.ai/models/providers/scaleway)                                        | `scaleway/*`               | `SCALEWAY_API_KEY`                                                                                    |
-| [SCX.ai](https://mastra.ai/models/providers/scx)                                               | `scx/*`                    | `SCX_API_KEY`                                                                                         |
+| [SCNet Token Plan](https://mastra.ai/models/providers/scnet-token-plan)                        | `scnet-token-plan/*`       | `SCNET_API_KEY`                                                                                       |
+| [SCX.ai](https://mastra.ai/models/providers/scx-ai)                                            | `scx-ai/*`                 | `SCX_API_KEY`                                                                                         |
 | [SiliconFlow](https://mastra.ai/models/providers/siliconflow)                                  | `siliconflow/*`            | `SILICONFLOW_API_KEY`                                                                                 |
 | [SiliconFlow (China)](https://mastra.ai/models/providers/siliconflow-cn)                       | `siliconflow-cn/*`         | `SILICONFLOW_CN_API_KEY`                                                                              |
 | [Snowflake Cortex](https://mastra.ai/models/providers/snowflake-cortex)                        | `snowflake-cortex/*`       | `SNOWFLAKE_ACCOUNT`, `SNOWFLAKE_CORTEX_PAT`                                                           |
@@ -174,6 +180,7 @@ List of required environment variables for each model provider and gateway suppo
 | [Zhipu AI Coding Plan](https://mastra.ai/models/providers/zhipuai-coding-plan)                 | `zhipuai-coding-plan/*`    | `ZHIPU_API_KEY`                                                                                       |
 | [Azure OpenAI](https://mastra.ai/models/gateways/azure-openai) (Gateway)                       | `azure-openai/*`           | `AZURE_API_KEY`, `AZURE_TENANT_ID`, `AZURE_CLIENT_ID`, `AZURE_CLIENT_SECRET`, `AZURE_SUBSCRIPTION_ID` |
 | [Mastra](https://mastra.ai/models/gateways/mastra) (Gateway)                                   | `mastra/*`                 | `MASTRA_GATEWAY_API_KEY`                                                                              |
+| [Merge Gateway](https://mastra.ai/models/gateways/merge-gateway) (Gateway)                     | `merge-gateway/*`          | `MERGE_GATEWAY_API_KEY`                                                                               |
 | [Neon](https://mastra.ai/models/gateways/neon) (Gateway)                                       | `neon/*`                   | `NEON_AI_GATEWAY_BASE_URL`, `NEON_AI_GATEWAY_TOKEN`                                                   |
 | [Netlify](https://mastra.ai/models/gateways/netlify) (Gateway)                                 | `netlify/*`                | `NETLIFY_TOKEN`, `NETLIFY_SITE_ID`                                                                    |
 | [OpenRouter](https://mastra.ai/models/gateways/openrouter) (Gateway)                           | `openrouter/*`             | `OPENROUTER_API_KEY`                                                                                  |

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

@@ -0,0 +1,212 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![Merge Gateway logo](https://models.dev/logos/merge-gateway.svg)Merge Gateway
+
+Merge Gateway aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 174 models through Mastra's model router.
+
+Learn more in the [Merge Gateway documentation](https://docs.merge.dev/merge-gateway).
+
+## Usage
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "merge-gateway/anthropic/claude-3-7-sonnet-20250219"
+});
+```
+
+> **Note:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Merge Gateway documentation](https://docs.merge.dev/merge-gateway) for details.
+
+## Configuration
+
+```bash
+# Use gateway API key
+MERGE_GATEWAY_API_KEY=your-gateway-key
+
+# Or use provider API keys directly
+OPENAI_API_KEY=sk-...
+ANTHROPIC_API_KEY=ant-...
+```
+
+## Available models
+
+| Model                                            |
+| ------------------------------------------------ |
+| `anthropic/claude-3-7-sonnet-20250219`           |
+| `anthropic/claude-fable-5`                       |
+| `anthropic/claude-haiku-4-5-20251001`            |
+| `anthropic/claude-opus-4-1-20250805`             |
+| `anthropic/claude-opus-4-20250514`               |
+| `anthropic/claude-opus-4-5-20251101`             |
+| `anthropic/claude-opus-4-6`                      |
+| `anthropic/claude-opus-4-7`                      |
+| `anthropic/claude-opus-4-8`                      |
+| `anthropic/claude-opus-5`                        |
+| `anthropic/claude-sonnet-4-20250514`             |
+| `anthropic/claude-sonnet-4-5-20250929`           |
+| `anthropic/claude-sonnet-4-6`                    |
+| `anthropic/claude-sonnet-5`                      |
+| `bytedance/dola-seed-2.0-code`                   |
+| `bytedance/dola-seed-2.0-code-preview`           |
+| `bytedance/dola-seed-2.0-lite`                   |
+| `bytedance/dola-seed-2.0-mini`                   |
+| `bytedance/dola-seed-2.0-pro`                    |
+| `cohere/command-a-03-2025`                       |
+| `cohere/command-r-08-2024`                       |
+| `cohere/command-r-plus-08-2024`                  |
+| `cohere/command-r7b-12-2024`                     |
+| `deepseek/deepseek-r1`                           |
+| `deepseek/deepseek-v3`                           |
+| `deepseek/deepseek-v3.1`                         |
+| `deepseek/deepseek-v3.2`                         |
+| `deepseek/deepseek-v4-flash`                     |
+| `deepseek/deepseek-v4-flash-0731`                |
+| `deepseek/deepseek-v4-pro`                       |
+| `deepseek/deepseek-v4-pro-0813`                  |
+| `google/gemini-2.5-computer-use-preview-10-2025` |
+| `google/gemini-2.5-flash`                        |
+| `google/gemini-2.5-flash-image`                  |
+| `google/gemini-2.5-flash-lite`                   |
+| `google/gemini-2.5-pro`                          |
+| `google/gemini-3-flash-preview`                  |
+| `google/gemini-3-pro-image`                      |
+| `google/gemini-3-pro-preview`                    |
+| `google/gemini-3.1-flash-image`                  |
+| `google/gemini-3.1-flash-lite`                   |
+| `google/gemini-3.1-flash-lite-preview`           |
+| `google/gemini-3.1-pro-preview`                  |
+| `google/gemini-3.1-pro-preview-customtools`      |
+| `google/gemini-3.5-flash`                        |
+| `google/gemini-3.5-flash-lite`                   |
+| `google/gemini-3.6-flash`                        |
+| `google/gemini-3.7-flash`                        |
+| `google/gemini-embedding-001`                    |
+| `google/gemini-flash-latest`                     |
+| `google/gemini-flash-lite-latest`                |
+| `google/gemma-4-26b-a4b-it`                      |
+| `google/gemma-4-31b-it`                          |
+| `meta/llama-3.1-8b-instruct`                     |
+| `meta/llama-3.3-70b-instruct`                    |
+| `meta/muse-spark-1.1`                            |
+| `meta/muse-spark-1.2`                            |
+| `minimax/minimax-m2`                             |
+| `minimax/minimax-m2.1`                           |
+| `minimax/minimax-m2.5`                           |
+| `minimax/minimax-m2.5-highspeed`                 |
+| `minimax/minimax-m2.7`                           |
+| `minimax/minimax-m2.7-highspeed`                 |
+| `minimax/minimax-m3`                             |
+| `mistral/codestral-latest`                       |
+| `mistral/devstral-2512`                          |
+| `mistral/devstral-medium-2507`                   |
+| `mistral/devstral-medium-latest`                 |
+| `mistral/devstral-small-2507`                    |
+| `mistral/magistral-medium-latest`                |
+| `mistral/mistral-large-2411`                     |
+| `mistral/mistral-large-2512`                     |
+| `mistral/mistral-large-latest`                   |
+| `mistral/mistral-medium-2505`                    |
+| `mistral/mistral-medium-latest`                  |
+| `mistral/mistral-small-latest`                   |
+| `mistral/pixtral-large-latest`                   |
+| `moonshot/kimi-k2.5`                             |
+| `moonshot/kimi-k2.6`                             |
+| `moonshot/kimi-k2.7-code`                        |
+| `moonshot/kimi-k2.7-code-highspeed`              |
+| `moonshot/kimi-k3`                               |
+| `moonshotai/kimi-k2-thinking`                    |
+| `nvidia/nemotron-3.5-lightning-30b-a3b`          |
+| `nvidia/nemotron-nano-9b-v2`                     |
+| `openai/gpt-3.5-turbo`                           |
+| `openai/gpt-4`                                   |
+| `openai/gpt-4-turbo`                             |
+| `openai/gpt-4.1`                                 |
+| `openai/gpt-4.1-mini`                            |
+| `openai/gpt-4.1-nano`                            |
+| `openai/gpt-4o`                                  |
+| `openai/gpt-4o-2024-05-13`                       |
+| `openai/gpt-4o-2024-08-06`                       |
+| `openai/gpt-4o-2024-11-20`                       |
+| `openai/gpt-4o-mini`                             |
+| `openai/gpt-5`                                   |
+| `openai/gpt-5-chat-latest`                       |
+| `openai/gpt-5-mini`                              |
+| `openai/gpt-5-nano`                              |
+| `openai/gpt-5.1`                                 |
+| `openai/gpt-5.1-chat-latest`                     |
+| `openai/gpt-5.2`                                 |
+| `openai/gpt-5.2-chat-latest`                     |
+| `openai/gpt-5.3-chat-latest`                     |
+| `openai/gpt-5.4`                                 |
+| `openai/gpt-5.4-mini`                            |
+| `openai/gpt-5.4-nano`                            |
+| `openai/gpt-5.5`                                 |
+| `openai/gpt-5.6-luna`                            |
+| `openai/gpt-5.6-sol`                             |
+| `openai/gpt-5.6-terra`                           |
+| `openai/gpt-oss-120b`                            |
+| `openai/gpt-oss-20b`                             |
+| `openai/gpt-oss-safeguard-120b`                  |
+| `openai/o1`                                      |
+| `openai/o3`                                      |
+| `openai/o3-mini`                                 |
+| `openai/o4-mini`                                 |
+| `qwen/qwen-flash`                                |
+| `qwen/qwen-plus`                                 |
+| `qwen/qwen3-235b-a22b`                           |
+| `qwen/qwen3-235b-a22b-instruct-2507`             |
+| `qwen/qwen3-30b-a3b`                             |
+| `qwen/qwen3-32b`                                 |
+| `qwen/qwen3-coder-480b-a35b-instruct`            |
+| `qwen/qwen3-coder-flash`                         |
+| `qwen/qwen3-coder-next`                          |
+| `qwen/qwen3-coder-plus`                          |
+| `qwen/qwen3-max`                                 |
+| `qwen/qwen3-next-80b-a3b-instruct`               |
+| `qwen/qwen3-next-80b-a3b-thinking`               |
+| `qwen/qwen3-vl-235b-a22b-instruct`               |
+| `qwen/qwen3-vl-235b-a22b-thinking`               |
+| `qwen/qwen3-vl-plus`                             |
+| `qwen/qwen3.5-122b-a10b`                         |
+| `qwen/qwen3.5-27b`                               |
+| `qwen/qwen3.5-35b-a3b`                           |
+| `qwen/qwen3.5-397b-a17b`                         |
+| `qwen/qwen3.5-9b`                                |
+| `qwen/qwen3.5-flash`                             |
+| `qwen/qwen3.5-plus`                              |
+| `qwen/qwen3.6-27b`                               |
+| `qwen/qwen3.6-35b-a3b`                           |
+| `qwen/qwen3.6-flash`                             |
+| `qwen/qwen3.6-max-preview`                       |
+| `qwen/qwen3.6-plus`                              |
+| `qwen/qwen3.7-max`                               |
+| `qwen/qwen3.7-plus`                              |
+| `qwen/qwen3.8-2.4t-a95b`                         |
+| `qwen/qwen3.8-max`                               |
+| `sakana/fugu-ultra`                              |
+| `sakana/sakana-namazu`                           |
+| `thinkingmachines/inkling`                       |
+| `writer/palmyra-x4`                              |
+| `writer/palmyra-x5`                              |
+| `xai/grok-4.20-0309-non-reasoning`               |
+| `xai/grok-4.20-0309-reasoning`                   |
+| `xai/grok-4.3`                                   |
+| `xai/grok-4.5`                                   |
+| `xai/grok-4.6`                                   |
+| `xai/grok-build-0.1`                             |
+| `zai/glm-4.5`                                    |
+| `zai/glm-4.5-air`                                |
+| `zai/glm-4.5v`                                   |
+| `zai/glm-4.6`                                    |
+| `zai/glm-4.7`                                    |
+| `zai/glm-4.7-flash`                              |
+| `zai/glm-4.7-flashx`                             |
+| `zai/glm-5`                                      |
+| `zai/glm-5-turbo`                                |
+| `zai/glm-5.1`                                    |
+| `zai/glm-5.2`                                    |
+| `zai/glm-5.3`                                    |

package/.docs/models/gateways/openrouter.md

@@ -2,7 +2,7 @@
 
 # ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter
 
-OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 351 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 353 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -386,4 +386,6 @@ ANTHROPIC_API_KEY=ant-...
 | `z-ai/glm-5-turbo`                                         |
 | `z-ai/glm-5.1`                                             |
 | `z-ai/glm-5.2`                                             |
+| `z-ai/glm-5.2:free`                                        |
+| `z-ai/glm-5.3`                                             |
 | `z-ai/glm-5v-turbo`                                        |

package/.docs/models/gateways/vercel.md

@@ -2,7 +2,7 @@
 
 # ![Vercel logo](https://models.dev/logos/vercel.svg)Vercel
 
-Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 327 models through Mastra's model router.
+Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 348 models through Mastra's model router.
 
 Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
 
@@ -65,6 +65,7 @@ ANTHROPIC_API_KEY=ant-...
 | `alibaba/qwen3.7-max`                    |
 | `alibaba/qwen3.7-plus`                   |
 | `alibaba/qwen3.8-2.4t-a95b`              |
+| `alibaba/qwen3.8-27b`                    |
 | `alibaba/qwen3.8-max`                    |
 | `alibaba/wan-v2.5-t2v-preview`           |
 | `alibaba/wan-v2.6-i2v`                   |
@@ -231,40 +232,57 @@ ANTHROPIC_API_KEY=ant-...
 | `nvidia/nemotron-3-nano-30b-a3b`         |
 | `nvidia/nemotron-3-super-120b-a12b`      |
 | `nvidia/nemotron-3-ultra-550b-a55b`      |
+| `nvidia/nemotron-3.5-lightning`          |
 | `nvidia/nemotron-nano-12b-v2-vl`         |
 | `nvidia/nemotron-nano-9b-v2`             |
 | `openai/gpt-3.5-turbo`                   |
 | `openai/gpt-4-turbo`                     |
 | `openai/gpt-4.1`                         |
+| `openai/gpt-4.1-fast`                    |
 | `openai/gpt-4.1-mini`                    |
+| `openai/gpt-4.1-mini-fast`               |
 | `openai/gpt-4.1-nano`                    |
+| `openai/gpt-4.1-nano-fast`               |
 | `openai/gpt-4o`                          |
+| `openai/gpt-4o-fast`                     |
 | `openai/gpt-4o-mini`                     |
+| `openai/gpt-4o-mini-fast`                |
 | `openai/gpt-4o-mini-search-preview`      |
 | `openai/gpt-4o-mini-transcribe`          |
 | `openai/gpt-4o-transcribe`               |
 | `openai/gpt-5`                           |
 | `openai/gpt-5-codex`                     |
+| `openai/gpt-5-fast`                      |
 | `openai/gpt-5-mini`                      |
+| `openai/gpt-5-mini-fast`                 |
 | `openai/gpt-5-nano`                      |
 | `openai/gpt-5-pro`                       |
 | `openai/gpt-5.1-codex`                   |
 | `openai/gpt-5.1-codex-max`               |
 | `openai/gpt-5.1-codex-mini`              |
 | `openai/gpt-5.1-thinking`                |
+| `openai/gpt-5.1-thinking-fast`           |
 | `openai/gpt-5.2`                         |
 | `openai/gpt-5.2-codex`                   |
+| `openai/gpt-5.2-fast`                    |
 | `openai/gpt-5.2-pro`                     |
 | `openai/gpt-5.3-codex`                   |
+| `openai/gpt-5.3-codex-fast`              |
 | `openai/gpt-5.4`                         |
+| `openai/gpt-5.4-fast`                    |
 | `openai/gpt-5.4-mini`                    |
+| `openai/gpt-5.4-mini-fast`               |
 | `openai/gpt-5.4-nano`                    |
 | `openai/gpt-5.4-pro`                     |
 | `openai/gpt-5.5`                         |
+| `openai/gpt-5.5-fast`                    |
 | `openai/gpt-5.5-pro`                     |
 | `openai/gpt-5.6-luna`                    |
+| `openai/gpt-5.6-luna-fast`               |
 | `openai/gpt-5.6-sol`                     |
+| `openai/gpt-5.6-sol-fast`                |
 | `openai/gpt-5.6-terra`                   |
+| `openai/gpt-5.6-terra-fast`              |
 | `openai/gpt-image-1`                     |
 | `openai/gpt-image-1-mini`                |
 | `openai/gpt-image-1.5`                   |
@@ -280,9 +298,11 @@ ANTHROPIC_API_KEY=ant-...
 | `openai/o1`                              |
 | `openai/o3`                              |
 | `openai/o3-deep-research`                |
+| `openai/o3-fast`                         |
 | `openai/o3-mini`                         |
 | `openai/o3-pro`                          |
 | `openai/o4-mini`                         |
+| `openai/o4-mini-fast`                    |
 | `openai/text-embedding-3-large`          |
 | `openai/text-embedding-3-small`          |
 | `openai/text-embedding-ada-002`          |
@@ -362,4 +382,5 @@ ANTHROPIC_API_KEY=ant-...
 | `zai/glm-5.1`                            |
 | `zai/glm-5.2`                            |
 | `zai/glm-5.2-fast`                       |
+| `zai/glm-5.3`                            |
 | `zai/glm-5v-turbo`                       |

package/.docs/models/gateways.md

@@ -12,6 +12,7 @@ Create custom gateways for private LLM deployments or specialized provider integ
 
 - [Azure OpenAI](https://mastra.ai/models/gateways/azure-openai)
 - [Mastra](https://mastra.ai/models/gateways/mastra)
+- [Merge Gateway](https://mastra.ai/models/gateways/merge-gateway)
 - [Neon](https://mastra.ai/models/gateways/neon)
 - [Netlify](https://mastra.ai/models/gateways/netlify)
 - [OpenRouter](https://mastra.ai/models/gateways/openrouter)

package/.docs/models/index.md

@@ -2,7 +2,7 @@
 
 # Model Providers
 
-Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 5960 models from 172 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 6202 models from 179 providers through a single API.
 
 ## Features