@mastra/mcp-docs-server 1.2.13-alpha.1 → 1.2.13-alpha.12

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 (160) hide show
  1. package/.docs/docs/agents/agent-approval.md +2 -2
  2. package/.docs/docs/agents/overview.md +1 -1
  3. package/.docs/docs/agents/supervisor-agents.md +2 -2
  4. package/.docs/docs/agents/using-tools.md +29 -0
  5. package/.docs/docs/capabilities/channels/imessage.md +181 -0
  6. package/.docs/docs/capabilities/channels/overview.md +1 -0
  7. package/.docs/docs/{evals/datasets → datasets}/overview.md +3 -3
  8. package/.docs/docs/{evals/datasets → datasets}/running-experiments.md +60 -3
  9. package/.docs/docs/deployment/workers.md +14 -14
  10. package/.docs/docs/editor/overview.md +201 -206
  11. package/.docs/docs/evals/evals-with-memory.md +1 -1
  12. package/.docs/docs/getting-started/develop.md +196 -0
  13. package/.docs/docs/index.md +78 -1
  14. package/.docs/docs/long-running-agents/durable-agents.md +2 -2
  15. package/.docs/docs/mastra-platform/overview.md +1 -1
  16. package/.docs/docs/mastra-platform/workspaces.md +152 -0
  17. package/.docs/docs/memory/observational-memory.md +53 -13
  18. package/.docs/docs/memory/overview.md +14 -0
  19. package/.docs/docs/server/auth/workers.md +7 -5
  20. package/.docs/docs/server/mastra-client.md +60 -0
  21. package/.docs/docs/server/pubsub.md +2 -2
  22. package/.docs/docs/studio/observability.md +4 -0
  23. package/.docs/docs/studio/overview.md +2 -2
  24. package/.docs/docs/workflows/overview.md +1 -1
  25. package/.docs/docs/workflows/scheduled-workflows.md +1 -0
  26. package/.docs/docs/workspace/search.md +1 -1
  27. package/.docs/guides/deployment/kubernetes.md +2 -0
  28. package/.docs/guides/deployment/mastra-workers.md +350 -6
  29. package/.docs/guides/deployment/vercel.md +2 -0
  30. package/.docs/guides/getting-started/quickstart.md +3 -3
  31. package/.docs/{docs → guides}/rag/chunking-and-embedding.md +1 -1
  32. package/.docs/{docs → guides}/rag/graph-rag.md +1 -1
  33. package/.docs/{docs → guides}/rag/overview.md +2 -2
  34. package/.docs/{docs → guides}/rag/retrieval.md +1 -1
  35. package/.docs/{docs → guides}/voice/overview.md +4 -4
  36. package/.docs/{docs → guides}/voice/realtime-voice.md +2 -2
  37. package/.docs/{docs → guides}/voice/speech-to-speech.md +1 -1
  38. package/.docs/{docs → guides}/voice/speech-to-text.md +1 -1
  39. package/.docs/{docs → guides}/voice/text-to-speech.md +2 -2
  40. package/.docs/models/embeddings.md +63 -65
  41. package/.docs/models/environment-variables.md +6 -2
  42. package/.docs/models/gateways/netlify.md +1 -2
  43. package/.docs/models/gateways/openrouter.md +5 -6
  44. package/.docs/models/gateways/vercel.md +9 -1
  45. package/.docs/models/index.md +1 -1
  46. package/.docs/models/providers/alibaba-cn.md +3 -1
  47. package/.docs/models/providers/alibaba-token-plan-cn.md +27 -25
  48. package/.docs/models/providers/alibaba-token-plan.md +27 -25
  49. package/.docs/models/providers/alibaba.md +2 -1
  50. package/.docs/models/providers/ambient.md +13 -12
  51. package/.docs/models/providers/baseten.md +3 -1
  52. package/.docs/models/providers/chutes.md +6 -8
  53. package/.docs/models/providers/crof.md +3 -1
  54. package/.docs/models/providers/crossmodel.md +7 -3
  55. package/.docs/models/providers/deepinfra.md +9 -2
  56. package/.docs/models/providers/digitalocean.md +34 -27
  57. package/.docs/models/providers/empiriolabs.md +5 -1
  58. package/.docs/models/providers/fireworks-ai.md +20 -19
  59. package/.docs/models/providers/greenpt.md +17 -8
  60. package/.docs/models/providers/groq.md +20 -20
  61. package/.docs/models/providers/huggingface.md +5 -1
  62. package/.docs/models/providers/hyper.md +13 -8
  63. package/.docs/models/providers/impossibl.md +148 -0
  64. package/.docs/models/providers/infomaniak.md +83 -0
  65. package/.docs/models/providers/kilo.md +349 -350
  66. package/.docs/models/providers/llmgateway.md +7 -4
  67. package/.docs/models/providers/minimax.md +1 -1
  68. package/.docs/models/providers/mistral.md +5 -2
  69. package/.docs/models/providers/modal.md +5 -4
  70. package/.docs/models/providers/modelis.md +81 -0
  71. package/.docs/models/providers/nano-gpt.md +146 -148
  72. package/.docs/models/providers/neuralwatt.md +4 -1
  73. package/.docs/models/providers/ofox.md +2 -2
  74. package/.docs/models/providers/ollama-cloud.md +23 -22
  75. package/.docs/models/providers/openai.md +2 -2
  76. package/.docs/models/providers/opencode-go.md +4 -2
  77. package/.docs/models/providers/opencode.md +1 -1
  78. package/.docs/models/providers/perplexity-agent.md +3 -1
  79. package/.docs/models/providers/requesty.md +54 -45
  80. package/.docs/models/providers/scaleway.md +1 -3
  81. package/.docs/models/providers/scx.md +74 -0
  82. package/.docs/models/providers/tensorx.md +97 -0
  83. package/.docs/models/providers/the-grid-ai.md +3 -3
  84. package/.docs/models/providers/togetherai.md +2 -1
  85. package/.docs/models/providers/umans-ai-coding-plan.md +11 -9
  86. package/.docs/models/providers/umans-ai.md +11 -9
  87. package/.docs/models/providers/wandb.md +2 -2
  88. package/.docs/models/providers/zai-coding-plan.md +11 -13
  89. package/.docs/models/providers/zhipuai-coding-plan.md +12 -12
  90. package/.docs/models/providers.md +5 -1
  91. package/.docs/reference/agents/agent.md +1 -1
  92. package/.docs/reference/agents/durable-agent.md +12 -1
  93. package/.docs/reference/agents/generate.md +1 -1
  94. package/.docs/reference/agents/getVoice.md +1 -1
  95. package/.docs/{docs/getting-started → reference}/build-with-ai.md +5 -110
  96. package/.docs/reference/cli/create-mastra.md +2 -0
  97. package/.docs/reference/cli/mastra.md +36 -16
  98. package/.docs/reference/client-js/agents.md +1 -1
  99. package/.docs/reference/configuration.md +2 -2
  100. package/.docs/reference/core/getEditor.md +1 -1
  101. package/.docs/reference/core/getVector.md +2 -2
  102. package/.docs/reference/core/listVectors.md +2 -2
  103. package/.docs/reference/core/mastra-class.md +2 -2
  104. package/.docs/reference/datasets/startExperiment.md +6 -0
  105. package/.docs/reference/datasets/startExperimentAsync.md +4 -0
  106. package/.docs/reference/editor/browser-provider.md +2 -2
  107. package/.docs/reference/editor/filesystem-provider.md +1 -1
  108. package/.docs/reference/editor/mastra-editor.md +31 -18
  109. package/.docs/reference/editor/prompt-blocks.md +137 -0
  110. package/.docs/reference/editor/sandbox-provider.md +1 -1
  111. package/.docs/reference/editor/storage-browser-ref.md +3 -3
  112. package/.docs/reference/editor/storage-workspace-ref.md +3 -3
  113. package/.docs/reference/editor/tool-provider.md +44 -10
  114. package/.docs/reference/editor/tools.md +100 -0
  115. package/.docs/reference/editor/versioning.md +130 -0
  116. package/.docs/reference/evals/mastra-scorer.md +68 -8
  117. package/.docs/reference/evals/summarization.md +203 -0
  118. package/.docs/reference/file-based-agents/config.md +39 -1
  119. package/.docs/reference/index.md +4 -4
  120. package/.docs/reference/memory/observational-memory.md +76 -24
  121. package/.docs/reference/memory/serialized-memory-config.md +3 -3
  122. package/.docs/reference/observability/tracing/interfaces.md +6 -1
  123. package/.docs/reference/processors/processor-interface.md +14 -2
  124. package/.docs/reference/processors/regex-filter-processor.md +1 -1
  125. package/.docs/reference/processors/token-limiter-processor.md +15 -1
  126. package/.docs/reference/project-structure.md +1 -1
  127. package/.docs/reference/rag/database-config.md +1 -1
  128. package/.docs/reference/storage/composite.md +2 -0
  129. package/.docs/reference/streaming/agents/stream.md +1 -1
  130. package/.docs/reference/tools/isolated-vm-transport.md +1 -1
  131. package/.docs/reference/vectors/mongodb.md +13 -13
  132. package/.docs/reference/voice/livekit.md +3 -3
  133. package/.docs/reference/workers/overview.md +10 -8
  134. package/.docs/reference/workspace/platform-filesystem.md +8 -5
  135. package/.docs/reference/workspace/platform-sandbox.md +83 -7
  136. package/CHANGELOG.md +51 -0
  137. package/README.md +1 -1
  138. package/package.json +5 -5
  139. package/.docs/docs/agent-builder/access-control.md +0 -99
  140. package/.docs/docs/agent-builder/browser.md +0 -63
  141. package/.docs/docs/agent-builder/channels.md +0 -78
  142. package/.docs/docs/agent-builder/configuration.md +0 -132
  143. package/.docs/docs/agent-builder/deploying.md +0 -124
  144. package/.docs/docs/agent-builder/integrations.md +0 -115
  145. package/.docs/docs/agent-builder/memory.md +0 -69
  146. package/.docs/docs/agent-builder/model-policy.md +0 -50
  147. package/.docs/docs/agent-builder/overview.md +0 -114
  148. package/.docs/docs/agent-builder/skill-registries.md +0 -31
  149. package/.docs/docs/agent-builder/workspace.md +0 -62
  150. package/.docs/docs/editor/prompts.md +0 -140
  151. package/.docs/docs/editor/tools.md +0 -148
  152. package/.docs/docs/getting-started/file-based-agents.md +0 -121
  153. package/.docs/docs/mastra-platform/workspace.md +0 -111
  154. package/.docs/docs/what-is-mastra.md +0 -161
  155. package/.docs/reference/client-js/agent-builder.md +0 -163
  156. package/.docs/reference/editor/agent-builder/agent-builder-options.md +0 -76
  157. package/.docs/reference/editor/agent-builder/builder-agent-defaults.md +0 -79
  158. package/.docs/reference/editor/agent-builder/builder-models.md +0 -66
  159. /package/.docs/{docs → guides}/getting-started/manual-install.md +0 -0
  160. /package/.docs/{docs → guides}/rag/vector-databases.md +0 -0
@@ -29,7 +29,7 @@ You can then use the following voice capabilities:
29
29
 
30
30
  Turn your agent's responses into natural-sounding speech using Mastra's TTS capabilities. Choose from multiple providers like OpenAI, ElevenLabs, and more.
31
31
 
32
- For detailed configuration options and advanced features, check out our [Text-to-Speech guide](https://mastra.ai/docs/voice/text-to-speech).
32
+ For detailed configuration options and advanced features, check out our [Text-to-Speech guide](https://mastra.ai/guides/voice/text-to-speech).
33
33
 
34
34
  **OpenAI**:
35
35
 
@@ -331,7 +331,7 @@ Visit the [Murf Voice Reference](https://mastra.ai/reference/voice/murf) for mor
331
331
 
332
332
  ### Speech to Text (STT)
333
333
 
334
- Transcribe spoken content using providers like OpenAI, ElevenLabs, and more. For detailed configuration options and more, check out [Speech to Text](https://mastra.ai/docs/voice/speech-to-text).
334
+ Transcribe spoken content using providers like OpenAI, ElevenLabs, and more. For detailed configuration options and more, check out [Speech to Text](https://mastra.ai/guides/voice/speech-to-text).
335
335
 
336
336
  You can download a sample audio file from [here](https://github.com/mastra-ai/realtime-voice-demo/raw/refs/heads/main/how_can_i_help_you.mp3).
337
337
 
@@ -564,7 +564,7 @@ Visit the [Sarvam Voice Reference](https://mastra.ai/reference/voice/sarvam) for
564
564
 
565
565
  ### Speech to Speech (STS)
566
566
 
567
- Create conversational experiences with speech-to-speech capabilities. The unified API enables real-time voice interactions between users and AI agents. For detailed configuration options and advanced features, check out [Speech to Speech](https://mastra.ai/docs/voice/speech-to-speech).
567
+ Create conversational experiences with speech-to-speech capabilities. The unified API enables real-time voice interactions between users and AI agents. For detailed configuration options and advanced features, check out [Speech to Speech](https://mastra.ai/guides/voice/speech-to-speech).
568
568
 
569
569
  **OpenAI**:
570
570
 
@@ -775,7 +775,7 @@ Visit the [xAI Realtime Voice Reference](https://mastra.ai/reference/voice/xai-r
775
775
 
776
776
  ### Realtime voice
777
777
 
778
- Run live calls a user can talk over, in the browser or over the phone. Mastra hands the audio loop to LiveKit, which covers voice activity detection, semantic turn detection, and barge-in, while your agent generates each reply with its own model, tools, and memory. For setup and configuration options, check out [Realtime voice](https://mastra.ai/docs/voice/realtime-voice).
778
+ Run live calls a user can talk over, in the browser or over the phone. Mastra hands the audio loop to LiveKit, which covers voice activity detection, semantic turn detection, and barge-in, while your agent generates each reply with its own model, tools, and memory. For setup and configuration options, check out [Realtime voice](https://mastra.ai/guides/voice/realtime-voice).
779
779
 
780
780
  ## Voice configuration
781
781
 
@@ -6,7 +6,7 @@ Realtime voice turns a Mastra agent into a live call a user can talk over, in th
6
6
 
7
7
  The [`@mastra/livekit`](https://mastra.ai/reference/voice/livekit) package connects Mastra agents to the [LiveKit Agents framework](https://docs.livekit.io/agents/): LiveKit owns the audio loop like voice activity detection, streaming speech-to-text, semantic turn detection, barge-in, and text-to-speech. Your Mastra agent generates every reply with its own model, tools, and memory.
8
8
 
9
- Use realtime voice when you need low-latency, interruptible voice conversations. For provider-based speech-to-speech without LiveKit, see [Speech to Speech](https://mastra.ai/docs/voice/speech-to-speech).
9
+ Use realtime voice when you need low-latency, interruptible voice conversations. For provider-based speech-to-speech without LiveKit, see [Speech to Speech](https://mastra.ai/guides/voice/speech-to-speech).
10
10
 
11
11
  ## Quickstart
12
12
 
@@ -399,6 +399,6 @@ Conversation history lives in Mastra Memory, so voice sessions and text chat can
399
399
  ## Related
400
400
 
401
401
  - [`@mastra/livekit` reference](https://mastra.ai/reference/voice/livekit)
402
- - [Speech to Speech](https://mastra.ai/docs/voice/speech-to-speech)
402
+ - [Speech to Speech](https://mastra.ai/guides/voice/speech-to-speech)
403
403
  - [Agent Memory](https://mastra.ai/docs/memory/overview)
404
404
  - [LiveKit Agents docs](https://docs.livekit.io/agents/)
@@ -54,7 +54,7 @@ const micStream = getMicrophoneStream()
54
54
  await agent.voice.send(micStream)
55
55
  ```
56
56
 
57
- For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/docs/voice/overview).
57
+ For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/guides/voice/overview).
58
58
 
59
59
  ## Use tools in realtime sessions
60
60
 
@@ -96,4 +96,4 @@ const transcription = await agent.voice.listen(audioStream, {
96
96
  console.log(`Transcription: ${transcription}`)
97
97
  ```
98
98
 
99
- For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/docs/voice/overview).
99
+ For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/guides/voice/overview).
@@ -4,7 +4,7 @@
4
4
 
5
5
  Text-to-Speech (TTS) in Mastra offers a unified API for synthesizing spoken audio from text using providers. By incorporating TTS into your applications, you can enhance user experience with natural voice interactions and improve accessibility for users with visual impairments, plus create more engaging multimodal interfaces.
6
6
 
7
- TTS is a core component of any voice application. Combined with STT (Speech-to-Text), it forms the foundation of voice interaction systems. Newer models support STS ([Speech-to-Speech](https://mastra.ai/docs/voice/speech-to-speech)) which can be used for real-time interactions but come at high cost ($).
7
+ TTS is a core component of any voice application. Combined with STT (Speech-to-Text), it forms the foundation of voice interaction systems. Newer models support STS ([Speech-to-Speech](https://mastra.ai/guides/voice/speech-to-speech)) which can be used for real-time interactions but come at high cost ($).
8
8
 
9
9
  ## Configuration
10
10
 
@@ -102,4 +102,4 @@ await new Promise<void>((resolve, reject) => {
102
102
  })
103
103
  ```
104
104
 
105
- For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/docs/voice/overview).
105
+ For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/guides/voice/overview).
@@ -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,7 +142,8 @@ 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` |
142
- | [The Grid AI](https://mastra.ai/models/providers/the-grid-ai) | `the-grid-ai/*` | `THEGRIDAI_API_KEY` |
145
+ | [TensorX](https://mastra.ai/models/providers/tensorx) | `tensorx/*` | `TENSORX_API_KEY` |
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` |
145
149
  | [Together AI](https://mastra.ai/models/providers/togetherai) | `togetherai/*` | `TOGETHER_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 338 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` |
@@ -100,6 +101,7 @@ ANTHROPIC_API_KEY=ant-...
100
101
  | `deepseek/deepseek-v3.2` |
101
102
  | `deepseek/deepseek-v3.2-exp` |
102
103
  | `deepseek/deepseek-v4-flash` |
104
+ | `deepseek/deepseek-v4-flash-0731` |
103
105
  | `deepseek/deepseek-v4-pro` |
104
106
  | `google/gemini-2.5-flash` |
105
107
  | `google/gemini-2.5-flash-image` |
@@ -164,7 +166,6 @@ ANTHROPIC_API_KEY=ant-...
164
166
  | `minimax/minimax-m2.7` |
165
167
  | `minimax/minimax-m3` |
166
168
  | `mistralai/codestral-2508` |
167
- | `mistralai/devstral-2512` |
168
169
  | `mistralai/ministral-14b-2512` |
169
170
  | `mistralai/ministral-3b-2512` |
170
171
  | `mistralai/ministral-8b-2512` |
@@ -224,14 +225,12 @@ ANTHROPIC_API_KEY=ant-...
224
225
  | `openai/gpt-4o-mini` |
225
226
  | `openai/gpt-4o-mini-2024-07-18` |
226
227
  | `openai/gpt-5` |
227
- | `openai/gpt-5-codex` |
228
228
  | `openai/gpt-5-image` |
229
229
  | `openai/gpt-5-image-mini` |
230
230
  | `openai/gpt-5-mini` |
231
231
  | `openai/gpt-5-nano` |
232
232
  | `openai/gpt-5-pro` |
233
233
  | `openai/gpt-5.1` |
234
- | `openai/gpt-5.1-chat` |
235
234
  | `openai/gpt-5.1-codex` |
236
235
  | `openai/gpt-5.1-codex-max` |
237
236
  | `openai/gpt-5.1-codex-mini` |
@@ -264,12 +263,10 @@ ANTHROPIC_API_KEY=ant-...
264
263
  | `openai/o1` |
265
264
  | `openai/o1-pro` |
266
265
  | `openai/o3` |
267
- | `openai/o3-deep-research` |
268
266
  | `openai/o3-mini` |
269
267
  | `openai/o3-mini-high` |
270
268
  | `openai/o3-pro` |
271
269
  | `openai/o4-mini` |
272
- | `openai/o4-mini-deep-research` |
273
270
  | `openai/o4-mini-high` |
274
271
  | `openrouter/auto` |
275
272
  | `openrouter/bodybuilder` |
@@ -334,6 +331,7 @@ ANTHROPIC_API_KEY=ant-...
334
331
  | `qwen/qwen3.7-flash` |
335
332
  | `qwen/qwen3.7-max` |
336
333
  | `qwen/qwen3.7-plus` |
334
+ | `qwen/qwen3.8-max` |
337
335
  | `rekaai/reka-edge` |
338
336
  | `rekaai/reka-flash-3` |
339
337
  | `relace/relace-apply-3` |
@@ -352,6 +350,7 @@ ANTHROPIC_API_KEY=ant-...
352
350
  | `thedrummer/skyfall-36b-v2` |
353
351
  | `thedrummer/unslopnemo-12b` |
354
352
  | `thinkingmachines/inkling` |
353
+ | `thinkingmachines/inkling-small` |
355
354
  | `undi95/remm-slerp-l2-13b` |
356
355
  | `upstage/solar-pro-3` |
357
356
  | `writer/palmyra-x5` |
@@ -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 307 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` |
@@ -179,6 +182,7 @@ ANTHROPIC_API_KEY=ant-...
179
182
  | `meta/llama-4-maverick` |
180
183
  | `meta/llama-4-scout` |
181
184
  | `meta/muse-spark-1.1` |
185
+ | `minimax/minimax-h3` |
182
186
  | `minimax/minimax-m2` |
183
187
  | `minimax/minimax-m2.1` |
184
188
  | `minimax/minimax-m2.1-lightning` |
@@ -276,6 +280,8 @@ ANTHROPIC_API_KEY=ant-...
276
280
  | `openai/tts-1` |
277
281
  | `openai/tts-1-hd` |
278
282
  | `openai/whisper-1` |
283
+ | `perplexity/pplx-embed-v1-0.6b` |
284
+ | `perplexity/pplx-embed-v1-4b` |
279
285
  | `perplexity/sonar` |
280
286
  | `perplexity/sonar-pro` |
281
287
  | `perplexity/sonar-reasoning-pro` |
@@ -296,6 +302,7 @@ ANTHROPIC_API_KEY=ant-...
296
302
  | `stepfun/step-3.7-flash` |
297
303
  | `tencent/hy3` |
298
304
  | `thinkingmachines/inkling` |
305
+ | `thinkingmachines/inkling-small` |
299
306
  | `voyage/rerank-2.5` |
300
307
  | `voyage/rerank-2.5-lite` |
301
308
  | `voyage/voyage-3-large` |
@@ -326,6 +333,7 @@ ANTHROPIC_API_KEY=ant-...
326
333
  | `xai/grok-stt` |
327
334
  | `xai/grok-tts` |
328
335
  | `xai/grok-voice-think-fast-1.0` |
336
+ | `xai/grok-voice-think-fast-2.0` |
329
337
  | `xiaomi/mimo-v2.5` |
330
338
  | `xiaomi/mimo-v2.5-pro` |
331
339
  | `zai/glm-4.5` |
@@ -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 5145 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 |