@mastra/mcp-docs-server 0.13.38 → 0.13.39-alpha.0

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 (135) hide show
  1. package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +11 -11
  2. package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +16 -16
  3. package/.docs/organized/changelogs/%40mastra%2Fastra.md +10 -10
  4. package/.docs/organized/changelogs/%40mastra%2Fauth.md +6 -0
  5. package/.docs/organized/changelogs/%40mastra%2Fchroma.md +11 -11
  6. package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +10 -10
  7. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +16 -16
  8. package/.docs/organized/changelogs/%40mastra%2Fcloud.md +10 -10
  9. package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +10 -10
  10. package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +10 -10
  11. package/.docs/organized/changelogs/%40mastra%2Fcore.md +20 -20
  12. package/.docs/organized/changelogs/%40mastra%2Fcouchbase.md +11 -11
  13. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +12 -12
  14. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloudflare.md +11 -11
  15. package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +11 -11
  16. package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +11 -11
  17. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +35 -35
  18. package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +11 -11
  19. package/.docs/organized/changelogs/%40mastra%2Fevals.md +11 -11
  20. package/.docs/organized/changelogs/%40mastra%2Ffastembed.md +6 -0
  21. package/.docs/organized/changelogs/%40mastra%2Flance.md +10 -10
  22. package/.docs/organized/changelogs/%40mastra%2Flibsql.md +11 -11
  23. package/.docs/organized/changelogs/%40mastra%2Floggers.md +11 -11
  24. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +11 -11
  25. package/.docs/organized/changelogs/%40mastra%2Fmcp-registry-registry.md +10 -10
  26. package/.docs/organized/changelogs/%40mastra%2Fmcp.md +11 -11
  27. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +11 -11
  28. package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +10 -10
  29. package/.docs/organized/changelogs/%40mastra%2Fmssql.md +11 -11
  30. package/.docs/organized/changelogs/%40mastra%2Fopensearch.md +10 -10
  31. package/.docs/organized/changelogs/%40mastra%2Fpg.md +10 -10
  32. package/.docs/organized/changelogs/%40mastra%2Fpinecone.md +10 -10
  33. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +22 -22
  34. package/.docs/organized/changelogs/%40mastra%2Fqdrant.md +11 -11
  35. package/.docs/organized/changelogs/%40mastra%2Frag.md +10 -10
  36. package/.docs/organized/changelogs/%40mastra%2Freact.md +10 -10
  37. package/.docs/organized/changelogs/%40mastra%2Fs3vectors.md +9 -0
  38. package/.docs/organized/changelogs/%40mastra%2Fschema-compat.md +6 -0
  39. package/.docs/organized/changelogs/%40mastra%2Fserver.md +18 -18
  40. package/.docs/organized/changelogs/%40mastra%2Fturbopuffer.md +10 -10
  41. package/.docs/organized/changelogs/%40mastra%2Fupstash.md +10 -10
  42. package/.docs/organized/changelogs/%40mastra%2Fvectorize.md +10 -10
  43. package/.docs/organized/changelogs/%40mastra%2Fvoice-azure.md +10 -10
  44. package/.docs/organized/changelogs/%40mastra%2Fvoice-cloudflare.md +11 -11
  45. package/.docs/organized/changelogs/%40mastra%2Fvoice-deepgram.md +11 -11
  46. package/.docs/organized/changelogs/%40mastra%2Fvoice-elevenlabs.md +11 -11
  47. package/.docs/organized/changelogs/%40mastra%2Fvoice-gladia.md +11 -11
  48. package/.docs/organized/changelogs/%40mastra%2Fvoice-google-gemini-live.md +11 -1
  49. package/.docs/organized/changelogs/%40mastra%2Fvoice-google.md +10 -10
  50. package/.docs/organized/changelogs/%40mastra%2Fvoice-murf.md +11 -11
  51. package/.docs/organized/changelogs/%40mastra%2Fvoice-openai-realtime.md +10 -10
  52. package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md +10 -10
  53. package/.docs/organized/changelogs/%40mastra%2Fvoice-playai.md +11 -11
  54. package/.docs/organized/changelogs/%40mastra%2Fvoice-sarvam.md +11 -11
  55. package/.docs/organized/changelogs/%40mastra%2Fvoice-speechify.md +10 -10
  56. package/.docs/organized/changelogs/create-mastra.md +7 -7
  57. package/.docs/organized/changelogs/mastra.md +18 -18
  58. package/.docs/raw/agents/overview.mdx +2 -2
  59. package/.docs/raw/auth/jwt.mdx +2 -2
  60. package/.docs/raw/auth/supabase.mdx +2 -2
  61. package/.docs/raw/auth/workos.mdx +2 -2
  62. package/.docs/raw/course/02-agent-tools-mcp/04-initializing-mcp-tools.md +2 -2
  63. package/.docs/raw/course/03-agent-memory/18-advanced-configuration-semantic-recall.md +1 -1
  64. package/.docs/raw/frameworks/agentic-uis/ai-sdk.mdx +24 -8
  65. package/.docs/raw/frameworks/agentic-uis/openrouter.mdx +1 -1
  66. package/.docs/raw/frameworks/servers/express.mdx +1 -1
  67. package/.docs/raw/frameworks/web-frameworks/sveltekit.mdx +34 -18
  68. package/.docs/raw/getting-started/installation.mdx +7 -7
  69. package/.docs/raw/getting-started/mcp-docs-server.mdx +1 -1
  70. package/.docs/raw/getting-started/studio.mdx +27 -17
  71. package/.docs/raw/getting-started/templates.mdx +12 -4
  72. package/.docs/raw/index.mdx +1 -1
  73. package/.docs/raw/mastra-cloud/dashboard.mdx +6 -6
  74. package/.docs/raw/mastra-cloud/observability.mdx +2 -2
  75. package/.docs/raw/mastra-cloud/overview.mdx +1 -1
  76. package/.docs/raw/mastra-cloud/setting-up.mdx +1 -1
  77. package/.docs/raw/memory/overview.mdx +1 -1
  78. package/.docs/raw/memory/semantic-recall.mdx +2 -4
  79. package/.docs/raw/memory/threads-and-resources.mdx +1 -1
  80. package/.docs/raw/memory/working-memory.mdx +1 -1
  81. package/.docs/raw/observability/ai-tracing/exporters/default.mdx +6 -6
  82. package/.docs/raw/observability/ai-tracing/overview.mdx +7 -7
  83. package/.docs/raw/observability/overview.mdx +1 -1
  84. package/.docs/raw/reference/agents/agent.mdx +2 -2
  85. package/.docs/raw/reference/agents/listScorers.mdx +69 -0
  86. package/.docs/raw/reference/agents/listTools.mdx +69 -0
  87. package/.docs/raw/reference/agents/listWorkflows.mdx +69 -0
  88. package/.docs/raw/reference/cli/mastra.mdx +1 -1
  89. package/.docs/raw/reference/client-js/agents.mdx +1 -1
  90. package/.docs/raw/reference/client-js/logs.mdx +1 -1
  91. package/.docs/raw/reference/client-js/mastra-client.mdx +7 -7
  92. package/.docs/raw/reference/client-js/memory.mdx +1 -1
  93. package/.docs/raw/reference/client-js/tools.mdx +1 -1
  94. package/.docs/raw/reference/client-js/workflows.mdx +1 -1
  95. package/.docs/raw/reference/core/getScorerByName.mdx +1 -1
  96. package/.docs/raw/reference/core/listAgents.mdx +35 -0
  97. package/.docs/raw/reference/core/listLogs.mdx +96 -0
  98. package/.docs/raw/reference/core/listLogsByRunId.mdx +87 -0
  99. package/.docs/raw/reference/core/listScorers.mdx +43 -0
  100. package/.docs/raw/reference/core/listWorkflows.mdx +45 -0
  101. package/.docs/raw/reference/memory/memory-class.mdx +2 -1
  102. package/.docs/raw/reference/observability/ai-tracing/ai-tracing.mdx +0 -1
  103. package/.docs/raw/reference/observability/ai-tracing/interfaces.mdx +1 -1
  104. package/.docs/raw/reference/observability/otel-tracing/providers/keywordsai.mdx +1 -1
  105. package/.docs/raw/reference/processors/batch-parts-processor.mdx +10 -14
  106. package/.docs/raw/reference/processors/language-detector.mdx +20 -32
  107. package/.docs/raw/reference/processors/moderation-processor.mdx +46 -30
  108. package/.docs/raw/reference/processors/pii-detector.mdx +47 -32
  109. package/.docs/raw/reference/processors/prompt-injection-detector.mdx +20 -30
  110. package/.docs/raw/reference/processors/system-prompt-scrubber.mdx +24 -29
  111. package/.docs/raw/reference/processors/token-limiter-processor.mdx +14 -23
  112. package/.docs/raw/reference/processors/unicode-normalizer.mdx +12 -14
  113. package/.docs/raw/reference/rag/document.mdx +1 -1
  114. package/.docs/raw/reference/scorers/run-experiment.mdx +1 -1
  115. package/.docs/raw/reference/storage/mssql.mdx +3 -3
  116. package/.docs/raw/reference/streaming/workflows/resumeStreamVNext.mdx +1 -1
  117. package/.docs/raw/reference/streaming/workflows/stream.mdx +1 -1
  118. package/.docs/raw/reference/streaming/workflows/streamVNext.mdx +1 -1
  119. package/.docs/raw/reference/tools/mcp-client.mdx +8 -8
  120. package/.docs/raw/reference/voice/google-gemini-live.mdx +1 -1
  121. package/.docs/raw/reference/workflows/step.mdx +1 -1
  122. package/.docs/raw/reference/workflows/workflow-methods/foreach.mdx +1 -1
  123. package/.docs/raw/reference/workflows/workflow-methods/map.mdx +72 -2
  124. package/.docs/raw/reference/workflows/workflow.mdx +0 -14
  125. package/.docs/raw/scorers/overview.mdx +5 -5
  126. package/.docs/raw/server-db/middleware.mdx +4 -4
  127. package/.docs/raw/tools-mcp/overview.mdx +2 -2
  128. package/.docs/raw/workflows/agents-and-tools.mdx +2 -6
  129. package/.docs/raw/workflows/control-flow.mdx +208 -165
  130. package/.docs/raw/workflows/inngest-workflow.mdx +2 -2
  131. package/.docs/raw/workflows/overview.mdx +106 -54
  132. package/.docs/raw/workflows/suspend-and-resume.mdx +1 -9
  133. package/CHANGELOG.md +10 -0
  134. package/package.json +4 -4
  135. package/.docs/raw/workflows/input-data-mapping.mdx +0 -107
@@ -1,5 +1,14 @@
1
1
  # @mastra/voice-speechify
2
2
 
3
+ ## 0.11.12-alpha.0
4
+
5
+ ### Patch Changes
6
+
7
+ - update peerdeps ([`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc))
8
+
9
+ - Updated dependencies [[`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc), [`6d7e90d`](https://github.com/mastra-ai/mastra/commit/6d7e90db09713e6250f4d6c3d3cff1b4740e50f9), [`f78b908`](https://github.com/mastra-ai/mastra/commit/f78b9080e11af765969b36b4a619761056030840), [`23c2614`](https://github.com/mastra-ai/mastra/commit/23c26140fdbf04b8c59e8d7d52106d67dad962ec), [`e365eda`](https://github.com/mastra-ai/mastra/commit/e365eda45795b43707310531cac1e2ce4e5a0712)]:
10
+ - @mastra/core@0.24.0-alpha.0
11
+
3
12
  ## 0.11.11
4
13
 
5
14
  ### Patch Changes
@@ -289,14 +298,5 @@
289
298
 
290
299
  ## 0.10.9-alpha.0
291
300
 
292
- ### Patch Changes
293
-
294
- - [#6942](https://github.com/mastra-ai/mastra/pull/6942) [`ca8ec2f`](https://github.com/mastra-ai/mastra/commit/ca8ec2f61884b9dfec5fc0d5f4f29d281ad13c01) Thanks [@wardpeet](https://github.com/wardpeet)! - Add zod as peerdeps for all packages
295
-
296
- - Updated dependencies [[`943a7f3`](https://github.com/mastra-ai/mastra/commit/943a7f3dbc6a8ab3f9b7bc7c8a1c5b319c3d7f56), [`be49354`](https://github.com/mastra-ai/mastra/commit/be493546dca540101923ec700feb31f9a13939f2), [`d591ab3`](https://github.com/mastra-ai/mastra/commit/d591ab3ecc985c1870c0db347f8d7a20f7360536), [`ba82abe`](https://github.com/mastra-ai/mastra/commit/ba82abe76e869316bb5a9c95e8ea3946f3436fae), [`727f7e5`](https://github.com/mastra-ai/mastra/commit/727f7e5086e62e0dfe3356fb6dcd8bcb420af246), [`82d9f64`](https://github.com/mastra-ai/mastra/commit/82d9f647fbe4f0177320e7c05073fce88599aa95), [`4189486`](https://github.com/mastra-ai/mastra/commit/4189486c6718fda78347bdf4ce4d3fc33b2236e1), [`ca8ec2f`](https://github.com/mastra-ai/mastra/commit/ca8ec2f61884b9dfec5fc0d5f4f29d281ad13c01)]:
297
- - @mastra/core@0.14.2-alpha.1
298
-
299
- ## 0.10.8
300
-
301
301
 
302
- ... 1391 more lines hidden. See full changelog in package directory.
302
+ ... 1400 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,11 @@
1
1
  # create-mastra
2
2
 
3
+ ## 0.18.0-alpha.0
4
+
5
+ ### Patch Changes
6
+
7
+ - update peerdeps ([`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc))
8
+
3
9
  ## 0.17.7
4
10
 
5
11
  ## 0.17.7-alpha.0
@@ -292,11 +298,5 @@
292
298
 
293
299
  ## 0.13.4-alpha.1
294
300
 
295
- ### Patch Changes
296
-
297
- - disable network label when memory is not enabled OR the agent has no subagents ([#8341](https://github.com/mastra-ai/mastra/pull/8341))
298
-
299
- ## 0.13.4-alpha.0
300
-
301
301
 
302
- ... 1804 more lines hidden. See full changelog in package directory.
302
+ ... 1810 more lines hidden. See full changelog in package directory.
@@ -1,5 +1,22 @@
1
1
  # mastra
2
2
 
3
+ ## 0.18.0-alpha.0
4
+
5
+ ### Minor Changes
6
+
7
+ - Update peer dependencies to match core package version bump (0.23.4) ([#9487](https://github.com/mastra-ai/mastra/pull/9487))
8
+
9
+ ### Patch Changes
10
+
11
+ - update peerdeps ([`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc))
12
+
13
+ - Fixes issue where clicking the reset button in the model picker would fail to restore the original LanguageModelV2 (or any other types) object that was passed during agent construction. ([#9487](https://github.com/mastra-ai/mastra/pull/9487))
14
+
15
+ - Updated dependencies [[`5ca1cca`](https://github.com/mastra-ai/mastra/commit/5ca1ccac61ffa7141e6d9fa8f22d3ad4d03bf5dc), [`2437a90`](https://github.com/mastra-ai/mastra/commit/2437a90d94a0ff94fa8dd42d2558d73c124972d3), [`6d7e90d`](https://github.com/mastra-ai/mastra/commit/6d7e90db09713e6250f4d6c3d3cff1b4740e50f9), [`23c2614`](https://github.com/mastra-ai/mastra/commit/23c26140fdbf04b8c59e8d7d52106d67dad962ec), [`f78b908`](https://github.com/mastra-ai/mastra/commit/f78b9080e11af765969b36b4a619761056030840), [`23c2614`](https://github.com/mastra-ai/mastra/commit/23c26140fdbf04b8c59e8d7d52106d67dad962ec), [`3e6c29a`](https://github.com/mastra-ai/mastra/commit/3e6c29a8924f63da4def2cf95180f671b3b2c89c), [`139588d`](https://github.com/mastra-ai/mastra/commit/139588df7755c9111a3060f72a789c1a8c95e091), [`186b29b`](https://github.com/mastra-ai/mastra/commit/186b29bd51ac1dcc24ad3825fdb7207a6d6391a6), [`4e92a19`](https://github.com/mastra-ai/mastra/commit/4e92a19aef1bd7f608482b366b1e46873a9dc6c7), [`e365eda`](https://github.com/mastra-ai/mastra/commit/e365eda45795b43707310531cac1e2ce4e5a0712), [`dbb705e`](https://github.com/mastra-ai/mastra/commit/dbb705e61999ec655b912ea8b5d77ae4792989a7)]:
16
+ - @mastra/deployer@0.24.0-alpha.0
17
+ - @mastra/loggers@0.10.19-alpha.0
18
+ - @mastra/core@0.24.0-alpha.0
19
+
3
20
  ## 0.17.7
4
21
 
5
22
  ### Patch Changes
@@ -281,22 +298,5 @@
281
298
  - @mastra/deployer@0.21.0-alpha.0
282
299
  - @mastra/core@0.21.0-alpha.0
283
300
  - @mastra/loggers@0.10.16-alpha.0
284
- - @mastra/mcp@0.13.5-alpha.0
285
-
286
- ## 0.15.1
287
-
288
- ### Patch Changes
289
-
290
- - Marked telemetry as disabled in the default template, in preperation for the Nov 4th deprecation. ([#8618](https://github.com/mastra-ai/mastra/pull/8618))
291
-
292
- - Improve the overall flow of the `create-mastra` CLI by first asking all questions and then creating the project structure. If you skip entering an API key during the wizard, the `your-api-key` placeholder will now be added to an `.env.example` file instead of `.env`. ([#8603](https://github.com/mastra-ai/mastra/pull/8603))
293
-
294
- - Updated dependencies [[`07eaf25`](https://github.com/mastra-ai/mastra/commit/07eaf25aada9e42235dbf905854de53da4d8121b), [`0d71771`](https://github.com/mastra-ai/mastra/commit/0d71771f5711164c79f8e80919bc84d6bffeb6bc), [`0d6e55e`](https://github.com/mastra-ai/mastra/commit/0d6e55ecc5a2e689cd4fc9c86525e0eb54d82372), [`68b1111`](https://github.com/mastra-ai/mastra/commit/68b11118a1303f93e9c0c157850c0751309304c5)]:
295
- - @mastra/core@0.20.2
296
- - @mastra/deployer@0.20.2
297
-
298
- ## 0.15.1-alpha.1
299
-
300
- ### Patch Changes
301
301
 
302
- ... 6379 more lines hidden. See full changelog in package directory.
302
+ ... 6396 more lines hidden. See full changelog in package directory.
@@ -450,9 +450,9 @@ export const testAgent = new Agent({
450
450
 
451
451
  > See [Runtime Context](/docs/server-db/runtime-context) for more information.
452
452
 
453
- ## Testing with Mastra Playground
453
+ ## Testing with Studio
454
454
 
455
- Use the Mastra [Playground](/docs/getting-started/studio) to test agents with different messages, inspect tool calls and responses, and debug agent behavior.
455
+ Use [Studio](/docs/getting-started/studio) to test agents with different messages, inspect tool calls and responses, and debug agent behavior.
456
456
 
457
457
  ## Related
458
458
 
@@ -58,7 +58,7 @@ export const mastraClient = new MastraClient({
58
58
  Once `MastraClient` is configured, you can send authenticated requests from your frontend application, or use `curl` for quick local testing:
59
59
 
60
60
  <Tabs>
61
- <TabItem value="curl" label="cURL">
61
+ <TabItem value="react" label="React">
62
62
  ```tsx title="src/components/test-agent.tsx" showLineNumbers copy
63
63
  import { mastraClient } from "../../lib/mastra-client";
64
64
 
@@ -78,7 +78,7 @@ Once `MastraClient` is configured, you can send authenticated requests from your
78
78
  ```
79
79
 
80
80
  </TabItem>
81
- <TabItem value="react" label="React">
81
+ <TabItem value="curl" label="cURL">
82
82
  ```bash copy
83
83
  curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
84
84
  -H "Content-Type: application/json" \
@@ -97,7 +97,7 @@ export const mastraClient = new MastraClient({
97
97
  Once `MastraClient` is configured with the Supabase access token, you can send authenticated requests:
98
98
 
99
99
  <Tabs>
100
- <TabItem value="curl" label="cURL">
100
+ <TabItem value="react" label="React">
101
101
  ```tsx title="src/components/test-agent.tsx" showLineNumbers copy
102
102
  import { mastraClient } from "../../lib/mastra-client";
103
103
 
@@ -117,7 +117,7 @@ Once `MastraClient` is configured with the Supabase access token, you can send a
117
117
  ```
118
118
 
119
119
  </TabItem>
120
- <TabItem value="react" label="React">
120
+ <TabItem value="curl" label="cURL">
121
121
  ```bash copy
122
122
  curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
123
123
  -H "Content-Type: application/json" \
@@ -159,7 +159,7 @@ export const createMastraClient = (accessToken: string) => {
159
159
  Once `MastraClient` is configured with the WorkOS access token, you can send authenticated requests:
160
160
 
161
161
  <Tabs>
162
- <TabItem value="curl" label="cURL">
162
+ <TabItem value="react" label="React">
163
163
  ```typescript title="src/api/agents.ts" showLineNumbers copy
164
164
  import { WorkOS } from '@workos-inc/node';
165
165
  import { MastraClient } from '@mastra/client-js';
@@ -191,7 +191,7 @@ Once `MastraClient` is configured with the WorkOS access token, you can send aut
191
191
  ```
192
192
 
193
193
  </TabItem>
194
- <TabItem value="react" label="React">
194
+ <TabItem value="curl" label="cURL">
195
195
  ```bash copy
196
196
  curl -X POST http://localhost:4111/api/agents/weatherAgent/generate \
197
197
  -H "Content-Type: application/json" \
@@ -3,9 +3,9 @@
3
3
  Once you have the configuration set up, you need to initialize the MCP tools:
4
4
 
5
5
  ```typescript
6
- const mcpTools = await mcp.getTools();
6
+ const mcpTools = await mcp.listTools();
7
7
  ```
8
8
 
9
- This asynchronous call fetches all the available tools from the configured MCP servers. The `getTools()` method connects to each server specified in your configuration, retrieves the available tools, and returns them in a format that can be used by your Mastra agent.
9
+ This asynchronous call fetches all the available tools from the configured MCP servers. The `listTools()` method connects to each server specified in your configuration, retrieves the available tools, and returns them in a format that can be used by your Mastra agent.
10
10
 
11
11
  The `mcpTools` object will contain all the tools provided by the MCP servers you've configured. We'll add these tools to our agent in the next step.
@@ -23,6 +23,6 @@ const memory = new Memory({
23
23
  });
24
24
  ```
25
25
 
26
- The `topK` parameter controls how many semantically similar messages are retrieved. A higher value will retrieve more messages, which can be helpful for complex topics but may also include less relevant information. The default value is `2`.
26
+ The `topK` parameter controls how many semantically similar messages are retrieved. A higher value will retrieve more messages, which can be helpful for complex topics but may also include less relevant information. The default value is `4`.
27
27
 
28
28
  The `messageRange` parameter controls how much context is included with each match. This is important because the matching message alone might not provide enough context to understand the conversation. Including messages before and after the match helps the agent understand the context of the matched message.
@@ -32,16 +32,24 @@ The recommended way of using Mastra and AI SDK together is by installing the `@m
32
32
 
33
33
  <Tabs>
34
34
  <TabItem value="npm" label="npm">
35
- ```bash copy npm install @mastra/ai-sdk ```
35
+ ```bash copy
36
+ npm install @mastra/ai-sdk
37
+ ```
36
38
  </TabItem>
37
39
  <TabItem value="pnpm" label="pnpm">
38
- ```bash copy pnpm add @mastra/ai-sdk ```
40
+ ```bash copy
41
+ pnpm add @mastra/ai-sdk
42
+ ```
39
43
  </TabItem>
40
44
  <TabItem value="yarn" label="yarn">
41
- ```bash copy yarn add @mastra/ai-sdk ```
45
+ ```bash copy
46
+ yarn add @mastra/ai-sdk
47
+ ```
42
48
  </TabItem>
43
49
  <TabItem value="bun" label="bun">
44
- ```bash copy bun add @mastra/ai-sdk ```
50
+ ```bash copy
51
+ bun add @mastra/ai-sdk
52
+ ```
45
53
  </TabItem>
46
54
  </Tabs>
47
55
 
@@ -350,16 +358,24 @@ Install the required AI SDK React package:
350
358
 
351
359
  <Tabs>
352
360
  <TabItem value="npm" label="npm">
353
- ```bash copy npm install @ai-sdk/react ```
361
+ ```bash copy
362
+ npm install @ai-sdk/react
363
+ ```
354
364
  </TabItem>
355
365
  <TabItem value="pnpm" label="pnpm">
356
- ```bash copy pnpm add @ai-sdk/react ```
366
+ ```bash copy
367
+ pnpm add @ai-sdk/react
368
+ ```
357
369
  </TabItem>
358
370
  <TabItem value="yarn" label="yarn">
359
- ```bash copy yarn add @ai-sdk/react ```
371
+ ```bash copy
372
+ yarn add @ai-sdk/react
373
+ ```
360
374
  </TabItem>
361
375
  <TabItem value="bun" label="bun">
362
- ```bash copy bun add @ai-sdk/react ```
376
+ ```bash copy
377
+ bun add @ai-sdk/react
378
+ ```
363
379
  </TabItem>
364
380
  </Tabs>
365
381
 
@@ -91,7 +91,7 @@ npm run dev
91
91
 
92
92
  This will start the Mastra development server.
93
93
 
94
- You can now test your agent by visiting [http://localhost:4111](http://localhost:4111) for the playground or via the Mastra API at [http://localhost:4111/api/agents/assistant/stream](http://localhost:4111/api/agents/assistant/stream).
94
+ You can now test your agent by visiting [http://localhost:4111](http://localhost:4111) and using Studio or via the Mastra API at [http://localhost:4111/api/agents/assistant/stream](http://localhost:4111/api/agents/assistant/stream).
95
95
 
96
96
  </StepItem>
97
97
 
@@ -202,7 +202,7 @@ Add a script to your `package.json`:
202
202
  }
203
203
  ```
204
204
 
205
- Start the Mastra playground:
205
+ Start the Mastra dev server:
206
206
 
207
207
  ```bash copy
208
208
  npm run mastra:dev
@@ -31,19 +31,23 @@ Install the required Mastra packages:
31
31
 
32
32
  <Tabs>
33
33
  <TabItem value="npm" label="npm">
34
- ```bash copy npm install mastra@latest @mastra/core@latest
35
- @mastra/libsql@latest ```
34
+ ```bash copy
35
+ npm install mastra@latest @mastra/core@latest @mastra/libsql@latest
36
+ ```
36
37
  </TabItem>
37
38
  <TabItem value="yarn" label="yarn">
38
- ```bash copy yarn add mastra@latest @mastra/core@latest
39
- @mastra/libsql@latest ```
39
+ ```bash copy
40
+ yarn add mastra@latest @mastra/core@latest @mastra/libsql@latest
41
+ ```
40
42
  </TabItem>
41
43
  <TabItem value="pnpm" label="pnpm">
42
- ```bash copy pnpm add mastra@latest @mastra/core@latest
43
- @mastra/libsql@latest ```
44
+ ```bash copy
45
+ pnpm add mastra@latest @mastra/core@latest @mastra/libsql@latest
46
+ ```
44
47
  </TabItem>
45
48
  <TabItem value="bun" label="bun">
46
- ```bash copy bun add mastra@latest @mastra/core@latest @mastra/libsql@latest
49
+ ```bash copy
50
+ bun add mastra@latest @mastra/core@latest @mastra/libsql@latest
47
51
  ```
48
52
  </TabItem>
49
53
  </Tabs>
@@ -146,10 +150,14 @@ Start the Mastra Dev Server to expose your agents as REST endpoints:
146
150
 
147
151
  <Tabs>
148
152
  <TabItem value="npm" label="npm">
149
- ```bash copy npm run dev:mastra ```
153
+ ```bash copy
154
+ npm run dev:mastra
155
+ ```
150
156
  </TabItem>
151
157
  <TabItem value="cli" label="CLI">
152
- ```bash copy mastra dev:mastra ```
158
+ ```bash copy
159
+ mastra dev:mastra
160
+ ```
153
161
  </TabItem>
154
162
  </Tabs>
155
163
 
@@ -254,19 +262,23 @@ Install the required Mastra packages:
254
262
 
255
263
  <Tabs>
256
264
  <TabItem value="npm" label="npm">
257
- ```bash copy npm install mastra@latest @mastra/core@latest
258
- @mastra/libsql@latest ```
265
+ ```bash copy
266
+ npm install mastra@latest @mastra/core@latest @mastra/libsql@latest
267
+ ```
259
268
  </TabItem>
260
269
  <TabItem value="yarn" label="yarn">
261
- ```bash copy yarn add mastra@latest @mastra/core@latest
262
- @mastra/libsql@latest ```
270
+ ```bash copy
271
+ yarn add mastra@latest @mastra/core@latest @mastra/libsql@latest
272
+ ```
263
273
  </TabItem>
264
274
  <TabItem value="pnpm" label="pnpm">
265
- ```bash copy pnpm add mastra@latest @mastra/core@latest
266
- @mastra/libsql@latest ```
275
+ ```bash copy
276
+ pnpm add mastra@latest @mastra/core@latest @mastra/libsql@latest
277
+ ```
267
278
  </TabItem>
268
279
  <TabItem value="bun" label="bun">
269
- ```bash copy bun add mastra@latest @mastra/core@latest @mastra/libsql@latest
280
+ ```bash copy
281
+ bun add mastra@latest @mastra/core@latest @mastra/libsql@latest
270
282
  ```
271
283
  </TabItem>
272
284
  </Tabs>
@@ -369,10 +381,14 @@ Start the Mastra Dev Server to expose your agents as REST endpoints:
369
381
 
370
382
  <Tabs>
371
383
  <TabItem value="npm" label="npm">
372
- ```bash copy npm run dev:mastra ```
384
+ ```bash copy
385
+ npm run dev:mastra
386
+ ```
373
387
  </TabItem>
374
388
  <TabItem value="cli" label="CLI">
375
- ```bash copy mastra dev:mastra ```
389
+ ```bash copy
390
+ mastra dev:mastra
391
+ ```
376
392
  </TabItem>
377
393
  </Tabs>
378
394
 
@@ -30,28 +30,28 @@ The wizard will guide you through setup, create a new directory for your project
30
30
  <TabItem value="npm" label="npm">
31
31
 
32
32
  ```bash copy
33
- npm create mastra@latest -y
33
+ npm create mastra@latest
34
34
  ```
35
35
 
36
36
  </TabItem>
37
37
  <TabItem value="pnpm" label="pnpm">
38
38
 
39
39
  ```bash copy
40
- pnpm create mastra@latest -y
40
+ pnpm create mastra@latest
41
41
  ```
42
42
 
43
43
  </TabItem>
44
44
  <TabItem value="yarn" label="yarn">
45
45
 
46
46
  ```bash copy
47
- yarn create mastra@latest -y
47
+ yarn create mastra@latest
48
48
  ```
49
49
 
50
50
  </TabItem>
51
51
  <TabItem value="bun" label="bun">
52
52
 
53
53
  ```bash copy
54
- bun create mastra@latest -y
54
+ bun create mastra@latest
55
55
  ```
56
56
 
57
57
  </TabItem>
@@ -65,7 +65,7 @@ You can use flags with `create mastra` like `--no-example` to skip the example w
65
65
 
66
66
  ### Test your agent
67
67
 
68
- Once setup is complete, follow the instructions in your terminal to start the Mastra dev server, then open the Playground at http://localhost:4111.
68
+ Once setup is complete, follow the instructions in your terminal to start the Mastra dev server, then open Studio at http://localhost:4111.
69
69
 
70
70
  Try asking about the weather. If your API key is set up correctly, you'll get a response:
71
71
 
@@ -77,7 +77,7 @@ If you encounter an error, your API key may not be configured correctly. Double-
77
77
 
78
78
  :::
79
79
 
80
- The [Playground](/docs/getting-started/studio) 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 application using the guides below.
80
+ [Studio](/docs/getting-started/studio) 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 application using the guides below.
81
81
 
82
82
  ### Next steps
83
83
 
@@ -309,7 +309,7 @@ export const mastra = new Mastra({
309
309
 
310
310
  <StepItem>
311
311
 
312
- You can now launch the [Playground](/docs/getting-started/studio) and test your agent.
312
+ You can now launch [Studio](/docs/getting-started/studio) and test your agent.
313
313
 
314
314
  <Tabs>
315
315
  <TabItem value="npm" label="npm">
@@ -3,7 +3,7 @@ title: "Mastra Docs Server | Getting Started | Mastra Docs"
3
3
  description: "Learn how to use the Mastra MCP documentation server in your IDE to turn it into an agentic Mastra expert."
4
4
  ---
5
5
 
6
- import Youtube from "@site/src/components/YouTube-player";
6
+ import YouTube from "@site/src/components/YouTube-player";
7
7
 
8
8
  # Mastra Docs Server
9
9
 
@@ -1,53 +1,63 @@
1
1
  ---
2
- title: "Playground | Getting Started | Mastra Docs"
2
+ title: "Studio | Getting Started | Mastra Docs"
3
3
  description: Guide on installing Mastra and setting up the necessary prerequisites for running it with various LLM providers.
4
4
  ---
5
5
 
6
- import Youtube from "@site/src/components/YouTube-player";
6
+ import YouTube from "@site/src/components/YouTube-player";
7
7
  import Tabs from "@theme/Tabs";
8
8
  import TabItem from "@theme/TabItem";
9
9
  import { VideoPlayer } from "@site/src/components/video-player";
10
10
 
11
- # Playground
11
+ # Studio
12
12
 
13
- Playground provides an interactive UI for building and testing your agents, along with a REST API that exposes your Mastra application as a local service. This lets you start building without worrying about integration right away.
13
+ Studio provides an interactive UI for building and testing your agents, along with a REST API that exposes your Mastra application as a local service. This lets you start building without worrying about integration right away.
14
14
 
15
- As your project evolves, Playground's development environment helps you iterate on your agent quickly. Meanwhile, Observability and Scorer features give you visibility into performance at every stage.
15
+ As your project evolves, Studio's development environment helps you iterate on your agent quickly. Meanwhile, Observability and Scorer features give you visibility into performance at every stage.
16
16
 
17
- To get started, run Playground locally using the instructions below, or [deploy to Mastra Cloud](https://mastra.ai/docs/mastra-cloud/setting-up) to collaborate with your team.
17
+ To get started, run Studio locally using the instructions below, or [create a project in Mastra Cloud](https://mastra.ai/docs/mastra-cloud/setting-up) to collaborate with your team.
18
18
 
19
- <YouTube id="spGlcTEjuXY" startTime={126} />
19
+ <YouTube id="ojGu6Bi4wYk" />
20
20
 
21
- ## Start Playground
21
+ ## Start Studio
22
22
 
23
23
  If you created your application with `create mastra`, start the local development server using the `dev` script. You can also run it directly with `mastra dev`.
24
24
 
25
25
  <Tabs>
26
26
  <TabItem value="npm" label="npm">
27
- ```bash copy npm run dev ```
27
+ ```bash copy
28
+ npm run dev
29
+ ```
28
30
  </TabItem>
29
31
  <TabItem value="pnpm" label="pnpm">
30
- ```bash copy pnpm run dev ```
32
+ ```bash copy
33
+ pnpm run dev
34
+ ```
31
35
  </TabItem>
32
36
  <TabItem value="yarn" label="yarn">
33
- ```bash copy yarn run dev ```
37
+ ```bash copy
38
+ yarn run dev
39
+ ```
34
40
  </TabItem>
35
41
  <TabItem value="bun" label="bun">
36
- ```bash copy bun run dev ```
42
+ ```bash copy
43
+ bun run dev
44
+ ```
37
45
  </TabItem>
38
46
  <TabItem value="mastra" label="mastra">
39
- ```bash copy mastra dev ```
47
+ ```bash copy
48
+ mastra dev
49
+ ```
40
50
  </TabItem>
41
51
  </Tabs>
42
52
 
43
53
  Once the server's running, you can:
44
54
 
45
- - Open the Playground UI at http://localhost:4111/ to test your agent interactively.
55
+ - Open the Studio UI at http://localhost:4111/ to test your agent interactively.
46
56
  - Visit http://localhost:4111/swagger-ui to discover and interact with the underlying REST API.
47
57
 
48
- ## Playground UI
58
+ ## Studio UI
49
59
 
50
- The Playground UI provides an interactive development environment for you to test your agents, workflows, and tools, observe exactly what happens under the hood with each interaction, and tweak things as you go.
60
+ The Studio UI provides an interactive development environment for you to test your agents, workflows, and tools, observe exactly what happens under the hood with each interaction, and tweak things as you go.
51
61
 
52
62
  ### Agents
53
63
 
@@ -73,7 +83,7 @@ Run tools in isolation to observe their behavior. Test them before assigning the
73
83
  ### MCP List the MCP servers attached to your Mastra instance and explore their
74
84
  available tools.
75
85
 
76
- ![MCP Servers Playground](/img/local-dev/local-dev-mcp-server-playground.jpg)
86
+ ![MCP Servers Studio](/img/local-dev/local-dev-mcp-server-playground.jpg)
77
87
 
78
88
  ### Observability
79
89
 
@@ -16,16 +16,24 @@ Install a template using the `create-mastra` command:
16
16
 
17
17
  <Tabs>
18
18
  <TabItem value="npm" label="npm">
19
- ```bash copy npx create-mastra@latest --template template-name ```
19
+ ```bash copy
20
+ npx create-mastra@latest --template template-name
21
+ ```
20
22
  </TabItem>
21
23
  <TabItem value="yarn" label="yarn">
22
- ```bash copy yarn dlx create-mastra@latest --template template-name ```
24
+ ```bash copy
25
+ yarn dlx create-mastra@latest --template template-name
26
+ ```
23
27
  </TabItem>
24
28
  <TabItem value="pnpm" label="pnpm">
25
- ```bash copy pnpm create mastra@latest --template template-name ```
29
+ ```bash copy
30
+ pnpm create mastra@latest --template template-name
31
+ ```
26
32
  </TabItem>
27
33
  <TabItem value="bun" label="bun">
28
- ```bash copy bun create mastra@latest --template template-name ```
34
+ ```bash copy
35
+ bun create mastra@latest --template template-name
36
+ ```
29
37
  </TabItem>
30
38
  </Tabs>
31
39
 
@@ -5,7 +5,7 @@ sidebar_label: "Introduction"
5
5
  description: "Mastra is an all-in-one framework for building AI-powered applications and agents with a modern TypeScript stack."
6
6
  ---
7
7
 
8
- import Youtube from "@site/src/components/YouTube-player";
8
+ import YouTube from "@site/src/components/YouTube-player";
9
9
 
10
10
  # About Mastra
11
11
 
@@ -7,7 +7,7 @@ import { MastraCloudCallout } from "@site/src/components/MastraCloudCallout";
7
7
 
8
8
  # Navigating the Dashboard
9
9
 
10
- This page explains how to navigate the Mastra Cloud dashboard, where you can configure your project, view deployment details, and interact with agents and workflows using the built-in [Playground](/docs/mastra-cloud/dashboard#playground).
10
+ This page explains how to navigate the Mastra Cloud dashboard, where you can configure your project, view deployment details, and interact with agents and workflows using the built-in [Studio](/docs/mastra-cloud/dashboard#studio).
11
11
 
12
12
  <MastraCloudCallout />
13
13
 
@@ -53,13 +53,13 @@ You can manage environment variables, edit key project settings like the name an
53
53
 
54
54
  > Changes to configuration require a new deployment before taking effect.
55
55
 
56
- ## Playground
56
+ ## Studio
57
57
 
58
58
  ### Agents
59
59
 
60
60
  On the **Agents** page you'll see all agents used in your application. Click any agent to interact using the chat interface.
61
61
 
62
- ![Dashboard playground agents](/img/mastra-cloud/mastra-cloud-dashboard-playground-agents.jpg)
62
+ ![Dashboard Studio agents](/img/mastra-cloud/mastra-cloud-dashboard-playground-agents.jpg)
63
63
 
64
64
  Key features:
65
65
 
@@ -69,7 +69,7 @@ Test your agents in real time using the chat interface, review traces of each in
69
69
 
70
70
  On the **Workflows** page you'll see all workflows used in your application. Click any workflow to interact using the runner interface.
71
71
 
72
- ![Dashboard playground workflows](/img/mastra-cloud/mastra-cloud-dashboard-playground-workflows.jpg)
72
+ ![Dashboard Studio workflows](/img/mastra-cloud/mastra-cloud-dashboard-playground-workflows.jpg)
73
73
 
74
74
  Key features:
75
75
 
@@ -79,7 +79,7 @@ Visualize your workflow with a step-by-step graph, view execution traces, and ru
79
79
 
80
80
  On the **Tools** page you'll see all tools used by your agents. Click any tool to interact using the input interface.
81
81
 
82
- ![Dashboard playground tools](/img/mastra-cloud/mastra-cloud-dashboard-playground-tools.jpg)
82
+ ![Dashboard Studio tools](/img/mastra-cloud/mastra-cloud-dashboard-playground-tools.jpg)
83
83
 
84
84
  Key features:
85
85
 
@@ -89,7 +89,7 @@ Test your tools by providing an input that matches the schema and viewing the st
89
89
 
90
90
  The **MCP Servers** page lists all MCP Servers included in your application. Click any MCP Server for more information.
91
91
 
92
- ![Dashboard playground mcp servers](/img/mastra-cloud/mastra-cloud-dashboard-playground-mcpservers.jpg)
92
+ ![Dashboard Studio mcp servers](/img/mastra-cloud/mastra-cloud-dashboard-playground-mcpservers.jpg)
93
93
 
94
94
  Key features:
95
95
 
@@ -27,7 +27,7 @@ More detailed traces are available for both agents and workflows by using a [log
27
27
 
28
28
  ### Agents
29
29
 
30
- With a [logger](/docs/observability/logging) enabled, you can view detailed outputs from your agents in the **Traces** section of the Agents Playground.
30
+ With a [logger](/docs/observability/logging) enabled, you can view detailed outputs from your agents in the **Traces** section in Studio.
31
31
 
32
32
  ![observability agents](/img/mastra-cloud/mastra-cloud-observability-agents.jpg)
33
33
 
@@ -37,7 +37,7 @@ Tools passed to the agent during generation are standardized using `convertTools
37
37
 
38
38
  ### Workflows
39
39
 
40
- With a [logger](/docs/observability/logging) enabled, you can view detailed outputs from your workflows in the **Traces** section of the Workflows Playground.
40
+ With a [logger](/docs/observability/logging) enabled, you can view detailed outputs from your workflows in the **Traces** section in Studio.
41
41
 
42
42
  ![observability workflows](/img/mastra-cloud/mastra-cloud-observability-workflows.jpg)
43
43
 
@@ -29,7 +29,7 @@ Monitor and debug your applications with detailed output logs, deployment state,
29
29
 
30
30
  Key features:
31
31
 
32
- The Project Dashboard gives you an overview of your application's status and deployments, with access to logs and a built-in playground for testing agents and workflows.
32
+ The Project Dashboard gives you an overview of your application's status and deployments, with access to logs and a Studio for testing agents and workflows.
33
33
 
34
34
  ## Project structure
35
35