@mastra/mcp-docs-server 1.2.7-alpha.6 → 1.2.7

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (169) hide show
  1. package/.docs/docs/agent-builder/integrations.md +44 -2
  2. package/.docs/docs/agent-builder/skill-registries.md +1 -3
  3. package/.docs/docs/agent-controller/overview.md +1 -1
  4. package/.docs/docs/agent-controller/session.md +1 -3
  5. package/.docs/docs/agents/code-mode.md +17 -1
  6. package/.docs/docs/agents/guardrails.md +8 -8
  7. package/.docs/docs/agents/overview.md +2 -2
  8. package/.docs/docs/agents/processors.md +9 -3
  9. package/.docs/docs/agents/skills.md +2 -4
  10. package/.docs/docs/agents/structured-output.md +1 -1
  11. package/.docs/docs/agents/supervisor-agents.md +1 -3
  12. package/.docs/docs/agents/using-tools.md +4 -4
  13. package/.docs/docs/browser/agent-browser.md +1 -3
  14. package/.docs/docs/browser/browser-viewer.md +1 -3
  15. package/.docs/docs/browser/stagehand.md +1 -1
  16. package/.docs/docs/capabilities/channels/overview.md +1 -3
  17. package/.docs/docs/deployment/mastra-server.md +2 -4
  18. package/.docs/docs/editor/overview.md +2 -6
  19. package/.docs/docs/editor/prompts.md +1 -1
  20. package/.docs/docs/editor/tools.md +3 -5
  21. package/.docs/docs/evals/custom-scorers.md +1 -3
  22. package/.docs/docs/evals/datasets/overview.md +4 -4
  23. package/.docs/docs/evals/datasets/running-experiments.md +4 -2
  24. package/.docs/docs/evals/evals-with-memory.md +1 -3
  25. package/.docs/docs/evals/gates-and-verdicts.md +17 -2
  26. package/.docs/docs/evals/quick-checks.md +1 -3
  27. package/.docs/docs/getting-started/file-based-agents.md +9 -4
  28. package/.docs/docs/long-running-agents/background-tasks.md +1 -1
  29. package/.docs/docs/long-running-agents/durable-agents.md +3 -5
  30. package/.docs/docs/long-running-agents/goals.md +1 -3
  31. package/.docs/docs/long-running-agents/signal-providers.md +1 -3
  32. package/.docs/docs/long-running-agents/signals.md +7 -21
  33. package/.docs/docs/mastra-platform/configuration.md +15 -22
  34. package/.docs/docs/mastra-platform/database.md +50 -6
  35. package/.docs/docs/mastra-platform/deploy.md +142 -0
  36. package/.docs/docs/mastra-platform/environments.md +103 -0
  37. package/.docs/docs/mastra-platform/github.md +2 -2
  38. package/.docs/docs/mastra-platform/overview.md +5 -5
  39. package/.docs/docs/mastra-platform/server.md +2 -0
  40. package/.docs/docs/mastra-platform/studio.md +5 -3
  41. package/.docs/docs/mcp/mcp-apps.md +3 -3
  42. package/.docs/docs/mcp/overview.md +6 -10
  43. package/.docs/docs/memory/overview.md +4 -4
  44. package/.docs/docs/observability/integrations/exporters/mastra-platform.md +1 -3
  45. package/.docs/docs/observability/logging.md +3 -1
  46. package/.docs/docs/observability/metrics/querying.md +2 -0
  47. package/.docs/docs/observability/tracing/overview.md +3 -1
  48. package/.docs/docs/server/auth/auth0.md +1 -1
  49. package/.docs/docs/server/auth/better-auth.md +2 -2
  50. package/.docs/docs/server/auth/clerk.md +1 -1
  51. package/.docs/docs/server/auth/firebase.md +1 -1
  52. package/.docs/docs/server/auth/google.md +2 -2
  53. package/.docs/docs/server/auth/jwt.md +2 -2
  54. package/.docs/docs/server/auth/okta.md +2 -2
  55. package/.docs/docs/server/auth/workos.md +1 -1
  56. package/.docs/docs/server/mastra-client.md +1 -1
  57. package/.docs/docs/server/mastra-server.md +1 -1
  58. package/.docs/docs/server/pubsub.md +1 -1
  59. package/.docs/docs/server/request-context.md +4 -4
  60. package/.docs/docs/server/server-adapters.md +8 -8
  61. package/.docs/docs/studio/auth.md +1 -3
  62. package/.docs/docs/workflows/agents-and-tools.md +3 -5
  63. package/.docs/docs/workflows/control-flow.md +1 -1
  64. package/.docs/docs/workflows/overview.md +5 -5
  65. package/.docs/guides/build-your-ui/assistant-ui.md +1 -1
  66. package/.docs/guides/build-your-ui/copilotkit/overview.md +1 -1
  67. package/.docs/guides/concepts/streaming.md +3 -3
  68. package/.docs/guides/guide/chef-michel.md +1 -1
  69. package/.docs/guides/guide/coding-agent.md +392 -0
  70. package/.docs/guides/migrations/mastra-cloud.md +5 -12
  71. package/.docs/models/environment-variables.md +16 -2
  72. package/.docs/models/gateways/azure-openai.md +15 -15
  73. package/.docs/models/gateways/mastra.md +2 -2
  74. package/.docs/models/gateways/netlify.md +4 -1
  75. package/.docs/models/gateways/openrouter.md +10 -11
  76. package/.docs/models/gateways/vercel.md +9 -10
  77. package/.docs/models/index.md +1 -1
  78. package/.docs/models/providers/abacus.md +44 -14
  79. package/.docs/models/providers/ai-router.md +77 -0
  80. package/.docs/models/providers/ambient.md +10 -6
  81. package/.docs/models/providers/baseten.md +1 -1
  82. package/.docs/models/providers/blueclaw.md +74 -0
  83. package/.docs/models/providers/crossmodel.md +115 -0
  84. package/.docs/models/providers/daoxe.md +81 -0
  85. package/.docs/models/providers/databricks.md +7 -2
  86. package/.docs/models/providers/deepinfra.md +2 -2
  87. package/.docs/models/providers/deepseek.md +2 -2
  88. package/.docs/models/providers/ebcloud.md +76 -0
  89. package/.docs/models/providers/empiriolabs.md +108 -0
  90. package/.docs/models/providers/google.md +4 -0
  91. package/.docs/models/providers/hpc-ai.md +16 -10
  92. package/.docs/models/providers/inferx.md +78 -0
  93. package/.docs/models/providers/llmgateway.md +6 -7
  94. package/.docs/models/providers/lynkr.md +73 -0
  95. package/.docs/models/providers/meta.md +101 -0
  96. package/.docs/models/providers/model-oracle-ai.md +87 -0
  97. package/.docs/models/providers/nano-gpt.md +2 -2
  98. package/.docs/models/providers/neon.md +1 -1
  99. package/.docs/models/providers/nvidia.md +1 -3
  100. package/.docs/models/providers/openai.md +16 -3
  101. package/.docs/models/providers/opencode.md +5 -2
  102. package/.docs/models/providers/pioneer.md +148 -0
  103. package/.docs/models/providers/poolside.md +6 -5
  104. package/.docs/models/providers/routing-run.md +23 -34
  105. package/.docs/models/providers/snowflake-cortex.md +4 -1
  106. package/.docs/models/providers/stepfun-ai-step-plan.md +75 -0
  107. package/.docs/models/providers/stepfun-ai.md +6 -6
  108. package/.docs/models/providers/stepfun-step-plan.md +76 -0
  109. package/.docs/models/providers/stepfun.md +5 -5
  110. package/.docs/models/providers/the-grid-ai.md +3 -3
  111. package/.docs/models/providers/unorouter.md +95 -0
  112. package/.docs/models/providers/vivgrid.md +5 -2
  113. package/.docs/models/providers/wafer.ai.md +9 -12
  114. package/.docs/models/providers/xai.md +1 -1
  115. package/.docs/models/providers/zenmux.md +5 -1
  116. package/.docs/models/providers.md +16 -2
  117. package/.docs/reference/agents/generateLegacy.md +8 -2
  118. package/.docs/reference/cli/mastra.md +131 -10
  119. package/.docs/reference/code-sdk/mount-agent-controller.md +2 -0
  120. package/.docs/reference/coding-agent/create-coding-agent.md +5 -4
  121. package/.docs/reference/evals/create-scorer.md +63 -0
  122. package/.docs/reference/evals/run-evals.md +2 -2
  123. package/.docs/reference/file-based-agents/logger.md +26 -0
  124. package/.docs/reference/file-based-agents/scorers.md +54 -0
  125. package/.docs/reference/index.md +2 -0
  126. package/.docs/reference/mastra-platform/api.md +1 -1
  127. package/.docs/reference/observability/metrics/automatic-metrics.md +8 -8
  128. package/.docs/reference/observability/tracing/exporters/braintrust.md +1 -0
  129. package/.docs/reference/observability/tracing/exporters/datadog.md +10 -9
  130. package/.docs/reference/observability/tracing/exporters/langsmith.md +8 -7
  131. package/.docs/reference/observability/tracing/exporters/posthog.md +13 -12
  132. package/.docs/reference/observability/tracing/exporters/sentry.md +1 -0
  133. package/.docs/reference/observability/tracing/interfaces.md +9 -0
  134. package/.docs/reference/processors/stream-error-retry-processor.md +39 -2
  135. package/.docs/reference/pubsub/base.md +10 -0
  136. package/.docs/reference/pubsub/caching-pubsub.md +8 -0
  137. package/.docs/reference/pubsub/redis-streams.md +12 -0
  138. package/.docs/reference/server/express-adapter.md +1 -3
  139. package/.docs/reference/server/fastify-adapter.md +1 -3
  140. package/.docs/reference/server/hono-adapter.md +1 -3
  141. package/.docs/reference/server/koa-adapter.md +1 -3
  142. package/.docs/reference/server/nestjs-adapter.md +1 -3
  143. package/.docs/reference/server/register-api-route.md +5 -4
  144. package/.docs/reference/templates/overview.md +1 -1
  145. package/.docs/reference/tools/mcp-client.md +22 -0
  146. package/.docs/reference/tools/mcp-server.md +161 -4
  147. package/.docs/reference/voice/google.md +48 -8
  148. package/.docs/reference/voice/speechify.md +10 -6
  149. package/.docs/reference/workspace/agentcore-runtime-sandbox.md +1 -3
  150. package/.docs/reference/workspace/agentfs-filesystem.md +1 -3
  151. package/.docs/reference/workspace/apple-container-sandbox.md +1 -3
  152. package/.docs/reference/workspace/archil-filesystem.md +1 -3
  153. package/.docs/reference/workspace/azure-blob-filesystem.md +1 -3
  154. package/.docs/reference/workspace/blaxel-sandbox.md +1 -3
  155. package/.docs/reference/workspace/daytona-sandbox.md +1 -3
  156. package/.docs/reference/workspace/docker-sandbox.md +1 -3
  157. package/.docs/reference/workspace/e2b-sandbox.md +20 -3
  158. package/.docs/reference/workspace/files-sdk-filesystem.md +1 -3
  159. package/.docs/reference/workspace/gcs-filesystem.md +1 -3
  160. package/.docs/reference/workspace/google-drive-filesystem.md +1 -3
  161. package/.docs/reference/workspace/local-filesystem.md +1 -3
  162. package/.docs/reference/workspace/local-sandbox.md +1 -3
  163. package/.docs/reference/workspace/modal-sandbox.md +1 -3
  164. package/.docs/reference/workspace/railway-sandbox.md +1 -3
  165. package/.docs/reference/workspace/s3-filesystem.md +1 -3
  166. package/.docs/reference/workspace/vercel-sandbox.md +5 -7
  167. package/.docs/reference/workspace/vercel-serverless.md +1 -3
  168. package/CHANGELOG.md +86 -0
  169. package/package.json +10 -10
@@ -0,0 +1,78 @@
1
+ > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
2
+
3
+ # ![InferX logo](https://models.dev/logos/inferx.svg)InferX
4
+
5
+ Access 6 InferX models through Mastra's model router. Authentication is handled automatically using the `INFERX_API_KEY` environment variable.
6
+
7
+ Learn more in the [InferX documentation](https://model.inferx.net/endpoints).
8
+
9
+ ```bash
10
+ INFERX_API_KEY=your-api-key
11
+ ```
12
+
13
+ ```typescript
14
+ import { Agent } from "@mastra/core/agent";
15
+
16
+ const agent = new Agent({
17
+ id: "my-agent",
18
+ name: "My Agent",
19
+ instructions: "You are a helpful assistant",
20
+ model: "inferx/google/gemma-4-31b-it-fp8"
21
+ });
22
+
23
+ // Generate a response
24
+ const response = await agent.generate("Hello!");
25
+
26
+ // Stream a response
27
+ const stream = await agent.stream("Tell me a story");
28
+ for await (const chunk of stream) {
29
+ console.log(chunk);
30
+ }
31
+ ```
32
+
33
+ > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [InferX documentation](https://model.inferx.net/endpoints) for details.
34
+
35
+ ## Models
36
+
37
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
+ | ------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
+ | `inferx/google/gemma-4-31b-it-fp8` | 262K | | | | | | — | — |
40
+ | `inferx/qwen/qwen3-coder-next-fp8` | 256K | | | | | | — | — |
41
+ | `inferx/qwen/qwen3-coder-next-fp8-1m` | 1.0M | | | | | | — | — |
42
+ | `inferx/qwen/qwen3.5-122b-a10b-nvfp4` | 256K | | | | | | — | — |
43
+ | `inferx/qwen/qwen3.6-27b-fp8` | 262K | | | | | | — | — |
44
+ | `inferx/qwen/qwen3.6-35b-a3b-fp8` | 262K | | | | | | — | — |
45
+
46
+ ## Advanced configuration
47
+
48
+ ### Custom headers
49
+
50
+ ```typescript
51
+ const agent = new Agent({
52
+ id: "custom-agent",
53
+ name: "custom-agent",
54
+ model: {
55
+ url: "https://model.inferx.net/endpoints/v1",
56
+ id: "inferx/google/gemma-4-31b-it-fp8",
57
+ apiKey: process.env.INFERX_API_KEY,
58
+ headers: {
59
+ "X-Custom-Header": "value"
60
+ }
61
+ }
62
+ });
63
+ ```
64
+
65
+ ### Dynamic model selection
66
+
67
+ ```typescript
68
+ const agent = new Agent({
69
+ id: "dynamic-agent",
70
+ name: "Dynamic Agent",
71
+ model: ({ requestContext }) => {
72
+ const useAdvanced = requestContext.task === "complex";
73
+ return useAdvanced
74
+ ? "inferx/qwen/qwen3.6-35b-a3b-fp8"
75
+ : "inferx/google/gemma-4-31b-it-fp8";
76
+ }
77
+ });
78
+ ```
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![LLM Gateway logo](https://models.dev/logos/llmgateway.svg)LLM Gateway
4
4
 
5
- Access 177 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
5
+ Access 176 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [LLM Gateway documentation](https://llmgateway.io/docs).
8
8
 
@@ -113,6 +113,9 @@ for await (const chunk of stream) {
113
113
  | `llmgateway/gpt-5.4-pro` | 1.1M | | | | | | $30 | $180 |
114
114
  | `llmgateway/gpt-5.5` | 1.1M | | | | | | $5 | $30 |
115
115
  | `llmgateway/gpt-5.5-pro` | 1.1M | | | | | | $30 | $180 |
116
+ | `llmgateway/gpt-5.6-luna` | 1.1M | | | | | | $1 | $6 |
117
+ | `llmgateway/gpt-5.6-sol` | 1.1M | | | | | | $5 | $30 |
118
+ | `llmgateway/gpt-5.6-terra` | 1.1M | | | | | | $3 | $15 |
116
119
  | `llmgateway/gpt-oss-120b` | 131K | | | | | | $0.05 | $0.25 |
117
120
  | `llmgateway/gpt-oss-20b` | 131K | | | | | | $0.04 | $0.15 |
118
121
  | `llmgateway/grok-4` | 256K | | | | | | $3 | $15 |
@@ -140,8 +143,6 @@ for await (const chunk of stream) {
140
143
  | `llmgateway/llama-3.3-70b-instruct` | 131K | | | | | | $0.13 | $0.40 |
141
144
  | `llmgateway/llama-4-maverick-17b-instruct` | 1.0M | | | | | | $0.27 | $0.85 |
142
145
  | `llmgateway/llama-4-scout-17b-instruct` | 131K | | | | | | $0.18 | $0.59 |
143
- | `llmgateway/mimo-v2-omni` | 256K | | | | | | $0.40 | $2 |
144
- | `llmgateway/mimo-v2-pro` | 1.0M | | | | | | $1 | $3 |
145
146
  | `llmgateway/mimo-v2.5` | 1.0M | | | | | | $0.14 | $0.28 |
146
147
  | `llmgateway/mimo-v2.5-pro` | 1.0M | | | | | | $0.43 | $0.87 |
147
148
  | `llmgateway/minimax-m2` | 197K | | | | | | $0.20 | $1 |
@@ -159,6 +160,7 @@ for await (const chunk of stream) {
159
160
  | `llmgateway/mistral-large-2512` | 262K | | | | | | $0.50 | $2 |
160
161
  | `llmgateway/mistral-large-latest` | 128K | | | | | | $4 | $12 |
161
162
  | `llmgateway/mistral-small-2506` | 128K | | | | | | $0.10 | $0.30 |
163
+ | `llmgateway/muse-spark-1.1` | 1.0M | | | | | | $1 | $4 |
162
164
  | `llmgateway/nemotron-3-ultra-550b` | 262K | | | | | | $0.50 | $3 |
163
165
  | `llmgateway/o1` | 200K | | | | | | $15 | $60 |
164
166
  | `llmgateway/o3` | 200K | | | | | | $2 | $8 |
@@ -172,9 +174,6 @@ for await (const chunk of stream) {
172
174
  | `llmgateway/qwen-omni-turbo` | 33K | | | | | | $0.20 | $0.80 |
173
175
  | `llmgateway/qwen-plus` | 131K | | | | | | $0.40 | $1 |
174
176
  | `llmgateway/qwen-plus-latest` | 1.0M | | | | | | $0.40 | $1 |
175
- | `llmgateway/qwen-turbo` | 1.0M | | | | | | $0.05 | $0.20 |
176
- | `llmgateway/qwen-vl-max` | 131K | | | | | | $0.80 | $3 |
177
- | `llmgateway/qwen-vl-plus` | 131K | | | | | | $0.21 | $0.64 |
178
177
  | `llmgateway/qwen2-5-vl-32b-instruct` | 131K | | | | | | $1 | $4 |
179
178
  | `llmgateway/qwen2-5-vl-72b-instruct` | 33K | | | | | | $0.13 | $0.40 |
180
179
  | `llmgateway/qwen3-235b-a22b-fp8` | 41K | | | | | | $0.20 | $0.80 |
@@ -200,12 +199,12 @@ for await (const chunk of stream) {
200
199
  | `llmgateway/qwen3-vl-plus` | 262K | | | | | | $0.20 | $2 |
201
200
  | `llmgateway/qwen3.5-9b` | 262K | | | | | | $0.10 | $0.15 |
202
201
  | `llmgateway/qwen3.6-35b-a3b` | 262K | | | | | | $0.25 | $1 |
202
+ | `llmgateway/qwen3.6-flash` | 262K | | | | | | $0.15 | $0.90 |
203
203
  | `llmgateway/qwen3.6-max-preview` | 262K | | | | | | $1 | $8 |
204
204
  | `llmgateway/qwen3.6-plus` | 262K | | | | | | $0.50 | $3 |
205
205
  | `llmgateway/qwen3.7-max` | 1.0M | | | | | | $1 | $4 |
206
206
  | `llmgateway/qwen3.7-plus` | 1.0M | | | | | | $0.40 | $2 |
207
207
  | `llmgateway/qwen35-397b-a17b` | 262K | | | | | | $0.60 | $4 |
208
- | `llmgateway/qwq-plus` | 131K | | | | | | $0.80 | $2 |
209
208
  | `llmgateway/seed-1-6-250615` | 256K | | | | | | $0.25 | $2 |
210
209
  | `llmgateway/seed-1-6-250915` | 256K | | | | | | $0.25 | $2 |
211
210
  | `llmgateway/seed-1-6-flash-250715` | 256K | | | | | | $0.07 | $0.30 |
@@ -0,0 +1,73 @@
1
+ > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
2
+
3
+ # ![Lynkr logo](https://models.dev/logos/lynkr.svg)Lynkr
4
+
5
+ Access 1 Lynkr model through Mastra's model router. Authentication is handled automatically using the `LYNKR_API_KEY` environment variable.
6
+
7
+ Learn more in the [Lynkr documentation](https://github.com/Fast-Editor/Lynkr).
8
+
9
+ ```bash
10
+ LYNKR_API_KEY=your-api-key
11
+ ```
12
+
13
+ ```typescript
14
+ import { Agent } from "@mastra/core/agent";
15
+
16
+ const agent = new Agent({
17
+ id: "my-agent",
18
+ name: "My Agent",
19
+ instructions: "You are a helpful assistant",
20
+ model: "lynkr/lynkr-auto"
21
+ });
22
+
23
+ // Generate a response
24
+ const response = await agent.generate("Hello!");
25
+
26
+ // Stream a response
27
+ const stream = await agent.stream("Tell me a story");
28
+ for await (const chunk of stream) {
29
+ console.log(chunk);
30
+ }
31
+ ```
32
+
33
+ > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Lynkr documentation](https://github.com/Fast-Editor/Lynkr) for details.
34
+
35
+ ## Models
36
+
37
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
+ | ------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
+ | `lynkr/lynkr-auto` | 128K | | | | | | — | — |
40
+
41
+ ## Advanced configuration
42
+
43
+ ### Custom headers
44
+
45
+ ```typescript
46
+ const agent = new Agent({
47
+ id: "custom-agent",
48
+ name: "custom-agent",
49
+ model: {
50
+ url: "http://127.0.0.1:8081/v1",
51
+ id: "lynkr/lynkr-auto",
52
+ apiKey: process.env.LYNKR_API_KEY,
53
+ headers: {
54
+ "X-Custom-Header": "value"
55
+ }
56
+ }
57
+ });
58
+ ```
59
+
60
+ ### Dynamic model selection
61
+
62
+ ```typescript
63
+ const agent = new Agent({
64
+ id: "dynamic-agent",
65
+ name: "Dynamic Agent",
66
+ model: ({ requestContext }) => {
67
+ const useAdvanced = requestContext.task === "complex";
68
+ return useAdvanced
69
+ ? "lynkr/lynkr-auto"
70
+ : "lynkr/lynkr-auto";
71
+ }
72
+ });
73
+ ```
@@ -0,0 +1,101 @@
1
+ > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
2
+
3
+ # ![Meta logo](https://models.dev/logos/meta.svg)Meta
4
+
5
+ Access 1 Meta model through Mastra's model router. Authentication is handled automatically using the `META_MODEL_API_KEY` environment variable.
6
+
7
+ Learn more in the [Meta documentation](https://dev.meta.ai/docs).
8
+
9
+ ```bash
10
+ META_MODEL_API_KEY=your-api-key
11
+ ```
12
+
13
+ ```typescript
14
+ import { Agent } from "@mastra/core/agent";
15
+
16
+ const agent = new Agent({
17
+ id: "my-agent",
18
+ name: "My Agent",
19
+ instructions: "You are a helpful assistant",
20
+ model: "meta/muse-spark-1.1"
21
+ });
22
+
23
+ // Generate a response
24
+ const response = await agent.generate("Hello!");
25
+
26
+ // Stream a response
27
+ const stream = await agent.stream("Tell me a story");
28
+ for await (const chunk of stream) {
29
+ console.log(chunk);
30
+ }
31
+ ```
32
+
33
+ > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Meta documentation](https://dev.meta.ai/docs) for details.
34
+
35
+ ## Models
36
+
37
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
+ | --------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
+ | `meta/muse-spark-1.1` | 1.0M | | | | | | $1 | $4 |
40
+
41
+ ## Advanced configuration
42
+
43
+ ### Custom headers
44
+
45
+ ```typescript
46
+ const agent = new Agent({
47
+ id: "custom-agent",
48
+ name: "custom-agent",
49
+ model: {
50
+ url: "https://api.meta.ai/v1",
51
+ id: "meta/muse-spark-1.1",
52
+ apiKey: process.env.META_MODEL_API_KEY,
53
+ headers: {
54
+ "X-Custom-Header": "value"
55
+ }
56
+ }
57
+ });
58
+ ```
59
+
60
+ ### Dynamic model selection
61
+
62
+ ```typescript
63
+ const agent = new Agent({
64
+ id: "dynamic-agent",
65
+ name: "Dynamic Agent",
66
+ model: ({ requestContext }) => {
67
+ const useAdvanced = requestContext.task === "complex";
68
+ return useAdvanced
69
+ ? "meta/muse-spark-1.1"
70
+ : "meta/muse-spark-1.1";
71
+ }
72
+ });
73
+ ```
74
+
75
+ ## Direct provider installation
76
+
77
+ 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.
78
+
79
+ **npm**:
80
+
81
+ ```bash
82
+ npm install @ai-sdk/openai
83
+ ```
84
+
85
+ **pnpm**:
86
+
87
+ ```bash
88
+ pnpm add @ai-sdk/openai
89
+ ```
90
+
91
+ **Yarn**:
92
+
93
+ ```bash
94
+ yarn add @ai-sdk/openai
95
+ ```
96
+
97
+ **Bun**:
98
+
99
+ ```bash
100
+ bun add @ai-sdk/openai
101
+ ```
@@ -0,0 +1,87 @@
1
+ > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
2
+
3
+ # ![Model Oracle AI logo](https://models.dev/logos/model-oracle-ai.svg)Model Oracle AI
4
+
5
+ Access 15 Model Oracle AI models through Mastra's model router. Authentication is handled automatically using the `MODEL_ORACLE_API_KEY` environment variable.
6
+
7
+ Learn more in the [Model Oracle AI documentation](https://modeloracle.com/setup/).
8
+
9
+ ```bash
10
+ MODEL_ORACLE_API_KEY=your-api-key
11
+ ```
12
+
13
+ ```typescript
14
+ import { Agent } from "@mastra/core/agent";
15
+
16
+ const agent = new Agent({
17
+ id: "my-agent",
18
+ name: "My Agent",
19
+ instructions: "You are a helpful assistant",
20
+ model: "model-oracle-ai/auto"
21
+ });
22
+
23
+ // Generate a response
24
+ const response = await agent.generate("Hello!");
25
+
26
+ // Stream a response
27
+ const stream = await agent.stream("Tell me a story");
28
+ for await (const chunk of stream) {
29
+ console.log(chunk);
30
+ }
31
+ ```
32
+
33
+ > **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Model Oracle AI documentation](https://modeloracle.com/setup/) for details.
34
+
35
+ ## Models
36
+
37
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
+ | ---------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
+ | `model-oracle-ai/auto` | 1.0M | | | | | | — | — |
40
+ | `model-oracle-ai/claude-fable-5` | 1.0M | | | | | | — | — |
41
+ | `model-oracle-ai/claude-haiku-4.5` | 200K | | | | | | — | — |
42
+ | `model-oracle-ai/claude-opus-4.8` | 1.0M | | | | | | — | — |
43
+ | `model-oracle-ai/claude-sonnet-5` | 1.0M | | | | | | — | — |
44
+ | `model-oracle-ai/deepseek-v4-pro` | 1.0M | | | | | | — | — |
45
+ | `model-oracle-ai/glm-5.2` | 1.0M | | | | | | — | — |
46
+ | `model-oracle-ai/gpt-4.1` | 1.0M | | | | | | — | — |
47
+ | `model-oracle-ai/gpt-4.1-mini` | 1.0M | | | | | | — | — |
48
+ | `model-oracle-ai/gpt-5` | 400K | | | | | | — | — |
49
+ | `model-oracle-ai/gpt-5.4` | 1.1M | | | | | | — | — |
50
+ | `model-oracle-ai/gpt-5.4-mini` | 400K | | | | | | — | — |
51
+ | `model-oracle-ai/gpt-5.4-nano` | 400K | | | | | | — | — |
52
+ | `model-oracle-ai/gpt-5.5` | 1.1M | | | | | | — | — |
53
+ | `model-oracle-ai/o4-mini` | 200K | | | | | | — | — |
54
+
55
+ ## Advanced configuration
56
+
57
+ ### Custom headers
58
+
59
+ ```typescript
60
+ const agent = new Agent({
61
+ id: "custom-agent",
62
+ name: "custom-agent",
63
+ model: {
64
+ url: "https://api.modeloracle.com/api/v1",
65
+ id: "model-oracle-ai/auto",
66
+ apiKey: process.env.MODEL_ORACLE_API_KEY,
67
+ headers: {
68
+ "X-Custom-Header": "value"
69
+ }
70
+ }
71
+ });
72
+ ```
73
+
74
+ ### Dynamic model selection
75
+
76
+ ```typescript
77
+ const agent = new Agent({
78
+ id: "dynamic-agent",
79
+ name: "Dynamic Agent",
80
+ model: ({ requestContext }) => {
81
+ const useAdvanced = requestContext.task === "complex";
82
+ return useAdvanced
83
+ ? "model-oracle-ai/o4-mini"
84
+ : "model-oracle-ai/auto";
85
+ }
86
+ });
87
+ ```
@@ -430,8 +430,8 @@ for await (const chunk of stream) {
430
430
  | `nano-gpt/perceptron/perceptron-mk1` | 33K | | | | | | $0.15 | $2 |
431
431
  | `nano-gpt/phi-4-mini-instruct` | 128K | | | | | | $0.17 | $0.68 |
432
432
  | `nano-gpt/phi-4-multimodal-instruct` | 128K | | | | | | $0.07 | $0.11 |
433
- | `nano-gpt/poolside/laguna-m.1` | 128K | | | | | | $0.10 | $0.30 |
434
- | `nano-gpt/poolside/laguna-xs.2` | 128K | | | | | | $0.10 | $0.30 |
433
+ | `nano-gpt/poolside/laguna-m.1` | 262K | | | | | | $0.20 | $0.40 |
434
+ | `nano-gpt/poolside/laguna-xs.2` | 262K | | | | | | $0.20 | $0.40 |
435
435
  | `nano-gpt/qvq-max` | 128K | | | | | | $1 | $5 |
436
436
  | `nano-gpt/qwen-3.6-plus` | 992K | | | | | | $0.45 | $3 |
437
437
  | `nano-gpt/qwen-long` | 10.0M | | | | | | $0.10 | $0.41 |
@@ -83,7 +83,7 @@ const agent = new Agent({
83
83
  id: "custom-agent",
84
84
  name: "custom-agent",
85
85
  model: {
86
- url: "${NEON_AI_GATEWAY_BASE_URL}/ai-gateway/mlflow/v1",
86
+ url: "${NEON_AI_GATEWAY_BASE_URL}/v1",
87
87
  id: "neon/claude-haiku-4-5",
88
88
  apiKey: process.env.NEON_AI_GATEWAY_TOKEN,
89
89
  headers: {
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![Nvidia logo](https://models.dev/logos/nvidia.svg)Nvidia
4
4
 
5
- Access 84 Nvidia models through Mastra's model router. Authentication is handled automatically using the `NVIDIA_API_KEY` environment variable.
5
+ Access 82 Nvidia models through Mastra's model router. Authentication is handled automatically using the `NVIDIA_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [Nvidia documentation](https://docs.api.nvidia.com/nim/).
8
8
 
@@ -73,8 +73,6 @@ for await (const chunk of stream) {
73
73
  | `nvidia/mistralai/mistral-small-4-119b-2603` | 128K | | | | | | — | — |
74
74
  | `nvidia/mistralai/mixtral-8x22b-instruct` | 66K | | | | | | — | — |
75
75
  | `nvidia/mistralai/mixtral-8x7b-instruct` | 33K | | | | | | — | — |
76
- | `nvidia/moonshotai/kimi-k2-instruct-0905` | 262K | | | | | | — | — |
77
- | `nvidia/moonshotai/kimi-k2.6` | 262K | | | | | | — | — |
78
76
  | `nvidia/nvidia/active-speaker-detection` | — | | | | | | — | — |
79
77
  | `nvidia/nvidia/bevformer` | 128K | | | | | | — | — |
80
78
  | `nvidia/nvidia/cosmos-predict1-5b` | — | | | | | | — | — |
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![OpenAI logo](https://models.dev/logos/openai.svg)OpenAI
4
4
 
5
- Access 51 OpenAI models through Mastra's model router. Authentication is handled automatically using the `OPENAI_API_KEY` environment variable.
5
+ Access 56 OpenAI models through Mastra's model router. Authentication is handled automatically using the `OPENAI_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [OpenAI documentation](https://platform.openai.com/docs/models).
8
8
 
@@ -70,10 +70,15 @@ for await (const chunk of stream) {
70
70
  | `openai/gpt-5.4-pro` | 1.1M | | | | | | $30 | $180 |
71
71
  | `openai/gpt-5.5` | 1.1M | | | | | | $5 | $30 |
72
72
  | `openai/gpt-5.5-pro` | 1.1M | | | | | | $30 | $180 |
73
+ | `openai/gpt-5.6` | 1.1M | | | | | | $5 | $30 |
74
+ | `openai/gpt-5.6-luna` | 1.1M | | | | | | $1 | $6 |
75
+ | `openai/gpt-5.6-sol` | 1.1M | | | | | | $5 | $30 |
76
+ | `openai/gpt-5.6-terra` | 1.1M | | | | | | $3 | $15 |
73
77
  | `openai/gpt-image-1` | — | | | | | | — | — |
74
78
  | `openai/gpt-image-1-mini` | — | | | | | | — | — |
75
79
  | `openai/gpt-image-1.5` | — | | | | | | — | — |
76
80
  | `openai/gpt-image-2` | — | | | | | | $5 | $30 |
81
+ | `openai/gpt-realtime-2.1` | 128K | | | | | | $4 | $24 |
77
82
  | `openai/o1` | 200K | | | | | | $15 | $60 |
78
83
  | `openai/o1-pro` | 200K | | | | | | $150 | $600 |
79
84
  | `openai/o3` | 200K | | | | | | $2 | $8 |
@@ -137,7 +142,7 @@ const response = await agent.generate("Hello!", {
137
142
 
138
143
  **conversation** (`string | null | undefined`)
139
144
 
140
- **include** (`("file_search_call.results" | "message.output_text.logprobs" | "reasoning.encrypted_content")[] | null | undefined`)
145
+ **include** (`("web_search_call.results" | "file_search_call.results" | "message.output_text.logprobs" | "reasoning.encrypted_content")[] | null | undefined`)
141
146
 
142
147
  **instructions** (`string | null | undefined`)
143
148
 
@@ -153,18 +158,26 @@ const response = await agent.generate("Hello!", {
153
158
 
154
159
  **promptCacheKey** (`string | null | undefined`)
155
160
 
161
+ **promptCacheOptions** (`{ mode?: "explicit" | "implicit" | undefined; ttl?: "30m" | undefined; } | undefined`)
162
+
156
163
  **promptCacheRetention** (`"in_memory" | "24h" | null | undefined`)
157
164
 
158
165
  **reasoningEffort** (`string | null | undefined`)
159
166
 
167
+ **reasoningMode** (`"standard" | "pro" | undefined`)
168
+
169
+ **reasoningContext** (`"auto" | "current_turn" | "all_turns" | undefined`)
170
+
160
171
  **reasoningSummary** (`string | null | undefined`)
161
172
 
162
173
  **safetyIdentifier** (`string | null | undefined`)
163
174
 
164
- **serviceTier** (`"default" | "auto" | "flex" | "priority" | null | undefined`)
175
+ **serviceTier** (`"auto" | "default" | "flex" | "priority" | null | undefined`)
165
176
 
166
177
  **store** (`boolean | null | undefined`): Controls whether OpenAI stores your API requests for model training. Required to be "false" if your organization has zero data retention enabled. See: https\://platform.openai.com/docs/guides/your-data#zero-data-retention
167
178
 
179
+ **passThroughUnsupportedFiles** (`boolean | undefined`)
180
+
168
181
  **strictJsonSchema** (`boolean | null | undefined`)
169
182
 
170
183
  **textVerbosity** (`"low" | "medium" | "high" | null | undefined`)
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![OpenCode Zen logo](https://models.dev/logos/opencode.svg)OpenCode Zen
4
4
 
5
- Access 52 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
5
+ Access 55 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [OpenCode Zen documentation](https://opencode.ai/docs/zen).
8
8
 
@@ -74,9 +74,12 @@ for await (const chunk of stream) {
74
74
  | `opencode/gpt-5.4-pro` | 1.1M | | | | | | $30 | $180 |
75
75
  | `opencode/gpt-5.5` | 1.1M | | | | | | $5 | $30 |
76
76
  | `opencode/gpt-5.5-pro` | 1.1M | | | | | | $30 | $180 |
77
+ | `opencode/gpt-5.6-luna` | 1.1M | | | | | | $1 | $6 |
78
+ | `opencode/gpt-5.6-sol` | 1.1M | | | | | | $5 | $30 |
79
+ | `opencode/gpt-5.6-terra` | 1.1M | | | | | | $3 | $15 |
77
80
  | `opencode/grok-4.5` | 500K | | | | | | $2 | $6 |
78
81
  | `opencode/grok-build-0.1` | 256K | | | | | | $1 | $2 |
79
- | `opencode/hy3-free` | 256K | | | | | | — | — |
82
+ | `opencode/hy3-free` | 190K | | | | | | — | — |
80
83
  | `opencode/kimi-k2.5` | 262K | | | | | | $0.60 | $3 |
81
84
  | `opencode/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
82
85
  | `opencode/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |