@mastra/mcp-docs-server 1.1.5 → 1.1.6

package/.docs/models/providers/google-vertex.md

@@ -0,0 +1,33 @@
+# ![Vertex logo](https://models.dev/logos/google-vertex.svg)Vertex
+
+Vertex is available through the AI SDK. Install the provider package to use their models with Mastra.
+
+For detailed provider-specific documentation, see the [AI SDK Vertex provider docs](https://ai-sdk.dev/providers/ai-sdk-providers/google-vertex).
+
+To use this provider with Mastra agents, see the [Agent Overview documentation](https://mastra.ai/docs/agents/overview).
+
+## Installation
+
+**npm**:
+
+```bash
+npm install @ai-sdk/google-vertex
+```
+
+**pnpm**:
+
+```bash
+pnpm add @ai-sdk/google-vertex
+```
+
+**Yarn**:
+
+```bash
+yarn add @ai-sdk/google-vertex
+```
+
+**Bun**:
+
+```bash
+bun add @ai-sdk/google-vertex
+```

package/.docs/models/providers/google.md

@@ -0,0 +1,159 @@
+# ![Google logo](https://models.dev/logos/google.svg)Google
+
+Access 26 Google models through Mastra's model router. Authentication is handled automatically using the `GOOGLE_GENERATIVE_AI_API_KEY` environment variable.
+
+Learn more in the [Google documentation](https://ai.google.dev/gemini-api/docs/pricing).
+
+```bash
+GOOGLE_GENERATIVE_AI_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: "google/gemini-1.5-flash"
+});
+
+// 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 |
+| --------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `google/gemini-1.5-flash`                           | 1.0M    |       |           |       |       |       | $0.07      | $0.30       |
+| `google/gemini-1.5-flash-8b`                        | 1.0M    |       |           |       |       |       | $0.04      | $0.15       |
+| `google/gemini-1.5-pro`                             | 1.0M    |       |           |       |       |       | $1         | $5          |
+| `google/gemini-2.0-flash`                           | 1.0M    |       |           |       |       |       | $0.10      | $0.40       |
+| `google/gemini-2.0-flash-lite`                      | 1.0M    |       |           |       |       |       | $0.07      | $0.30       |
+| `google/gemini-2.5-flash`                           | 1.0M    |       |           |       |       |       | $0.30      | $3          |
+| `google/gemini-2.5-flash-image`                     | 33K     |       |           |       |       |       | $0.30      | $30         |
+| `google/gemini-2.5-flash-image-preview`             | 33K     |       |           |       |       |       | $0.30      | $30         |
+| `google/gemini-2.5-flash-lite`                      | 1.0M    |       |           |       |       |       | $0.10      | $0.40       |
+| `google/gemini-2.5-flash-lite-preview-06-17`        | 1.0M    |       |           |       |       |       | $0.10      | $0.40       |
+| `google/gemini-2.5-flash-lite-preview-09-2025`      | 1.0M    |       |           |       |       |       | $0.10      | $0.40       |
+| `google/gemini-2.5-flash-preview-04-17`             | 1.0M    |       |           |       |       |       | $0.15      | $0.60       |
+| `google/gemini-2.5-flash-preview-05-20`             | 1.0M    |       |           |       |       |       | $0.15      | $0.60       |
+| `google/gemini-2.5-flash-preview-09-2025`           | 1.0M    |       |           |       |       |       | $0.30      | $3          |
+| `google/gemini-2.5-flash-preview-tts`               | 8K      |       |           |       |       |       | $0.50      | $10         |
+| `google/gemini-2.5-pro`                             | 1.0M    |       |           |       |       |       | $1         | $10         |
+| `google/gemini-2.5-pro-preview-05-06`               | 1.0M    |       |           |       |       |       | $1         | $10         |
+| `google/gemini-2.5-pro-preview-06-05`               | 1.0M    |       |           |       |       |       | $1         | $10         |
+| `google/gemini-2.5-pro-preview-tts`                 | 8K      |       |           |       |       |       | $1         | $20         |
+| `google/gemini-3-flash-preview`                     | 1.0M    |       |           |       |       |       | $0.50      | $3          |
+| `google/gemini-3-pro-preview`                       | 1.0M    |       |           |       |       |       | $2         | $12         |
+| `google/gemini-embedding-001`                       | 2K      |       |           |       |       |       | $0.15      | —           |
+| `google/gemini-flash-latest`                        | 1.0M    |       |           |       |       |       | $0.30      | $3          |
+| `google/gemini-flash-lite-latest`                   | 1.0M    |       |           |       |       |       | $0.10      | $0.40       |
+| `google/gemini-live-2.5-flash`                      | 128K    |       |           |       |       |       | $0.50      | $2          |
+| `google/gemini-live-2.5-flash-preview-native-audio` | 131K    |       |           |       |       |       | $0.50      | $2          |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    id: "google/gemini-1.5-flash",
+    apiKey: process.env.GOOGLE_GENERATIVE_AI_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
+      ? "google/gemini-live-2.5-flash-preview-native-audio"
+      : "google/gemini-1.5-flash";
+  }
+});
+```
+
+## Provider Options
+
+Google supports the following provider-specific options via the `providerOptions` parameter:
+
+```typescript
+const response = await agent.generate("Hello!", {
+  providerOptions: {
+    google: {
+      // See available options in the table below
+    }
+  }
+});
+```
+
+### Available Options
+
+**responseModalities?:** (`("TEXT" | "IMAGE")[] | undefined`)
+
+**thinkingConfig?:** (`{ thinkingBudget?: number | undefined; includeThoughts?: boolean | undefined; thinkingLevel?: "minimal" | "low" | "medium" | "high" | undefined; } | undefined`)
+
+**cachedContent?:** (`string | undefined`)
+
+**structuredOutputs?:** (`boolean | undefined`)
+
+**safetySettings?:** (`{ category: "HARM_CATEGORY_UNSPECIFIED" | "HARM_CATEGORY_HATE_SPEECH" | "HARM_CATEGORY_DANGEROUS_CONTENT" | "HARM_CATEGORY_HARASSMENT" | "HARM_CATEGORY_SEXUALLY_EXPLICIT" | "HARM_CATEGORY_CIVIC_INTEGRITY"; threshold: "HARM_BLOCK_THRESHOLD_UNSPECIFIED" | ... 4 more ... | "OFF"; }[] | undefined`)
+
+**threshold?:** (`"HARM_BLOCK_THRESHOLD_UNSPECIFIED" | "BLOCK_LOW_AND_ABOVE" | "BLOCK_MEDIUM_AND_ABOVE" | "BLOCK_ONLY_HIGH" | "BLOCK_NONE" | "OFF" | undefined`)
+
+**audioTimestamp?:** (`boolean | undefined`)
+
+**labels?:** (`Record<string, string> | undefined`)
+
+**mediaResolution?:** (`"MEDIA_RESOLUTION_UNSPECIFIED" | "MEDIA_RESOLUTION_LOW" | "MEDIA_RESOLUTION_MEDIUM" | "MEDIA_RESOLUTION_HIGH" | undefined`)
+
+**imageConfig?:** (`{ aspectRatio?: "1:1" | "2:3" | "3:2" | "3:4" | "4:3" | "4:5" | "5:4" | "9:16" | "16:9" | "21:9" | undefined; imageSize?: "1K" | "2K" | "4K" | undefined; } | undefined`)
+
+**retrievalConfig?:** (`{ latLng?: { latitude: number; longitude: number; } | undefined; } | undefined`)
+
+## 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/google) for more details.
+
+**npm**:
+
+```bash
+npm install @ai-sdk/google
+```
+
+**pnpm**:
+
+```bash
+pnpm add @ai-sdk/google
+```
+
+**Yarn**:
+
+```bash
+yarn add @ai-sdk/google
+```
+
+**Bun**:
+
+```bash
+bun add @ai-sdk/google
+```

package/.docs/models/providers/groq.md

@@ -0,0 +1,107 @@
+# ![Groq logo](https://models.dev/logos/groq.svg)Groq
+
+Access 9 Groq models through Mastra's model router. Authentication is handled automatically using the `GROQ_API_KEY` environment variable.
+
+Learn more in the [Groq documentation](https://console.groq.com/docs/models).
+
+```bash
+GROQ_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: "groq/llama-3.1-8b-instant"
+});
+
+// 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 |
+| ---------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `groq/llama-3.1-8b-instant`                          | 131K    |       |           |       |       |       | $0.05      | $0.08       |
+| `groq/llama-3.3-70b-versatile`                       | 131K    |       |           |       |       |       | $0.59      | $0.79       |
+| `groq/meta-llama/llama-4-maverick-17b-128e-instruct` | 131K    |       |           |       |       |       | $0.20      | $0.60       |
+| `groq/meta-llama/llama-4-scout-17b-16e-instruct`     | 131K    |       |           |       |       |       | $0.11      | $0.34       |
+| `groq/meta-llama/llama-guard-4-12b`                  | 131K    |       |           |       |       |       | $0.20      | $0.20       |
+| `groq/moonshotai/kimi-k2-instruct-0905`              | 262K    |       |           |       |       |       | $1         | $3          |
+| `groq/openai/gpt-oss-120b`                           | 131K    |       |           |       |       |       | $0.15      | $0.60       |
+| `groq/openai/gpt-oss-20b`                            | 131K    |       |           |       |       |       | $0.07      | $0.30       |
+| `groq/qwen/qwen3-32b`                                | 131K    |       |           |       |       |       | $0.29      | $0.59       |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.groq.com/openai/v1",
+    id: "groq/llama-3.1-8b-instant",
+    apiKey: process.env.GROQ_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
+      ? "groq/qwen/qwen3-32b"
+      : "groq/llama-3.1-8b-instant";
+  }
+});
+```
+
+## 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/groq) for more details.
+
+**npm**:
+
+```bash
+npm install @ai-sdk/groq
+```
+
+**pnpm**:
+
+```bash
+pnpm add @ai-sdk/groq
+```
+
+**Yarn**:
+
+```bash
+yarn add @ai-sdk/groq
+```
+
+**Bun**:
+
+```bash
+bun add @ai-sdk/groq
+```
+
+For detailed provider-specific documentation, see the [AI SDK Groq provider docs](https://ai-sdk.dev/providers/ai-sdk-providers/groq).

package/.docs/models/providers/helicone.md

@@ -0,0 +1,161 @@
+# ![Helicone logo](https://models.dev/logos/helicone.svg)Helicone
+
+Access 91 Helicone models through Mastra's model router. Authentication is handled automatically using the `HELICONE_API_KEY` environment variable.
+
+Learn more in the [Helicone documentation](https://helicone.ai/models).
+
+```bash
+HELICONE_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: "helicone/chatgpt-4o-latest"
+});
+
+// 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 [Helicone documentation](https://helicone.ai/models) for details.
+
+## Models
+
+| Model                                    | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ---------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `helicone/chatgpt-4o-latest`             | 128K    |       |           |       |       |       | $5         | $20         |
+| `helicone/claude-3-haiku-20240307`       | 200K    |       |           |       |       |       | $0.25      | $1          |
+| `helicone/claude-3.5-haiku`              | 200K    |       |           |       |       |       | $0.80      | $4          |
+| `helicone/claude-3.5-sonnet-v2`          | 200K    |       |           |       |       |       | $3         | $15         |
+| `helicone/claude-3.7-sonnet`             | 200K    |       |           |       |       |       | $3         | $15         |
+| `helicone/claude-4.5-haiku`              | 200K    |       |           |       |       |       | $1         | $5          |
+| `helicone/claude-4.5-opus`               | 200K    |       |           |       |       |       | $5         | $25         |
+| `helicone/claude-4.5-sonnet`             | 200K    |       |           |       |       |       | $3         | $15         |
+| `helicone/claude-haiku-4-5-20251001`     | 200K    |       |           |       |       |       | $1         | $5          |
+| `helicone/claude-opus-4`                 | 200K    |       |           |       |       |       | $15        | $75         |
+| `helicone/claude-opus-4-1`               | 200K    |       |           |       |       |       | $15        | $75         |
+| `helicone/claude-opus-4-1-20250805`      | 200K    |       |           |       |       |       | $15        | $75         |
+| `helicone/claude-sonnet-4`               | 200K    |       |           |       |       |       | $3         | $15         |
+| `helicone/claude-sonnet-4-5-20250929`    | 200K    |       |           |       |       |       | $3         | $15         |
+| `helicone/codex-mini-latest`             | 200K    |       |           |       |       |       | $2         | $6          |
+| `helicone/deepseek-r1-distill-llama-70b` | 128K    |       |           |       |       |       | $0.03      | $0.13       |
+| `helicone/deepseek-reasoner`             | 128K    |       |           |       |       |       | $0.56      | $2          |
+| `helicone/deepseek-tng-r1t2-chimera`     | 130K    |       |           |       |       |       | $0.30      | $1          |
+| `helicone/deepseek-v3`                   | 128K    |       |           |       |       |       | $0.56      | $2          |
+| `helicone/deepseek-v3.1-terminus`        | 128K    |       |           |       |       |       | $0.27      | $1          |
+| `helicone/deepseek-v3.2`                 | 164K    |       |           |       |       |       | $0.27      | $0.41       |
+| `helicone/ernie-4.5-21b-a3b-thinking`    | 128K    |       |           |       |       |       | $0.07      | $0.28       |
+| `helicone/gemini-2.5-flash`              | 1.0M    |       |           |       |       |       | $0.30      | $3          |
+| `helicone/gemini-2.5-flash-lite`         | 1.0M    |       |           |       |       |       | $0.10      | $0.40       |
+| `helicone/gemini-2.5-pro`                | 1.0M    |       |           |       |       |       | $1         | $10         |
+| `helicone/gemini-3-pro-preview`          | 1.0M    |       |           |       |       |       | $2         | $12         |
+| `helicone/gemma-3-12b-it`                | 131K    |       |           |       |       |       | $0.05      | $0.10       |
+| `helicone/gemma2-9b-it`                  | 8K      |       |           |       |       |       | $0.01      | $0.03       |
+| `helicone/glm-4.6`                       | 205K    |       |           |       |       |       | $0.45      | $2          |
+| `helicone/gpt-4.1`                       | 1.0M    |       |           |       |       |       | $2         | $8          |
+| `helicone/gpt-4.1-mini`                  | 1.0M    |       |           |       |       |       | $0.40      | $2          |
+| `helicone/gpt-4.1-mini-2025-04-14`       | 1.0M    |       |           |       |       |       | $0.40      | $2          |
+| `helicone/gpt-4.1-nano`                  | 1.0M    |       |           |       |       |       | $0.10      | $0.40       |
+| `helicone/gpt-4o`                        | 128K    |       |           |       |       |       | $3         | $10         |
+| `helicone/gpt-4o-mini`                   | 128K    |       |           |       |       |       | $0.15      | $0.60       |
+| `helicone/gpt-5`                         | 400K    |       |           |       |       |       | $1         | $10         |
+| `helicone/gpt-5-chat-latest`             | 128K    |       |           |       |       |       | $1         | $10         |
+| `helicone/gpt-5-codex`                   | 400K    |       |           |       |       |       | $1         | $10         |
+| `helicone/gpt-5-mini`                    | 400K    |       |           |       |       |       | $0.25      | $2          |
+| `helicone/gpt-5-nano`                    | 400K    |       |           |       |       |       | $0.05      | $0.40       |
+| `helicone/gpt-5-pro`                     | 128K    |       |           |       |       |       | $15        | $120        |
+| `helicone/gpt-5.1`                       | 400K    |       |           |       |       |       | $1         | $10         |
+| `helicone/gpt-5.1-chat-latest`           | 128K    |       |           |       |       |       | $1         | $10         |
+| `helicone/gpt-5.1-codex`                 | 400K    |       |           |       |       |       | $1         | $10         |
+| `helicone/gpt-5.1-codex-mini`            | 400K    |       |           |       |       |       | $0.25      | $2          |
+| `helicone/gpt-oss-120b`                  | 131K    |       |           |       |       |       | $0.04      | $0.16       |
+| `helicone/gpt-oss-20b`                   | 131K    |       |           |       |       |       | $0.05      | $0.20       |
+| `helicone/grok-3`                        | 131K    |       |           |       |       |       | $3         | $15         |
+| `helicone/grok-3-mini`                   | 131K    |       |           |       |       |       | $0.30      | $0.50       |
+| `helicone/grok-4`                        | 256K    |       |           |       |       |       | $3         | $15         |
+| `helicone/grok-4-1-fast-non-reasoning`   | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
+| `helicone/grok-4-1-fast-reasoning`       | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
+| `helicone/grok-4-fast-non-reasoning`     | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
+| `helicone/grok-4-fast-reasoning`         | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
+| `helicone/grok-code-fast-1`              | 256K    |       |           |       |       |       | $0.20      | $2          |
+| `helicone/hermes-2-pro-llama-3-8b`       | 131K    |       |           |       |       |       | $0.14      | $0.14       |
+| `helicone/kimi-k2-0711`                  | 131K    |       |           |       |       |       | $0.57      | $2          |
+| `helicone/kimi-k2-0905`                  | 262K    |       |           |       |       |       | $0.50      | $2          |
+| `helicone/kimi-k2-thinking`              | 256K    |       |           |       |       |       | $0.48      | $2          |
+| `helicone/llama-3.1-8b-instant`          | 131K    |       |           |       |       |       | $0.05      | $0.08       |
+| `helicone/llama-3.1-8b-instruct`         | 16K     |       |           |       |       |       | $0.02      | $0.05       |
+| `helicone/llama-3.1-8b-instruct-turbo`   | 128K    |       |           |       |       |       | $0.02      | $0.03       |
+| `helicone/llama-3.3-70b-instruct`        | 128K    |       |           |       |       |       | $0.13      | $0.39       |
+| `helicone/llama-3.3-70b-versatile`       | 131K    |       |           |       |       |       | $0.59      | $0.79       |
+| `helicone/llama-4-maverick`              | 131K    |       |           |       |       |       | $0.15      | $0.60       |
+| `helicone/llama-4-scout`                 | 131K    |       |           |       |       |       | $0.08      | $0.30       |
+| `helicone/llama-guard-4`                 | 131K    |       |           |       |       |       | $0.21      | $0.21       |
+| `helicone/llama-prompt-guard-2-22m`      | 512     |       |           |       |       |       | $0.01      | $0.01       |
+| `helicone/llama-prompt-guard-2-86m`      | 512     |       |           |       |       |       | $0.01      | $0.01       |
+| `helicone/mistral-large-2411`            | 128K    |       |           |       |       |       | $2         | $6          |
+| `helicone/mistral-nemo`                  | 128K    |       |           |       |       |       | $20        | $40         |
+| `helicone/mistral-small`                 | 128K    |       |           |       |       |       | $75        | $200        |
+| `helicone/o1`                            | 200K    |       |           |       |       |       | $15        | $60         |
+| `helicone/o1-mini`                       | 128K    |       |           |       |       |       | $1         | $4          |
+| `helicone/o3`                            | 200K    |       |           |       |       |       | $2         | $8          |
+| `helicone/o3-mini`                       | 200K    |       |           |       |       |       | $1         | $4          |
+| `helicone/o3-pro`                        | 200K    |       |           |       |       |       | $20        | $80         |
+| `helicone/o4-mini`                       | 200K    |       |           |       |       |       | $1         | $4          |
+| `helicone/qwen2.5-coder-7b-fast`         | 32K     |       |           |       |       |       | $0.03      | $0.09       |
+| `helicone/qwen3-235b-a22b-thinking`      | 262K    |       |           |       |       |       | $0.30      | $3          |
+| `helicone/qwen3-30b-a3b`                 | 41K     |       |           |       |       |       | $0.08      | $0.29       |
+| `helicone/qwen3-32b`                     | 131K    |       |           |       |       |       | $0.29      | $0.59       |
+| `helicone/qwen3-coder`                   | 262K    |       |           |       |       |       | $0.22      | $0.95       |
+| `helicone/qwen3-coder-30b-a3b-instruct`  | 262K    |       |           |       |       |       | $0.10      | $0.30       |
+| `helicone/qwen3-next-80b-a3b-instruct`   | 262K    |       |           |       |       |       | $0.14      | $1          |
+| `helicone/qwen3-vl-235b-a22b-instruct`   | 256K    |       |           |       |       |       | $0.30      | $2          |
+| `helicone/sonar`                         | 127K    |       |           |       |       |       | $1         | $1          |
+| `helicone/sonar-deep-research`           | 127K    |       |           |       |       |       | $2         | $8          |
+| `helicone/sonar-pro`                     | 200K    |       |           |       |       |       | $3         | $15         |
+| `helicone/sonar-reasoning`               | 127K    |       |           |       |       |       | $1         | $5          |
+| `helicone/sonar-reasoning-pro`           | 127K    |       |           |       |       |       | $2         | $8          |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://ai-gateway.helicone.ai/v1",
+    id: "helicone/chatgpt-4o-latest",
+    apiKey: process.env.HELICONE_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
+      ? "helicone/sonar-reasoning-pro"
+      : "helicone/chatgpt-4o-latest";
+  }
+});
+```

package/.docs/models/providers/huggingface.md

@@ -0,0 +1,90 @@
+# ![Hugging Face logo](https://models.dev/logos/huggingface.svg)Hugging Face
+
+Access 20 Hugging Face models through Mastra's model router. Authentication is handled automatically using the `HF_TOKEN` environment variable.
+
+Learn more in the [Hugging Face documentation](https://huggingface.co).
+
+```bash
+HF_TOKEN=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: "huggingface/MiniMaxAI/MiniMax-M2.1"
+});
+
+// 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 [Hugging Face documentation](https://huggingface.co) for details.
+
+## Models
+
+| Model                                             | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `huggingface/deepseek-ai/DeepSeek-R1-0528`        | 164K    |       |           |       |       |       | $3         | $5          |
+| `huggingface/deepseek-ai/DeepSeek-V3.2`           | 164K    |       |           |       |       |       | $0.28      | $0.40       |
+| `huggingface/MiniMaxAI/MiniMax-M2.1`              | 205K    |       |           |       |       |       | $0.30      | $1          |
+| `huggingface/MiniMaxAI/MiniMax-M2.5`              | 205K    |       |           |       |       |       | $0.30      | $1          |
+| `huggingface/moonshotai/Kimi-K2-Instruct`         | 131K    |       |           |       |       |       | $1         | $3          |
+| `huggingface/moonshotai/Kimi-K2-Instruct-0905`    | 262K    |       |           |       |       |       | $1         | $3          |
+| `huggingface/moonshotai/Kimi-K2-Thinking`         | 262K    |       |           |       |       |       | $0.60      | $3          |
+| `huggingface/moonshotai/Kimi-K2.5`                | 262K    |       |           |       |       |       | $0.60      | $3          |
+| `huggingface/Qwen/Qwen3-235B-A22B-Thinking-2507`  | 262K    |       |           |       |       |       | $0.30      | $3          |
+| `huggingface/Qwen/Qwen3-Coder-480B-A35B-Instruct` | 262K    |       |           |       |       |       | $2         | $2          |
+| `huggingface/Qwen/Qwen3-Coder-Next`               | 262K    |       |           |       |       |       | $0.20      | $2          |
+| `huggingface/Qwen/Qwen3-Embedding-4B`             | 32K     |       |           |       |       |       | $0.01      | —           |
+| `huggingface/Qwen/Qwen3-Embedding-8B`             | 32K     |       |           |       |       |       | $0.01      | —           |
+| `huggingface/Qwen/Qwen3-Next-80B-A3B-Instruct`    | 262K    |       |           |       |       |       | $0.25      | $1          |
+| `huggingface/Qwen/Qwen3-Next-80B-A3B-Thinking`    | 262K    |       |           |       |       |       | $0.30      | $2          |
+| `huggingface/Qwen/Qwen3.5-397B-A17B`              | 262K    |       |           |       |       |       | $0.60      | $4          |
+| `huggingface/XiaomiMiMo/MiMo-V2-Flash`            | 262K    |       |           |       |       |       | $0.10      | $0.30       |
+| `huggingface/zai-org/GLM-4.7`                     | 205K    |       |           |       |       |       | $0.60      | $2          |
+| `huggingface/zai-org/GLM-4.7-Flash`               | 200K    |       |           |       |       |       | —          | —           |
+| `huggingface/zai-org/GLM-5`                       | 203K    |       |           |       |       |       | $1         | $3          |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://router.huggingface.co/v1",
+    id: "huggingface/MiniMaxAI/MiniMax-M2.1",
+    apiKey: process.env.HF_TOKEN,
+    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
+      ? "huggingface/zai-org/GLM-5"
+      : "huggingface/MiniMaxAI/MiniMax-M2.1";
+  }
+});
+```

package/.docs/models/providers/iflowcn.md

@@ -0,0 +1,84 @@
+# ![iFlow logo](https://models.dev/logos/iflowcn.svg)iFlow
+
+Access 14 iFlow models through Mastra's model router. Authentication is handled automatically using the `IFLOW_API_KEY` environment variable.
+
+Learn more in the [iFlow documentation](https://platform.iflow.cn/en/docs).
+
+```bash
+IFLOW_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: "iflowcn/deepseek-r1"
+});
+
+// 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 [iFlow documentation](https://platform.iflow.cn/en/docs) for details.
+
+## Models
+
+| Model                                   | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| --------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `iflowcn/deepseek-r1`                   | 128K    |       |           |       |       |       | —          | —           |
+| `iflowcn/deepseek-v3`                   | 128K    |       |           |       |       |       | —          | —           |
+| `iflowcn/deepseek-v3.2`                 | 128K    |       |           |       |       |       | —          | —           |
+| `iflowcn/glm-4.6`                       | 200K    |       |           |       |       |       | —          | —           |
+| `iflowcn/kimi-k2`                       | 128K    |       |           |       |       |       | —          | —           |
+| `iflowcn/kimi-k2-0905`                  | 256K    |       |           |       |       |       | —          | —           |
+| `iflowcn/qwen3-235b`                    | 128K    |       |           |       |       |       | —          | —           |
+| `iflowcn/qwen3-235b-a22b-instruct`      | 256K    |       |           |       |       |       | —          | —           |
+| `iflowcn/qwen3-235b-a22b-thinking-2507` | 256K    |       |           |       |       |       | —          | —           |
+| `iflowcn/qwen3-32b`                     | 128K    |       |           |       |       |       | —          | —           |
+| `iflowcn/qwen3-coder-plus`              | 256K    |       |           |       |       |       | —          | —           |
+| `iflowcn/qwen3-max`                     | 256K    |       |           |       |       |       | —          | —           |
+| `iflowcn/qwen3-max-preview`             | 256K    |       |           |       |       |       | —          | —           |
+| `iflowcn/qwen3-vl-plus`                 | 256K    |       |           |       |       |       | —          | —           |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://apis.iflow.cn/v1",
+    id: "iflowcn/deepseek-r1",
+    apiKey: process.env.IFLOW_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
+      ? "iflowcn/qwen3-vl-plus"
+      : "iflowcn/deepseek-r1";
+  }
+});
+```