@mastra/mcp-docs-server 1.2.17-alpha.7 → 1.2.17

package/.docs/integrations/frameworks/sveltekit.md

@@ -288,7 +288,7 @@ Congratulations on building your Mastra agent with SvelteKit! 🎉
 From here, you can extend the project with your own tools and logic:
 
 - Learn more about [agents](https://mastra.ai/docs/agents/overview)
-- Give your agent its own [tools](https://mastra.ai/docs/agents/using-tools)
+- Give your agent its own [tools](https://mastra.ai/docs/agents/tools)
 - Add human-like [memory](https://mastra.ai/docs/memory/overview) to your agent
 
 When you're ready, read more about how Mastra integrates with AI SDK UI and SvelteKit, and how to deploy your agent anywhere:

package/.docs/integrations/frameworks/vite-react.md

@@ -196,7 +196,7 @@ yarn add @mastra/ai-sdk@latest @ai-sdk/react ai
 bun add @mastra/ai-sdk@latest @ai-sdk/react ai
 ```
 
-Next, initialize AI Elements. When prompted, choose the default options:
+Next, initialize AI Elements. When prompted to select a component library, choose **Radix UI**, then accept the defaults for the remaining prompts:
 
 **npm**:
 
@@ -222,6 +222,10 @@ yarn dlx ai-elements@latest
 bun x ai-elements@latest
 ```
 
+> **Note:** The `ai-elements` command runs `shadcn add` against the AI Elements registry, which currently publishes Radix UI components only. Installing them into a Base UI project produces TypeScript errors, tracked in [vercel/ai-elements#383](https://github.com/vercel/ai-elements/issues/383).
+>
+> The component library prompt only appears when your project has no `components.json`. If you already have one, check that its `style` is a Radix option, such as `new-york` or a `radix-*` style, and not a `base-*` style, before running the command.
+
 This downloads the entire AI Elements UI component library into a `@/components/ai-elements` folder.
 
 ## Create a chat route
@@ -418,7 +422,7 @@ Congratulations on building your Mastra agent with React! 🎉
 From here, you can extend the project with your own tools and logic:
 
 - Learn more about [agents](https://mastra.ai/docs/agents/overview)
-- Give your agent its own [tools](https://mastra.ai/docs/agents/using-tools)
+- Give your agent its own [tools](https://mastra.ai/docs/agents/tools)
 - Add human-like [memory](https://mastra.ai/docs/memory/overview) to your agent
 
 When you're ready, read more about how Mastra integrates with AI SDK UI and React, and how to deploy your agent anywhere:

package/.docs/integrations/sandboxes/agentcore.md

@@ -199,5 +199,5 @@ Returns: `Promise<SandboxInfo>`.
 
 - [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox)
 - [Workspace class](https://mastra.ai/reference/workspace/workspace-class)
-- [Sandbox overview](https://mastra.ai/docs/workspace/sandbox)
+- [Sandbox overview](https://mastra.ai/docs/sandbox/overview)
 - [AWS Bedrock AgentCore Runtime command execution](https://docs.aws.amazon.com/bedrock-agentcore/latest/devguide/runtime-execute-command.html)

package/.docs/integrations/sandboxes/apple-container.md

@@ -254,4 +254,4 @@ const editor = new MastraEditor({
 - [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox)
 - [DockerSandbox reference](https://mastra.ai/integrations/sandboxes/docker)
 - [LocalSandbox reference](https://mastra.ai/reference/workspace/local-sandbox)
-- [Sandbox](https://mastra.ai/docs/workspace/sandbox)
+- [Sandbox](https://mastra.ai/docs/sandbox/overview)

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`                                                                                   |
@@ -72,10 +74,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 +90,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 +130,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 +179,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 349 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).
 
@@ -106,6 +106,7 @@ ANTHROPIC_API_KEY=ant-...
 | `deepseek/deepseek-v4-flash-0731`                          |
 | `deepseek/deepseek-v4-pro`                                 |
 | `deepseek/deepseek-v4-pro-0813`                            |
+| `dots-studio/dots-3-note-preview:free`                     |
 | `google/gemini-2.5-flash`                                  |
 | `google/gemini-2.5-flash-image`                            |
 | `google/gemini-2.5-flash-lite`                             |
@@ -340,6 +341,7 @@ ANTHROPIC_API_KEY=ant-...
 | `qwen/qwen3.7-max`                                         |
 | `qwen/qwen3.7-plus`                                        |
 | `qwen/qwen3.8-2.4t-a95b`                                   |
+| `qwen/qwen3.8-27b`                                         |
 | `qwen/qwen3.8-max`                                         |
 | `rekaai/reka-edge`                                         |
 | `rekaai/reka-flash-3`                                      |
@@ -384,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`                                        |