@mastra/mcp-docs-server 1.2.7-alpha.12 → 1.2.7-alpha.16

package/.docs/docs/agents/using-tools.md

@@ -4,6 +4,8 @@
 
 Agents use tools to call APIs, query databases, or run custom functions from your codebase. Tools give agents capabilities beyond language generation by providing structured access to data and performing clearly defined operations. You can also load tools from remote [MCP servers](https://mastra.ai/docs/mcp/overview) to expand an agent's capabilities.
 
+**For AI agents:** Run `npx mastra api tool execute weather-tool '{"location":"San Francisco"}'` to test this tool directly instead of writing a temporary script. The command requires a running Mastra server; start the local server with `npx mastra dev`, or pass the reachable server's base URL with `--url`. Run `npx mastra api tool execute --schema` before constructing different input. Install Mastra's skill with `npx skills add mastra-ai/skills --skill mastra` for complete API CLI discovery, targeting, schema, authentication, and error-handling guidance.
+
 ## When to use tools
 
 Use tools when an agent needs additional context or information from remote resources, or when it needs to run code that performs a specific operation. This includes tasks a model can't reliably handle on its own, such as fetching live data or returning consistent, well-defined outputs.

package/.docs/docs/evals/datasets/overview.md

@@ -6,6 +6,8 @@
 
 Datasets are collections of test cases that you run experiments against to measure how well your agents and workflows perform. Each mutation creates a new version, so you can reproduce past experiments exactly. Pair datasets with [scorers](https://mastra.ai/docs/evals/overview) to track quality across prompts, models, or code changes.
 
+**For AI agents:** Run `npx mastra api dataset create '{"name":"translation-pairs"}'` to create a dataset directly instead of opening Studio or writing a temporary script. The command requires a running Mastra server with a storage adapter that supports datasets; start the local server with `npx mastra dev`, or pass the reachable server's base URL with `--url`. Run `npx mastra api dataset create --schema` before adding different dataset fields. Install Mastra's skill with `npx skills add mastra-ai/skills --skill mastra` for complete API CLI discovery, targeting, schema, authentication, and error-handling guidance.
+
 ## Usage
 
 ### Configure storage

package/.docs/docs/evals/datasets/running-experiments.md

@@ -6,6 +6,8 @@
 
 An experiment runs every item in a dataset through a target (an agent, a workflow, or a scorer) and then optionally scores the outputs. Use a scorer as the target when you want to evaluate an LLM judge itself. Results are persisted to storage so you can compare runs across different prompts, models, or code changes.
 
+**For AI agents:** Run `npx mastra api experiment run dataset_123 '{"name":"translation-baseline"}'` to start an experiment directly instead of opening Studio or writing a temporary script. Use a dataset ID returned by `npx mastra api dataset list` in place of the sample ID. The command requires a running Mastra server with dataset storage and registered experiment targets; start the local server with `npx mastra dev`, or pass the reachable server's base URL with `--url`. Run `npx mastra api experiment run --schema` before constructing different input, and get user approval before starting an experiment because it can make model calls. Install Mastra's skill with `npx skills add mastra-ai/skills --skill mastra` for complete API CLI discovery, targeting, schema, authentication, and error-handling guidance.
+
 ## Basic experiment
 
 Call [`startExperiment()`](https://mastra.ai/reference/datasets/startExperiment) with a target and scorers:

package/.docs/docs/evals/gates-and-verdicts.md

@@ -66,6 +66,23 @@ const result = await runEvals({
 
 Any scorer works as a gate. Quick Checks are a natural fit because they return binary 1/0 scores. Visit [runEvals() reference](https://mastra.ai/reference/evals/run-evals) for the full parameter and return type documentation.
 
+### Gate-only runs
+
+`scorers` is optional when at least one gate is provided. This is useful for deterministic CI checks where you only care about pass/fail gates and don't need to track any quality metrics.
+
+```typescript
+import { runEvals } from '@mastra/core/evals'
+import { checks } from '@mastra/evals/checks'
+
+const result = await runEvals({
+  data: [{ input: 'What is the weather in Brooklyn?' }],
+  target: weatherAgent,
+  gates: [checks.calledTool('get_weather'), checks.noToolErrors()],
+})
+```
+
+You must provide at least one scorer or gate — a run with neither throws an error.
+
 ## Thresholds
 
 Wrap a scorer in `{ scorer, threshold }` to set pass/fail bounds. The threshold is compared against the scorer's average score across all data items.

package/.docs/docs/getting-started/file-based-agents.md

@@ -6,13 +6,15 @@
 
 > **Beta:** This feature is in beta. Breaking changes may occur without a major version bump until the API is stable.
 
-File-based agents are a new, convention-based way to define Mastra agents and project primitives from a directory structure under `src/mastra/`. You'll like this approach if you want an agent to be self-contained, easy to scan and extend.
+File-based agents are an experimental, convention-based way to define [Mastra agents](https://mastra.ai/docs/agents/overview) and the primitives they use in files under `src/mastra/`, instead of registering them manually on your [`Mastra`](https://mastra.ai/reference/core/mastra-class) instance.
 
-Adopting this feature is a fundamental decision about how to structure your project. You'll need to follow the file conventions and be aware of its limitations, namely that you can't use dynamic configuration or runtime wiring.
+This approach reduces glue code and makes the file system itself a direct representation of your [project structure](https://mastra.ai/reference/project-structure), so both you and your coding agent can understand it at a glance.
 
-However, you can use file-based agents, code-defined agents, or both in the same project. All Mastra docs currently use code-first examples. As file-based agents mature, more examples may use this structure where it makes sense.
+You can build your entire project with file-based agents or combine this approach with agents and other primitives defined directly in code, making it easy to adopt incrementally.
 
-Under the hood Mastra is assembling code-defined agents and primitives from the files you create. So explanations and concepts you can find on other docs pages apply to file-based agents as well.
+File-based agents have some limitations while in beta. Not every Mastra feature can be defined in a file yet, and they are not the best fit for dynamic configuration or runtime wiring. When needed, you can define agents and related primitives directly in code.
+
+> **Note:** All Mastra documentation currently shows agents and primitives defined directly in code. File-based agents use the same underlying concepts and APIs, so the guidance elsewhere in the docs still applies. As file-based agents mature, more examples may use this structure where appropriate.
 
 ## Basic layout
 
@@ -78,6 +80,7 @@ Map each primitive or feature to its file convention:
 | [Logger](https://mastra.ai/reference/file-based-agents/logger)                   | `src/mastra/logger.ts`                                                                    |
 | [Server config](https://mastra.ai/reference/file-based-agents/server)            | `src/mastra/server.ts`                                                                    |
 | [Studio config](https://mastra.ai/reference/file-based-agents/studio)            | `src/mastra/studio.ts`                                                                    |
+| [Schedules](https://mastra.ai/docs/long-running-agents/schedules)                | Not yet file-based — create at runtime with `mastra.schedules.create()`                   |
 
 ## Discovery lifecycle
 

package/.docs/docs/mastra-platform/github.md

@@ -9,7 +9,7 @@ The GitHub integration links a Mastra platform project to a GitHub repository. W
 After a repository is linked, the platform:
 
 - Builds and deploys Studio and Server on every push to the configured branches.
-- Provisions managed databases and the Mastra gateway API key for projects created from a template.
+- Provisions managed databases and the Gateway API key for projects created from a template.
 - Surfaces commit, branch, and pull request context on each deploy.
 - Reports build status back to GitHub as check runs and to the project dashboard with live status badges and inline logs.
 
@@ -59,7 +59,7 @@ Templates are the fastest way to get started. The platform creates a new reposit
 
 3. Configure the template's managed database requirements. Templates can declare required databases (such as Turso or Neon) and you pick the provider and region per requirement.
 
-4. Add any template-specific environment variables (for example, AI provider API keys). The platform seeds `MASTRA_GATEWAY_API_KEY` and `MASTRA_PLATFORM_ACCESS_TOKEN` automatically so that template code that talks to the Mastra gateway works on the first deploy.
+4. Add any template-specific environment variables (for example, AI provider API keys). The platform seeds `MASTRA_GATEWAY_API_KEY` and `MASTRA_PLATFORM_ACCESS_TOKEN` automatically so that template code that talks to the Gateway works on the first deploy.
 
 5. Select **Create project**. The platform creates the repository, writes a `.mastra-project.json` config file into it, provisions the managed databases, and triggers the initial Studio and Server deploys.
 

package/.docs/docs/observability/logging.md

@@ -6,6 +6,8 @@ Mastra's logging system captures function execution, input data, and output resp
 
 When deploying to the Mastra platform, logs are shown in the dashboard. In self-hosted or custom environments, logs can be directed to files or external services depending on the configured transports.
 
+**For AI agents:** Run `npx mastra api log list '{"level":"error","page":0,"perPage":50}'` to inspect recent error logs directly instead of opening Studio or writing a temporary script. The command requires a running Mastra server with observability logging configured; start the local server with `npx mastra dev`, or pass the reachable server's base URL with `--url`. Run `npx mastra api log list --schema` before constructing different filters. Install Mastra's skill with `npx skills add mastra-ai/skills --skill mastra` for complete API CLI discovery, targeting, schema, authentication, and error-handling guidance.
+
 ## Configuring logs with `PinoLogger`
 
 When [initializing a new Mastra project](https://mastra.ai/guides/getting-started/quickstart) using the CLI, `PinoLogger` is included by default.

package/.docs/docs/observability/metrics/querying.md

@@ -4,6 +4,8 @@
 
 Mastra exposes the same five OLAP queries (`getMetricAggregate`, `getMetricBreakdown`, `getMetricTimeSeries`, `getMetricPercentiles`, and discovery helpers) through three surfaces: an in-process store accessor, the runtime HTTP API, and the `mastra api metric` CLI. All three accept the same Zod-validated input shapes, so you can move from a one-off CLI investigation to a programmatic dashboard tool without re-learning the API.
 
+**For AI agents:** Run `npx mastra api metric aggregate '{"name":"mastra_agent_duration_ms","aggregation":"avg"}'` to query average agent latency directly instead of writing a temporary script. Querying local metrics requires a running Mastra server with an OLAP-capable observability store; start the local server with `npx mastra dev`, or pass the reachable server's base URL with `--url`. Run `npx mastra api metric aggregate --schema` before constructing a different query. Install Mastra's skill with `npx skills add mastra-ai/skills --skill mastra` for complete API CLI discovery, targeting, schema, authentication, and error-handling guidance.
+
 ## When to use this
 
 - Build a custom dashboard or KPI tile alongside Studio.

package/.docs/docs/observability/tracing/overview.md

@@ -6,6 +6,8 @@ Tracing is the observability signal that records how a request moves through age
 
 This page focuses on trace-specific concepts: span hierarchy, sampling, metadata, filtering, trace IDs, and third-party trace context.
 
+**For AI agents:** Run `npx mastra api trace list '{"page":0,"perPage":20}'` to inspect recent traces directly instead of opening Studio or writing a temporary script. The command requires a running Mastra server with observability configured; start the local server with `npx mastra dev`, or pass the reachable server's base URL with `--url`. Run `npx mastra api trace list --schema` before constructing different filters. Install Mastra's skill with `npx skills add mastra-ai/skills --skill mastra` for complete API CLI discovery, targeting, schema, authentication, and error-handling guidance.
+
 ## When to use tracing
 
 - Debug unexpected agent or workflow behavior by inspecting the full execution path.

package/.docs/docs/workflows/overview.md

@@ -4,7 +4,7 @@
 
 Workflows let you define complex sequences of tasks using clear, structured steps rather than relying on the reasoning of a single agent. They give you full control over how tasks are broken down, how data moves between them, and what gets executed when. Workflows run using the built-in execution engine by default, or can be deployed to [workflow runners](https://mastra.ai/docs/deployment/workflow-runners) like Inngest for managed infrastructure.
 
-![Workflows overview](/assets/images/workflows-overview-4509c840549a01ff7386daa5101bda26.jpg)
+**For AI agents:** Run `npx mastra api workflow run start test-workflow '{"inputData":{"message":"Hello, world!"}}'` to start this workflow directly instead of writing a temporary script. The command requires a running Mastra server; start the local server with `npx mastra dev`, or pass the reachable server's base URL with `--url`. Run `npx mastra api workflow run start --schema` before constructing different input. Install Mastra's skill with `npx skills add mastra-ai/skills --skill mastra` for complete API CLI discovery, targeting, schema, authentication, and error-handling guidance.
 
 ## When to use workflows
 

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

@@ -9,6 +9,7 @@ List of required environment variables for each model provider and gateway suppo
 | [302.AI](https://mastra.ai/models/providers/302ai)                                             | `302ai/*`                  | `302AI_API_KEY`                                                                                       |
 | [Abacus](https://mastra.ai/models/providers/abacus)                                            | `abacus/*`                 | `ABACUS_API_KEY`                                                                                      |
 | [abliteration.ai](https://mastra.ai/models/providers/abliteration-ai)                          | `abliteration-ai/*`        | `ABLIT_KEY`                                                                                           |
+| [AI-ROUTER](https://mastra.ai/models/providers/ai-router)                                      | `ai-router/*`              | `AI_ROUTER_API_KEY`                                                                                   |
 | [Alibaba](https://mastra.ai/models/providers/alibaba)                                          | `alibaba/*`                | `DASHSCOPE_API_KEY`                                                                                   |
 | [Alibaba (China)](https://mastra.ai/models/providers/alibaba-cn)                               | `alibaba-cn/*`             | `DASHSCOPE_API_KEY`                                                                                   |
 | [Alibaba Coding Plan](https://mastra.ai/models/providers/alibaba-coding-plan)                  | `alibaba-coding-plan/*`    | `ALIBABA_CODING_PLAN_API_KEY`                                                                         |
@@ -23,6 +24,7 @@ List of required environment variables for each model provider and gateway suppo
 | [Bailing](https://mastra.ai/models/providers/bailing)                                          | `bailing/*`                | `BAILING_API_TOKEN`                                                                                   |
 | [Baseten](https://mastra.ai/models/providers/baseten)                                          | `baseten/*`                | `BASETEN_API_KEY`                                                                                     |
 | [Berget.AI](https://mastra.ai/models/providers/berget)                                         | `berget/*`                 | `BERGET_API_KEY`                                                                                      |
+| [Blue Claw](https://mastra.ai/models/providers/blueclaw)                                       | `blueclaw/*`               | `BLUECLAW_API_KEY`                                                                                    |
 | [Cerebras](https://mastra.ai/models/providers/cerebras)                                        | `cerebras/*`               | `CEREBRAS_API_KEY`                                                                                    |
 | [Chutes](https://mastra.ai/models/providers/chutes)                                            | `chutes/*`                 | `CHUTES_API_KEY`                                                                                      |
 | [Clarifai](https://mastra.ai/models/providers/clarifai)                                        | `clarifai/*`               | `CLARIFAI_PAT`                                                                                        |
@@ -33,11 +35,13 @@ List of required environment variables for each model provider and gateway suppo
 | [CrofAI](https://mastra.ai/models/providers/crof)                                              | `crof/*`                   | `CROF_API_KEY`                                                                                        |
 | [CrossModel](https://mastra.ai/models/providers/crossmodel)                                    | `crossmodel/*`             | `CROSSMODEL_API_KEY`                                                                                  |
 | [D.Run (China)](https://mastra.ai/models/providers/drun)                                       | `drun/*`                   | `DRUN_API_KEY`                                                                                        |
+| [DaoXE](https://mastra.ai/models/providers/daoxe)                                              | `daoxe/*`                  | `DAOXE_API_KEY`                                                                                       |
 | [Databricks](https://mastra.ai/models/providers/databricks)                                    | `databricks/*`             | `DATABRICKS_HOST`, `DATABRICKS_TOKEN`                                                                 |
 | [Deep Infra](https://mastra.ai/models/providers/deepinfra)                                     | `deepinfra/*`              | `DEEPINFRA_API_KEY`                                                                                   |
 | [DeepSeek](https://mastra.ai/models/providers/deepseek)                                        | `deepseek/*`               | `DEEPSEEK_API_KEY`                                                                                    |
 | [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`                                                                                     |
 | [EmpirioLabs AI](https://mastra.ai/models/providers/empiriolabs)                               | `empiriolabs/*`            | `EMPIRIOLABS_API_KEY`                                                                                 |
 | [evroc](https://mastra.ai/models/providers/evroc)                                              | `evroc/*`                  | `EVROC_API_KEY`                                                                                       |
 | [FastRouter](https://mastra.ai/models/providers/fastrouter)                                    | `fastrouter/*`             | `FASTROUTER_API_KEY`                                                                                  |
@@ -56,6 +60,7 @@ List of required environment variables for each model provider and gateway suppo
 | [Inception](https://mastra.ai/models/providers/inception)                                      | `inception/*`              | `INCEPTION_API_KEY`                                                                                   |
 | [Inceptron](https://mastra.ai/models/providers/inceptron)                                      | `inceptron/*`              | `INCEPTRON_API_KEY`                                                                                   |
 | [Inference](https://mastra.ai/models/providers/inference)                                      | `inference/*`              | `INFERENCE_API_KEY`                                                                                   |
+| [InferX](https://mastra.ai/models/providers/inferx)                                            | `inferx/*`                 | `INFERX_API_KEY`                                                                                      |
 | [IO.NET](https://mastra.ai/models/providers/io-net)                                            | `io-net/*`                 | `IOINTELLIGENCE_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`                                                                                      |
@@ -69,6 +74,7 @@ List of required environment variables for each model provider and gateway suppo
 | [LMStudio](https://mastra.ai/models/providers/lmstudio)                                        | `lmstudio/*`               | `LMSTUDIO_API_KEY`                                                                                    |
 | [LongCat](https://mastra.ai/models/providers/longcat)                                          | `longcat/*`                | `LONGCAT_API_KEY`                                                                                     |
 | [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`                                                                                    |
 | [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`                                                                                     |
@@ -115,8 +121,10 @@ 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`                                                                                     |
-| [StepFun](https://mastra.ai/models/providers/stepfun)                                          | `stepfun/*`                | `STEPFUN_API_KEY`                                                                                     |
-| [StepFun AI](https://mastra.ai/models/providers/stepfun-ai)                                    | `stepfun-ai/*`             | `STEPFUN_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`                                                                                     |
+| [StepFun Step Plan (Global)](https://mastra.ai/models/providers/stepfun-ai-step-plan)          | `stepfun-ai-step-plan/*`   | `STEPFUN_API_KEY`                                                                                     |
 | [Subconscious](https://mastra.ai/models/providers/subconscious)                                | `subconscious/*`           | `SUBCONSCIOUS_API_KEY`                                                                                |
 | [submodel](https://mastra.ai/models/providers/submodel)                                        | `submodel/*`               | `SUBMODEL_INSTAGEN_ACCESS_KEY`                                                                        |
 | [Synthetic](https://mastra.ai/models/providers/synthetic)                                      | `synthetic/*`              | `SYNTHETIC_API_KEY`                                                                                   |

package/.docs/models/gateways/azure-openai.md

@@ -57,13 +57,13 @@ import { Mastra } from "@mastra/core";
 import { AzureOpenAIGateway } from "@mastra/core/llm";
 
 export const mastra = new Mastra({
-  gateways: [
-    new AzureOpenAIGateway({
+  gateways: {
+    "azure-openai": new AzureOpenAIGateway({
       resourceName: "my-openai-resource",
       apiKey: process.env.AZURE_API_KEY!,
       deployments: ["gpt-5-4-prod", "gpt-5-4-mini-dev"],
     }),
-  ],
+  },
 });
 ```
 
@@ -76,8 +76,8 @@ import { Mastra } from "@mastra/core";
 import { AzureOpenAIGateway } from "@mastra/core/llm";
 
 export const mastra = new Mastra({
-  gateways: [
-    new AzureOpenAIGateway({
+  gateways: {
+    "azure-openai": new AzureOpenAIGateway({
       resourceName: "my-openai-resource",
       apiKey: process.env.AZURE_API_KEY!,
       management: {
@@ -88,7 +88,7 @@ export const mastra = new Mastra({
         resourceGroup: "my-resource-group",
       },
     }),
-  ],
+  },
 });
 ```
 
@@ -106,8 +106,8 @@ import { Mastra } from "@mastra/core";
 import { AzureOpenAIGateway } from "@mastra/core/llm";
 
 export const mastra = new Mastra({
-  gateways: [
-    new AzureOpenAIGateway({
+  gateways: {
+    "azure-openai": new AzureOpenAIGateway({
       resourceName: "my-openai-resource",
       authentication: {
         type: "entraId",
@@ -115,7 +115,7 @@ export const mastra = new Mastra({
       },
       deployments: ["gpt-5-4-prod", "gpt-5-4-mini-dev"],
     }),
-  ],
+  },
 });
 ```
 
@@ -138,12 +138,12 @@ import { Mastra } from "@mastra/core";
 import { AzureOpenAIGateway } from "@mastra/core/llm";
 
 export const mastra = new Mastra({
-  gateways: [
-    new AzureOpenAIGateway({
+  gateways: {
+    "azure-openai": new AzureOpenAIGateway({
       resourceName: "my-openai-resource",
       apiKey: process.env.AZURE_API_KEY!,
     }),
-  ],
+  },
 });
 ```
 
@@ -156,14 +156,14 @@ import { Mastra } from "@mastra/core";
 import { AzureOpenAIGateway } from "@mastra/core/llm";
 
 export const mastra = new Mastra({
-  gateways: [
-    new AzureOpenAIGateway({
+  gateways: {
+    "azure-openai": new AzureOpenAIGateway({
       resourceName: "my-openai-resource",
       apiKey: process.env.AZURE_API_KEY!,
       useResponsesAPI: true,
       deployments: ["my-gpt-5-4-deployment"],
     }),
-  ],
+  },
 });
 ```
 

package/.docs/models/gateways/mastra.md

@@ -2,9 +2,9 @@
 
 # ![Mastra logo](https://mastra.ai/brand/logo.svg)Mastra
 
-The Mastra Memory Gateway is an OpenAI-compatible API proxy with built-in [Observational Memory](https://gateway.mastra.ai/docs/features#observational-memory). Point any HTTP client, SDK, or framework at the gateway and every conversation is automatically remembered without any memory management code.
+The Gateway is an OpenAI-compatible API proxy with built-in [Observational Memory](https://gateway.mastra.ai/docs/features#observational-memory). Point any HTTP client, SDK, or framework at the gateway and every conversation is automatically remembered without any memory management code.
 
-Learn more in the [Memory Gateway documentation](https://gateway.mastra.ai/docs).
+Learn more in the [Gateway documentation](https://gateway.mastra.ai/docs).
 
 ## Get an API key
 

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 345 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 344 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -142,7 +142,6 @@ ANTHROPIC_API_KEY=ant-...
 | `liquid/lfm-2.5-1.2b-instruct:free`                             |
 | `liquid/lfm-2.5-1.2b-thinking:free`                             |
 | `mancer/weaver`                                                 |
-| `meta-llama/llama-3-8b-instruct`                                |
 | `meta-llama/llama-3.1-70b-instruct`                             |
 | `meta-llama/llama-3.1-8b-instruct`                              |
 | `meta-llama/llama-3.2-11b-vision-instruct`                      |

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 306 models through Mastra's model router.
+Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 309 models through Mastra's model router.
 
 Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
 
@@ -112,6 +112,7 @@ ANTHROPIC_API_KEY=ant-...
 | `bytedance/seedream-4.0`                 |
 | `bytedance/seedream-4.5`                 |
 | `bytedance/seedream-5.0-lite`            |
+| `bytedance/seedream-5.0-pro`             |
 | `cohere/command-a`                       |
 | `cohere/embed-v4.0`                      |
 | `cohere/rerank-v3.5`                     |
@@ -164,8 +165,10 @@ ANTHROPIC_API_KEY=ant-...
 | `klingai/kling-v3.0-i2v`                 |
 | `klingai/kling-v3.0-motion-control`      |
 | `klingai/kling-v3.0-t2v`                 |
+| `kwaipilot/kat-coder-air-v2.5`           |
 | `kwaipilot/kat-coder-pro-v1`             |
 | `kwaipilot/kat-coder-pro-v2`             |
+| `kwaipilot/kat-coder-pro-v2.5`           |
 | `meituan/longcat-flash-chat`             |
 | `meituan/longcat-flash-thinking-2601`    |
 | `meta/llama-3.1-70b`                     |

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

package/.docs/models/providers/ai-router.md

@@ -0,0 +1,77 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![AI-ROUTER logo](https://models.dev/logos/ai-router.svg)AI-ROUTER
+
+Access 5 AI-ROUTER models through Mastra's model router. Authentication is handled automatically using the `AI_ROUTER_API_KEY` environment variable.
+
+Learn more in the [AI-ROUTER documentation](https://ai-router.dev/openai-compatible-api-gateway/).
+
+```bash
+AI_ROUTER_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "ai-router/gpt-5.4"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [AI-ROUTER documentation](https://ai-router.dev/openai-compatible-api-gateway/) for details.
+
+## Models
+
+| Model                     | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `ai-router/gpt-5.4`       | 1.1M    |       |           |       |       |       | $3         | $15         |
+| `ai-router/gpt-5.5`       | 1.1M    |       |           |       |       |       | $5         | $30         |
+| `ai-router/gpt-5.6-luna`  | 1.1M    |       |           |       |       |       | $1         | $6          |
+| `ai-router/gpt-5.6-sol`   | 1.1M    |       |           |       |       |       | $5         | $30         |
+| `ai-router/gpt-5.6-terra` | 1.1M    |       |           |       |       |       | $3         | $15         |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.ai-router.dev/v1",
+    id: "ai-router/gpt-5.4",
+    apiKey: process.env.AI_ROUTER_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "ai-router/gpt-5.6-terra"
+      : "ai-router/gpt-5.4";
+  }
+});
+```

package/.docs/models/providers/ambient.md

@@ -2,7 +2,7 @@
 
 # ![Ambient logo](https://models.dev/logos/ambient.svg)Ambient
 
-Access 3 Ambient models through Mastra's model router. Authentication is handled automatically using the `AMBIENT_API_KEY` environment variable.
+Access 4 Ambient models through Mastra's model router. Authentication is handled automatically using the `AMBIENT_API_KEY` environment variable.
 
 Learn more in the [Ambient documentation](https://ambient.xyz).
 
@@ -37,8 +37,9 @@ for await (const chunk of stream) {
 | Model                               | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | ----------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
 | `ambient/moonshotai/kimi-k2.6`      | 262K    |       |           |       |       |       | $0.95      | $4          |
-| `ambient/moonshotai/kimi-k2.7-code` | 262K    |       |           |       |       |       | $0.75      | $4          |
+| `ambient/moonshotai/kimi-k2.7-code` | 262K    |       |           |       |       |       | $0.84      | $4          |
 | `ambient/zai-org/GLM-5.1-FP8`       | 203K    |       |           |       |       |       | $1         | $4          |
+| `ambient/zai-org/GLM-5.2-FP8`       | 203K    |       |           |       |       |       | $1         | $4          |
 
 ## Advanced configuration
 
@@ -68,7 +69,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "ambient/zai-org/GLM-5.1-FP8"
+      ? "ambient/zai-org/GLM-5.2-FP8"
       : "ambient/moonshotai/kimi-k2.6";
   }
 });

package/.docs/models/providers/blueclaw.md

@@ -0,0 +1,74 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![Blue Claw logo](https://models.dev/logos/blueclaw.svg)Blue Claw
+
+Access 2 Blue Claw models through Mastra's model router. Authentication is handled automatically using the `BLUECLAW_API_KEY` environment variable.
+
+Learn more in the [Blue Claw documentation](https://blueclaw.network).
+
+```bash
+BLUECLAW_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "blueclaw/Qwen/Qwen3.6-35B-A3B-FP8"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Blue Claw documentation](https://blueclaw.network) for details.
+
+## Models
+
+| Model                               | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ----------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `blueclaw/Qwen/Qwen3.6-35B-A3B-FP8` | 131K    |       |           |       |       |       | —          | —           |
+| `blueclaw/Qwen3.6-27B`              | 197K    |       |           |       |       |       | —          | —           |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://openai.blueclaw.network/v1",
+    id: "blueclaw/Qwen/Qwen3.6-35B-A3B-FP8",
+    apiKey: process.env.BLUECLAW_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "blueclaw/Qwen3.6-27B"
+      : "blueclaw/Qwen/Qwen3.6-35B-A3B-FP8";
+  }
+});
+```

package/.docs/models/providers/crossmodel.md

@@ -2,7 +2,7 @@
 
 # ![CrossModel logo](https://models.dev/logos/crossmodel.svg)CrossModel
 
-Access 37 CrossModel models through Mastra's model router. Authentication is handled automatically using the `CROSSMODEL_API_KEY` environment variable.
+Access 40 CrossModel models through Mastra's model router. Authentication is handled automatically using the `CROSSMODEL_API_KEY` environment variable.
 
 Learn more in the [CrossModel documentation](https://www.crossmodel.ai/docs).
 
@@ -61,6 +61,9 @@ for await (const chunk of stream) {
 | `crossmodel/openai/gpt-5.4-nano`           | 400K    |       |           |       |       |       | $0.20      | $1          |
 | `crossmodel/openai/gpt-5.5`                | 1.1M    |       |           |       |       |       | $5         | $30         |
 | `crossmodel/openai/gpt-5.5-pro`            | 1.1M    |       |           |       |       |       | $30        | $180        |
+| `crossmodel/openai/gpt-5.6-luna`           | 1.1M    |       |           |       |       |       | $1         | $6          |
+| `crossmodel/openai/gpt-5.6-sol`            | 1.1M    |       |           |       |       |       | $5         | $30         |
+| `crossmodel/openai/gpt-5.6-terra`          | 1.1M    |       |           |       |       |       | $3         | $15         |
 | `crossmodel/qwen/qwen3.6-flash`            | 1.0M    |       |           |       |       |       | $0.19      | $1          |
 | `crossmodel/qwen/qwen3.6-plus`             | 1.0M    |       |           |       |       |       | $0.32      | $2          |
 | `crossmodel/qwen/qwen3.7-max`              | 1.0M    |       |           |       |       |       | $2         | $6          |