@mastra/mcp-docs-server 1.2.7-alpha.4 → 1.2.7-alpha.8

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

@@ -128,4 +128,8 @@ yarn dlx mastra api trace list
 bun x mastra api trace list
 ```
 
-For observability commands, the CLI targets the hosted observability API and can infer credentials from your project environment. See the [`mastra api` CLI reference](https://mastra.ai/reference/cli/mastra) for available observability commands, filtering, pagination, credential resolution, and direct `curl` examples.
+For observability commands, the CLI targets the hosted observability API and can infer credentials from your project environment. See the [`mastra api` CLI reference](https://mastra.ai/reference/cli/mastra) for available observability commands, filtering, pagination, credential resolution, and direct `curl` examples.
+
+## Related
+
+- 📹 [Mastra observability and Studio workshop](https://www.youtube.com/watch?v=dKO_a3RPra0)

package/.docs/docs/memory/observational-memory.md

@@ -714,4 +714,5 @@ In practical terms, OM replaces both working memory and message history, and has
 - [Memory Overview](https://mastra.ai/docs/memory/overview)
 - [Message History](https://mastra.ai/docs/memory/message-history)
 - [Memory Processors](https://mastra.ai/docs/memory/memory-processors)
-- [Mastra Code](https://code.mastra.ai/): A coding agent using Observational Memory
+- [Mastra Code](https://code.mastra.ai/): A coding agent using Observational Memory
+- 📹 [Mastra processors and Observational Memory workshop](https://www.youtube.com/watch?v=4Vpp7xQYvl0)

package/.docs/docs/memory/overview.md

@@ -15,6 +15,8 @@ If the combined memory exceeds the model's context limit, [memory processors](ht
 
 Memory results will be stored in one or more of your configured [storage providers](https://mastra.ai/docs/storage/overview).
 
+> **📹 Watch:** Watch [Mastra memory concepts](https://www.youtube.com/watch?v=18iIHQtIPmc) for a conceptual overview of the memory layers agents can use.
+
 ## When to use memory
 
 Use memory when your agent needs to maintain multi-turn conversations that reference prior exchanges, recall user preferences or facts from earlier in a session, or build context over time within a conversation thread. Skip memory for single-turn requests where each interaction is independent.

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

@@ -4,7 +4,7 @@
 
 If you ask your friend what they did last weekend, they will search in their memory for events associated with "last weekend" and then tell you what they did. That's sort of like how semantic recall works in Mastra.
 
-> **Watch 📹:** What semantic recall is, how it works, and how to configure it in Mastra → [YouTube (5 minutes)](https://youtu.be/UVZtK8cK8xQ)
+> **📹 Watch:** Watch [Mastra semantic recall](https://www.youtube.com/watch?v=UVZtK8cK8xQ\&pp=ygUVbWFzdHJhIHdvcmtpbmcgbWVtb3J5) to see how agents retrieve relevant messages from past conversations.
 
 ## How semantic recall works
 

package/.docs/docs/memory/working-memory.md

@@ -10,6 +10,8 @@ This is useful for maintaining ongoing state that's always relevant and should a
 
 If you use [Observational Memory](https://mastra.ai/docs/memory/observational-memory), `observationalMemory.observation.manageWorkingMemory` lets OM update working memory for the agent.
 
+> **📹 Watch:** Watch [Mastra working memory](https://www.youtube.com/watch?v=UMy_JHLf1n8\&pp=ygUVbWFzdHJhIHdvcmtpbmcgbWVtb3J5) to see how agents keep persistent user context available across interactions.
+
 Working memory can persist at two different scopes:
 
 - **Resource-scoped** (default): Memory persists across all conversation threads for the same user
@@ -43,9 +45,7 @@ const agent = new Agent({
 
 ## How it works
 
-Working memory is a block of Markdown text that the agent is able to update over time to store continuously relevant information:
-
-[YouTube video player](https://www.youtube-nocookie.com/embed/UMy_JHLf1n8)
+Working memory is a block of Markdown text that the agent is able to update over time to store continuously relevant information.
 
 ## Memory persistence scopes
 

package/.docs/docs/studio/overview.md

@@ -4,7 +4,7 @@
 
 Studio provides an interactive UI for building, testing, and managing your agents, workflows, and tools. Run it locally during development, add [authentication](https://mastra.ai/docs/studio/auth), or [deploy it](https://mastra.ai/docs/studio/deployment) to production so your team can manage agents, monitor performance, and gain insights through built-in observability.
 
-[YouTube video player](https://www.youtube-nocookie.com/embed/ojGu6Bi4wYk)
+> **📹 Watch:** Watch [Mastra Studio overview](https://youtu.be/ojGu6Bi4wYk) for a short walkthrough of building, testing, and managing agents in Studio.
 
 ## Start Studio
 

package/.docs/docs/workflows/control-flow.md

@@ -101,8 +101,6 @@ export const testWorkflow = createWorkflow({
   .commit()
 ```
 
-> **📹 Watch:** How to run steps in parallel and optimize your Mastra workflow → [YouTube (3 minutes)](https://youtu.be/GQJxve5Hki4)
-
 ### Output structure
 
 When steps run in parallel, the output is an object where each key is the step's `id` and the value is that step's output. This allows you to access each parallel step's result independently.

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

@@ -10,8 +10,6 @@ Workflows let you define complex sequences of tasks using clear, structured step
 
 Use workflows for tasks that are clearly defined upfront and involve multiple steps with a specific execution order. They give you fine-grained control over how data flows and transforms between steps, and which primitives are called at each stage.
 
-> **Tip:** Watch an introduction to workflows, and how they compare to agents on [YouTube (7 minutes)](https://youtu.be/0jg2g3sNvgw).
-
 ## Core principles
 
 Mastra workflows operate using these principles:
@@ -546,4 +544,5 @@ For a closer look at workflows, see our [Workflow Guide](https://mastra.ai/guide
 - [Workflow State](https://mastra.ai/docs/workflows/workflow-state)
 - [Control Flow](https://mastra.ai/docs/workflows/control-flow)
 - [Suspend and Resume](https://mastra.ai/docs/workflows/suspend-and-resume)
-- [Error Handling](https://mastra.ai/docs/workflows/error-handling)
+- [Error Handling](https://mastra.ai/docs/workflows/error-handling)
+- 📹 [Agentic workflows with Mastra workshop](https://www.youtube.com/watch?v=HGt8pVPpX9g)

package/.docs/docs/workspace/overview.md

@@ -411,4 +411,5 @@ External providers may perform additional setup like establishing connections or
 - [LSP inspection](https://mastra.ai/docs/workspace/lsp)
 - [Skills](https://mastra.ai/docs/workspace/skills)
 - [Search and indexing](https://mastra.ai/docs/workspace/search)
-- [Workspace class reference](https://mastra.ai/reference/workspace/workspace-class)
+- [Workspace class reference](https://mastra.ai/reference/workspace/workspace-class)
+- 📹 [Introduction to Mastra Workspaces workshop](https://www.youtube.com/watch?v=QcQLiYlJuNQ)

package/.docs/docs/workspace/sandbox.md

@@ -15,6 +15,8 @@ A sandbox provider executes commands in a controlled environment:
 - **Timeouts**: Prevent long-running commands from hanging
 - **Isolation**: Optional OS-level sandboxing for security
 
+> **📹 Watch:** Watch [Mastra remote sandboxes overview](https://www.youtube.com/watch?v=Ix2X-sjVXjw) to see how remote sandboxes give agents an isolated computer to work in.
+
 ## Supported providers
 
 - [`LocalSandbox`](https://mastra.ai/reference/workspace/local-sandbox): Executes commands on the local machine

package/.docs/guides/getting-started/quickstart.md

@@ -8,6 +8,8 @@ The `create mastra` CLI command is the quickest way to get started. It walks you
 
 If you need more control over the setup, see the [manual installation guide](https://mastra.ai/docs/getting-started/manual-install). You can also use [`mastra init`](https://mastra.ai/reference/cli/mastra) for existing projects.
 
+> **📹 Watch:** Watch [Mastra AI agent course](https://www.youtube.com/watch?v=lCmf_qrGfGA) for a guided introduction to building agents with Mastra.
+
 ## Before you begin
 
 - You'll need an API key from a supported [model provider](https://mastra.ai/models). If you don't have a preference, use [OpenAI](https://mastra.ai/models/providers/openai).
@@ -58,7 +60,7 @@ Depending on your choices, you'll also end up with [Mastra Skills](https://mastr
 
 Once setup is complete, follow the instructions in your terminal to start the Mastra dev server, then open Studio at [localhost:4111](http://localhost:4111).
 
-Try asking about the weather. If your API key is set up correctly, you'll get a response:
+Try asking about the weather. If your API key is set up correctly, you'll get a response in Studio.
 
 [Studio](https://mastra.ai/docs/studio/overview) lets you rapidly build and prototype agents without needing to build a UI. Once you're ready, you can integrate your Mastra agent into your app using the guides below.
 

package/.docs/guides/guide/chef-michel.md

@@ -6,8 +6,6 @@ In this guide, you'll create a "Chef Assistant" agent that helps users cook meal
 
 You'll learn how to create the agent and register it with Mastra. Next, you'll interact with the agent through your terminal and get to know different response formats. Lastly, you'll access the agent through Mastra's local API endpoints.
 
-[YouTube video player](https://www.youtube-nocookie.com/embed/_tZhOqHCrF0)
-
 ## Prerequisites
 
 - Node.js `v22.13.0` or later installed

package/.docs/guides/guide/slack-assistant.md

@@ -182,12 +182,12 @@ You can extend this agent to:
 
 - [Deploy your application](https://mastra.ai/docs/deployment/overview) and update the Slack **Request URL** to your production endpoint
 - Add more adapters (Discord, Telegram) to the same agent so it responds on multiple platforms
-- Configure [multimodal content](https://mastra.ai/docs/agents/channels) to let your agent process images, video, and audio shared in chat
+- Configure [multimodal content](https://mastra.ai/docs/capabilities/channels/overview) to let your agent process images, video, and audio shared in chat
 - Add [tools](https://mastra.ai/docs/agents/using-tools) to give the agent access to external APIs and data
 
 Learn more:
 
-- [Channels overview](https://mastra.ai/docs/agents/channels)
+- [Channels overview](https://mastra.ai/docs/capabilities/channels/overview)
 - [Studio](https://mastra.ai/docs/studio/overview)
 - [Deployment overview](https://mastra.ai/docs/deployment/overview)
 - [Chat SDK adapter docs](https://chat-sdk.dev)

package/.docs/guides/guide/stock-agent.md

@@ -4,8 +4,6 @@
 
 In this guide, you're going to create an agent that fetches the last day's closing stock price for a given symbol. You'll learn how to create a tool, add it to an agent, and use the agent to fetch stock prices.
 
-[YouTube video player](https://www.youtube-nocookie.com/embed/rIaZ4l7y9wo)
-
 ## Prerequisites
 
 - Node.js `v22.13.0` or later installed

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

@@ -31,6 +31,7 @@ List of required environment variables for each model provider and gateway suppo
 | [Cloudflare Workers AI](https://mastra.ai/models/providers/cloudflare-workers-ai)              | `cloudflare-workers-ai/*`  | `CLOUDFLARE_ACCOUNT_ID`, `CLOUDFLARE_API_KEY`                                                         |
 | [Cortecs](https://mastra.ai/models/providers/cortecs)                                          | `cortecs/*`                | `CORTECS_API_KEY`                                                                                     |
 | [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`                                                                                        |
 | [Databricks](https://mastra.ai/models/providers/databricks)                                    | `databricks/*`             | `DATABRICKS_HOST`, `DATABRICKS_TOKEN`                                                                 |
 | [Deep Infra](https://mastra.ai/models/providers/deepinfra)                                     | `deepinfra/*`              | `DEEPINFRA_API_KEY`                                                                                   |
@@ -68,6 +69,7 @@ List of required environment variables for each model provider and gateway suppo
 | [LongCat](https://mastra.ai/models/providers/longcat)                                          | `longcat/*`                | `LONGCAT_API_KEY`                                                                                     |
 | [LucidQuery](https://mastra.ai/models/providers/lucidquery)                                    | `lucidquery/*`             | `LUCIDQUERY_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`                                                                                     |
 | [MiniMax (minimaxi.com)](https://mastra.ai/models/providers/minimax-cn)                        | `minimax-cn/*`             | `MINIMAX_API_KEY`                                                                                     |
 | [MiniMax Token Plan (minimax.io)](https://mastra.ai/models/providers/minimax-coding-plan)      | `minimax-coding-plan/*`    | `MINIMAX_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 67 models through Mastra's model router.
+Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 70 models through Mastra's model router.
 
 Learn more in the [Netlify documentation](https://docs.netlify.com/build/ai-gateway/overview/).
 
@@ -101,6 +101,9 @@ ANTHROPIC_API_KEY=ant-...
 | `openai/gpt-5.5-2026-04-23`                 |
 | `openai/gpt-5.5-pro`                        |
 | `openai/gpt-5.5-pro-2026-04-23`             |
+| `openai/gpt-5.6-luna`                       |
+| `openai/gpt-5.6-sol`                        |
+| `openai/gpt-5.6-terra`                      |
 | `openai/o3`                                 |
 | `openai/o3-mini`                            |
 | `openai/o4-mini`                            |

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 344 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 345 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -104,7 +104,6 @@ ANTHROPIC_API_KEY=ant-...
 | `google/gemini-2.5-flash`                                       |
 | `google/gemini-2.5-flash-image`                                 |
 | `google/gemini-2.5-flash-lite`                                  |
-| `google/gemini-2.5-flash-lite-preview-09-2025`                  |
 | `google/gemini-2.5-pro`                                         |
 | `google/gemini-2.5-pro-preview`                                 |
 | `google/gemini-2.5-pro-preview-05-06`                           |
@@ -140,7 +139,6 @@ ANTHROPIC_API_KEY=ant-...
 | `inflection/inflection-3-pi`                                    |
 | `inflection/inflection-3-productivity`                          |
 | `kwaipilot/kat-coder-pro-v2`                                    |
-| `liquid/lfm-2-24b-a2b`                                          |
 | `liquid/lfm-2.5-1.2b-instruct:free`                             |
 | `liquid/lfm-2.5-1.2b-thinking:free`                             |
 | `mancer/weaver`                                                 |
@@ -254,6 +252,12 @@ ANTHROPIC_API_KEY=ant-...
 | `openai/gpt-5.4-pro`                                            |
 | `openai/gpt-5.5`                                                |
 | `openai/gpt-5.5-pro`                                            |
+| `openai/gpt-5.6-luna`                                           |
+| `openai/gpt-5.6-luna-pro`                                       |
+| `openai/gpt-5.6-sol`                                            |
+| `openai/gpt-5.6-sol-pro`                                        |
+| `openai/gpt-5.6-terra`                                          |
+| `openai/gpt-5.6-terra-pro`                                      |
 | `openai/gpt-audio`                                              |
 | `openai/gpt-audio-mini`                                         |
 | `openai/gpt-chat-latest`                                        |
@@ -287,8 +291,6 @@ ANTHROPIC_API_KEY=ant-...
 | `poolside/laguna-m.1:free`                                      |
 | `poolside/laguna-xs-2.1`                                        |
 | `poolside/laguna-xs-2.1:free`                                   |
-| `poolside/laguna-xs.2`                                          |
-| `poolside/laguna-xs.2:free`                                     |
 | `qwen/qwen-2.5-72b-instruct`                                    |
 | `qwen/qwen-2.5-7b-instruct`                                     |
 | `qwen/qwen-2.5-coder-32b-instruct`                              |
@@ -349,7 +351,6 @@ ANTHROPIC_API_KEY=ant-...
 | `sao10k/l3.3-euryale-70b`                                       |
 | `stepfun/step-3.5-flash`                                        |
 | `stepfun/step-3.7-flash`                                        |
-| `switchpoint/router`                                            |
 | `tencent/hunyuan-a13b-instruct`                                 |
 | `tencent/hy3`                                                   |
 | `tencent/hy3-preview`                                           |

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 301 models through Mastra's model router.
+Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 305 models through Mastra's model router.
 
 Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
 
@@ -177,6 +177,7 @@ ANTHROPIC_API_KEY=ant-...
 | `meta/llama-3.3-70b`                     |
 | `meta/llama-4-maverick`                  |
 | `meta/llama-4-scout`                     |
+| `meta/muse-spark-1.1`                    |
 | `minimax/minimax-m2`                     |
 | `minimax/minimax-m2.1`                   |
 | `minimax/minimax-m2.1-lightning`         |
@@ -250,6 +251,9 @@ ANTHROPIC_API_KEY=ant-...
 | `openai/gpt-5.4-pro`                     |
 | `openai/gpt-5.5`                         |
 | `openai/gpt-5.5-pro`                     |
+| `openai/gpt-5.6-luna`                    |
+| `openai/gpt-5.6-sol`                     |
+| `openai/gpt-5.6-terra`                   |
 | `openai/gpt-image-1`                     |
 | `openai/gpt-image-1-mini`                |
 | `openai/gpt-image-1.5`                   |

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

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

@@ -0,0 +1,109 @@
+> Discover all available pages from the documentation index: https://mastra.ai/llms.txt
+
+# ![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.
+
+Learn more in the [CrossModel documentation](https://www.crossmodel.ai/docs).
+
+```bash
+CROSSMODEL_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: "crossmodel/anthropic/claude-fable-5"
+});
+
+// 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 [CrossModel documentation](https://www.crossmodel.ai/docs) for details.
+
+## Models
+
+| Model                                      | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `crossmodel/anthropic/claude-fable-5`      | 1.0M    |       |           |       |       |       | $10        | $50         |
+| `crossmodel/anthropic/claude-haiku-4-5`    | 200K    |       |           |       |       |       | $1         | $5          |
+| `crossmodel/anthropic/claude-opus-4-7`     | 1.0M    |       |           |       |       |       | $5         | $25         |
+| `crossmodel/anthropic/claude-opus-4-8`     | 1.0M    |       |           |       |       |       | $5         | $25         |
+| `crossmodel/anthropic/claude-sonnet-4-6`   | 1.0M    |       |           |       |       |       | $3         | $15         |
+| `crossmodel/anthropic/claude-sonnet-5`     | 1.0M    |       |           |       |       |       | $2         | $10         |
+| `crossmodel/deepseek/deepseek-v4-flash`    | 1.0M    |       |           |       |       |       | $0.16      | $0.32       |
+| `crossmodel/deepseek/deepseek-v4-pro`      | 1.0M    |       |           |       |       |       | $0.47      | $0.94       |
+| `crossmodel/gemini/gemini-2.5-flash`       | 1.0M    |       |           |       |       |       | $0.30      | $3          |
+| `crossmodel/gemini/gemini-2.5-flash-lite`  | 1.0M    |       |           |       |       |       | $0.10      | $0.40       |
+| `crossmodel/gemini/gemini-2.5-pro`         | 1.0M    |       |           |       |       |       | $1         | $10         |
+| `crossmodel/gemini/gemini-3-flash-preview` | 1.0M    |       |           |       |       |       | $0.50      | $3          |
+| `crossmodel/gemini/gemini-3.1-pro-preview` | 1.0M    |       |           |       |       |       | $2         | $12         |
+| `crossmodel/gemini/gemini-3.5-flash`       | 1.0M    |       |           |       |       |       | $2         | $9          |
+| `crossmodel/minimax/minimax-m2.7`          | 205K    |       |           |       |       |       | $0.33      | $1          |
+| `crossmodel/minimax/minimax-m3`            | 1.0M    |       |           |       |       |       | $0.33      | $1          |
+| `crossmodel/moonshot/kimi-k2.5`            | 262K    |       |           |       |       |       | $0.62      | $3          |
+| `crossmodel/moonshot/kimi-k2.6`            | 262K    |       |           |       |       |       | $1         | $4          |
+| `crossmodel/moonshot/kimi-k2.7-code`       | 262K    |       |           |       |       |       | $1         | $4          |
+| `crossmodel/openai/gpt-4o-mini`            | 128K    |       |           |       |       |       | $0.15      | $0.60       |
+| `crossmodel/openai/gpt-5.4`                | 1.1M    |       |           |       |       |       | $3         | $15         |
+| `crossmodel/openai/gpt-5.4-mini`           | 400K    |       |           |       |       |       | $0.75      | $5          |
+| `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/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          |
+| `crossmodel/qwen/qwen3.7-plus`             | 1.0M    |       |           |       |       |       | $0.32      | $1          |
+| `crossmodel/tencent/hy3-preview`           | 256K    |       |           |       |       |       | $0.19      | $0.63       |
+| `crossmodel/xiaomi/mimo-v2.5`              | 1.0M    |       |           |       |       |       | $0.16      | $0.32       |
+| `crossmodel/xiaomi/mimo-v2.5-pro`          | 1.0M    |       |           |       |       |       | $0.47      | $0.94       |
+| `crossmodel/z-ai/glm-4.7`                  | 200K    |       |           |       |       |       | $0.47      | $2          |
+| `crossmodel/z-ai/glm-5`                    | 200K    |       |           |       |       |       | $0.60      | $3          |
+| `crossmodel/z-ai/glm-5-turbo`              | 200K    |       |           |       |       |       | $0.90      | $4          |
+| `crossmodel/z-ai/glm-5.1`                  | 200K    |       |           |       |       |       | $1         | $4          |
+| `crossmodel/z-ai/glm-5.2`                  | 1.0M    |       |           |       |       |       | $1         | $4          |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.crossmodel.ai/v1",
+    id: "crossmodel/anthropic/claude-fable-5",
+    apiKey: process.env.CROSSMODEL_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
+      ? "crossmodel/z-ai/glm-5.2"
+      : "crossmodel/anthropic/claude-fable-5";
+  }
+});
+```