@mastra/mcp-docs-server 1.2.13-alpha.9 → 1.2.13

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 (133) hide show
  1. package/.docs/docs/agents/overview.md +1 -1
  2. package/.docs/docs/agents/supervisor-agents.md +2 -2
  3. package/.docs/docs/agents/using-tools.md +29 -0
  4. package/.docs/docs/capabilities/channels/imessage.md +181 -0
  5. package/.docs/docs/capabilities/channels/overview.md +1 -0
  6. package/.docs/docs/{evals/datasets → datasets}/overview.md +3 -3
  7. package/.docs/docs/{evals/datasets → datasets}/running-experiments.md +59 -2
  8. package/.docs/docs/editor/overview.md +201 -206
  9. package/.docs/docs/evals/evals-with-memory.md +1 -1
  10. package/.docs/docs/getting-started/develop.md +196 -0
  11. package/.docs/docs/index.md +78 -1
  12. package/.docs/docs/mastra-platform/workspaces.md +13 -13
  13. package/.docs/docs/memory/observational-memory.md +23 -0
  14. package/.docs/docs/studio/observability.md +4 -0
  15. package/.docs/docs/studio/overview.md +2 -2
  16. package/.docs/docs/workspace/search.md +1 -1
  17. package/.docs/guides/getting-started/quickstart.md +3 -3
  18. package/.docs/{docs → guides}/rag/chunking-and-embedding.md +1 -1
  19. package/.docs/{docs → guides}/rag/graph-rag.md +1 -1
  20. package/.docs/{docs → guides}/rag/overview.md +2 -2
  21. package/.docs/{docs → guides}/rag/retrieval.md +1 -1
  22. package/.docs/{docs → guides}/voice/overview.md +4 -4
  23. package/.docs/{docs → guides}/voice/realtime-voice.md +2 -2
  24. package/.docs/{docs → guides}/voice/speech-to-speech.md +1 -1
  25. package/.docs/{docs → guides}/voice/speech-to-text.md +1 -1
  26. package/.docs/{docs → guides}/voice/text-to-speech.md +2 -2
  27. package/.docs/models/embeddings.md +63 -65
  28. package/.docs/models/environment-variables.md +5 -1
  29. package/.docs/models/gateways/netlify.md +1 -2
  30. package/.docs/models/gateways/openrouter.md +3 -1
  31. package/.docs/models/gateways/vercel.md +6 -1
  32. package/.docs/models/index.md +1 -1
  33. package/.docs/models/providers/alibaba-cn.md +3 -1
  34. package/.docs/models/providers/alibaba-token-plan-cn.md +27 -25
  35. package/.docs/models/providers/alibaba-token-plan.md +27 -25
  36. package/.docs/models/providers/alibaba.md +2 -1
  37. package/.docs/models/providers/ambient.md +13 -12
  38. package/.docs/models/providers/baseten.md +3 -1
  39. package/.docs/models/providers/chutes.md +6 -8
  40. package/.docs/models/providers/crof.md +2 -1
  41. package/.docs/models/providers/crossmodel.md +4 -1
  42. package/.docs/models/providers/deepinfra.md +9 -2
  43. package/.docs/models/providers/digitalocean.md +34 -27
  44. package/.docs/models/providers/empiriolabs.md +4 -1
  45. package/.docs/models/providers/fireworks-ai.md +20 -19
  46. package/.docs/models/providers/greenpt.md +17 -8
  47. package/.docs/models/providers/groq.md +20 -20
  48. package/.docs/models/providers/huggingface.md +3 -1
  49. package/.docs/models/providers/hyper.md +9 -7
  50. package/.docs/models/providers/impossibl.md +148 -0
  51. package/.docs/models/providers/infomaniak.md +83 -0
  52. package/.docs/models/providers/kilo.md +349 -350
  53. package/.docs/models/providers/llmgateway.md +3 -1
  54. package/.docs/models/providers/mistral.md +5 -2
  55. package/.docs/models/providers/modal.md +5 -4
  56. package/.docs/models/providers/modelis.md +81 -0
  57. package/.docs/models/providers/nano-gpt.md +146 -148
  58. package/.docs/models/providers/neuralwatt.md +2 -1
  59. package/.docs/models/providers/ofox.md +2 -2
  60. package/.docs/models/providers/ollama-cloud.md +23 -22
  61. package/.docs/models/providers/opencode-go.md +3 -2
  62. package/.docs/models/providers/requesty.md +54 -45
  63. package/.docs/models/providers/scx.md +74 -0
  64. package/.docs/models/providers/tensorx.md +97 -0
  65. package/.docs/models/providers/togetherai.md +2 -1
  66. package/.docs/models/providers/umans-ai-coding-plan.md +11 -9
  67. package/.docs/models/providers/umans-ai.md +11 -9
  68. package/.docs/models/providers/wandb.md +2 -2
  69. package/.docs/models/providers/zai-coding-plan.md +7 -7
  70. package/.docs/models/providers/zhipuai-coding-plan.md +9 -9
  71. package/.docs/models/providers.md +5 -1
  72. package/.docs/reference/agents/agent.md +1 -1
  73. package/.docs/reference/agents/generate.md +1 -1
  74. package/.docs/reference/agents/getVoice.md +1 -1
  75. package/.docs/{docs/getting-started → reference}/build-with-ai.md +5 -110
  76. package/.docs/reference/cli/create-mastra.md +2 -0
  77. package/.docs/reference/cli/mastra.md +66 -1
  78. package/.docs/reference/client-js/agents.md +1 -1
  79. package/.docs/reference/configuration.md +2 -2
  80. package/.docs/reference/core/getEditor.md +1 -1
  81. package/.docs/reference/core/getVector.md +2 -2
  82. package/.docs/reference/core/listVectors.md +2 -2
  83. package/.docs/reference/core/mastra-class.md +1 -1
  84. package/.docs/reference/datasets/startExperiment.md +6 -0
  85. package/.docs/reference/datasets/startExperimentAsync.md +4 -0
  86. package/.docs/reference/editor/browser-provider.md +2 -2
  87. package/.docs/reference/editor/filesystem-provider.md +1 -1
  88. package/.docs/reference/editor/mastra-editor.md +31 -18
  89. package/.docs/reference/editor/prompt-blocks.md +137 -0
  90. package/.docs/reference/editor/sandbox-provider.md +1 -1
  91. package/.docs/reference/editor/storage-browser-ref.md +3 -3
  92. package/.docs/reference/editor/storage-workspace-ref.md +3 -3
  93. package/.docs/reference/editor/tool-provider.md +44 -10
  94. package/.docs/reference/editor/tools.md +100 -0
  95. package/.docs/reference/editor/versioning.md +130 -0
  96. package/.docs/reference/evals/mastra-scorer.md +68 -8
  97. package/.docs/reference/file-based-agents/config.md +39 -1
  98. package/.docs/reference/index.md +3 -4
  99. package/.docs/reference/memory/observational-memory.md +3 -1
  100. package/.docs/reference/memory/serialized-memory-config.md +3 -3
  101. package/.docs/reference/observability/tracing/interfaces.md +3 -1
  102. package/.docs/reference/processors/token-limiter-processor.md +15 -1
  103. package/.docs/reference/project-structure.md +1 -1
  104. package/.docs/reference/rag/database-config.md +1 -1
  105. package/.docs/reference/storage/composite.md +2 -0
  106. package/.docs/reference/streaming/agents/stream.md +1 -1
  107. package/.docs/reference/voice/livekit.md +3 -3
  108. package/.docs/reference/workspace/platform-filesystem.md +3 -3
  109. package/.docs/reference/workspace/platform-sandbox.md +5 -5
  110. package/CHANGELOG.md +23 -0
  111. package/README.md +1 -1
  112. package/package.json +6 -6
  113. package/.docs/docs/agent-builder/access-control.md +0 -99
  114. package/.docs/docs/agent-builder/browser.md +0 -63
  115. package/.docs/docs/agent-builder/channels.md +0 -78
  116. package/.docs/docs/agent-builder/configuration.md +0 -132
  117. package/.docs/docs/agent-builder/deploying.md +0 -124
  118. package/.docs/docs/agent-builder/integrations.md +0 -115
  119. package/.docs/docs/agent-builder/memory.md +0 -69
  120. package/.docs/docs/agent-builder/model-policy.md +0 -50
  121. package/.docs/docs/agent-builder/overview.md +0 -114
  122. package/.docs/docs/agent-builder/skill-registries.md +0 -31
  123. package/.docs/docs/agent-builder/workspace.md +0 -62
  124. package/.docs/docs/editor/prompts.md +0 -140
  125. package/.docs/docs/editor/tools.md +0 -148
  126. package/.docs/docs/getting-started/file-based-agents.md +0 -121
  127. package/.docs/docs/what-is-mastra.md +0 -161
  128. package/.docs/reference/client-js/agent-builder.md +0 -163
  129. package/.docs/reference/editor/agent-builder/agent-builder-options.md +0 -76
  130. package/.docs/reference/editor/agent-builder/builder-agent-defaults.md +0 -79
  131. package/.docs/reference/editor/agent-builder/builder-models.md +0 -66
  132. /package/.docs/{docs → guides}/getting-started/manual-install.md +0 -0
  133. /package/.docs/{docs → guides}/rag/vector-databases.md +0 -0
@@ -7,14 +7,14 @@ Mastra's model router supports embedding models using the same `provider/model`
7
7
  ## Quickstart
8
8
 
9
9
  ```typescript
10
- import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
11
- import { embedMany } from "ai";
10
+ import { ModelRouterEmbeddingModel } from '@mastra/core/llm'
11
+ import { embedMany } from 'ai'
12
12
 
13
13
  // Generate embeddings
14
14
  const { embeddings } = await embedMany({
15
- model: new ModelRouterEmbeddingModel("openai/text-embedding-3-small"),
16
- values: ["Hello world", "Semantic search is powerful"],
17
- });
15
+ model: new ModelRouterEmbeddingModel('openai/text-embedding-3-small'),
16
+ values: ['Hello world', 'Semantic search is powerful'],
17
+ })
18
18
  ```
19
19
 
20
20
  ## Supported models
@@ -26,7 +26,7 @@ const { embeddings } = await embedMany({
26
26
  - `text-embedding-ada-002` - 1536 dimensions, 8191 max tokens
27
27
 
28
28
  ```typescript
29
- const embedder = new ModelRouterEmbeddingModel("openai/text-embedding-3-small");
29
+ const embedder = new ModelRouterEmbeddingModel('openai/text-embedding-3-small')
30
30
  ```
31
31
 
32
32
  ### Google
@@ -34,7 +34,7 @@ const embedder = new ModelRouterEmbeddingModel("openai/text-embedding-3-small");
34
34
  - `gemini-embedding-001` - 768 dimensions, 2048 max tokens
35
35
 
36
36
  ```typescript
37
- const embedder = new ModelRouterEmbeddingModel("google/gemini-embedding-001");
37
+ const embedder = new ModelRouterEmbeddingModel('google/gemini-embedding-001')
38
38
  ```
39
39
 
40
40
  ### VoyageAI
@@ -79,29 +79,29 @@ bun add @mastra/voyageai
79
79
  - `voyage-multimodal-3.5` - 1024 dimensions, supports text + images
80
80
 
81
81
  ```typescript
82
- import { voyage, voyageEmbedding } from "@mastra/voyageai";
82
+ import { voyage, voyageEmbedding } from '@mastra/voyageai'
83
83
 
84
84
  // Use default model (voyage-3.5)
85
85
  const { embeddings } = await voyage.doEmbed({
86
- values: ["Hello world"],
87
- });
86
+ values: ['Hello world'],
87
+ })
88
88
 
89
89
  // Use specific model (voyage-3-large)
90
90
  const largeEmbeddings = await voyage.large.doEmbed({
91
- values: ["More complex content"],
92
- });
91
+ values: ['More complex content'],
92
+ })
93
93
 
94
94
  // Custom configuration
95
95
  const customModel = voyageEmbedding({
96
- model: "voyage-3.5",
97
- inputType: "query", // or 'document'
96
+ model: 'voyage-3.5',
97
+ inputType: 'query', // or 'document'
98
98
  outputDimension: 512, // 256, 512, 1024, or 2048
99
- baseUrl: "https://ai.mongodb.com/v1", // Optional: custom endpoint (e.g. MongoDB-hosted Voyage)
100
- });
99
+ baseUrl: 'https://ai.mongodb.com/v1', // Optional: custom endpoint (e.g. MongoDB-hosted Voyage)
100
+ })
101
101
 
102
102
  const { embeddings: customEmbeddings } = await customModel.doEmbed({
103
- values: ["Custom configuration example"],
104
- });
103
+ values: ['Custom configuration example'],
104
+ })
105
105
  ```
106
106
 
107
107
  **VoyageAI with MongoDB:**
@@ -109,48 +109,48 @@ const { embeddings: customEmbeddings } = await customModel.doEmbed({
109
109
  VoyageAI works seamlessly with MongoDB Atlas Vector Search:
110
110
 
111
111
  ```typescript
112
- import { voyage } from "@mastra/voyageai";
113
- import { MongoDBVector } from "@mastra/mongodb";
112
+ import { voyage } from '@mastra/voyageai'
113
+ import { MongoDBVector } from '@mastra/mongodb'
114
114
 
115
115
  const mongoVector = new MongoDBVector({
116
- id: "mongodb-vector",
116
+ id: 'mongodb-vector',
117
117
  uri: process.env.MONGODB_URI,
118
118
  dbName: process.env.MONGODB_DB_NAME,
119
- });
119
+ })
120
120
 
121
121
  // Create index matching VoyageAI dimensions
122
122
  await mongoVector.createIndex({
123
- indexName: "documents",
123
+ indexName: 'documents',
124
124
  dimension: 1024, // voyage-3.5 default
125
- });
125
+ })
126
126
 
127
127
  // Generate and store embeddings
128
128
  const { embeddings } = await voyage.doEmbed({
129
- values: chunks.map((chunk) => chunk.text),
130
- });
129
+ values: chunks.map(chunk => chunk.text),
130
+ })
131
131
 
132
132
  await mongoVector.upsert({
133
- indexName: "documents",
133
+ indexName: 'documents',
134
134
  vectors: embeddings,
135
- metadata: chunks.map((chunk) => ({ text: chunk.text })),
136
- });
135
+ metadata: chunks.map(chunk => ({ text: chunk.text })),
136
+ })
137
137
  ```
138
138
 
139
139
  **Multimodal embeddings (text + images):**
140
140
 
141
141
  ```typescript
142
- import { voyage } from "@mastra/voyageai";
142
+ import { voyage } from '@mastra/voyageai'
143
143
 
144
144
  const { embeddings } = await voyage.multimodal.doEmbed({
145
145
  values: [
146
146
  {
147
147
  content: [
148
- { type: "text", text: "Product description" },
149
- { type: "image_url", image_url: "https://example.com/image.jpg" },
148
+ { type: 'text', text: 'Product description' },
149
+ { type: 'image_url', image_url: 'https://example.com/image.jpg' },
150
150
  ],
151
151
  },
152
152
  ],
153
- });
153
+ })
154
154
  ```
155
155
 
156
156
  For more details, see the [MongoDB + VoyageAI integration guide](https://mastra.ai/reference/vectors/mongodb).
@@ -175,14 +175,14 @@ VOYAGE_API_KEY=pa-...
175
175
  You can use any OpenAI-compatible embedding endpoint with a custom URL:
176
176
 
177
177
  ```typescript
178
- import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
178
+ import { ModelRouterEmbeddingModel } from '@mastra/core/llm'
179
179
 
180
180
  const embedder = new ModelRouterEmbeddingModel({
181
- providerId: "ollama",
182
- modelId: "nomic-embed-text",
183
- url: "http://localhost:11434/v1",
184
- apiKey: "not-needed", // Some providers don't require API keys
185
- });
181
+ providerId: 'ollama',
182
+ modelId: 'nomic-embed-text',
183
+ url: 'http://localhost:11434/v1',
184
+ apiKey: 'not-needed', // Some providers don't require API keys
185
+ })
186
186
  ```
187
187
 
188
188
  ## Usage with Memory
@@ -190,19 +190,19 @@ const embedder = new ModelRouterEmbeddingModel({
190
190
  The embedding model router integrates seamlessly with Mastra's memory system:
191
191
 
192
192
  ```typescript
193
- import { Memory } from "@mastra/memory";
194
- import { Agent } from "@mastra/core/agent";
195
- import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
193
+ import { Memory } from '@mastra/memory'
194
+ import { Agent } from '@mastra/core/agent'
195
+ import { ModelRouterEmbeddingModel } from '@mastra/core/llm'
196
196
 
197
197
  const agent = new Agent({
198
- id: "my-agent",
199
- name: "my-agent",
200
- instructions: "You are a helpful assistant",
201
- model: "openai/gpt-5.1",
198
+ id: 'my-agent',
199
+ name: 'my-agent',
200
+ instructions: 'You are a helpful assistant',
201
+ model: 'openai/gpt-5.1',
202
202
  memory: new Memory({
203
- embedder: new ModelRouterEmbeddingModel("openai/text-embedding-3-small"),
203
+ embedder: new ModelRouterEmbeddingModel('openai/text-embedding-3-small'),
204
204
  }),
205
- });
205
+ })
206
206
  ```
207
207
 
208
208
  > **Info:** The `embedder` field accepts:
@@ -216,14 +216,14 @@ const agent = new Agent({
216
216
  Use embedding models for document chunking and retrieval:
217
217
 
218
218
  ```typescript
219
- import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
220
- import { embedMany } from "ai";
219
+ import { ModelRouterEmbeddingModel } from '@mastra/core/llm'
220
+ import { embedMany } from 'ai'
221
221
 
222
222
  // Embed document chunks
223
223
  const { embeddings } = await embedMany({
224
- model: new ModelRouterEmbeddingModel("openai/text-embedding-3-small"),
225
- values: chunks.map((chunk) => chunk.text),
226
- });
224
+ model: new ModelRouterEmbeddingModel('openai/text-embedding-3-small'),
225
+ values: chunks.map(chunk => chunk.text),
226
+ })
227
227
 
228
228
  // Store embeddings in your vector database
229
229
  await vectorStore.upsert(
@@ -232,7 +232,7 @@ await vectorStore.upsert(
232
232
  vector: embeddings[i],
233
233
  metadata: chunk.metadata,
234
234
  })),
235
- );
235
+ )
236
236
  ```
237
237
 
238
238
  ## TypeScript Support
@@ -240,13 +240,13 @@ await vectorStore.upsert(
240
240
  The model router provides full TypeScript autocomplete for embedding model IDs:
241
241
 
242
242
  ```typescript
243
- import type { EmbeddingModelId } from "@mastra/core";
243
+ import type { EmbeddingModelId } from '@mastra/core'
244
244
 
245
245
  // Type-safe embedding model selection
246
- const modelId: EmbeddingModelId = "openai/text-embedding-3-small";
246
+ const modelId: EmbeddingModelId = 'openai/text-embedding-3-small'
247
247
  // ^ Autocomplete shows all supported models
248
248
 
249
- const embedder = new ModelRouterEmbeddingModel(modelId);
249
+ const embedder = new ModelRouterEmbeddingModel(modelId)
250
250
  ```
251
251
 
252
252
  ## Error handling
@@ -255,9 +255,9 @@ The model router validates provider and model IDs at construction time:
255
255
 
256
256
  ```typescript
257
257
  try {
258
- const embedder = new ModelRouterEmbeddingModel("invalid/model");
258
+ const embedder = new ModelRouterEmbeddingModel('invalid/model')
259
259
  } catch (error) {
260
- console.error(error.message);
260
+ console.error(error.message)
261
261
  // "Unknown provider: invalid. Available providers: openai, google"
262
262
  }
263
263
  ```
@@ -266,12 +266,10 @@ Missing API keys are also caught early:
266
266
 
267
267
  ```typescript
268
268
  try {
269
- const embedder = new ModelRouterEmbeddingModel(
270
- "openai/text-embedding-3-small",
271
- );
269
+ const embedder = new ModelRouterEmbeddingModel('openai/text-embedding-3-small')
272
270
  // Throws if OPENAI_API_KEY is not set
273
271
  } catch (error) {
274
- console.error(error.message);
272
+ console.error(error.message)
275
273
  // "API key not found for provider openai. Set OPENAI_API_KEY environment variable."
276
274
  }
277
275
  ```
@@ -279,5 +277,5 @@ try {
279
277
  ## Next Steps
280
278
 
281
279
  - [Memory & Semantic Recall](https://mastra.ai/docs/memory/semantic-recall): Use embeddings for agent memory
282
- - [RAG & Chunking](https://mastra.ai/docs/rag/chunking-and-embedding): Build retrieval-augmented generation systems
283
- - [Vector Databases](https://mastra.ai/docs/rag/vector-databases): Store and query embeddings
280
+ - [RAG & Chunking](https://mastra.ai/guides/rag/chunking-and-embedding): Build retrieval-augmented generation systems
281
+ - [Vector Databases](https://mastra.ai/guides/rag/vector-databases): Store and query embeddings
@@ -53,7 +53,6 @@ List of required environment variables for each model provider and gateway suppo
53
53
  | [FreeModel](https://mastra.ai/models/providers/freemodel) | `freemodel/*` | `FREEMODEL_API_KEY` |
54
54
  | [Friendli](https://mastra.ai/models/providers/friendli) | `friendli/*` | `FRIENDLI_TOKEN` |
55
55
  | [FrogBot](https://mastra.ai/models/providers/frogbot) | `frogbot/*` | `FROGBOT_API_KEY` |
56
- | [GitHub Models](https://mastra.ai/models/providers/github-models) | `github-models/*` | `GITHUB_TOKEN` |
57
56
  | [GMI Cloud](https://mastra.ai/models/providers/gmicloud) | `gmicloud/*` | `GMICLOUD_API_KEY` |
58
57
  | [Google](https://mastra.ai/models/providers/google) | `google/*` | `GOOGLE_API_KEY`, `GOOGLE_GENERATIVE_AI_API_KEY` |
59
58
  | [GreenPT](https://mastra.ai/models/providers/greenpt) | `greenpt/*` | `GREENPT_API_KEY` |
@@ -63,10 +62,12 @@ List of required environment variables for each model provider and gateway suppo
63
62
  | [HPC-AI](https://mastra.ai/models/providers/hpc-ai) | `hpc-ai/*` | `HPC_AI_API_KEY` |
64
63
  | [Hugging Face](https://mastra.ai/models/providers/huggingface) | `huggingface/*` | `HF_TOKEN` |
65
64
  | [iFlow](https://mastra.ai/models/providers/iflowcn) | `iflowcn/*` | `IFLOW_API_KEY` |
65
+ | [Impossibl](https://mastra.ai/models/providers/impossibl) | `impossibl/*` | `IMPOSSIBL_API_KEY` |
66
66
  | [Inception](https://mastra.ai/models/providers/inception) | `inception/*` | `INCEPTION_API_KEY` |
67
67
  | [Inceptron](https://mastra.ai/models/providers/inceptron) | `inceptron/*` | `INCEPTRON_API_KEY` |
68
68
  | [Inference](https://mastra.ai/models/providers/inference) | `inference/*` | `INFERENCE_API_KEY` |
69
69
  | [InferX](https://mastra.ai/models/providers/inferx) | `inferx/*` | `INFERX_API_KEY` |
70
+ | [Infomaniak](https://mastra.ai/models/providers/infomaniak) | `infomaniak/*` | `INFOMANIAK_PRODUCT_ID`, `INFOMANIAK_API_KEY` |
70
71
  | [IO.NET](https://mastra.ai/models/providers/io-net) | `io-net/*` | `IOINTELLIGENCE_API_KEY` |
71
72
  | [Jiekou.AI](https://mastra.ai/models/providers/jiekou) | `jiekou/*` | `JIEKOU_API_KEY` |
72
73
  | [Kenari](https://mastra.ai/models/providers/kenari) | `kenari/*` | `KENARI_API_KEY` |
@@ -92,6 +93,7 @@ List of required environment variables for each model provider and gateway suppo
92
93
  | [Moark](https://mastra.ai/models/providers/moark) | `moark/*` | `MOARK_API_KEY` |
93
94
  | [Modal](https://mastra.ai/models/providers/modal) | `modal/*` | `MODAL_PROXY_TOKEN` |
94
95
  | [Model Oracle AI](https://mastra.ai/models/providers/model-oracle-ai) | `model-oracle-ai/*` | `MODEL_ORACLE_API_KEY` |
96
+ | [Modelis](https://mastra.ai/models/providers/modelis) | `modelis/*` | `MODELIS_API_KEY` |
95
97
  | [ModelScope](https://mastra.ai/models/providers/modelscope) | `modelscope/*` | `MODELSCOPE_API_KEY` |
96
98
  | [Moonshot AI](https://mastra.ai/models/providers/moonshotai) | `moonshotai/*` | `MOONSHOT_API_KEY` |
97
99
  | [Moonshot AI (China)](https://mastra.ai/models/providers/moonshotai-cn) | `moonshotai-cn/*` | `MOONSHOT_API_KEY` |
@@ -125,6 +127,7 @@ List of required environment variables for each model provider and gateway suppo
125
127
  | [Sakana AI](https://mastra.ai/models/providers/sakana) | `sakana/*` | `SAKANA_API_KEY` |
126
128
  | [Sarvam AI](https://mastra.ai/models/providers/sarvam) | `sarvam/*` | `SARVAM_API_KEY` |
127
129
  | [Scaleway](https://mastra.ai/models/providers/scaleway) | `scaleway/*` | `SCALEWAY_API_KEY` |
130
+ | [SCX.ai](https://mastra.ai/models/providers/scx) | `scx/*` | `SCX_API_KEY` |
128
131
  | [SiliconFlow](https://mastra.ai/models/providers/siliconflow) | `siliconflow/*` | `SILICONFLOW_API_KEY` |
129
132
  | [SiliconFlow (China)](https://mastra.ai/models/providers/siliconflow-cn) | `siliconflow-cn/*` | `SILICONFLOW_CN_API_KEY` |
130
133
  | [Snowflake Cortex](https://mastra.ai/models/providers/snowflake-cortex) | `snowflake-cortex/*` | `SNOWFLAKE_ACCOUNT`, `SNOWFLAKE_CORTEX_PAT` |
@@ -139,6 +142,7 @@ List of required environment variables for each model provider and gateway suppo
139
142
  | [Tencent Coding Plan (China)](https://mastra.ai/models/providers/tencent-coding-plan) | `tencent-coding-plan/*` | `TENCENT_CODING_PLAN_API_KEY` |
140
143
  | [Tencent Token Plan](https://mastra.ai/models/providers/tencent-token-plan) | `tencent-token-plan/*` | `TENCENT_TOKEN_PLAN_API_KEY` |
141
144
  | [Tencent TokenHub](https://mastra.ai/models/providers/tencent-tokenhub) | `tencent-tokenhub/*` | `TENCENT_TOKENHUB_API_KEY` |
145
+ | [TensorX](https://mastra.ai/models/providers/tensorx) | `tensorx/*` | `TENSORX_API_KEY` |
142
146
  | [The Grid AI](https://mastra.ai/models/providers/the-grid-ai) | `the-grid-ai/*` | `THEGRID_API_KEY` |
143
147
  | [Thinking Machines](https://mastra.ai/models/providers/thinkingmachines) | `thinkingmachines/*` | `TINKER_API_KEY` |
144
148
  | [Tinfoil](https://mastra.ai/models/providers/tinfoil) | `tinfoil/*` | `TINFOIL_API_KEY` |
@@ -2,7 +2,7 @@
2
2
 
3
3
  # Netlify
4
4
 
5
- Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 68 models through Mastra's model router.
5
+ Netlify AI Gateway provides unified access to multiple providers with built-in caching and observability. Access 67 models through Mastra's model router.
6
6
 
7
7
  Learn more in the [Netlify documentation](https://docs.netlify.com/build/ai-gateway/overview/).
8
8
 
@@ -40,7 +40,6 @@ ANTHROPIC_API_KEY=ant-...
40
40
  | `anthropic/claude-fable-5` |
41
41
  | `anthropic/claude-haiku-4-5` |
42
42
  | `anthropic/claude-haiku-4-5-20251001` |
43
- | `anthropic/claude-opus-4-1-20250805` |
44
43
  | `anthropic/claude-opus-4-5` |
45
44
  | `anthropic/claude-opus-4-5-20251101` |
46
45
  | `anthropic/claude-opus-4-6` |
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter
4
4
 
5
- OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 335 models through Mastra's model router.
5
+ OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 337 models through Mastra's model router.
6
6
 
7
7
  Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
8
8
 
@@ -40,6 +40,7 @@ ANTHROPIC_API_KEY=ant-...
40
40
  | `~anthropic/claude-haiku-latest` |
41
41
  | `~anthropic/claude-opus-latest` |
42
42
  | `~anthropic/claude-sonnet-latest` |
43
+ | `~deepseek/deepseek-v4-flash-latest` |
43
44
  | `~google/gemini-flash-latest` |
44
45
  | `~google/gemini-pro-latest` |
45
46
  | `~moonshotai/kimi-latest` |
@@ -330,6 +331,7 @@ ANTHROPIC_API_KEY=ant-...
330
331
  | `qwen/qwen3.7-flash` |
331
332
  | `qwen/qwen3.7-max` |
332
333
  | `qwen/qwen3.7-plus` |
334
+ | `qwen/qwen3.8-max` |
333
335
  | `rekaai/reka-edge` |
334
336
  | `rekaai/reka-flash-3` |
335
337
  | `relace/relace-apply-3` |
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![Vercel logo](https://models.dev/logos/vercel.svg)Vercel
4
4
 
5
- Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 310 models through Mastra's model router.
5
+ Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 315 models through Mastra's model router.
6
6
 
7
7
  Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
8
8
 
@@ -64,6 +64,7 @@ ANTHROPIC_API_KEY=ant-...
64
64
  | `alibaba/qwen3.7-flash` |
65
65
  | `alibaba/qwen3.7-max` |
66
66
  | `alibaba/qwen3.7-plus` |
67
+ | `alibaba/qwen3.8-max` |
67
68
  | `alibaba/wan-v2.5-t2v-preview` |
68
69
  | `alibaba/wan-v2.6-i2v` |
69
70
  | `alibaba/wan-v2.6-i2v-flash` |
@@ -128,6 +129,7 @@ ANTHROPIC_API_KEY=ant-...
128
129
  | `deepseek/deepseek-v3.2` |
129
130
  | `deepseek/deepseek-v3.2-thinking` |
130
131
  | `deepseek/deepseek-v4-flash` |
132
+ | `deepseek/deepseek-v4-flash-0731` |
131
133
  | `deepseek/deepseek-v4-pro` |
132
134
  | `google/gemini-2.5-flash` |
133
135
  | `google/gemini-2.5-flash-image` |
@@ -157,6 +159,7 @@ ANTHROPIC_API_KEY=ant-...
157
159
  | `google/veo-3.0-generate-001` |
158
160
  | `google/veo-3.1-fast-generate-001` |
159
161
  | `google/veo-3.1-generate-001` |
162
+ | `google/veo-3.1-lite-generate-001` |
160
163
  | `inception/mercury-2` |
161
164
  | `inception/mercury-coder-small` |
162
165
  | `inclusionai/ling-3.0-flash-free` |
@@ -277,6 +280,8 @@ ANTHROPIC_API_KEY=ant-...
277
280
  | `openai/tts-1` |
278
281
  | `openai/tts-1-hd` |
279
282
  | `openai/whisper-1` |
283
+ | `perplexity/pplx-embed-v1-0.6b` |
284
+ | `perplexity/pplx-embed-v1-4b` |
280
285
  | `perplexity/sonar` |
281
286
  | `perplexity/sonar-pro` |
282
287
  | `perplexity/sonar-reasoning-pro` |
@@ -2,7 +2,7 @@
2
2
 
3
3
  # Model Providers
4
4
 
5
- Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 5154 models from 164 providers through a single API.
5
+ Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 5288 models from 168 providers through a single API.
6
6
 
7
7
  ## Features
8
8
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![Alibaba (China) logo](https://models.dev/logos/alibaba-cn.svg)Alibaba (China)
4
4
 
5
- Access 84 Alibaba (China) models through Mastra's model router. Authentication is handled automatically using the `DASHSCOPE_API_KEY` environment variable.
5
+ Access 86 Alibaba (China) models through Mastra's model router. Authentication is handled automatically using the `DASHSCOPE_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [Alibaba (China) documentation](https://www.alibabacloud.com/help/en/model-studio/models).
8
8
 
@@ -111,8 +111,10 @@ for await (const chunk of stream) {
111
111
  | `alibaba-cn/qwen3.6-flash` | 1.0M | | | | | | $0.19 | $1 |
112
112
  | `alibaba-cn/qwen3.6-max-preview` | 246K | | | | | | $1 | $8 |
113
113
  | `alibaba-cn/qwen3.6-plus` | 1.0M | | | | | | $0.50 | $3 |
114
+ | `alibaba-cn/qwen3.7-flash` | 1.0M | | | | | | $0.03 | $0.12 |
114
115
  | `alibaba-cn/qwen3.7-max` | 1.0M | | | | | | $3 | $8 |
115
116
  | `alibaba-cn/qwen3.7-plus` | 1.0M | | | | | | $0.50 | $3 |
117
+ | `alibaba-cn/qwen3.8-max` | 1.0M | | | | | | $2 | $5 |
116
118
  | `alibaba-cn/qwq-32b` | 131K | | | | | | $0.29 | $0.86 |
117
119
  | `alibaba-cn/qwq-plus` | 131K | | | | | | $0.23 | $0.57 |
118
120
  | `alibaba-cn/siliconflow/deepseek-r1-0528` | 164K | | | | | | $0.50 | $2 |
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![Alibaba Token Plan (China) logo](https://models.dev/logos/alibaba-token-plan-cn.svg)Alibaba Token Plan (China)
4
4
 
5
- Access 22 Alibaba Token Plan (China) models through Mastra's model router. Authentication is handled automatically using the `ALIBABA_TOKEN_PLAN_API_KEY` environment variable.
5
+ Access 24 Alibaba Token Plan (China) models through Mastra's model router. Authentication is handled automatically using the `ALIBABA_TOKEN_PLAN_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [Alibaba Token Plan (China) documentation](https://www.alibabacloud.com/help/zh/model-studio/token-plan-overview).
8
8
 
@@ -34,30 +34,32 @@ for await (const chunk of stream) {
34
34
 
35
35
  ## Models
36
36
 
37
- | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
- | ------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
- | `alibaba-token-plan-cn/deepseek-v3.2` | 131K | | | | | | — | — |
40
- | `alibaba-token-plan-cn/deepseek-v4-flash` | 1.0M | | | | | | — | — |
41
- | `alibaba-token-plan-cn/deepseek-v4-pro` | 1.0M | | | | | | — | — |
42
- | `alibaba-token-plan-cn/glm-5` | 203K | | | | | | — | — |
43
- | `alibaba-token-plan-cn/glm-5.1` | 203K | | | | | | — | — |
44
- | `alibaba-token-plan-cn/glm-5.2` | 1.0M | | | | | | — | — |
45
- | `alibaba-token-plan-cn/happyhorse-1.1-i2v` | | | | | | | — | — |
46
- | `alibaba-token-plan-cn/happyhorse-1.1-r2v` | — | | | | | | — | — |
47
- | `alibaba-token-plan-cn/happyhorse-1.1-t2v` | — | | | | | | — | — |
48
- | `alibaba-token-plan-cn/kimi-k2.5` | 262K | | | | | | — | — |
49
- | `alibaba-token-plan-cn/kimi-k2.6` | 262K | | | | | | — | — |
50
- | `alibaba-token-plan-cn/kimi-k2.7-code` | 262K | | | | | | — | — |
51
- | `alibaba-token-plan-cn/MiniMax-M2.5` | 197K | | | | | | — | — |
52
- | `alibaba-token-plan-cn/qwen-image-2.0` | 8K | | | | | | — | — |
53
- | `alibaba-token-plan-cn/qwen-image-2.0-pro` | 8K | | | | | | — | — |
54
- | `alibaba-token-plan-cn/qwen3.6-flash` | 1.0M | | | | | | — | — |
55
- | `alibaba-token-plan-cn/qwen3.6-plus` | 1.0M | | | | | | — | — |
56
- | `alibaba-token-plan-cn/qwen3.7-max` | 1.0M | | | | | | — | — |
57
- | `alibaba-token-plan-cn/qwen3.7-plus` | 1.0M | | | | | | — | — |
58
- | `alibaba-token-plan-cn/qwen3.8-max-preview` | 1.0M | | | | | | — | — |
59
- | `alibaba-token-plan-cn/wan2.7-image` | 8K | | | | | | — | — |
60
- | `alibaba-token-plan-cn/wan2.7-image-pro` | 8K | | | | | | — | — |
37
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
+ | ---------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
+ | `alibaba-token-plan-cn/deepseek-v3.2` | 131K | | | | | | — | — |
40
+ | `alibaba-token-plan-cn/deepseek-v4-flash` | 1.0M | | | | | | — | — |
41
+ | `alibaba-token-plan-cn/deepseek-v4-flash-0731` | 1.0M | | | | | | — | — |
42
+ | `alibaba-token-plan-cn/deepseek-v4-pro` | 1.0M | | | | | | — | — |
43
+ | `alibaba-token-plan-cn/glm-5` | 203K | | | | | | — | — |
44
+ | `alibaba-token-plan-cn/glm-5.1` | 203K | | | | | | — | — |
45
+ | `alibaba-token-plan-cn/glm-5.2` | 1.0M | | | | | | — | — |
46
+ | `alibaba-token-plan-cn/happyhorse-1.1-i2v` | — | | | | | | — | — |
47
+ | `alibaba-token-plan-cn/happyhorse-1.1-r2v` | — | | | | | | — | — |
48
+ | `alibaba-token-plan-cn/happyhorse-1.1-t2v` | | | | | | | — | — |
49
+ | `alibaba-token-plan-cn/kimi-k2.5` | 262K | | | | | | — | — |
50
+ | `alibaba-token-plan-cn/kimi-k2.6` | 262K | | | | | | — | — |
51
+ | `alibaba-token-plan-cn/kimi-k2.7-code` | 262K | | | | | | — | — |
52
+ | `alibaba-token-plan-cn/MiniMax-M2.5` | 197K | | | | | | — | — |
53
+ | `alibaba-token-plan-cn/qwen-image-2.0` | 8K | | | | | | — | — |
54
+ | `alibaba-token-plan-cn/qwen-image-2.0-pro` | 8K | | | | | | — | — |
55
+ | `alibaba-token-plan-cn/qwen3.6-flash` | 1.0M | | | | | | — | — |
56
+ | `alibaba-token-plan-cn/qwen3.6-plus` | 1.0M | | | | | | — | — |
57
+ | `alibaba-token-plan-cn/qwen3.7-max` | 1.0M | | | | | | — | — |
58
+ | `alibaba-token-plan-cn/qwen3.7-plus` | 1.0M | | | | | | — | — |
59
+ | `alibaba-token-plan-cn/qwen3.8-max` | 1.0M | | | | | | — | — |
60
+ | `alibaba-token-plan-cn/qwen3.8-max-preview` | 1.0M | | | | | | — | — |
61
+ | `alibaba-token-plan-cn/wan2.7-image` | 8K | | | | | | — | — |
62
+ | `alibaba-token-plan-cn/wan2.7-image-pro` | 8K | | | | | | — | — |
61
63
 
62
64
  ## Advanced configuration
63
65
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![Alibaba Token Plan logo](https://models.dev/logos/alibaba-token-plan.svg)Alibaba Token Plan
4
4
 
5
- Access 22 Alibaba Token Plan models through Mastra's model router. Authentication is handled automatically using the `ALIBABA_TOKEN_PLAN_API_KEY` environment variable.
5
+ Access 24 Alibaba Token Plan models through Mastra's model router. Authentication is handled automatically using the `ALIBABA_TOKEN_PLAN_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [Alibaba Token Plan documentation](https://www.alibabacloud.com/help/en/model-studio/token-plan-overview).
8
8
 
@@ -34,30 +34,32 @@ for await (const chunk of stream) {
34
34
 
35
35
  ## Models
36
36
 
37
- | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
- | ---------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
- | `alibaba-token-plan/deepseek-v3.2` | 131K | | | | | | — | — |
40
- | `alibaba-token-plan/deepseek-v4-flash` | 1.0M | | | | | | — | — |
41
- | `alibaba-token-plan/deepseek-v4-pro` | 1.0M | | | | | | — | — |
42
- | `alibaba-token-plan/glm-5` | 203K | | | | | | — | — |
43
- | `alibaba-token-plan/glm-5.1` | 203K | | | | | | — | — |
44
- | `alibaba-token-plan/glm-5.2` | 1.0M | | | | | | — | — |
45
- | `alibaba-token-plan/happyhorse-1.1-i2v` | | | | | | | — | — |
46
- | `alibaba-token-plan/happyhorse-1.1-r2v` | — | | | | | | — | — |
47
- | `alibaba-token-plan/happyhorse-1.1-t2v` | — | | | | | | — | — |
48
- | `alibaba-token-plan/kimi-k2.5` | 262K | | | | | | — | — |
49
- | `alibaba-token-plan/kimi-k2.6` | 262K | | | | | | — | — |
50
- | `alibaba-token-plan/kimi-k2.7-code` | 262K | | | | | | — | — |
51
- | `alibaba-token-plan/MiniMax-M2.5` | 197K | | | | | | — | — |
52
- | `alibaba-token-plan/qwen-image-2.0` | 8K | | | | | | — | — |
53
- | `alibaba-token-plan/qwen-image-2.0-pro` | 8K | | | | | | — | — |
54
- | `alibaba-token-plan/qwen3.6-flash` | 1.0M | | | | | | — | — |
55
- | `alibaba-token-plan/qwen3.6-plus` | 1.0M | | | | | | — | — |
56
- | `alibaba-token-plan/qwen3.7-max` | 1.0M | | | | | | — | — |
57
- | `alibaba-token-plan/qwen3.7-plus` | 1.0M | | | | | | — | — |
58
- | `alibaba-token-plan/qwen3.8-max-preview` | 1.0M | | | | | | — | — |
59
- | `alibaba-token-plan/wan2.7-image` | 8K | | | | | | — | — |
60
- | `alibaba-token-plan/wan2.7-image-pro` | 8K | | | | | | — | — |
37
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
38
+ | ------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
39
+ | `alibaba-token-plan/deepseek-v3.2` | 131K | | | | | | — | — |
40
+ | `alibaba-token-plan/deepseek-v4-flash` | 1.0M | | | | | | — | — |
41
+ | `alibaba-token-plan/deepseek-v4-flash-0731` | 1.0M | | | | | | — | — |
42
+ | `alibaba-token-plan/deepseek-v4-pro` | 1.0M | | | | | | — | — |
43
+ | `alibaba-token-plan/glm-5` | 203K | | | | | | — | — |
44
+ | `alibaba-token-plan/glm-5.1` | 203K | | | | | | — | — |
45
+ | `alibaba-token-plan/glm-5.2` | 1.0M | | | | | | — | — |
46
+ | `alibaba-token-plan/happyhorse-1.1-i2v` | — | | | | | | — | — |
47
+ | `alibaba-token-plan/happyhorse-1.1-r2v` | — | | | | | | — | — |
48
+ | `alibaba-token-plan/happyhorse-1.1-t2v` | | | | | | | — | — |
49
+ | `alibaba-token-plan/kimi-k2.5` | 262K | | | | | | — | — |
50
+ | `alibaba-token-plan/kimi-k2.6` | 262K | | | | | | — | — |
51
+ | `alibaba-token-plan/kimi-k2.7-code` | 262K | | | | | | — | — |
52
+ | `alibaba-token-plan/MiniMax-M2.5` | 197K | | | | | | — | — |
53
+ | `alibaba-token-plan/qwen-image-2.0` | 8K | | | | | | — | — |
54
+ | `alibaba-token-plan/qwen-image-2.0-pro` | 8K | | | | | | — | — |
55
+ | `alibaba-token-plan/qwen3.6-flash` | 1.0M | | | | | | — | — |
56
+ | `alibaba-token-plan/qwen3.6-plus` | 1.0M | | | | | | — | — |
57
+ | `alibaba-token-plan/qwen3.7-max` | 1.0M | | | | | | — | — |
58
+ | `alibaba-token-plan/qwen3.7-plus` | 1.0M | | | | | | — | — |
59
+ | `alibaba-token-plan/qwen3.8-max` | 1.0M | | | | | | — | — |
60
+ | `alibaba-token-plan/qwen3.8-max-preview` | 1.0M | | | | | | — | — |
61
+ | `alibaba-token-plan/wan2.7-image` | 8K | | | | | | — | — |
62
+ | `alibaba-token-plan/wan2.7-image-pro` | 8K | | | | | | — | — |
61
63
 
62
64
  ## Advanced configuration
63
65
 
@@ -2,7 +2,7 @@
2
2
 
3
3
  # ![Alibaba logo](https://models.dev/logos/alibaba.svg)Alibaba
4
4
 
5
- Access 51 Alibaba models through Mastra's model router. Authentication is handled automatically using the `DASHSCOPE_API_KEY` environment variable.
5
+ Access 52 Alibaba models through Mastra's model router. Authentication is handled automatically using the `DASHSCOPE_API_KEY` environment variable.
6
6
 
7
7
  Learn more in the [Alibaba documentation](https://www.alibabacloud.com/help/en/model-studio/models).
8
8
 
@@ -86,6 +86,7 @@ for await (const chunk of stream) {
86
86
  | `alibaba/qwen3.6-plus` | 1.0M | | | | | | $0.50 | $3 |
87
87
  | `alibaba/qwen3.7-max` | 1.0M | | | | | | $3 | $8 |
88
88
  | `alibaba/qwen3.7-plus` | 1.0M | | | | | | $0.50 | $3 |
89
+ | `alibaba/qwen3.8-max` | 1.0M | | | | | | $2 | $6 |
89
90
  | `alibaba/qwq-plus` | 131K | | | | | | $0.80 | $2 |
90
91
 
91
92
  ## Advanced configuration