@mastra/mcp-docs-server 1.2.19-alpha.15 → 1.2.19-alpha.16

package/.docs/docs/channels.md

@@ -82,7 +82,7 @@ For example, a Slack adapter on an agent with the `your-agent` ID uses:
 /api/agents/your-agent/channels/slack/webhook
 ```
 
-Point the platform's webhook, event, or interactions URL to this path. Follow the guide for your platform or the [Chat SDK docs](https://chat-sdk.dev/adapters).
+Point the platform's webhook, event, or interactions URL to this path. Follow the guide for your platform or the [Chat SDK docs](https://chat-sdk.dev/adapters). The webhook acknowledges the request before the agent finishes responding. See [Error handling and delivery](#error-handling-and-delivery) for what happens when verification or a handler fails.
 
 During local development, platform webhooks need a public URL to reach your local server. Use a tunnel like [cloudflared](https://github.com/cloudflare/cloudflared) or [ngrok](https://ngrok.com/) to expose your server, `localhost:4111` by default:
 
@@ -215,6 +215,32 @@ Add only JSON-serializable, non-sensitive values. Signal metadata may be stored
 
 Use `requestContext` for run-scoped configuration, such as credentials for a message that starts a run. Use `signalMetadata` for context that must stay attached to one message, including messages delivered to an active run.
 
+## Error handling and delivery
+
+A channel webhook acknowledges the platform before the agent finishes, so a `200` response means "received", not "answered". Before that acknowledgment, the adapter rejects bad requests synchronously (`401` for failed verification, `400` for an unparseable body, `503` for transient state failures) and the platform redelivers on non-`2xx` responses per its own policy. After the `200`, the platform never retries and Mastra owns errors. The default handler catches agent-run failures and posts an error message to the thread (customize it with `formatError`, which defaults to `❌ Error: {message}`). A custom handler that throws is only logged by Chat SDK, so nothing is posted or retried. Catch failures in custom handlers yourself:
+
+```typescript
+channels: {
+  adapters: {
+    slack: createSlackAdapter(),
+  },
+  handlers: {
+    onDirectMessage: async (thread, message, defaultHandler, ctx) => {
+      try {
+        ctx.signalMetadata.ticketId = await lookupTicket(message)
+      } catch (error) {
+        ctx.mastra?.getLogger().error('Ticket lookup failed', { error })
+        await thread.post('Something went wrong looking up your ticket. Try again in a moment.')
+        return
+      }
+      await defaultHandler(thread, message)
+    },
+  },
+},
+```
+
+Platform retries also mean the same event can arrive more than once. Adapters deduplicate redelivered events using channel state, so configure [storage](https://mastra.ai/docs/storage) to keep deduplication reliable across restarts. Deduplication is best effort, so keep side effects in custom handlers idempotent so a duplicate that slips through doesn't repeat work like creating a ticket.
+
 ## Multimodal content
 
 Models like Gemini can process images, video, and audio natively. Combine `inlineMedia` and `inlineLinks` to let users share rich content with your agent across platforms:

package/.docs/docs/memory/semantic-recall.md

@@ -350,6 +350,25 @@ const agent = new Agent({
 })
 ```
 
+FastEmbed also exposes the multilingual E5 model for non-English content. E5 is asymmetric, so it's exposed as two models: `multilingualE5LargePassage` for text you index and `multilingualE5LargeQuery` for search text.
+
+```ts
+import { Memory } from '@mastra/memory'
+import { Agent } from '@mastra/core/agent'
+import { fastembed } from '@mastra/fastembed'
+
+const agent = new Agent({
+  id: 'agent',
+  memory: new Memory({
+    embedder: fastembed.multilingualE5LargePassage,
+  }),
+})
+```
+
+Memory uses a single embedder for both storing and recalling messages, so pick one of the two models and use it consistently. Use the paired `multilingualE5LargeQuery` model only where you control both sides of the pipeline, such as a RAG workflow that indexes with the passage model and searches with the query model.
+
+Multilingual E5 produces 1024-dimensional vectors. Your vector index must be created with matching dimensions, and E5 vectors can't be mixed with vectors from another embedder in the same index.
+
 ## PostgreSQL index optimization
 
 When using PostgreSQL as your vector store, you can optimize semantic recall performance by configuring the vector index. This is particularly important for large-scale deployments with thousands of messages.

package/.docs/docs/observability/metrics/overview.md

@@ -2,30 +2,38 @@
 
 # Metrics
 
-Mastra automatically emits performance and usage metrics from traced execution. There's no manual instrumentation needed. Metrics are derived from spans as they complete.
+Mastra automatically derives metrics from spans as traced operations complete. No separate metric instrumentation is required.
 
-These categories of metrics are emitted automatically:
+Mastra emits:
 
-- **Duration metrics**: Execution time for agents, workflows, tools, model calls, and processors.
-- **Token usage metrics**: Input and output token counts broken down by type (text, cache, audio, image, reasoning).
-- **Cost estimation**: Estimated cost per model call based on an embedded pricing registry.
+- **Duration metrics** for agent runs, workflows, tools, model calls, and processors
+- **Token usage metrics** for model input and output, including detailed token categories when the provider reports them
+- **Cost estimates** calculated from token usage, provider, model, and an embedded pricing registry
 
-> **Note:** Metrics require an analytics-capable store for observability. Most relational databases (LibSQL, MSSQL) aren't supported for metrics. In-memory storage resets on restart.
->
-> For local development, use [DuckDB](https://duckdb.org/) through `@mastra/duckdb`. For production, use [ClickHouse](https://clickhouse.com/) through `@mastra/clickhouse`. `PostgresStoreVNext` with the observability domain enabled also supports metrics, but always provide a time range to avoid full partition scans.
->
-> Google Cloud Spanner supports metrics, but it's not recommended for heavy metrics workloads. The Spanner adapter disables metrics by default because metrics are write-heavy and scan-heavy. Set `disableMetrics: false` only for light workloads, or route metrics to an OLAP store.
+Metrics retain trace correlation context, so you can investigate a change in a chart by finding the related span. See the [Automatic metrics reference](https://mastra.ai/reference/observability/metrics/automatic-metrics) for metric names, labels, and cost fields.
 
 ## When to use metrics
 
 - Monitor latency across agents, tools, workflows, and model calls
-- Track token consumption and cost trends over time
-- Identify error-heavy agents or tools by comparing success and error rates
-- Compare performance before and after prompt, model, or code changes
+- Track token consumption and estimated cost over time
+- Compare success and error rates across agents or tools
+- Measure the effect of prompt, model, or code changes
 
-## Get started
+## Storage support
 
-Install the required packages:
+Metrics require an analytics-capable observability store:
+
+- **DuckDB** through `@mastra/duckdb` is recommended for local development.
+- **ClickHouse** through `@mastra/clickhouse` is recommended for high-volume production workloads.
+- **PostgresStoreVNext** supports metrics when its observability domain is enabled.
+- **In-memory storage** supports metrics, but its data is lost when the process restarts.
+- **Google Cloud Spanner** disables metrics by default. Set `disableMetrics: false` only for light workloads, or route metrics to a dedicated OLAP store.
+
+Other storage adapters, including LibSQL, MSSQL, and MongoDB, can store other observability signals but don't implement metric storage and queries.
+
+## Set up local metrics
+
+Install the observability, application storage, and DuckDB packages:
 
 **npm**:
 
@@ -51,7 +59,7 @@ yarn add @mastra/observability @mastra/libsql @mastra/duckdb
 bun add @mastra/observability @mastra/libsql @mastra/duckdb
 ```
 
-Then configure observability with a composite store that routes the observability domain to DuckDB:
+Configure a composite store that routes the observability domain to DuckDB:
 
 ```ts
 import { Mastra } from '@mastra/core/mastra'
@@ -83,37 +91,16 @@ export const mastra = new Mastra({
 })
 ```
 
-## Studio
-
-The Studio metrics dashboard visualizes all automatic metrics with KPI cards, detailed breakdowns, token usage timelines, and configurable time ranges. See [Studio observability](https://mastra.ai/docs/studio/observability) for a full walkthrough.
-
-## What Mastra measures
-
-Mastra emits three categories of metrics automatically:
+`MastraStorageExporter` persists metrics to the configured observability store and makes them available to Studio. Use `MastraPlatformExporter` instead, or alongside it, to send metrics to Mastra Platform.
 
-- **Duration**: Execution time in milliseconds for agents, workflows, tools, model calls, and processors.
-- **Token usage**: Input and output token counts, broken down by type (text, cache, audio, image, reasoning).
-- **Cost estimation**: Estimated cost per model call, based on an embedded pricing registry.
+## View and query metrics
 
-Each metric carries trace correlation context so you can drill from a dashboard spike to the exact span that caused it.
+Use the [Studio observability dashboard](https://mastra.ai/docs/studio/observability) to inspect KPI cards, breakdowns, and time-series charts. For custom dashboards and analysis, use the observability store, `@mastra/client-js`, HTTP endpoints, or CLI described in the [Metric queries reference](https://mastra.ai/reference/observability/metrics/queries).
 
-For the full list of metric names, labels, and cost fields, see the [Automatic metrics reference](https://mastra.ai/reference/observability/metrics/automatic-metrics).
+In production, always include a timestamp range in metric queries. Time bounds limit the data scanned and allow partitioned backends to skip unrelated partitions or chunks.
 
-## How automatic metrics work
+## Related
 
-Mastra auto-instruments agent runs, workflow steps, tool calls, and model generations as spans. When a span ends, the observability layer extracts metrics from it:
-
-1. **Duration**: Calculated from the span's start and end timestamps.
-2. **Token usage**: Extracted from the `usage` attribute on model generation spans.
-3. **Cost estimation**: Runs each token metric through an embedded pricing registry that matches by provider and model name.
-
-Before storage, all metric labels pass through a cardinality filter that blocks known high-cardinality values (such as trace IDs and UUIDs) to keep storage efficient. Metrics are then batched by an internal event buffer and flushed to storage by the `MastraStorageExporter`.
-
-## Next steps
-
-- [Automatic metrics reference](https://mastra.ai/reference/observability/metrics/automatic-metrics)
-- [Querying metrics](https://mastra.ai/docs/observability/metrics/querying)
-- [Tracing overview](https://mastra.ai/docs/observability/tracing/overview)
-- [Studio observability](https://mastra.ai/docs/studio/observability)
 - [Observability overview](https://mastra.ai/docs/observability/overview)
-- [MastraStorageExporter reference](https://mastra.ai/docs/observability/integrations/exporters/mastra-storage)
+- [Tracing overview](https://mastra.ai/docs/observability/tracing/overview)
+- [MastraStorageExporter](https://mastra.ai/docs/observability/integrations/exporters/mastra-storage)

package/.docs/docs/server/server-adapters.md

@@ -20,6 +20,7 @@ Server adapters let you run Mastra with your own HTTP server instead of the Hono
 
 Mastra currently provides these official server adapters:
 
+- [@mastra/elysia](https://mastra.ai/reference/server/elysia-adapter)
 - [@mastra/express](https://mastra.ai/reference/server/express-adapter)
 - [@mastra/hono](https://mastra.ai/reference/server/hono-adapter)
 - [@mastra/fastify](https://mastra.ai/reference/server/fastify-adapter)
@@ -32,8 +33,58 @@ You can build your own adapter, read [custom adapters](https://mastra.ai/docs/se
 
 Install the adapter for the framework of your choice.
 
+**Elysia**:
+
+**npm**:
+
+```bash
+npm install @mastra/elysia@latest elysia
+```
+
+**pnpm**:
+
+```bash
+pnpm add @mastra/elysia@latest elysia
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/elysia@latest elysia
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/elysia@latest elysia
+```
+
 **Express**:
 
+```bash
+npm install @mastra/elysia@latest elysia
+```
+
+**Hono**:
+
+```bash
+pnpm add @mastra/elysia@latest elysia
+```
+
+**Fastify**:
+
+```bash
+yarn add @mastra/elysia@latest elysia
+```
+
+**Koa**:
+
+```bash
+bun add @mastra/elysia@latest elysia
+```
+
+**NestJS**:
+
 **npm**:
 
 ```bash
@@ -58,31 +109,31 @@ yarn add @mastra/express@latest
 bun add @mastra/express@latest
 ```
 
-**Hono**:
+**Tab 7**:
 
 ```bash
 npm install @mastra/express@latest
 ```
 
-**Fastify**:
+**Tab 8**:
 
 ```bash
 pnpm add @mastra/express@latest
 ```
 
-**Koa**:
+**Tab 9**:
 
 ```bash
 yarn add @mastra/express@latest
 ```
 
-**NestJS**:
+**Tab 10**:
 
 ```bash
 bun add @mastra/express@latest
 ```
 
-**Tab 6**:
+**Tab 11**:
 
 **npm**:
 
@@ -108,31 +159,31 @@ yarn add @mastra/hono@latest
 bun add @mastra/hono@latest
 ```
 
-**Tab 7**:
+**Tab 12**:
 
 ```bash
 npm install @mastra/hono@latest
 ```
 
-**Tab 8**:
+**Tab 13**:
 
 ```bash
 pnpm add @mastra/hono@latest
 ```
 
-**Tab 9**:
+**Tab 14**:
 
 ```bash
 yarn add @mastra/hono@latest
 ```
 
-**Tab 10**:
+**Tab 15**:
 
 ```bash
 bun add @mastra/hono@latest
 ```
 
-**Tab 11**:
+**Tab 16**:
 
 **npm**:
 
@@ -158,31 +209,31 @@ yarn add @mastra/fastify@latest
 bun add @mastra/fastify@latest
 ```
 
-**Tab 12**:
+**Tab 17**:
 
 ```bash
 npm install @mastra/fastify@latest
 ```
 
-**Tab 13**:
+**Tab 18**:
 
 ```bash
 pnpm add @mastra/fastify@latest
 ```
 
-**Tab 14**:
+**Tab 19**:
 
 ```bash
 yarn add @mastra/fastify@latest
 ```
 
-**Tab 15**:
+**Tab 20**:
 
 ```bash
 bun add @mastra/fastify@latest
 ```
 
-**Tab 16**:
+**Tab 21**:
 
 **npm**:
 
@@ -208,31 +259,31 @@ yarn add @mastra/koa@latest
 bun add @mastra/koa@latest
 ```
 
-**Tab 17**:
+**Tab 22**:
 
 ```bash
 npm install @mastra/koa@latest
 ```
 
-**Tab 18**:
+**Tab 23**:
 
 ```bash
 pnpm add @mastra/koa@latest
 ```
 
-**Tab 19**:
+**Tab 24**:
 
 ```bash
 yarn add @mastra/koa@latest
 ```
 
-**Tab 20**:
+**Tab 25**:
 
 ```bash
 bun add @mastra/koa@latest
 ```
 
-**Tab 21**:
+**Tab 26**:
 
 **npm**:
 
@@ -258,25 +309,25 @@ yarn add @mastra/nestjs@latest
 bun add @mastra/nestjs@latest
 ```
 
-**Tab 22**:
+**Tab 27**:
 
 ```bash
 npm install @mastra/nestjs@latest
 ```
 
-**Tab 23**:
+**Tab 28**:
 
 ```bash
 pnpm add @mastra/nestjs@latest
 ```
 
-**Tab 24**:
+**Tab 29**:
 
 ```bash
 yarn add @mastra/nestjs@latest
 ```
 
-**Tab 25**:
+**Tab 30**:
 
 ```bash
 bun add @mastra/nestjs@latest
@@ -286,6 +337,25 @@ bun add @mastra/nestjs@latest
 
 Initialize your app as usual, then create a `MastraServer` by passing in the `app` and your main `mastra` instance from `src/mastra/index.ts`. Calling `init()` automatically registers Mastra middleware and all available endpoints. You can continue adding your own routes as normal, either before or after `init()`, and they’ll run alongside Mastra’s endpoints.
 
+**Elysia**:
+
+```typescript
+import { Elysia } from 'elysia'
+import { MastraServer } from '@mastra/elysia'
+import { mastra } from './mastra'
+
+const app = new Elysia()
+const server = new MastraServer({ app, mastra })
+
+await server.init()
+
+app.listen(4111)
+
+console.log('Server running on http://localhost:4111')
+```
+
+> **Note:** See the [Elysia Adapter](https://mastra.ai/reference/server/elysia-adapter) documentation for full configuration options.
+
 **Express**:
 
 ```typescript
@@ -466,7 +536,7 @@ You can add your own routes to the app alongside Mastra's routes.
 - When you want Mastra-managed auth and route metadata such as `requiresAuth`, prefer `registerApiRoute()`.
 - When you mount routes directly on the framework app, use the adapter's exported `createAuthMiddleware()` helper if those routes need Mastra auth.
 
-Visit "Adding custom routes" for [Express](https://mastra.ai/reference/server/express-adapter) and [Hono](https://mastra.ai/reference/server/hono-adapter) for more information.
+Visit "Adding custom routes" for [Elysia](https://mastra.ai/reference/server/elysia-adapter), [Express](https://mastra.ai/reference/server/express-adapter), and [Hono](https://mastra.ai/reference/server/hono-adapter) for more information.
 
 ## Route prefixes
 
@@ -607,7 +677,7 @@ When using adapters, configure these features directly with your framework. For
 
 Server adapters register MCP (Model Context Protocol) routes during `registerRoutes()` when MCP servers are configured in your Mastra instance. MCP allows external tools and services to connect to your Mastra server and interact with your agents.
 
-The adapter registers routes for both HTTP and SSE (Server-Sent Events) transports, enabling different client connection patterns.
+Most adapters register routes for both HTTP and SSE (Server-Sent Events) transports, enabling different client connection patterns. The Elysia adapter currently supports MCP HTTP transport only.
 
 ### Serverless mode
 
@@ -643,6 +713,7 @@ See [MCP](https://mastra.ai/docs/connections/mcp) for configuration details and
 
 ## Related
 
+- [Elysia Adapter](https://mastra.ai/reference/server/elysia-adapter) - Elysia-specific setup
 - [Hono Adapter](https://mastra.ai/reference/server/hono-adapter) - Hono-specific setup
 - [Express Adapter](https://mastra.ai/reference/server/express-adapter) - Express-specific setup
 - [NestJS Adapter](https://mastra.ai/reference/server/nestjs-adapter) - NestJS-specific setup

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

@@ -10,6 +10,7 @@ List of required environment variables for each model provider and gateway suppo
 | [Abacus](https://mastra.ai/models/providers/abacus)                                            | `abacus/*`                 | `ABACUS_API_KEY`                                                                                      |
 | [abliteration.ai](https://mastra.ai/models/providers/abliteration-ai)                          | `abliteration-ai/*`        | `ABLIT_KEY`                                                                                           |
 | [AgentRouter](https://mastra.ai/models/providers/agentrouter)                                  | `agentrouter/*`            | `AGENTROUTER_API_KEY`                                                                                 |
+| [Agnes AI](https://mastra.ai/models/providers/agnes)                                           | `agnes/*`                  | `AGNES_API_KEY`                                                                                       |
 | [AI-ROUTER](https://mastra.ai/models/providers/ai-router)                                      | `ai-router/*`              | `AI_ROUTER_API_KEY`                                                                                   |
 | [ai&](https://mastra.ai/models/providers/aiand)                                                | `aiand/*`                  | `AIAND_API_KEY`                                                                                       |
 | [AKI.IO](https://mastra.ai/models/providers/aki-io)                                            | `aki-io/*`                 | `AKI_IO_API_KEY`                                                                                      |
@@ -77,6 +78,7 @@ 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`                                                                              |
+| [IteraCompute](https://mastra.ai/models/providers/iteracompute)                                | `iteracompute/*`           | `ITERACOMPUTE_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`                                                                                      |
@@ -111,6 +113,7 @@ List of required environment variables for each model provider and gateway suppo
 | [NanoGPT](https://mastra.ai/models/providers/nano-gpt)                                         | `nano-gpt/*`               | `NANO_GPT_API_KEY`                                                                                    |
 | [NEAR AI Cloud](https://mastra.ai/models/providers/nearai)                                     | `nearai/*`                 | `NEARAI_API_KEY`                                                                                      |
 | [Nebius Token Factory](https://mastra.ai/models/providers/nebius)                              | `nebius/*`                 | `NEBIUS_API_KEY`                                                                                      |
+| [NeoSmith](https://mastra.ai/models/providers/neosmith)                                        | `neosmith/*`               | `NEOSMITH_API_KEY`                                                                                    |
 | [Neuralwatt](https://mastra.ai/models/providers/neuralwatt)                                    | `neuralwatt/*`             | `NEURALWATT_API_KEY`                                                                                  |
 | [Nova](https://mastra.ai/models/providers/nova)                                                | `nova/*`                   | `NOVA_API_KEY`                                                                                        |
 | [NovitaAI](https://mastra.ai/models/providers/novita-ai)                                       | `novita-ai/*`              | `NOVITA_API_KEY`                                                                                      |
@@ -144,6 +147,7 @@ List of required environment variables for each model provider and gateway suppo
 | [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`                                                           |
 | [STACKIT](https://mastra.ai/models/providers/stackit)                                          | `stackit/*`                | `STACKIT_API_KEY`                                                                                     |
+| [Standard Compute](https://mastra.ai/models/providers/standardcompute)                         | `standardcompute/*`        | `STANDARDCOMPUTE_API_KEY`                                                                             |
 | [StepFun (China)](https://mastra.ai/models/providers/stepfun)                                  | `stepfun/*`                | `STEPFUN_API_KEY`                                                                                     |
 | [StepFun (Global)](https://mastra.ai/models/providers/stepfun-ai)                              | `stepfun-ai/*`             | `STEPFUN_API_KEY`                                                                                     |
 | [StepFun Step Plan (China)](https://mastra.ai/models/providers/stepfun-step-plan)              | `stepfun-step-plan/*`      | `STEPFUN_API_KEY`                                                                                     |

package/.docs/models/gateways/netlify.md

@@ -2,7 +2,7 @@
 
 # Netlify
 
-Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 233 models through Mastra's model router.
+Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 234 models through Mastra's model router.
 
 Learn more in the [Netlify documentation](https://docs.netlify.com/build/ai-gateway/overview/).
 
@@ -169,6 +169,7 @@ ANTHROPIC_API_KEY=ant-...
 | `openrouter/mistralai/ministral-8b-2512`                              |
 | `openrouter/mistralai/mistral-large-2512`                             |
 | `openrouter/mistralai/mistral-medium-3`                               |
+| `openrouter/mistralai/mistral-medium-3-5`                             |
 | `openrouter/mistralai/mistral-medium-3.1`                             |
 | `openrouter/mistralai/mistral-nemo`                                   |
 | `openrouter/mistralai/mistral-small-24b-instruct-2501`                |

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 355 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 357 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -170,7 +170,9 @@ ANTHROPIC_API_KEY=ant-...
 | `minimax/minimax-m2.1`                                     |
 | `minimax/minimax-m2.5`                                     |
 | `minimax/minimax-m2.7`                                     |
+| `minimax/minimax-m2.7:free`                                |
 | `minimax/minimax-m3`                                       |
+| `minimax/minimax-m3:free`                                  |
 | `mistralai/codestral-2508`                                 |
 | `mistralai/devstral-2512`                                  |
 | `mistralai/ministral-14b-2512`                             |

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 348 models through Mastra's model router.
+Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 351 models through Mastra's model router.
 
 Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
 
@@ -75,6 +75,7 @@ ANTHROPIC_API_KEY=ant-...
 | `alibaba/wan-v2.6-t2v`                    |
 | `alibaba/wan-v2.7-r2v`                    |
 | `alibaba/wan-v2.7-t2v`                    |
+| `alibaba/wan-v3.0-video`                  |
 | `amazon/nova-2-lite`                      |
 | `amazon/nova-lite`                        |
 | `amazon/nova-micro`                       |
@@ -203,8 +204,10 @@ ANTHROPIC_API_KEY=ant-...
 | `minimax/minimax-m2.5`                    |
 | `minimax/minimax-m2.5-highspeed`          |
 | `minimax/minimax-m2.7`                    |
+| `minimax/minimax-m2.7-free`               |
 | `minimax/minimax-m2.7-highspeed`          |
 | `minimax/minimax-m3`                      |
+| `minimax/minimax-m3-free`                 |
 | `mistral/codestral`                       |
 | `mistral/codestral-embed`                 |
 | `mistral/devstral-2`                      |
@@ -233,7 +236,6 @@ ANTHROPIC_API_KEY=ant-...
 | `nvidia/nemotron-3-super-120b-a12b`       |
 | `nvidia/nemotron-3-ultra-550b-a55b`       |
 | `nvidia/nemotron-3.5-lightning`           |
-| `nvidia/nemotron-3.5-lightning-free`      |
 | `nvidia/nemotron-nano-12b-v2-vl`          |
 | `nvidia/nemotron-nano-9b-v2`              |
 | `openai/gpt-3.5-turbo`                    |
@@ -289,6 +291,7 @@ ANTHROPIC_API_KEY=ant-...
 | `openai/gpt-image-2`                      |
 | `openai/gpt-oss-120b`                     |
 | `openai/gpt-oss-20b`                      |
+| `openai/gpt-oss-safeguard-120b`           |
 | `openai/gpt-oss-safeguard-20b`            |
 | `openai/gpt-realtime-1.5`                 |
 | `openai/gpt-realtime-2`                   |

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 6819 models from 182 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 6837 models from 186 providers through a single API.
 
 ## Features