@mastra/mcp-docs-server 1.1.5 → 1.1.6-alpha.0

package/.docs/models/providers/synthetic.md

@@ -0,0 +1,96 @@
+# ![Synthetic logo](https://models.dev/logos/synthetic.svg)Synthetic
+
+Access 26 Synthetic models through Mastra's model router. Authentication is handled automatically using the `SYNTHETIC_API_KEY` environment variable.
+
+Learn more in the [Synthetic documentation](https://synthetic.new/pricing).
+
+```bash
+SYNTHETIC_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: "synthetic/hf:MiniMaxAI/MiniMax-M2"
+});
+
+// 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 [Synthetic documentation](https://synthetic.new/pricing) for details.
+
+## Models
+
+| Model                                                            | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ---------------------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `synthetic/hf:deepseek-ai/DeepSeek-R1`                           | 128K    |       |           |       |       |       | $0.55      | $2          |
+| `synthetic/hf:deepseek-ai/DeepSeek-R1-0528`                      | 128K    |       |           |       |       |       | $3         | $8          |
+| `synthetic/hf:deepseek-ai/DeepSeek-V3`                           | 128K    |       |           |       |       |       | $1         | $1          |
+| `synthetic/hf:deepseek-ai/DeepSeek-V3-0324`                      | 128K    |       |           |       |       |       | $1         | $1          |
+| `synthetic/hf:deepseek-ai/DeepSeek-V3.1`                         | 128K    |       |           |       |       |       | $0.56      | $2          |
+| `synthetic/hf:deepseek-ai/DeepSeek-V3.1-Terminus`                | 128K    |       |           |       |       |       | $1         | $1          |
+| `synthetic/hf:deepseek-ai/DeepSeek-V3.2`                         | 163K    |       |           |       |       |       | $0.27      | $0.40       |
+| `synthetic/hf:meta-llama/Llama-3.1-405B-Instruct`                | 128K    |       |           |       |       |       | $3         | $3          |
+| `synthetic/hf:meta-llama/Llama-3.1-70B-Instruct`                 | 128K    |       |           |       |       |       | $0.90      | $0.90       |
+| `synthetic/hf:meta-llama/Llama-3.1-8B-Instruct`                  | 128K    |       |           |       |       |       | $0.20      | $0.20       |
+| `synthetic/hf:meta-llama/Llama-3.3-70B-Instruct`                 | 128K    |       |           |       |       |       | $0.90      | $0.90       |
+| `synthetic/hf:meta-llama/Llama-4-Maverick-17B-128E-Instruct-FP8` | 524K    |       |           |       |       |       | $0.22      | $0.88       |
+| `synthetic/hf:meta-llama/Llama-4-Scout-17B-16E-Instruct`         | 328K    |       |           |       |       |       | $0.15      | $0.60       |
+| `synthetic/hf:MiniMaxAI/MiniMax-M2`                              | 197K    |       |           |       |       |       | $0.55      | $2          |
+| `synthetic/hf:MiniMaxAI/MiniMax-M2.1`                            | 205K    |       |           |       |       |       | $0.55      | $2          |
+| `synthetic/hf:moonshotai/Kimi-K2-Instruct-0905`                  | 262K    |       |           |       |       |       | $1         | $1          |
+| `synthetic/hf:moonshotai/Kimi-K2-Thinking`                       | 262K    |       |           |       |       |       | $0.55      | $2          |
+| `synthetic/hf:moonshotai/Kimi-K2.5`                              | 262K    |       |           |       |       |       | $0.55      | $2          |
+| `synthetic/hf:nvidia/Kimi-K2.5-NVFP4`                            | 262K    |       |           |       |       |       | $0.55      | $2          |
+| `synthetic/hf:openai/gpt-oss-120b`                               | 128K    |       |           |       |       |       | $0.10      | $0.10       |
+| `synthetic/hf:Qwen/Qwen2.5-Coder-32B-Instruct`                   | 33K     |       |           |       |       |       | $0.80      | $0.80       |
+| `synthetic/hf:Qwen/Qwen3-235B-A22B-Instruct-2507`                | 256K    |       |           |       |       |       | $0.20      | $0.60       |
+| `synthetic/hf:Qwen/Qwen3-235B-A22B-Thinking-2507`                | 256K    |       |           |       |       |       | $0.65      | $3          |
+| `synthetic/hf:Qwen/Qwen3-Coder-480B-A35B-Instruct`               | 256K    |       |           |       |       |       | $2         | $2          |
+| `synthetic/hf:zai-org/GLM-4.6`                                   | 200K    |       |           |       |       |       | $0.55      | $2          |
+| `synthetic/hf:zai-org/GLM-4.7`                                   | 200K    |       |           |       |       |       | $0.55      | $2          |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.synthetic.new/v1",
+    id: "synthetic/hf:MiniMaxAI/MiniMax-M2",
+    apiKey: process.env.SYNTHETIC_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
+      ? "synthetic/hf:zai-org/GLM-4.7"
+      : "synthetic/hf:MiniMaxAI/MiniMax-M2";
+  }
+});
+```

package/.docs/models/providers/togetherai.md

@@ -0,0 +1,115 @@
+# ![Together AI logo](https://models.dev/logos/togetherai.svg)Together AI
+
+Access 18 Together AI models through Mastra's model router. Authentication is handled automatically using the `TOGETHER_API_KEY` environment variable.
+
+Learn more in the [Together AI documentation](https://docs.together.ai/docs/serverless-models).
+
+```bash
+TOGETHER_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: "togetherai/MiniMaxAI/MiniMax-M2.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);
+}
+```
+
+## Models
+
+| Model                                                | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ---------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `togetherai/deepseek-ai/DeepSeek-R1`                 | 164K    |       |           |       |       |       | $3         | $7          |
+| `togetherai/deepseek-ai/DeepSeek-V3`                 | 131K    |       |           |       |       |       | $1         | $1          |
+| `togetherai/deepseek-ai/DeepSeek-V3-1`               | 131K    |       |           |       |       |       | $0.60      | $2          |
+| `togetherai/essentialai/Rnj-1-Instruct`              | 33K     |       |           |       |       |       | $0.15      | $0.15       |
+| `togetherai/meta-llama/Llama-3.3-70B-Instruct-Turbo` | 131K    |       |           |       |       |       | $0.88      | $0.88       |
+| `togetherai/MiniMaxAI/MiniMax-M2.5`                  | 205K    |       |           |       |       |       | $0.30      | $1          |
+| `togetherai/moonshotai/Kimi-K2-Instruct`             | 131K    |       |           |       |       |       | $1         | $3          |
+| `togetherai/moonshotai/Kimi-K2-Instruct-0905`        | 262K    |       |           |       |       |       | $1         | $3          |
+| `togetherai/moonshotai/Kimi-K2-Thinking`             | 262K    |       |           |       |       |       | $1         | $4          |
+| `togetherai/moonshotai/Kimi-K2.5`                    | 262K    |       |           |       |       |       | $0.50      | $3          |
+| `togetherai/openai/gpt-oss-120b`                     | 131K    |       |           |       |       |       | $0.15      | $0.60       |
+| `togetherai/Qwen/Qwen3-235B-A22B-Instruct-2507-tput` | 262K    |       |           |       |       |       | $0.20      | $0.60       |
+| `togetherai/Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8` | 262K    |       |           |       |       |       | $2         | $2          |
+| `togetherai/Qwen/Qwen3-Coder-Next-FP8`               | 262K    |       |           |       |       |       | $0.50      | $1          |
+| `togetherai/Qwen/Qwen3-Next-80B-A3B-Instruct`        | 262K    |       |           |       |       |       | $0.15      | $2          |
+| `togetherai/zai-org/GLM-4.6`                         | 200K    |       |           |       |       |       | $0.60      | $2          |
+| `togetherai/zai-org/GLM-4.7`                         | 200K    |       |           |       |       |       | $0.45      | $2          |
+| `togetherai/zai-org/GLM-5`                           | 203K    |       |           |       |       |       | $1         | $3          |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    id: "togetherai/MiniMaxAI/MiniMax-M2.5",
+    apiKey: process.env.TOGETHER_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
+      ? "togetherai/zai-org/GLM-5"
+      : "togetherai/MiniMaxAI/MiniMax-M2.5";
+  }
+});
+```
+
+## Direct Provider Installation
+
+This provider can also be installed directly as a standalone package, which can be used instead of the Mastra model router string. View the [package documentation](https://www.npmjs.com/package/@ai-sdk/togetherai) for more details.
+
+**npm**:
+
+```bash
+npm install @ai-sdk/togetherai
+```
+
+**pnpm**:
+
+```bash
+pnpm add @ai-sdk/togetherai
+```
+
+**Yarn**:
+
+```bash
+yarn add @ai-sdk/togetherai
+```
+
+**Bun**:
+
+```bash
+bun add @ai-sdk/togetherai
+```
+
+For detailed provider-specific documentation, see the [AI SDK Together AI provider docs](https://ai-sdk.dev/providers/ai-sdk-providers/togetherai).

package/.docs/models/providers/upstage.md

@@ -0,0 +1,73 @@
+# ![Upstage logo](https://models.dev/logos/upstage.svg)Upstage
+
+Access 3 Upstage models through Mastra's model router. Authentication is handled automatically using the `UPSTAGE_API_KEY` environment variable.
+
+Learn more in the [Upstage documentation](https://developers.upstage.ai).
+
+```bash
+UPSTAGE_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: "upstage/solar-mini"
+});
+
+// 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 [Upstage documentation](https://developers.upstage.ai) for details.
+
+## Models
+
+| Model                | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| -------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `upstage/solar-mini` | 33K     |       |           |       |       |       | $0.15      | $0.15       |
+| `upstage/solar-pro2` | 66K     |       |           |       |       |       | $0.25      | $0.25       |
+| `upstage/solar-pro3` | 131K    |       |           |       |       |       | $0.25      | $0.25       |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.upstage.ai/v1/solar",
+    id: "upstage/solar-mini",
+    apiKey: process.env.UPSTAGE_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
+      ? "upstage/solar-pro3"
+      : "upstage/solar-mini";
+  }
+});
+```

package/.docs/models/providers/venice.md

@@ -0,0 +1,95 @@
+# ![Venice AI logo](https://models.dev/logos/venice.svg)Venice AI
+
+Access 25 Venice AI models through Mastra's model router. Authentication is handled automatically using the `VENICE_API_KEY` environment variable.
+
+Learn more in the [Venice AI documentation](https://docs.venice.ai).
+
+```bash
+VENICE_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: "venice/claude-opus-45"
+});
+
+// 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 [Venice AI documentation](https://docs.venice.ai) for details.
+
+## Models
+
+| Model                                   | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| --------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `venice/claude-opus-45`                 | 203K    |       |           |       |       |       | $6         | $30         |
+| `venice/claude-sonnet-45`               | 203K    |       |           |       |       |       | $4         | $19         |
+| `venice/deepseek-v3.2`                  | 164K    |       |           |       |       |       | $0.40      | $1          |
+| `venice/gemini-3-flash-preview`         | 262K    |       |           |       |       |       | $0.70      | $4          |
+| `venice/gemini-3-pro-preview`           | 203K    |       |           |       |       |       | $3         | $15         |
+| `venice/google-gemma-3-27b-it`          | 203K    |       |           |       |       |       | $0.12      | $0.20       |
+| `venice/grok-41-fast`                   | 262K    |       |           |       |       |       | $0.50      | $1          |
+| `venice/grok-code-fast-1`               | 262K    |       |           |       |       |       | $0.25      | $2          |
+| `venice/hermes-3-llama-3.1-405b`        | 131K    |       |           |       |       |       | $1         | $3          |
+| `venice/kimi-k2-thinking`               | 262K    |       |           |       |       |       | $0.75      | $3          |
+| `venice/llama-3.2-3b`                   | 131K    |       |           |       |       |       | $0.15      | $0.60       |
+| `venice/llama-3.3-70b`                  | 131K    |       |           |       |       |       | $0.70      | $3          |
+| `venice/minimax-m21`                    | 203K    |       |           |       |       |       | $0.40      | $2          |
+| `venice/mistral-31-24b`                 | 131K    |       |           |       |       |       | $0.50      | $2          |
+| `venice/openai-gpt-52`                  | 262K    |       |           |       |       |       | $2         | $18         |
+| `venice/openai-gpt-52-codex`            | 262K    |       |           |       |       |       | $2         | $18         |
+| `venice/openai-gpt-oss-120b`            | 131K    |       |           |       |       |       | $0.07      | $0.30       |
+| `venice/qwen3-235b-a22b-instruct-2507`  | 131K    |       |           |       |       |       | $0.15      | $0.75       |
+| `venice/qwen3-235b-a22b-thinking-2507`  | 131K    |       |           |       |       |       | $0.45      | $4          |
+| `venice/qwen3-4b`                       | 33K     |       |           |       |       |       | $0.05      | $0.15       |
+| `venice/qwen3-coder-480b-a35b-instruct` | 262K    |       |           |       |       |       | $0.75      | $3          |
+| `venice/qwen3-next-80b`                 | 262K    |       |           |       |       |       | $0.35      | $2          |
+| `venice/qwen3-vl-235b-a22b`             | 262K    |       |           |       |       |       | $0.25      | $2          |
+| `venice/venice-uncensored`              | 33K     |       |           |       |       |       | $0.20      | $0.90       |
+| `venice/zai-org-glm-4.7`                | 203K    |       |           |       |       |       | $0.55      | $3          |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.venice.ai/api/v1",
+    id: "venice/claude-opus-45",
+    apiKey: process.env.VENICE_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
+      ? "venice/zai-org-glm-4.7"
+      : "venice/claude-opus-45";
+  }
+});
+```

package/.docs/models/providers/vivgrid.md

@@ -0,0 +1,106 @@
+# ![Vivgrid logo](https://models.dev/logos/vivgrid.svg)Vivgrid
+
+Access 8 Vivgrid models through Mastra's model router. Authentication is handled automatically using the `VIVGRID_API_KEY` environment variable.
+
+Learn more in the [Vivgrid documentation](https://docs.vivgrid.com/models).
+
+```bash
+VIVGRID_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: "vivgrid/deepseek-v3.2"
+});
+
+// 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 [Vivgrid documentation](https://docs.vivgrid.com/models) for details.
+
+## Models
+
+| Model                            | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| -------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `vivgrid/deepseek-v3.2`          | 128K    |       |           |       |       |       | $0.28      | $0.42       |
+| `vivgrid/gemini-3-flash-preview` | 1.0M    |       |           |       |       |       | $0.50      | $3          |
+| `vivgrid/gemini-3-pro-preview`   | 1.0M    |       |           |       |       |       | $2         | $12         |
+| `vivgrid/glm-5`                  | 203K    |       |           |       |       |       | $1         | $3          |
+| `vivgrid/gpt-5-mini`             | 272K    |       |           |       |       |       | $0.25      | $2          |
+| `vivgrid/gpt-5.1-codex`          | 400K    |       |           |       |       |       | $1         | $10         |
+| `vivgrid/gpt-5.1-codex-max`      | 400K    |       |           |       |       |       | $1         | $10         |
+| `vivgrid/gpt-5.2-codex`          | 400K    |       |           |       |       |       | $2         | $14         |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.vivgrid.com/v1",
+    id: "vivgrid/deepseek-v3.2",
+    apiKey: process.env.VIVGRID_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
+      ? "vivgrid/gpt-5.2-codex"
+      : "vivgrid/deepseek-v3.2";
+  }
+});
+```
+
+## Direct Provider Installation
+
+This provider can also be installed directly as a standalone package, which can be used instead of the Mastra model router string. View the [package documentation](https://www.npmjs.com/package/@ai-sdk/openai) for more details.
+
+**npm**:
+
+```bash
+npm install @ai-sdk/openai
+```
+
+**pnpm**:
+
+```bash
+pnpm add @ai-sdk/openai
+```
+
+**Yarn**:
+
+```bash
+yarn add @ai-sdk/openai
+```
+
+**Bun**:
+
+```bash
+bun add @ai-sdk/openai
+```

package/.docs/models/providers/vultr.md

@@ -0,0 +1,75 @@
+# ![Vultr logo](https://models.dev/logos/vultr.svg)Vultr
+
+Access 5 Vultr models through Mastra's model router. Authentication is handled automatically using the `VULTR_API_KEY` environment variable.
+
+Learn more in the [Vultr documentation](https://api.vultrinference.com/).
+
+```bash
+VULTR_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: "vultr/deepseek-r1-distill-llama-70b"
+});
+
+// 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 [Vultr documentation](https://api.vultrinference.com/) for details.
+
+## Models
+
+| Model                                 | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `vultr/deepseek-r1-distill-llama-70b` | 122K    |       |           |       |       |       | $0.20      | $0.20       |
+| `vultr/deepseek-r1-distill-qwen-32b`  | 122K    |       |           |       |       |       | $0.20      | $0.20       |
+| `vultr/gpt-oss-120b`                  | 122K    |       |           |       |       |       | $0.20      | $0.20       |
+| `vultr/kimi-k2-instruct`              | 59K     |       |           |       |       |       | $0.20      | $0.20       |
+| `vultr/qwen2.5-coder-32b-instruct`    | 13K     |       |           |       |       |       | $0.20      | $0.20       |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.vultrinference.com/v1",
+    id: "vultr/deepseek-r1-distill-llama-70b",
+    apiKey: process.env.VULTR_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
+      ? "vultr/qwen2.5-coder-32b-instruct"
+      : "vultr/deepseek-r1-distill-llama-70b";
+  }
+});
+```

package/.docs/models/providers/wandb.md

@@ -0,0 +1,80 @@
+# ![Weights & Biases logo](https://models.dev/logos/wandb.svg)Weights & Biases
+
+Access 10 Weights & Biases models through Mastra's model router. Authentication is handled automatically using the `WANDB_API_KEY` environment variable.
+
+Learn more in the [Weights & Biases documentation](https://weave-docs.wandb.ai).
+
+```bash
+WANDB_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: "wandb/Qwen/Qwen3-235B-A22B-Instruct-2507"
+});
+
+// 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 [Weights & Biases documentation](https://weave-docs.wandb.ai) for details.
+
+## Models
+
+| Model                                             | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `wandb/deepseek-ai/DeepSeek-R1-0528`              | 161K    |       |           |       |       |       | $1         | $5          |
+| `wandb/deepseek-ai/DeepSeek-V3-0324`              | 161K    |       |           |       |       |       | $1         | $3          |
+| `wandb/meta-llama/Llama-3.1-8B-Instruct`          | 128K    |       |           |       |       |       | $0.22      | $0.22       |
+| `wandb/meta-llama/Llama-3.3-70B-Instruct`         | 128K    |       |           |       |       |       | $0.71      | $0.71       |
+| `wandb/meta-llama/Llama-4-Scout-17B-16E-Instruct` | 64K     |       |           |       |       |       | $0.17      | $0.66       |
+| `wandb/microsoft/Phi-4-mini-instruct`             | 128K    |       |           |       |       |       | $0.08      | $0.35       |
+| `wandb/moonshotai/Kimi-K2-Instruct`               | 128K    |       |           |       |       |       | $1         | $4          |
+| `wandb/Qwen/Qwen3-235B-A22B-Instruct-2507`        | 262K    |       |           |       |       |       | $0.10      | $0.10       |
+| `wandb/Qwen/Qwen3-235B-A22B-Thinking-2507`        | 262K    |       |           |       |       |       | $0.10      | $0.10       |
+| `wandb/Qwen/Qwen3-Coder-480B-A35B-Instruct`       | 262K    |       |           |       |       |       | $1         | $2          |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.inference.wandb.ai/v1",
+    id: "wandb/Qwen/Qwen3-235B-A22B-Instruct-2507",
+    apiKey: process.env.WANDB_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
+      ? "wandb/moonshotai/Kimi-K2-Instruct"
+      : "wandb/Qwen/Qwen3-235B-A22B-Instruct-2507";
+  }
+});
+```