@mastra/mcp-docs-server 1.2.7-alpha.12 → 1.2.7-alpha.4

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 (158) hide show
  1. package/.docs/docs/agent-builder/integrations.md +2 -44
  2. package/.docs/docs/agent-builder/overview.md +3 -4
  3. package/.docs/docs/agent-builder/skill-registries.md +3 -1
  4. package/.docs/docs/agent-controller/overview.md +2 -3
  5. package/.docs/docs/agent-controller/session.md +3 -1
  6. package/.docs/docs/agents/a2a.md +1 -2
  7. package/.docs/docs/agents/channels.md +225 -0
  8. package/.docs/docs/agents/code-mode.md +1 -1
  9. package/.docs/docs/agents/file-based-agents.md +297 -0
  10. package/.docs/docs/agents/guardrails.md +9 -10
  11. package/.docs/docs/agents/overview.md +4 -4
  12. package/.docs/docs/agents/skills.md +5 -3
  13. package/.docs/docs/agents/structured-output.md +1 -1
  14. package/.docs/docs/agents/supervisor-agents.md +4 -3
  15. package/.docs/docs/agents/using-tools.md +4 -2
  16. package/.docs/docs/browser/agent-browser.md +3 -1
  17. package/.docs/docs/browser/browser-viewer.md +3 -1
  18. package/.docs/docs/browser/overview.md +1 -2
  19. package/.docs/docs/browser/stagehand.md +1 -1
  20. package/.docs/docs/deployment/mastra-server.md +4 -2
  21. package/.docs/docs/editor/overview.md +6 -2
  22. package/.docs/docs/editor/prompts.md +1 -1
  23. package/.docs/docs/editor/tools.md +5 -3
  24. package/.docs/docs/evals/custom-scorers.md +3 -1
  25. package/.docs/docs/evals/datasets/overview.md +5 -4
  26. package/.docs/docs/evals/datasets/running-experiments.md +2 -4
  27. package/.docs/docs/evals/evals-with-memory.md +3 -1
  28. package/.docs/docs/evals/gates-and-verdicts.md +3 -1
  29. package/.docs/docs/evals/overview.md +1 -4
  30. package/.docs/docs/evals/quick-checks.md +3 -1
  31. package/.docs/docs/long-running-agents/background-tasks.md +1 -1
  32. package/.docs/docs/long-running-agents/durable-agents.md +5 -3
  33. package/.docs/docs/long-running-agents/goals.md +3 -1
  34. package/.docs/docs/long-running-agents/signal-providers.md +3 -1
  35. package/.docs/docs/long-running-agents/signals.md +22 -11
  36. package/.docs/docs/mastra-platform/observability.md +1 -5
  37. package/.docs/docs/mcp/mcp-apps.md +3 -3
  38. package/.docs/docs/mcp/overview.md +10 -6
  39. package/.docs/docs/memory/observational-memory.md +1 -2
  40. package/.docs/docs/memory/overview.md +4 -6
  41. package/.docs/docs/memory/semantic-recall.md +1 -1
  42. package/.docs/docs/memory/working-memory.md +3 -3
  43. package/.docs/docs/observability/integrations/exporters/mastra-platform.md +3 -1
  44. package/.docs/docs/observability/logging.md +1 -1
  45. package/.docs/docs/observability/tracing/overview.md +1 -1
  46. package/.docs/docs/server/auth/auth0.md +1 -1
  47. package/.docs/docs/server/auth/better-auth.md +2 -2
  48. package/.docs/docs/server/auth/clerk.md +1 -1
  49. package/.docs/docs/server/auth/firebase.md +1 -1
  50. package/.docs/docs/server/auth/google.md +2 -2
  51. package/.docs/docs/server/auth/jwt.md +2 -2
  52. package/.docs/docs/server/auth/okta.md +2 -2
  53. package/.docs/docs/server/auth/workos.md +1 -1
  54. package/.docs/docs/server/mastra-client.md +1 -1
  55. package/.docs/docs/server/mastra-server.md +1 -1
  56. package/.docs/docs/server/pubsub.md +1 -1
  57. package/.docs/docs/server/request-context.md +4 -4
  58. package/.docs/docs/server/server-adapters.md +8 -8
  59. package/.docs/docs/studio/auth.md +3 -1
  60. package/.docs/docs/studio/overview.md +1 -1
  61. package/.docs/docs/workflows/agents-and-tools.md +5 -3
  62. package/.docs/docs/workflows/control-flow.md +3 -1
  63. package/.docs/docs/workflows/overview.md +7 -6
  64. package/.docs/docs/workspace/overview.md +1 -2
  65. package/.docs/docs/workspace/sandbox.md +0 -2
  66. package/.docs/guides/build-your-ui/assistant-ui.md +1 -1
  67. package/.docs/guides/build-your-ui/copilotkit/overview.md +1 -1
  68. package/.docs/guides/concepts/streaming.md +3 -3
  69. package/.docs/guides/getting-started/quickstart.md +1 -3
  70. package/.docs/guides/guide/chef-michel.md +2 -0
  71. package/.docs/guides/guide/slack-assistant.md +2 -2
  72. package/.docs/guides/guide/stock-agent.md +2 -0
  73. package/.docs/models/environment-variables.md +0 -6
  74. package/.docs/models/gateways/netlify.md +1 -4
  75. package/.docs/models/gateways/openrouter.md +7 -8
  76. package/.docs/models/gateways/vercel.md +1 -6
  77. package/.docs/models/index.md +1 -1
  78. package/.docs/models/providers/abacus.md +14 -44
  79. package/.docs/models/providers/llmgateway.md +181 -185
  80. package/.docs/models/providers/nano-gpt.md +2 -2
  81. package/.docs/models/providers/neon.md +29 -40
  82. package/.docs/models/providers/nvidia.md +3 -1
  83. package/.docs/models/providers/openai.md +1 -6
  84. package/.docs/models/providers/opencode.md +2 -5
  85. package/.docs/models/providers/poolside.md +5 -6
  86. package/.docs/models/providers/routing-run.md +34 -23
  87. package/.docs/models/providers/the-grid-ai.md +3 -3
  88. package/.docs/models/providers.md +0 -6
  89. package/.docs/reference/agents/channels.md +2 -2
  90. package/.docs/reference/channels/channel-provider.md +1 -1
  91. package/.docs/reference/channels/slack-provider.md +2 -2
  92. package/.docs/reference/cli/mastra.md +10 -117
  93. package/.docs/reference/evals/create-scorer.md +0 -8
  94. package/.docs/reference/index.md +0 -15
  95. package/.docs/reference/memory/memory-class.md +1 -1
  96. package/.docs/reference/memory/serialized-memory-config.md +1 -1
  97. package/.docs/reference/project-structure.md +1 -1
  98. package/.docs/reference/pubsub/lease-provider.md +1 -1
  99. package/.docs/reference/server/express-adapter.md +3 -1
  100. package/.docs/reference/server/fastify-adapter.md +3 -1
  101. package/.docs/reference/server/hono-adapter.md +3 -1
  102. package/.docs/reference/server/koa-adapter.md +3 -1
  103. package/.docs/reference/server/nestjs-adapter.md +3 -1
  104. package/.docs/reference/storage/clickhouse.md +0 -32
  105. package/.docs/reference/storage/composite.md +1 -27
  106. package/.docs/reference/storage/retention.md +0 -11
  107. package/.docs/reference/tools/mcp-client.md +0 -22
  108. package/.docs/reference/tools/mcp-server.md +4 -161
  109. package/.docs/reference/workspace/agentcore-runtime-sandbox.md +3 -1
  110. package/.docs/reference/workspace/agentfs-filesystem.md +3 -1
  111. package/.docs/reference/workspace/apple-container-sandbox.md +3 -1
  112. package/.docs/reference/workspace/archil-filesystem.md +3 -1
  113. package/.docs/reference/workspace/azure-blob-filesystem.md +3 -1
  114. package/.docs/reference/workspace/blaxel-sandbox.md +3 -1
  115. package/.docs/reference/workspace/daytona-sandbox.md +3 -1
  116. package/.docs/reference/workspace/docker-sandbox.md +3 -1
  117. package/.docs/reference/workspace/e2b-sandbox.md +3 -1
  118. package/.docs/reference/workspace/files-sdk-filesystem.md +3 -1
  119. package/.docs/reference/workspace/gcs-filesystem.md +3 -1
  120. package/.docs/reference/workspace/google-drive-filesystem.md +3 -1
  121. package/.docs/reference/workspace/local-filesystem.md +3 -1
  122. package/.docs/reference/workspace/local-sandbox.md +3 -1
  123. package/.docs/reference/workspace/modal-sandbox.md +3 -1
  124. package/.docs/reference/workspace/railway-sandbox.md +3 -1
  125. package/.docs/reference/workspace/s3-filesystem.md +3 -1
  126. package/.docs/reference/workspace/vercel-sandbox.md +7 -5
  127. package/.docs/reference/workspace/vercel-serverless.md +3 -1
  128. package/CHANGELOG.md +0 -29
  129. package/package.json +4 -4
  130. package/.docs/docs/capabilities/channels/discord.md +0 -98
  131. package/.docs/docs/capabilities/channels/other-adapters.md +0 -68
  132. package/.docs/docs/capabilities/channels/overview.md +0 -255
  133. package/.docs/docs/capabilities/channels/slack.md +0 -225
  134. package/.docs/docs/capabilities/channels/teams.md +0 -100
  135. package/.docs/docs/capabilities/channels/telegram.md +0 -98
  136. package/.docs/docs/capabilities/channels/whatsapp.md +0 -99
  137. package/.docs/docs/getting-started/file-based-agents.md +0 -116
  138. package/.docs/models/providers/crossmodel.md +0 -109
  139. package/.docs/models/providers/empiriolabs.md +0 -106
  140. package/.docs/models/providers/meta.md +0 -101
  141. package/.docs/models/providers/model-oracle-ai.md +0 -87
  142. package/.docs/models/providers/pioneer.md +0 -148
  143. package/.docs/models/providers/unorouter.md +0 -95
  144. package/.docs/reference/file-based-agents/config.md +0 -97
  145. package/.docs/reference/file-based-agents/instructions.md +0 -54
  146. package/.docs/reference/file-based-agents/logger.md +0 -26
  147. package/.docs/reference/file-based-agents/memory.md +0 -58
  148. package/.docs/reference/file-based-agents/observability.md +0 -32
  149. package/.docs/reference/file-based-agents/processors.md +0 -56
  150. package/.docs/reference/file-based-agents/scorers.md +0 -54
  151. package/.docs/reference/file-based-agents/server.md +0 -37
  152. package/.docs/reference/file-based-agents/skills.md +0 -56
  153. package/.docs/reference/file-based-agents/storage.md +0 -30
  154. package/.docs/reference/file-based-agents/studio.md +0 -56
  155. package/.docs/reference/file-based-agents/subagents.md +0 -123
  156. package/.docs/reference/file-based-agents/tools.md +0 -63
  157. package/.docs/reference/file-based-agents/workflows.md +0 -52
  158. package/.docs/reference/file-based-agents/workspace.md +0 -74
@@ -82,7 +82,7 @@ export const mastra = new Mastra({
82
82
  })
83
83
  ```
84
84
 
85
- Visit [Middleware](https://mastra.ai/docs/server/middleware) for how to use server middleware.
85
+ > **Info:** Visit [Middleware](https://mastra.ai/docs/server/middleware) for how to use server middleware.
86
86
 
87
87
  ## Studio
88
88
 
@@ -188,7 +188,7 @@ export const registryAgent = new Agent({
188
188
  })
189
189
  ```
190
190
 
191
- Visit [Agent](https://mastra.ai/reference/agents/agent) for a full list of configuration options.
191
+ > **Info:** Visit [Agent](https://mastra.ai/reference/agents/agent) for a full list of configuration options.
192
192
 
193
193
  ## Accessing values from workflow steps
194
194
 
@@ -210,7 +210,7 @@ const stepOne = createStep({
210
210
  })
211
211
  ```
212
212
 
213
- Visit [createStep()](https://mastra.ai/reference/workflows/step) for a full list of configuration options.
213
+ > **Info:** Visit [createStep()](https://mastra.ai/reference/workflows/step) for a full list of configuration options.
214
214
 
215
215
  ## Accessing values with tools
216
216
 
@@ -232,7 +232,7 @@ export const weatherTool = createTool({
232
232
  })
233
233
  ```
234
234
 
235
- Visit [createTool()](https://mastra.ai/reference/tools/create-tool) for a full list of configuration options.
235
+ > **Info:** Visit [createTool()](https://mastra.ai/reference/tools/create-tool) for a full list of configuration options.
236
236
 
237
237
  ## Reserved keys
238
238
 
@@ -303,7 +303,7 @@ app.listen(4111, () => {
303
303
  })
304
304
  ```
305
305
 
306
- See the [Express Adapter](https://mastra.ai/reference/server/express-adapter) documentation for full configuration options.
306
+ > **Info:** See the [Express Adapter](https://mastra.ai/reference/server/express-adapter) documentation for full configuration options.
307
307
 
308
308
  **Hono**:
309
309
 
@@ -324,7 +324,7 @@ serve({ fetch: app.fetch, port: 4111 }, () => {
324
324
  })
325
325
  ```
326
326
 
327
- See the [Hono Adapter](https://mastra.ai/reference/server/hono-adapter) documentation for full configuration options.
327
+ > **Info:** See the [Hono Adapter](https://mastra.ai/reference/server/hono-adapter) documentation for full configuration options.
328
328
 
329
329
  **Fastify**:
330
330
 
@@ -352,7 +352,7 @@ app.listen({ port }, () => {
352
352
  })
353
353
  ```
354
354
 
355
- See the [Fastify Adapter](https://mastra.ai/reference/server/fastify-adapter) documentation for full configuration options.
355
+ > **Info:** See the [Fastify Adapter](https://mastra.ai/reference/server/fastify-adapter) documentation for full configuration options.
356
356
 
357
357
  **Koa**:
358
358
 
@@ -387,7 +387,7 @@ app.listen(port, () => {
387
387
  })
388
388
  ```
389
389
 
390
- See the [Koa Adapter](https://mastra.ai/reference/server/koa-adapter) documentation for full configuration options.
390
+ > **Info:** See the [Koa Adapter](https://mastra.ai/reference/server/koa-adapter) documentation for full configuration options.
391
391
 
392
392
  **NestJS**:
393
393
 
@@ -418,7 +418,7 @@ async function bootstrap() {
418
418
  bootstrap()
419
419
  ```
420
420
 
421
- See the [NestJS Adapter](https://mastra.ai/reference/server/nestjs-adapter) documentation for full configuration options.
421
+ > **Info:** See the [NestJS Adapter](https://mastra.ai/reference/server/nestjs-adapter) documentation for full configuration options.
422
422
 
423
423
  ## Initialization flow
424
424
 
@@ -460,7 +460,7 @@ You can add your own routes to the app alongside Mastra's routes.
460
460
  - When you want Mastra-managed auth and route metadata such as `requiresAuth`, prefer `registerApiRoute()`.
461
461
  - When you mount routes directly on the framework app, use the adapter's exported `createAuthMiddleware()` helper if those routes need Mastra auth.
462
462
 
463
- Visit "Adding custom routes" for [Express](https://mastra.ai/reference/server/express-adapter) and [Hono](https://mastra.ai/reference/server/hono-adapter) for more information.
463
+ > **Info:** Visit "Adding custom routes" for [Express](https://mastra.ai/reference/server/express-adapter) and [Hono](https://mastra.ai/reference/server/hono-adapter) for more information.
464
464
 
465
465
  ## Route prefixes
466
466
 
@@ -513,7 +513,7 @@ const server = new MastraServer({
513
513
  })
514
514
  ```
515
515
 
516
- See [MastraServer](https://mastra.ai/reference/server/mastra-server) for full configuration options.
516
+ > **Info:** See [MastraServer](https://mastra.ai/reference/server/mastra-server) for full configuration options.
517
517
 
518
518
  ## Per-route auth overrides
519
519
 
@@ -540,7 +540,7 @@ const server = new MastraServer({
540
540
  })
541
541
  ```
542
542
 
543
- See [MastraServer](https://mastra.ai/reference/server/mastra-server) for full configuration options.
543
+ > **Info:** See [MastraServer](https://mastra.ai/reference/server/mastra-server) for full configuration options.
544
544
 
545
545
  ## Accessing the app
546
546
 
@@ -35,7 +35,9 @@ export const mastra = new Mastra({
35
35
  })
36
36
  ```
37
37
 
38
- Once configured, Studio shows a login screen and requires authentication for all API requests. Visit the [Auth docs](https://mastra.ai/docs/server/auth) for a full list of supported providers.
38
+ Once configured, Studio shows a login screen and requires authentication for all API requests.
39
+
40
+ > **Note:** Visit the [Auth docs](https://mastra.ai/docs/server/auth) for a full list of supported providers.
39
41
 
40
42
  ## How it works
41
43
 
@@ -4,7 +4,7 @@
4
4
 
5
5
  Studio provides an interactive UI for building, testing, and managing your agents, workflows, and tools. Run it locally during development, add [authentication](https://mastra.ai/docs/studio/auth), or [deploy it](https://mastra.ai/docs/studio/deployment) to production so your team can manage agents, monitor performance, and gain insights through built-in observability.
6
6
 
7
- > **📹 Watch:** Watch [Mastra Studio overview](https://youtu.be/ojGu6Bi4wYk) for a short walkthrough of building, testing, and managing agents in Studio.
7
+ [YouTube video player](https://www.youtube-nocookie.com/embed/ojGu6Bi4wYk)
8
8
 
9
9
  ## Start Studio
10
10
 
@@ -57,7 +57,7 @@ export const testWorkflow = createWorkflow({})
57
57
  .commit()
58
58
  ```
59
59
 
60
- Visit [Input Data Mapping](https://mastra.ai/docs/workflows/control-flow) for more information.
60
+ > **Info:** Visit [Input Data Mapping](https://mastra.ai/docs/workflows/control-flow) for more information.
61
61
 
62
62
  When no `structuredOutput` option is provided, Mastra agents use a default schema that expects a `prompt` string as input and returns a `text` string as output:
63
63
 
@@ -106,7 +106,9 @@ export const testWorkflow = createWorkflow({})
106
106
  .commit()
107
107
  ```
108
108
 
109
- The `structuredOutput.schema` option accepts any Standard JSON Schema. The agent will generate output conforming to this schema, and the step's `outputSchema` will be automatically set to match. Visit [Structured Output](https://mastra.ai/docs/agents/structured-output) for more options like error handling strategies and streaming with structured output.
109
+ The `structuredOutput.schema` option accepts any Standard JSON Schema. The agent will generate output conforming to this schema, and the step's `outputSchema` will be automatically set to match.
110
+
111
+ > **Info:** Visit [Structured Output](https://mastra.ai/docs/agents/structured-output) for more options like error handling strategies and streaming with structured output.
110
112
 
111
113
  ## Using tools in workflows
112
114
 
@@ -155,7 +157,7 @@ export const testWorkflow = createWorkflow({})
155
157
  .commit()
156
158
  ```
157
159
 
158
- Visit [Input Data Mapping](https://mastra.ai/docs/workflows/control-flow) for more information.
160
+ > **Info:** Visit [Input Data Mapping](https://mastra.ai/docs/workflows/control-flow) for more information.
159
161
 
160
162
  ## Related
161
163
 
@@ -101,6 +101,8 @@ export const testWorkflow = createWorkflow({
101
101
  .commit()
102
102
  ```
103
103
 
104
+ > **📹 Watch:** How to run steps in parallel and optimize your Mastra workflow → [YouTube (3 minutes)](https://youtu.be/GQJxve5Hki4)
105
+
104
106
  ### Output structure
105
107
 
106
108
  When steps run in parallel, the output is an object where each key is the step's `id` and the value is that step's output. This allows you to access each parallel step's result independently.
@@ -208,7 +210,7 @@ const writerStep = createStep({
208
210
  })
209
211
  ```
210
212
 
211
- Visit [Choosing the right pattern](#choosing-the-right-pattern) to understand when to use `.parallel()` vs `.foreach()`.
213
+ > **Info:** Visit [Choosing the right pattern](#choosing-the-right-pattern) to understand when to use `.parallel()` vs `.foreach()`.
212
214
 
213
215
  ## Conditional logic with `.branch()`
214
216
 
@@ -10,6 +10,8 @@ Workflows let you define complex sequences of tasks using clear, structured step
10
10
 
11
11
  Use workflows for tasks that are clearly defined upfront and involve multiple steps with a specific execution order. They give you fine-grained control over how data flows and transforms between steps, and which primitives are called at each stage.
12
12
 
13
+ > **Tip:** Watch an introduction to workflows, and how they compare to agents on [YouTube (7 minutes)](https://youtu.be/0jg2g3sNvgw).
14
+
13
15
  ## Core principles
14
16
 
15
17
  Mastra workflows operate using these principles:
@@ -101,7 +103,7 @@ const step1 = createStep({
101
103
  })
102
104
  ```
103
105
 
104
- Visit [`Step`](https://mastra.ai/reference/workflows/step) for a full list of configuration options.
106
+ > **Info:** Visit [`Step`](https://mastra.ai/reference/workflows/step) for a full list of configuration options.
105
107
 
106
108
  ### Using agents and tools
107
109
 
@@ -175,7 +177,7 @@ export const testWorkflow = createWorkflow({
175
177
  .commit();
176
178
  ```
177
179
 
178
- Visit [Workflow Class](https://mastra.ai/reference/workflows/workflow) for a full list of configuration options.
180
+ > **Info:** Visit [Workflow Class](https://mastra.ai/reference/workflows/workflow) for a full list of configuration options.
179
181
 
180
182
  ### Understanding control flow
181
183
 
@@ -212,7 +214,7 @@ const step1 = createStep({
212
214
  })
213
215
  ```
214
216
 
215
- Visit [Workflow State](https://mastra.ai/docs/workflows/workflow-state) for complete documentation on state schemas, initial state, persistence across suspend/resume, and nested workflows.
217
+ > **Info:** Visit [Workflow State](https://mastra.ai/docs/workflows/workflow-state) for complete documentation on state schemas, initial state, persistence across suspend/resume, and nested workflows.
216
218
 
217
219
  ## Workflows as steps
218
220
 
@@ -533,7 +535,7 @@ const step1 = createStep({
533
535
  })
534
536
  ```
535
537
 
536
- Visit [Request Context](https://mastra.ai/docs/server/request-context) for more information.
538
+ > **Info:** Visit [Request Context](https://mastra.ai/docs/server/request-context) for more information.
537
539
 
538
540
  > **Tip:** For type-safe request context schema validation, see [Schema Validation](https://mastra.ai/docs/server/request-context).
539
541
 
@@ -544,5 +546,4 @@ For a closer look at workflows, see our [Workflow Guide](https://mastra.ai/guide
544
546
  - [Workflow State](https://mastra.ai/docs/workflows/workflow-state)
545
547
  - [Control Flow](https://mastra.ai/docs/workflows/control-flow)
546
548
  - [Suspend and Resume](https://mastra.ai/docs/workflows/suspend-and-resume)
547
- - [Error Handling](https://mastra.ai/docs/workflows/error-handling)
548
- - 📹 [Agentic workflows with Mastra workshop](https://www.youtube.com/watch?v=HGt8pVPpX9g)
549
+ - [Error Handling](https://mastra.ai/docs/workflows/error-handling)
@@ -411,5 +411,4 @@ External providers may perform additional setup like establishing connections or
411
411
  - [LSP inspection](https://mastra.ai/docs/workspace/lsp)
412
412
  - [Skills](https://mastra.ai/docs/workspace/skills)
413
413
  - [Search and indexing](https://mastra.ai/docs/workspace/search)
414
- - [Workspace class reference](https://mastra.ai/reference/workspace/workspace-class)
415
- - 📹 [Introduction to Mastra Workspaces workshop](https://www.youtube.com/watch?v=QcQLiYlJuNQ)
414
+ - [Workspace class reference](https://mastra.ai/reference/workspace/workspace-class)
@@ -15,8 +15,6 @@ A sandbox provider executes commands in a controlled environment:
15
15
  - **Timeouts**: Prevent long-running commands from hanging
16
16
  - **Isolation**: Optional OS-level sandboxing for security
17
17
 
18
- > **📹 Watch:** Watch [Mastra remote sandboxes overview](https://www.youtube.com/watch?v=Ix2X-sjVXjw) to see how remote sandboxes give agents an isolated computer to work in.
19
-
20
18
  ## Supported providers
21
19
 
22
20
  - [`LocalSandbox`](https://mastra.ai/reference/workspace/local-sandbox): Executes commands on the local machine
@@ -6,7 +6,7 @@
6
6
 
7
7
  > **Info:** For a full-stack integration approach where Mastra runs directly in your Next.js API routes, see the [Full-Stack Integration Guide](https://www.assistant-ui.com/docs/integrations/frameworks/mastra/full-stack) on Assistant UI's documentation site.
8
8
 
9
- Visit Mastra's [**"UI Dojo"**](https://ui-dojo.mastra.ai/) to see real-world examples of Assistant UI integrated with Mastra.
9
+ > **Tip:** Visit Mastra's [**"UI Dojo"**](https://ui-dojo.mastra.ai/) to see real-world examples of Assistant UI integrated with Mastra.
10
10
 
11
11
  ## Integration guide
12
12
 
@@ -10,7 +10,7 @@ Visit the [CopilotKit documentation](https://docs.copilotkit.ai/) to learn more
10
10
 
11
11
  > **Info:** For a full-stack integration approach where Mastra runs directly in your Next.js API routes, see the [CopilotKit Quickstart](https://docs.copilotkit.ai/mastra/quickstart) guide.
12
12
 
13
- Visit Mastra's ["UI Dojo"](https://ui-dojo.mastra.ai/) to see real-world examples of CopilotKit integrated with Mastra.
13
+ > **Tip:** Visit Mastra's ["UI Dojo"](https://ui-dojo.mastra.ai/) to see real-world examples of CopilotKit integrated with Mastra.
14
14
 
15
15
  ## Integration guide
16
16
 
@@ -29,7 +29,7 @@ for await (const chunk of stream.textStream) {
29
29
  }
30
30
  ```
31
31
 
32
- Visit [Agent.stream()](https://mastra.ai/reference/streaming/agents/stream) for more information.
32
+ > **Info:** Visit [Agent.stream()](https://mastra.ai/reference/streaming/agents/stream) for more information.
33
33
 
34
34
  > **Tip:** For agents that dispatch [background tasks](https://mastra.ai/docs/long-running-agents/background-tasks), use [`Agent.streamUntilIdle()`](https://mastra.ai/reference/streaming/agents/streamUntilIdle) to keep the stream open until those tasks complete and the agent has had a chance to respond to their results.
35
35
 
@@ -101,7 +101,7 @@ for await (const chunk of stream) {
101
101
  }
102
102
  ```
103
103
 
104
- Visit [Run.stream()](https://mastra.ai/reference/streaming/workflows/stream) for more information.
104
+ > **Info:** Visit [Run.stream()](https://mastra.ai/reference/streaming/workflows/stream) for more information.
105
105
 
106
106
  ### Output from `Run.stream()`
107
107
 
@@ -160,7 +160,7 @@ for await (const chunk of stream) {
160
160
  }
161
161
  ```
162
162
 
163
- Visit [Agent.stream()](https://mastra.ai/reference/streaming/agents/stream) for more information.
163
+ > **Info:** Visit [Agent.stream()](https://mastra.ai/reference/streaming/agents/stream) for more information.
164
164
 
165
165
  ### Example agent output
166
166
 
@@ -8,8 +8,6 @@ The `create mastra` CLI command is the quickest way to get started. It walks you
8
8
 
9
9
  If you need more control over the setup, see the [manual installation guide](https://mastra.ai/docs/getting-started/manual-install). You can also use [`mastra init`](https://mastra.ai/reference/cli/mastra) for existing projects.
10
10
 
11
- > **📹 Watch:** Watch [Mastra AI agent course](https://www.youtube.com/watch?v=lCmf_qrGfGA) for a guided introduction to building agents with Mastra.
12
-
13
11
  ## Before you begin
14
12
 
15
13
  - You'll need an API key from a supported [model provider](https://mastra.ai/models). If you don't have a preference, use [OpenAI](https://mastra.ai/models/providers/openai).
@@ -60,7 +58,7 @@ Depending on your choices, you'll also end up with [Mastra Skills](https://mastr
60
58
 
61
59
  Once setup is complete, follow the instructions in your terminal to start the Mastra dev server, then open Studio at [localhost:4111](http://localhost:4111).
62
60
 
63
- Try asking about the weather. If your API key is set up correctly, you'll get a response in Studio.
61
+ Try asking about the weather. If your API key is set up correctly, you'll get a response:
64
62
 
65
63
  [Studio](https://mastra.ai/docs/studio/overview) lets you rapidly build and prototype agents without needing to build a UI. Once you're ready, you can integrate your Mastra agent into your app using the guides below.
66
64
 
@@ -6,6 +6,8 @@ In this guide, you'll create a "Chef Assistant" agent that helps users cook meal
6
6
 
7
7
  You'll learn how to create the agent and register it with Mastra. Next, you'll interact with the agent through your terminal and get to know different response formats. Lastly, you'll access the agent through Mastra's local API endpoints.
8
8
 
9
+ [YouTube video player](https://www.youtube-nocookie.com/embed/_tZhOqHCrF0)
10
+
9
11
  ## Prerequisites
10
12
 
11
13
  - Node.js `v22.13.0` or later installed
@@ -182,12 +182,12 @@ You can extend this agent to:
182
182
 
183
183
  - [Deploy your application](https://mastra.ai/docs/deployment/overview) and update the Slack **Request URL** to your production endpoint
184
184
  - Add more adapters (Discord, Telegram) to the same agent so it responds on multiple platforms
185
- - Configure [multimodal content](https://mastra.ai/docs/capabilities/channels/overview) to let your agent process images, video, and audio shared in chat
185
+ - Configure [multimodal content](https://mastra.ai/docs/agents/channels) to let your agent process images, video, and audio shared in chat
186
186
  - Add [tools](https://mastra.ai/docs/agents/using-tools) to give the agent access to external APIs and data
187
187
 
188
188
  Learn more:
189
189
 
190
- - [Channels overview](https://mastra.ai/docs/capabilities/channels/overview)
190
+ - [Channels overview](https://mastra.ai/docs/agents/channels)
191
191
  - [Studio](https://mastra.ai/docs/studio/overview)
192
192
  - [Deployment overview](https://mastra.ai/docs/deployment/overview)
193
193
  - [Chat SDK adapter docs](https://chat-sdk.dev)
@@ -4,6 +4,8 @@
4
4
 
5
5
  In this guide, you're going to create an agent that fetches the last day's closing stock price for a given symbol. You'll learn how to create a tool, add it to an agent, and use the agent to fetch stock prices.
6
6
 
7
+ [YouTube video player](https://www.youtube-nocookie.com/embed/rIaZ4l7y9wo)
8
+
7
9
  ## Prerequisites
8
10
 
9
11
  - Node.js `v22.13.0` or later installed
@@ -31,14 +31,12 @@ List of required environment variables for each model provider and gateway suppo
31
31
  | [Cloudflare Workers AI](https://mastra.ai/models/providers/cloudflare-workers-ai) | `cloudflare-workers-ai/*` | `CLOUDFLARE_ACCOUNT_ID`, `CLOUDFLARE_API_KEY` |
32
32
  | [Cortecs](https://mastra.ai/models/providers/cortecs) | `cortecs/*` | `CORTECS_API_KEY` |
33
33
  | [CrofAI](https://mastra.ai/models/providers/crof) | `crof/*` | `CROF_API_KEY` |
34
- | [CrossModel](https://mastra.ai/models/providers/crossmodel) | `crossmodel/*` | `CROSSMODEL_API_KEY` |
35
34
  | [D.Run (China)](https://mastra.ai/models/providers/drun) | `drun/*` | `DRUN_API_KEY` |
36
35
  | [Databricks](https://mastra.ai/models/providers/databricks) | `databricks/*` | `DATABRICKS_HOST`, `DATABRICKS_TOKEN` |
37
36
  | [Deep Infra](https://mastra.ai/models/providers/deepinfra) | `deepinfra/*` | `DEEPINFRA_API_KEY` |
38
37
  | [DeepSeek](https://mastra.ai/models/providers/deepseek) | `deepseek/*` | `DEEPSEEK_API_KEY` |
39
38
  | [DigitalOcean](https://mastra.ai/models/providers/digitalocean) | `digitalocean/*` | `DIGITALOCEAN_ACCESS_TOKEN` |
40
39
  | [DInference](https://mastra.ai/models/providers/dinference) | `dinference/*` | `DINFERENCE_API_KEY` |
41
- | [EmpirioLabs AI](https://mastra.ai/models/providers/empiriolabs) | `empiriolabs/*` | `EMPIRIOLABS_API_KEY` |
42
40
  | [evroc](https://mastra.ai/models/providers/evroc) | `evroc/*` | `EVROC_API_KEY` |
43
41
  | [FastRouter](https://mastra.ai/models/providers/fastrouter) | `fastrouter/*` | `FASTROUTER_API_KEY` |
44
42
  | [Fireworks AI](https://mastra.ai/models/providers/fireworks-ai) | `fireworks-ai/*` | `FIREWORKS_API_KEY` |
@@ -70,7 +68,6 @@ List of required environment variables for each model provider and gateway suppo
70
68
  | [LongCat](https://mastra.ai/models/providers/longcat) | `longcat/*` | `LONGCAT_API_KEY` |
71
69
  | [LucidQuery](https://mastra.ai/models/providers/lucidquery) | `lucidquery/*` | `LUCIDQUERY_API_KEY` |
72
70
  | [Meganova](https://mastra.ai/models/providers/meganova) | `meganova/*` | `MEGANOVA_API_KEY` |
73
- | [Meta](https://mastra.ai/models/providers/meta) | `meta/*` | `META_MODEL_API_KEY` |
74
71
  | [MiniMax (minimax.io)](https://mastra.ai/models/providers/minimax) | `minimax/*` | `MINIMAX_API_KEY` |
75
72
  | [MiniMax (minimaxi.com)](https://mastra.ai/models/providers/minimax-cn) | `minimax-cn/*` | `MINIMAX_API_KEY` |
76
73
  | [MiniMax Token Plan (minimax.io)](https://mastra.ai/models/providers/minimax-coding-plan) | `minimax-coding-plan/*` | `MINIMAX_API_KEY` |
@@ -78,7 +75,6 @@ List of required environment variables for each model provider and gateway suppo
78
75
  | [Mistral](https://mastra.ai/models/providers/mistral) | `mistral/*` | `MISTRAL_API_KEY` |
79
76
  | [Mixlayer](https://mastra.ai/models/providers/mixlayer) | `mixlayer/*` | `MIXLAYER_API_KEY` |
80
77
  | [Moark](https://mastra.ai/models/providers/moark) | `moark/*` | `MOARK_API_KEY` |
81
- | [Model Oracle AI](https://mastra.ai/models/providers/model-oracle-ai) | `model-oracle-ai/*` | `MODEL_ORACLE_API_KEY` |
82
78
  | [ModelScope](https://mastra.ai/models/providers/modelscope) | `modelscope/*` | `MODELSCOPE_API_KEY` |
83
79
  | [Moonshot AI](https://mastra.ai/models/providers/moonshotai) | `moonshotai/*` | `MOONSHOT_API_KEY` |
84
80
  | [Moonshot AI (China)](https://mastra.ai/models/providers/moonshotai-cn) | `moonshotai-cn/*` | `MOONSHOT_API_KEY` |
@@ -99,7 +95,6 @@ List of required environment variables for each model provider and gateway suppo
99
95
  | [OVHcloud AI Endpoints](https://mastra.ai/models/providers/ovhcloud) | `ovhcloud/*` | `OVHCLOUD_API_KEY` |
100
96
  | [Perplexity](https://mastra.ai/models/providers/perplexity) | `perplexity/*` | `PERPLEXITY_API_KEY` |
101
97
  | [Perplexity Agent](https://mastra.ai/models/providers/perplexity-agent) | `perplexity-agent/*` | `PERPLEXITY_API_KEY` |
102
- | [Pioneer](https://mastra.ai/models/providers/pioneer) | `pioneer/*` | `PIONEER_API_KEY` |
103
98
  | [Poe](https://mastra.ai/models/providers/poe) | `poe/*` | `POE_API_KEY` |
104
99
  | [Poolside](https://mastra.ai/models/providers/poolside) | `poolside/*` | `POOLSIDE_API_KEY` |
105
100
  | [Privatemode AI](https://mastra.ai/models/providers/privatemode-ai) | `privatemode-ai/*` | `PRIVATEMODE_API_KEY` |
@@ -129,7 +124,6 @@ List of required environment variables for each model provider and gateway suppo
129
124
  | [TrustedRouter](https://mastra.ai/models/providers/trustedrouter) | `trustedrouter/*` | `TRUSTEDROUTER_API_KEY` |
130
125
  | [Umans AI](https://mastra.ai/models/providers/umans-ai) | `umans-ai/*` | `UMANS_AI_API_KEY` |
131
126
  | [Umans AI Coding Plan](https://mastra.ai/models/providers/umans-ai-coding-plan) | `umans-ai-coding-plan/*` | `UMANS_AI_CODING_PLAN_API_KEY` |
132
- | [UnoRouter](https://mastra.ai/models/providers/unorouter) | `unorouter/*` | `UNOROUTER_API_KEY` |
133
127
  | [Upstage](https://mastra.ai/models/providers/upstage) | `upstage/*` | `UPSTAGE_API_KEY` |
134
128
  | [Vivgrid](https://mastra.ai/models/providers/vivgrid) | `vivgrid/*` | `VIVGRID_API_KEY` |
135
129
  | [Vultr](https://mastra.ai/models/providers/vultr) | `vultr/*` | `VULTR_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 70 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
 
@@ -101,9 +101,6 @@ ANTHROPIC_API_KEY=ant-...
101
101
  | `openai/gpt-5.5-2026-04-23` |
102
102
  | `openai/gpt-5.5-pro` |
103
103
  | `openai/gpt-5.5-pro-2026-04-23` |
104
- | `openai/gpt-5.6-luna` |
105
- | `openai/gpt-5.6-sol` |
106
- | `openai/gpt-5.6-terra` |
107
104
  | `openai/o3` |
108
105
  | `openai/o3-mini` |
109
106
  | `openai/o4-mini` |
@@ -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 345 models through Mastra's model router.
5
+ OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 344 models through Mastra's model router.
6
6
 
7
7
  Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
8
8
 
@@ -75,6 +75,7 @@ ANTHROPIC_API_KEY=ant-...
75
75
  | `anthropic/claude-sonnet-5` |
76
76
  | `arcee-ai/coder-large` |
77
77
  | `arcee-ai/trinity-large-thinking` |
78
+ | `arcee-ai/trinity-mini` |
78
79
  | `arcee-ai/virtuoso-large` |
79
80
  | `baidu/ernie-4.5-vl-424b-a47b` |
80
81
  | `bytedance-seed/seed-1.6` |
@@ -82,7 +83,6 @@ ANTHROPIC_API_KEY=ant-...
82
83
  | `bytedance-seed/seed-2.0-lite` |
83
84
  | `bytedance-seed/seed-2.0-mini` |
84
85
  | `bytedance/ui-tars-1.5-7b` |
85
- | `cognitivecomputations/dolphin-mistral-24b-venice-edition` |
86
86
  | `cognitivecomputations/dolphin-mistral-24b-venice-edition:free` |
87
87
  | `cohere/command-a` |
88
88
  | `cohere/command-r-08-2024` |
@@ -104,6 +104,7 @@ ANTHROPIC_API_KEY=ant-...
104
104
  | `google/gemini-2.5-flash` |
105
105
  | `google/gemini-2.5-flash-image` |
106
106
  | `google/gemini-2.5-flash-lite` |
107
+ | `google/gemini-2.5-flash-lite-preview-09-2025` |
107
108
  | `google/gemini-2.5-pro` |
108
109
  | `google/gemini-2.5-pro-preview` |
109
110
  | `google/gemini-2.5-pro-preview-05-06` |
@@ -139,6 +140,7 @@ ANTHROPIC_API_KEY=ant-...
139
140
  | `inflection/inflection-3-pi` |
140
141
  | `inflection/inflection-3-productivity` |
141
142
  | `kwaipilot/kat-coder-pro-v2` |
143
+ | `liquid/lfm-2-24b-a2b` |
142
144
  | `liquid/lfm-2.5-1.2b-instruct:free` |
143
145
  | `liquid/lfm-2.5-1.2b-thinking:free` |
144
146
  | `mancer/weaver` |
@@ -252,12 +254,6 @@ ANTHROPIC_API_KEY=ant-...
252
254
  | `openai/gpt-5.4-pro` |
253
255
  | `openai/gpt-5.5` |
254
256
  | `openai/gpt-5.5-pro` |
255
- | `openai/gpt-5.6-luna` |
256
- | `openai/gpt-5.6-luna-pro` |
257
- | `openai/gpt-5.6-sol` |
258
- | `openai/gpt-5.6-sol-pro` |
259
- | `openai/gpt-5.6-terra` |
260
- | `openai/gpt-5.6-terra-pro` |
261
257
  | `openai/gpt-audio` |
262
258
  | `openai/gpt-audio-mini` |
263
259
  | `openai/gpt-chat-latest` |
@@ -291,6 +287,8 @@ ANTHROPIC_API_KEY=ant-...
291
287
  | `poolside/laguna-m.1:free` |
292
288
  | `poolside/laguna-xs-2.1` |
293
289
  | `poolside/laguna-xs-2.1:free` |
290
+ | `poolside/laguna-xs.2` |
291
+ | `poolside/laguna-xs.2:free` |
294
292
  | `qwen/qwen-2.5-72b-instruct` |
295
293
  | `qwen/qwen-2.5-7b-instruct` |
296
294
  | `qwen/qwen-2.5-coder-32b-instruct` |
@@ -351,6 +349,7 @@ ANTHROPIC_API_KEY=ant-...
351
349
  | `sao10k/l3.3-euryale-70b` |
352
350
  | `stepfun/step-3.5-flash` |
353
351
  | `stepfun/step-3.7-flash` |
352
+ | `switchpoint/router` |
354
353
  | `tencent/hunyuan-a13b-instruct` |
355
354
  | `tencent/hy3` |
356
355
  | `tencent/hy3-preview` |
@@ -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 306 models through Mastra's model router.
5
+ Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 301 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
 
@@ -177,7 +177,6 @@ ANTHROPIC_API_KEY=ant-...
177
177
  | `meta/llama-3.3-70b` |
178
178
  | `meta/llama-4-maverick` |
179
179
  | `meta/llama-4-scout` |
180
- | `meta/muse-spark-1.1` |
181
180
  | `minimax/minimax-m2` |
182
181
  | `minimax/minimax-m2.1` |
183
182
  | `minimax/minimax-m2.1-lightning` |
@@ -251,9 +250,6 @@ ANTHROPIC_API_KEY=ant-...
251
250
  | `openai/gpt-5.4-pro` |
252
251
  | `openai/gpt-5.5` |
253
252
  | `openai/gpt-5.5-pro` |
254
- | `openai/gpt-5.6-luna` |
255
- | `openai/gpt-5.6-sol` |
256
- | `openai/gpt-5.6-terra` |
257
253
  | `openai/gpt-image-1` |
258
254
  | `openai/gpt-image-1-mini` |
259
255
  | `openai/gpt-image-1.5` |
@@ -263,7 +259,6 @@ ANTHROPIC_API_KEY=ant-...
263
259
  | `openai/gpt-oss-safeguard-20b` |
264
260
  | `openai/gpt-realtime-1.5` |
265
261
  | `openai/gpt-realtime-2` |
266
- | `openai/gpt-realtime-2.1` |
267
262
  | `openai/gpt-realtime-mini` |
268
263
  | `openai/o1` |
269
264
  | `openai/o3` |
@@ -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 4818 models from 147 providers through a single API.
5
+ Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 4582 models from 141 providers through a single API.
6
6
 
7
7
  ## Features
8
8