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

package/.docs/models/providers/opencode.md

@@ -0,0 +1,100 @@
+# ![OpenCode Zen logo](https://models.dev/logos/opencode.svg)OpenCode Zen
+
+Access 30 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
+
+Learn more in the [OpenCode Zen documentation](https://opencode.ai/docs/zen).
+
+```bash
+OPENCODE_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: "opencode/big-pickle"
+});
+
+// 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 [OpenCode Zen documentation](https://opencode.ai/docs/zen) for details.
+
+## Models
+
+| Model                         | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ----------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `opencode/big-pickle`         | 200K    |       |           |       |       |       | —          | —           |
+| `opencode/claude-3-5-haiku`   | 200K    |       |           |       |       |       | $0.80      | $4          |
+| `opencode/claude-haiku-4-5`   | 200K    |       |           |       |       |       | $1         | $5          |
+| `opencode/claude-opus-4-1`    | 200K    |       |           |       |       |       | $15        | $75         |
+| `opencode/claude-opus-4-5`    | 200K    |       |           |       |       |       | $5         | $25         |
+| `opencode/claude-opus-4-6`    | 1.0M    |       |           |       |       |       | $5         | $25         |
+| `opencode/claude-sonnet-4`    | 1.0M    |       |           |       |       |       | $3         | $15         |
+| `opencode/claude-sonnet-4-5`  | 1.0M    |       |           |       |       |       | $3         | $15         |
+| `opencode/gemini-3-flash`     | 1.0M    |       |           |       |       |       | $0.50      | $3          |
+| `opencode/gemini-3-pro`       | 1.0M    |       |           |       |       |       | $2         | $12         |
+| `opencode/glm-4.6`            | 205K    |       |           |       |       |       | $0.60      | $2          |
+| `opencode/glm-4.7`            | 205K    |       |           |       |       |       | $0.60      | $2          |
+| `opencode/glm-5`              | 205K    |       |           |       |       |       | $1         | $3          |
+| `opencode/glm-5-free`         | 205K    |       |           |       |       |       | —          | —           |
+| `opencode/gpt-5`              | 400K    |       |           |       |       |       | $1         | $9          |
+| `opencode/gpt-5-codex`        | 400K    |       |           |       |       |       | $1         | $9          |
+| `opencode/gpt-5-nano`         | 400K    |       |           |       |       |       | —          | —           |
+| `opencode/gpt-5.1`            | 400K    |       |           |       |       |       | $1         | $9          |
+| `opencode/gpt-5.1-codex`      | 400K    |       |           |       |       |       | $1         | $9          |
+| `opencode/gpt-5.1-codex-max`  | 400K    |       |           |       |       |       | $1         | $10         |
+| `opencode/gpt-5.1-codex-mini` | 400K    |       |           |       |       |       | $0.25      | $2          |
+| `opencode/gpt-5.2`            | 400K    |       |           |       |       |       | $2         | $14         |
+| `opencode/gpt-5.2-codex`      | 400K    |       |           |       |       |       | $2         | $14         |
+| `opencode/kimi-k2`            | 262K    |       |           |       |       |       | $0.40      | $3          |
+| `opencode/kimi-k2-thinking`   | 262K    |       |           |       |       |       | $0.40      | $3          |
+| `opencode/kimi-k2.5`          | 262K    |       |           |       |       |       | $0.60      | $3          |
+| `opencode/kimi-k2.5-free`     | 262K    |       |           |       |       |       | —          | —           |
+| `opencode/minimax-m2.1`       | 205K    |       |           |       |       |       | $0.30      | $1          |
+| `opencode/minimax-m2.5`       | 205K    |       |           |       |       |       | $0.30      | $1          |
+| `opencode/minimax-m2.5-free`  | 205K    |       |           |       |       |       | —          | —           |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://opencode.ai/zen/v1",
+    id: "opencode/big-pickle",
+    apiKey: process.env.OPENCODE_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
+      ? "opencode/minimax-m2.5-free"
+      : "opencode/big-pickle";
+  }
+});
+```

package/.docs/models/providers/ovhcloud.md

@@ -0,0 +1,83 @@
+# ![OVHcloud AI Endpoints logo](https://models.dev/logos/ovhcloud.svg)OVHcloud AI Endpoints
+
+Access 13 OVHcloud AI Endpoints models through Mastra's model router. Authentication is handled automatically using the `OVHCLOUD_API_KEY` environment variable.
+
+Learn more in the [OVHcloud AI Endpoints documentation](https://www.ovhcloud.com/en/public-cloud/ai-endpoints/catalog//).
+
+```bash
+OVHCLOUD_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: "ovhcloud/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 [OVHcloud AI Endpoints documentation](https://www.ovhcloud.com/en/public-cloud/ai-endpoints/catalog//) for details.
+
+## Models
+
+| Model                                          | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ---------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `ovhcloud/deepseek-r1-distill-llama-70b`       | 131K    |       |           |       |       |       | $0.74      | $0.74       |
+| `ovhcloud/gpt-oss-120b`                        | 131K    |       |           |       |       |       | $0.09      | $0.47       |
+| `ovhcloud/gpt-oss-20b`                         | 131K    |       |           |       |       |       | $0.05      | $0.18       |
+| `ovhcloud/llama-3.1-8b-instruct`               | 131K    |       |           |       |       |       | $0.11      | $0.11       |
+| `ovhcloud/meta-llama-3_3-70b-instruct`         | 131K    |       |           |       |       |       | $0.74      | $0.74       |
+| `ovhcloud/mistral-7b-instruct-v0.3`            | 66K     |       |           |       |       |       | $0.11      | $0.11       |
+| `ovhcloud/mistral-nemo-instruct-2407`          | 66K     |       |           |       |       |       | $0.14      | $0.14       |
+| `ovhcloud/mistral-small-3.2-24b-instruct-2506` | 131K    |       |           |       |       |       | $0.10      | $0.31       |
+| `ovhcloud/mixtral-8x7b-instruct-v0.1`          | 33K     |       |           |       |       |       | $0.70      | $0.70       |
+| `ovhcloud/qwen2.5-coder-32b-instruct`          | 33K     |       |           |       |       |       | $0.96      | $0.96       |
+| `ovhcloud/qwen2.5-vl-72b-instruct`             | 33K     |       |           |       |       |       | $1         | $1          |
+| `ovhcloud/qwen3-32b`                           | 33K     |       |           |       |       |       | $0.09      | $0.25       |
+| `ovhcloud/qwen3-coder-30b-a3b-instruct`        | 262K    |       |           |       |       |       | $0.07      | $0.26       |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://oai.endpoints.kepler.ai.cloud.ovh.net/v1",
+    id: "ovhcloud/deepseek-r1-distill-llama-70b",
+    apiKey: process.env.OVHCLOUD_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
+      ? "ovhcloud/qwen3-coder-30b-a3b-instruct"
+      : "ovhcloud/deepseek-r1-distill-llama-70b";
+  }
+});
+```

package/.docs/models/providers/perplexity.md

@@ -0,0 +1,100 @@
+# ![Perplexity logo](https://models.dev/logos/perplexity.svg)Perplexity
+
+Access 3 Perplexity models through Mastra's model router. Authentication is handled automatically using the `PERPLEXITY_API_KEY` environment variable.
+
+Learn more in the [Perplexity documentation](https://docs.perplexity.ai).
+
+```bash
+PERPLEXITY_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: "perplexity/sonar"
+});
+
+// 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 |
+| -------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `perplexity/sonar`               | 128K    |       |           |       |       |       | $1         | $1          |
+| `perplexity/sonar-pro`           | 200K    |       |           |       |       |       | $3         | $15         |
+| `perplexity/sonar-reasoning-pro` | 128K    |       |           |       |       |       | $2         | $8          |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    id: "perplexity/sonar",
+    apiKey: process.env.PERPLEXITY_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
+      ? "perplexity/sonar-reasoning-pro"
+      : "perplexity/sonar";
+  }
+});
+```
+
+## 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/perplexity) for more details.
+
+**npm**:
+
+```bash
+npm install @ai-sdk/perplexity
+```
+
+**pnpm**:
+
+```bash
+pnpm add @ai-sdk/perplexity
+```
+
+**Yarn**:
+
+```bash
+yarn add @ai-sdk/perplexity
+```
+
+**Bun**:
+
+```bash
+bun add @ai-sdk/perplexity
+```
+
+For detailed provider-specific documentation, see the [AI SDK Perplexity provider docs](https://ai-sdk.dev/providers/ai-sdk-providers/perplexity).

package/.docs/models/providers/poe.md

@@ -0,0 +1,183 @@
+# ![Poe logo](https://models.dev/logos/poe.svg)Poe
+
+Access 113 Poe models through Mastra's model router. Authentication is handled automatically using the `POE_API_KEY` environment variable.
+
+Learn more in the [Poe documentation](https://creator.poe.com/docs/external-applications/openai-compatible-api).
+
+```bash
+POE_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: "poe/anthropic/claude-haiku-3"
+});
+
+// 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 [Poe documentation](https://creator.poe.com/docs/external-applications/openai-compatible-api) for details.
+
+## Models
+
+| Model                                  | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| -------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `poe/anthropic/claude-haiku-3`         | 189K    |       |           |       |       |       | $0.21      | $1          |
+| `poe/anthropic/claude-haiku-3.5`       | 189K    |       |           |       |       |       | $0.68      | $3          |
+| `poe/anthropic/claude-haiku-4.5`       | 192K    |       |           |       |       |       | $0.85      | $4          |
+| `poe/anthropic/claude-opus-4`          | 193K    |       |           |       |       |       | $13        | $64         |
+| `poe/anthropic/claude-opus-4.1`        | 197K    |       |           |       |       |       | $13        | $64         |
+| `poe/anthropic/claude-opus-4.5`        | 197K    |       |           |       |       |       | $4         | $21         |
+| `poe/anthropic/claude-opus-4.6`        | 983K    |       |           |       |       |       | $4         | $21         |
+| `poe/anthropic/claude-sonnet-3.5`      | 189K    |       |           |       |       |       | $3         | $13         |
+| `poe/anthropic/claude-sonnet-3.5-june` | 189K    |       |           |       |       |       | $3         | $13         |
+| `poe/anthropic/claude-sonnet-3.7`      | 197K    |       |           |       |       |       | $3         | $13         |
+| `poe/anthropic/claude-sonnet-4`        | 983K    |       |           |       |       |       | $3         | $13         |
+| `poe/anthropic/claude-sonnet-4.5`      | 983K    |       |           |       |       |       | $3         | $13         |
+| `poe/cerebras/gpt-oss-120b-cs`         | —       |       |           |       |       |       | —          | —           |
+| `poe/cerebras/llama-3.1-8b-cs`         | —       |       |           |       |       |       | —          | —           |
+| `poe/cerebras/llama-3.3-70b-cs`        | —       |       |           |       |       |       | —          | —           |
+| `poe/cerebras/qwen3-235b-2507-cs`      | —       |       |           |       |       |       | —          | —           |
+| `poe/cerebras/qwen3-32b-cs`            | —       |       |           |       |       |       | —          | —           |
+| `poe/elevenlabs/elevenlabs-music`      | 2K      |       |           |       |       |       | —          | —           |
+| `poe/elevenlabs/elevenlabs-v2.5-turbo` | 128K    |       |           |       |       |       | —          | —           |
+| `poe/elevenlabs/elevenlabs-v3`         | 128K    |       |           |       |       |       | —          | —           |
+| `poe/google/gemini-2.0-flash`          | 990K    |       |           |       |       |       | $0.10      | $0.42       |
+| `poe/google/gemini-2.0-flash-lite`     | 990K    |       |           |       |       |       | $0.05      | $0.21       |
+| `poe/google/gemini-2.5-flash`          | 1.1M    |       |           |       |       |       | $0.21      | $2          |
+| `poe/google/gemini-2.5-flash-lite`     | 1.0M    |       |           |       |       |       | $0.07      | $0.28       |
+| `poe/google/gemini-2.5-pro`            | 1.1M    |       |           |       |       |       | $0.87      | $7          |
+| `poe/google/gemini-3-flash`            | 1.0M    |       |           |       |       |       | $0.40      | $2          |
+| `poe/google/gemini-3-pro`              | 1.0M    |       |           |       |       |       | $2         | $10         |
+| `poe/google/gemini-deep-research`      | 1.0M    |       |           |       |       |       | $2         | $10         |
+| `poe/google/imagen-3`                  | 480     |       |           |       |       |       | —          | —           |
+| `poe/google/imagen-3-fast`             | 480     |       |           |       |       |       | —          | —           |
+| `poe/google/imagen-4`                  | 480     |       |           |       |       |       | —          | —           |
+| `poe/google/imagen-4-fast`             | 480     |       |           |       |       |       | —          | —           |
+| `poe/google/imagen-4-ultra`            | 480     |       |           |       |       |       | —          | —           |
+| `poe/google/lyria`                     | —       |       |           |       |       |       | —          | —           |
+| `poe/google/nano-banana`               | 66K     |       |           |       |       |       | $0.21      | $2          |
+| `poe/google/nano-banana-pro`           | 66K     |       |           |       |       |       | $2         | $12         |
+| `poe/google/veo-2`                     | 480     |       |           |       |       |       | —          | —           |
+| `poe/google/veo-3`                     | 480     |       |           |       |       |       | —          | —           |
+| `poe/google/veo-3-fast`                | 480     |       |           |       |       |       | —          | —           |
+| `poe/google/veo-3.1`                   | 480     |       |           |       |       |       | —          | —           |
+| `poe/google/veo-3.1-fast`              | 480     |       |           |       |       |       | —          | —           |
+| `poe/ideogramai/ideogram`              | 150     |       |           |       |       |       | —          | —           |
+| `poe/ideogramai/ideogram-v2`           | 150     |       |           |       |       |       | —          | —           |
+| `poe/ideogramai/ideogram-v2a`          | 150     |       |           |       |       |       | —          | —           |
+| `poe/ideogramai/ideogram-v2a-turbo`    | 150     |       |           |       |       |       | —          | —           |
+| `poe/lumalabs/ray2`                    | 5K      |       |           |       |       |       | —          | —           |
+| `poe/novita/glm-4.6`                   | —       |       |           |       |       |       | —          | —           |
+| `poe/novita/glm-4.6v`                  | 131K    |       |           |       |       |       | —          | —           |
+| `poe/novita/glm-4.7`                   | 205K    |       |           |       |       |       | —          | —           |
+| `poe/novita/glm-4.7-flash`             | 200K    |       |           |       |       |       | —          | —           |
+| `poe/novita/glm-4.7-n`                 | 205K    |       |           |       |       |       | —          | —           |
+| `poe/novita/kimi-k2-thinking`          | 256K    |       |           |       |       |       | —          | —           |
+| `poe/novita/kimi-k2.5`                 | 256K    |       |           |       |       |       | —          | —           |
+| `poe/novita/minimax-m2.1`              | 205K    |       |           |       |       |       | —          | —           |
+| `poe/openai/chatgpt-4o-latest`         | 128K    |       |           |       |       |       | $5         | $14         |
+| `poe/openai/dall-e-3`                  | 800     |       |           |       |       |       | —          | —           |
+| `poe/openai/gpt-3.5-turbo`             | 16K     |       |           |       |       |       | $0.45      | $1          |
+| `poe/openai/gpt-3.5-turbo-instruct`    | 4K      |       |           |       |       |       | $1         | $2          |
+| `poe/openai/gpt-3.5-turbo-raw`         | 5K      |       |           |       |       |       | $0.45      | $1          |
+| `poe/openai/gpt-4-classic`             | 8K      |       |           |       |       |       | $27        | $54         |
+| `poe/openai/gpt-4-classic-0314`        | 8K      |       |           |       |       |       | $27        | $54         |
+| `poe/openai/gpt-4-turbo`               | 128K    |       |           |       |       |       | $9         | $27         |
+| `poe/openai/gpt-4.1`                   | 1.0M    |       |           |       |       |       | $2         | $7          |
+| `poe/openai/gpt-4.1-mini`              | 1.0M    |       |           |       |       |       | $0.36      | $1          |
+| `poe/openai/gpt-4.1-nano`              | 1.0M    |       |           |       |       |       | $0.09      | $0.36       |
+| `poe/openai/gpt-4o`                    | 128K    |       |           |       |       |       | —          | —           |
+| `poe/openai/gpt-4o-aug`                | 128K    |       |           |       |       |       | $2         | $9          |
+| `poe/openai/gpt-4o-mini`               | 128K    |       |           |       |       |       | $0.14      | $0.54       |
+| `poe/openai/gpt-4o-mini-search`        | 128K    |       |           |       |       |       | $0.14      | $0.54       |
+| `poe/openai/gpt-4o-search`             | 128K    |       |           |       |       |       | $2         | $9          |
+| `poe/openai/gpt-5`                     | 400K    |       |           |       |       |       | $1         | $9          |
+| `poe/openai/gpt-5-chat`                | 128K    |       |           |       |       |       | $1         | $9          |
+| `poe/openai/gpt-5-codex`               | 400K    |       |           |       |       |       | $1         | $9          |
+| `poe/openai/gpt-5-mini`                | 400K    |       |           |       |       |       | $0.22      | $2          |
+| `poe/openai/gpt-5-nano`                | 400K    |       |           |       |       |       | $0.04      | $0.36       |
+| `poe/openai/gpt-5-pro`                 | 400K    |       |           |       |       |       | $14        | $110        |
+| `poe/openai/gpt-5.1`                   | 400K    |       |           |       |       |       | $1         | $9          |
+| `poe/openai/gpt-5.1-codex`             | 400K    |       |           |       |       |       | $1         | $9          |
+| `poe/openai/gpt-5.1-codex-max`         | 400K    |       |           |       |       |       | $1         | $9          |
+| `poe/openai/gpt-5.1-codex-mini`        | 400K    |       |           |       |       |       | $0.22      | $2          |
+| `poe/openai/gpt-5.1-instant`           | 128K    |       |           |       |       |       | $1         | $9          |
+| `poe/openai/gpt-5.2`                   | 400K    |       |           |       |       |       | $2         | $13         |
+| `poe/openai/gpt-5.2-codex`             | 400K    |       |           |       |       |       | $2         | $13         |
+| `poe/openai/gpt-5.2-instant`           | 128K    |       |           |       |       |       | $2         | $13         |
+| `poe/openai/gpt-5.2-pro`               | 400K    |       |           |       |       |       | $19        | $150        |
+| `poe/openai/gpt-image-1`               | 128K    |       |           |       |       |       | —          | —           |
+| `poe/openai/gpt-image-1-mini`          | —       |       |           |       |       |       | —          | —           |
+| `poe/openai/gpt-image-1.5`             | 128K    |       |           |       |       |       | —          | —           |
+| `poe/openai/o1`                        | 200K    |       |           |       |       |       | $14        | $54         |
+| `poe/openai/o1-pro`                    | 200K    |       |           |       |       |       | $140       | $540        |
+| `poe/openai/o3`                        | 200K    |       |           |       |       |       | $2         | $7          |
+| `poe/openai/o3-deep-research`          | 200K    |       |           |       |       |       | $9         | $36         |
+| `poe/openai/o3-mini`                   | 200K    |       |           |       |       |       | $0.99      | $4          |
+| `poe/openai/o3-mini-high`              | 200K    |       |           |       |       |       | $0.99      | $4          |
+| `poe/openai/o3-pro`                    | 200K    |       |           |       |       |       | $18        | $72         |
+| `poe/openai/o4-mini`                   | 200K    |       |           |       |       |       | $0.99      | $4          |
+| `poe/openai/o4-mini-deep-research`     | 200K    |       |           |       |       |       | $2         | $7          |
+| `poe/openai/sora-2`                    | —       |       |           |       |       |       | —          | —           |
+| `poe/openai/sora-2-pro`                | —       |       |           |       |       |       | —          | —           |
+| `poe/poetools/claude-code`             | —       |       |           |       |       |       | —          | —           |
+| `poe/runwayml/runway`                  | 256     |       |           |       |       |       | —          | —           |
+| `poe/runwayml/runway-gen-4-turbo`      | 256     |       |           |       |       |       | —          | —           |
+| `poe/stabilityai/stablediffusionxl`    | 200     |       |           |       |       |       | —          | —           |
+| `poe/topazlabs-co/topazlabs`           | 204     |       |           |       |       |       | —          | —           |
+| `poe/trytako/tako`                     | 2K      |       |           |       |       |       | —          | —           |
+| `poe/xai/grok-3`                       | 131K    |       |           |       |       |       | $3         | $15         |
+| `poe/xai/grok-3-mini`                  | 131K    |       |           |       |       |       | $0.30      | $0.50       |
+| `poe/xai/grok-4`                       | 256K    |       |           |       |       |       | $3         | $15         |
+| `poe/xai/grok-4-fast-non-reasoning`    | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
+| `poe/xai/grok-4-fast-reasoning`        | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
+| `poe/xai/grok-4.1-fast-non-reasoning`  | 2.0M    |       |           |       |       |       | —          | —           |
+| `poe/xai/grok-4.1-fast-reasoning`      | 2.0M    |       |           |       |       |       | —          | —           |
+| `poe/xai/grok-code-fast-1`             | 256K    |       |           |       |       |       | $0.20      | $2          |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.poe.com/v1",
+    id: "poe/anthropic/claude-haiku-3",
+    apiKey: process.env.POE_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
+      ? "poe/xai/grok-code-fast-1"
+      : "poe/anthropic/claude-haiku-3";
+  }
+});
+```

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

@@ -0,0 +1,75 @@
+# ![Privatemode AI logo](https://models.dev/logos/privatemode-ai.svg)Privatemode AI
+
+Access 5 Privatemode AI models through Mastra's model router. Authentication is handled automatically using the `PRIVATEMODE_API_KEY` environment variable.
+
+Learn more in the [Privatemode AI documentation](https://docs.privatemode.ai).
+
+```bash
+PRIVATEMODE_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: "privatemode-ai/gemma-3-27b"
+});
+
+// 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 [Privatemode AI documentation](https://docs.privatemode.ai) for details.
+
+## Models
+
+| Model                                | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `privatemode-ai/gemma-3-27b`         | 128K    |       |           |       |       |       | —          | —           |
+| `privatemode-ai/gpt-oss-120b`        | 128K    |       |           |       |       |       | —          | —           |
+| `privatemode-ai/qwen3-coder-30b-a3b` | 128K    |       |           |       |       |       | —          | —           |
+| `privatemode-ai/qwen3-embedding-4b`  | 32K     |       |           |       |       |       | —          | —           |
+| `privatemode-ai/whisper-large-v3`    | —       |       |           |       |       |       | —          | —           |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "http://localhost:8080/v1",
+    id: "privatemode-ai/gemma-3-27b",
+    apiKey: process.env.PRIVATEMODE_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
+      ? "privatemode-ai/whisper-large-v3"
+      : "privatemode-ai/gemma-3-27b";
+  }
+});
+```

package/.docs/models/providers/requesty.md

@@ -0,0 +1,90 @@
+# ![Requesty logo](https://models.dev/logos/requesty.svg)Requesty
+
+Access 20 Requesty models through Mastra's model router. Authentication is handled automatically using the `REQUESTY_API_KEY` environment variable.
+
+Learn more in the [Requesty documentation](https://requesty.ai/solution/llm-routing/models).
+
+```bash
+REQUESTY_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: "requesty/anthropic/claude-3-7-sonnet"
+});
+
+// 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 [Requesty documentation](https://requesty.ai/solution/llm-routing/models) for details.
+
+## Models
+
+| Model                                    | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ---------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `requesty/anthropic/claude-3-7-sonnet`   | 200K    |       |           |       |       |       | $3         | $15         |
+| `requesty/anthropic/claude-haiku-4-5`    | 200K    |       |           |       |       |       | $1         | $5          |
+| `requesty/anthropic/claude-opus-4`       | 200K    |       |           |       |       |       | $15        | $75         |
+| `requesty/anthropic/claude-opus-4-1`     | 200K    |       |           |       |       |       | $15        | $75         |
+| `requesty/anthropic/claude-opus-4-5`     | 200K    |       |           |       |       |       | $5         | $25         |
+| `requesty/anthropic/claude-sonnet-4`     | 200K    |       |           |       |       |       | $3         | $15         |
+| `requesty/anthropic/claude-sonnet-4-5`   | 1.0M    |       |           |       |       |       | $3         | $15         |
+| `requesty/google/gemini-2.5-flash`       | 1.0M    |       |           |       |       |       | $0.30      | $3          |
+| `requesty/google/gemini-2.5-pro`         | 1.0M    |       |           |       |       |       | $1         | $10         |
+| `requesty/google/gemini-3-flash-preview` | 1.0M    |       |           |       |       |       | $0.50      | $3          |
+| `requesty/google/gemini-3-pro-preview`   | 1.0M    |       |           |       |       |       | $2         | $12         |
+| `requesty/openai/gpt-4.1`                | 1.0M    |       |           |       |       |       | $2         | $8          |
+| `requesty/openai/gpt-4.1-mini`           | 1.0M    |       |           |       |       |       | $0.40      | $2          |
+| `requesty/openai/gpt-4o-mini`            | 128K    |       |           |       |       |       | $0.15      | $0.60       |
+| `requesty/openai/gpt-5`                  | 400K    |       |           |       |       |       | $1         | $10         |
+| `requesty/openai/gpt-5-mini`             | 128K    |       |           |       |       |       | $0.25      | $2          |
+| `requesty/openai/gpt-5-nano`             | 16K     |       |           |       |       |       | $0.05      | $0.40       |
+| `requesty/openai/o4-mini`                | 200K    |       |           |       |       |       | $1         | $4          |
+| `requesty/xai/grok-4`                    | 256K    |       |           |       |       |       | $3         | $15         |
+| `requesty/xai/grok-4-fast`               | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://router.requesty.ai/v1",
+    id: "requesty/anthropic/claude-3-7-sonnet",
+    apiKey: process.env.REQUESTY_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
+      ? "requesty/xai/grok-4-fast"
+      : "requesty/anthropic/claude-3-7-sonnet";
+  }
+});
+```