@mastra/mcp-docs-server 1.0.0-beta.1 → 1.0.0-beta.3

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 (397) hide show
  1. package/.docs/organized/changelogs/%40mastra%2Fagent-builder.md +9 -9
  2. package/.docs/organized/changelogs/%40mastra%2Fai-sdk.md +35 -35
  3. package/.docs/organized/changelogs/%40mastra%2Fclickhouse.md +11 -11
  4. package/.docs/organized/changelogs/%40mastra%2Fclient-js.md +17 -17
  5. package/.docs/organized/changelogs/%40mastra%2Fcloudflare-d1.md +11 -11
  6. package/.docs/organized/changelogs/%40mastra%2Fcloudflare.md +11 -11
  7. package/.docs/organized/changelogs/%40mastra%2Fcodemod.md +14 -0
  8. package/.docs/organized/changelogs/%40mastra%2Fcore.md +172 -172
  9. package/.docs/organized/changelogs/%40mastra%2Fcouchbase.md +10 -10
  10. package/.docs/organized/changelogs/%40mastra%2Fdeployer-cloud.md +20 -20
  11. package/.docs/organized/changelogs/%40mastra%2Fdeployer-netlify.md +11 -11
  12. package/.docs/organized/changelogs/%40mastra%2Fdeployer-vercel.md +11 -11
  13. package/.docs/organized/changelogs/%40mastra%2Fdeployer.md +34 -34
  14. package/.docs/organized/changelogs/%40mastra%2Fdynamodb.md +14 -14
  15. package/.docs/organized/changelogs/%40mastra%2Fevals.md +10 -10
  16. package/.docs/organized/changelogs/%40mastra%2Flance.md +14 -14
  17. package/.docs/organized/changelogs/%40mastra%2Flibsql.md +11 -11
  18. package/.docs/organized/changelogs/%40mastra%2Floggers.md +10 -10
  19. package/.docs/organized/changelogs/%40mastra%2Fmcp-docs-server.md +27 -27
  20. package/.docs/organized/changelogs/%40mastra%2Fmcp.md +23 -23
  21. package/.docs/organized/changelogs/%40mastra%2Fmemory.md +10 -10
  22. package/.docs/organized/changelogs/%40mastra%2Fmongodb.md +11 -11
  23. package/.docs/organized/changelogs/%40mastra%2Fmssql.md +26 -26
  24. package/.docs/organized/changelogs/%40mastra%2Fpg.md +11 -11
  25. package/.docs/organized/changelogs/%40mastra%2Fpinecone.md +11 -11
  26. package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md +48 -48
  27. package/.docs/organized/changelogs/%40mastra%2Frag.md +11 -11
  28. package/.docs/organized/changelogs/%40mastra%2Freact.md +15 -15
  29. package/.docs/organized/changelogs/%40mastra%2Fserver.md +17 -17
  30. package/.docs/organized/changelogs/%40mastra%2Fupstash.md +14 -14
  31. package/.docs/organized/changelogs/%40mastra%2Fvoice-google-gemini-live.md +12 -12
  32. package/.docs/organized/changelogs/%40mastra%2Fvoice-openai.md +10 -10
  33. package/.docs/organized/changelogs/create-mastra.md +15 -15
  34. package/.docs/organized/changelogs/mastra.md +37 -37
  35. package/.docs/organized/code-examples/ai-elements.md +1 -1
  36. package/.docs/organized/code-examples/ai-sdk-useChat.md +1 -1
  37. package/.docs/organized/code-examples/ai-sdk-v5.md +1 -1
  38. package/.docs/organized/code-examples/assistant-ui.md +1 -1
  39. package/.docs/organized/code-examples/bird-checker-with-express.md +1 -1
  40. package/.docs/organized/code-examples/bird-checker-with-nextjs-and-eval.md +1 -1
  41. package/.docs/organized/code-examples/bird-checker-with-nextjs.md +1 -1
  42. package/.docs/organized/code-examples/client-side-tools.md +1 -1
  43. package/.docs/organized/code-examples/crypto-chatbot.md +1 -1
  44. package/.docs/organized/code-examples/fireworks-r1.md +1 -1
  45. package/.docs/organized/code-examples/heads-up-game.md +1 -1
  46. package/.docs/organized/code-examples/mcp-configuration.md +0 -3
  47. package/.docs/organized/code-examples/memory-per-resource-example.md +1 -1
  48. package/.docs/organized/code-examples/openapi-spec-writer.md +1 -1
  49. package/.docs/organized/code-examples/quick-start.md +1 -1
  50. package/.docs/organized/code-examples/stock-price-tool.md +1 -21
  51. package/.docs/organized/code-examples/workflow-ai-recruiter.md +1 -1
  52. package/.docs/organized/code-examples/workflow-with-inline-steps.md +1 -1
  53. package/.docs/organized/code-examples/workflow-with-memory.md +1 -1
  54. package/.docs/organized/code-examples/workflow-with-separate-steps.md +1 -1
  55. package/.docs/organized/code-examples/workflow-with-suspend-resume.md +1 -1
  56. package/.docs/raw/agents/adding-voice.mdx +1 -1
  57. package/.docs/raw/agents/agent-memory.mdx +1 -1
  58. package/.docs/raw/agents/guardrails.mdx +1 -1
  59. package/.docs/raw/agents/human-in-the-loop-with-tools.mdx +90 -0
  60. package/.docs/raw/agents/networks.mdx +1 -1
  61. package/.docs/raw/agents/overview.mdx +8 -13
  62. package/.docs/raw/agents/using-tools.mdx +10 -9
  63. package/.docs/raw/auth/auth0.mdx +1 -1
  64. package/.docs/raw/auth/clerk.mdx +1 -1
  65. package/.docs/raw/auth/firebase.mdx +1 -1
  66. package/.docs/raw/auth/index.mdx +1 -1
  67. package/.docs/raw/auth/jwt.mdx +1 -1
  68. package/.docs/raw/auth/supabase.mdx +1 -1
  69. package/.docs/raw/auth/workos.mdx +1 -1
  70. package/.docs/raw/community/contributing-templates.mdx +1 -1
  71. package/.docs/raw/community/discord.mdx +2 -2
  72. package/.docs/raw/community/licensing.mdx +1 -1
  73. package/.docs/raw/deployment/{server-deployment.mdx → building-mastra.mdx} +4 -4
  74. package/.docs/raw/deployment/cloud-providers/amazon-ec2.mdx +2 -2
  75. package/.docs/raw/deployment/cloud-providers/aws-lambda.mdx +3 -3
  76. package/.docs/raw/deployment/cloud-providers/azure-app-services.mdx +2 -2
  77. package/.docs/raw/deployment/{serverless-platforms → cloud-providers}/cloudflare-deployer.mdx +1 -1
  78. package/.docs/raw/deployment/cloud-providers/digital-ocean.mdx +2 -2
  79. package/.docs/raw/deployment/cloud-providers/index.mdx +8 -4
  80. package/.docs/raw/deployment/{serverless-platforms → cloud-providers}/netlify-deployer.mdx +1 -1
  81. package/.docs/raw/deployment/{serverless-platforms → cloud-providers}/vercel-deployer.mdx +1 -1
  82. package/.docs/raw/{mastra-cloud → deployment/mastra-cloud}/dashboard.mdx +3 -3
  83. package/.docs/raw/{mastra-cloud → deployment/mastra-cloud}/observability.mdx +2 -2
  84. package/.docs/raw/{mastra-cloud → deployment/mastra-cloud}/overview.mdx +3 -3
  85. package/.docs/raw/{mastra-cloud → deployment/mastra-cloud}/setting-up.mdx +4 -4
  86. package/.docs/raw/deployment/monorepo.mdx +3 -3
  87. package/.docs/raw/deployment/overview.mdx +5 -5
  88. package/.docs/raw/deployment/web-framework.mdx +1 -1
  89. package/.docs/raw/evals/{off-the-shelf-scorers.mdx → built-in-scorers.mdx} +17 -15
  90. package/.docs/raw/evals/custom-scorers.mdx +1 -1
  91. package/.docs/raw/evals/overview.mdx +3 -3
  92. package/.docs/raw/evals/running-in-ci.mdx +2 -2
  93. package/.docs/raw/frameworks/agentic-uis/ai-sdk.mdx +15 -128
  94. package/.docs/raw/frameworks/agentic-uis/assistant-ui.mdx +71 -19
  95. package/.docs/raw/frameworks/agentic-uis/cedar-os.mdx +8 -29
  96. package/.docs/raw/frameworks/agentic-uis/copilotkit.mdx +91 -267
  97. package/.docs/raw/frameworks/agentic-uis/openrouter.mdx +3 -3
  98. package/.docs/raw/frameworks/servers/express.mdx +1 -1
  99. package/.docs/raw/frameworks/web-frameworks/astro.mdx +1 -1
  100. package/.docs/raw/frameworks/web-frameworks/next-js.mdx +1 -1
  101. package/.docs/raw/frameworks/web-frameworks/sveltekit.mdx +1 -1
  102. package/.docs/raw/frameworks/web-frameworks/vite-react.mdx +1 -1
  103. package/.docs/raw/getting-started/mcp-docs-server.mdx +6 -6
  104. package/.docs/raw/getting-started/project-structure.mdx +1 -1
  105. package/.docs/raw/getting-started/quickstart.mdx +27 -0
  106. package/.docs/raw/getting-started/studio.mdx +3 -3
  107. package/.docs/raw/getting-started/templates.mdx +1 -1
  108. package/.docs/raw/guides/guide/ai-recruiter.mdx +1 -1
  109. package/.docs/raw/guides/guide/chef-michel.mdx +1 -1
  110. package/.docs/raw/{getting-started/installation.mdx → guides/guide/manual-install.mdx} +6 -80
  111. package/.docs/raw/guides/guide/notes-mcp-server.mdx +2 -2
  112. package/.docs/raw/guides/guide/research-assistant.mdx +2 -2
  113. package/.docs/raw/guides/guide/stock-agent.mdx +1 -1
  114. package/.docs/raw/guides/guide/web-search.mdx +1 -1
  115. package/.docs/raw/guides/migrations/ai-sdk-v4-to-v5.mdx +119 -0
  116. package/.docs/raw/guides/migrations/upgrade-to-v1/agent.mdx +11 -1
  117. package/.docs/raw/guides/migrations/upgrade-to-v1/client.mdx +42 -2
  118. package/.docs/raw/guides/migrations/upgrade-to-v1/evals.mdx +31 -1
  119. package/.docs/raw/guides/migrations/upgrade-to-v1/mastra.mdx +27 -3
  120. package/.docs/raw/guides/migrations/upgrade-to-v1/mcp.mdx +1 -1
  121. package/.docs/raw/guides/migrations/upgrade-to-v1/memory.mdx +28 -0
  122. package/.docs/raw/guides/migrations/upgrade-to-v1/overview.mdx +25 -3
  123. package/.docs/raw/guides/migrations/upgrade-to-v1/storage.mdx +80 -0
  124. package/.docs/raw/guides/migrations/upgrade-to-v1/tools.mdx +60 -0
  125. package/.docs/raw/guides/migrations/upgrade-to-v1/vectors.mdx +25 -1
  126. package/.docs/raw/guides/migrations/upgrade-to-v1/workflows.mdx +43 -1
  127. package/.docs/raw/guides/quickstarts/nextjs.mdx +18 -17
  128. package/.docs/raw/guides/quickstarts/standalone-server.mdx +86 -0
  129. package/.docs/raw/index.mdx +3 -3
  130. package/.docs/raw/logging.mdx +7 -7
  131. package/.docs/raw/mcp/overview.mdx +360 -0
  132. package/.docs/raw/mcp/publishing-mcp-server.mdx +139 -0
  133. package/.docs/raw/memory/conversation-history.mdx +1 -1
  134. package/.docs/raw/memory/memory-processors.mdx +1 -1
  135. package/.docs/raw/memory/overview.mdx +2 -2
  136. package/.docs/raw/memory/semantic-recall.mdx +2 -2
  137. package/.docs/raw/memory/storage/memory-with-libsql.mdx +1 -4
  138. package/.docs/raw/memory/storage/memory-with-mongodb.mdx +152 -0
  139. package/.docs/raw/memory/storage/memory-with-pg.mdx +1 -4
  140. package/.docs/raw/memory/storage/memory-with-upstash.mdx +1 -4
  141. package/.docs/raw/memory/threads-and-resources.mdx +1 -1
  142. package/.docs/raw/memory/working-memory.mdx +1 -1
  143. package/.docs/raw/observability/overview.mdx +2 -2
  144. package/.docs/raw/observability/tracing/exporters/arize.mdx +1 -1
  145. package/.docs/raw/observability/tracing/exporters/braintrust.mdx +1 -1
  146. package/.docs/raw/observability/tracing/exporters/cloud.mdx +2 -2
  147. package/.docs/raw/observability/tracing/exporters/default.mdx +1 -1
  148. package/.docs/raw/observability/tracing/exporters/langfuse.mdx +1 -1
  149. package/.docs/raw/observability/tracing/exporters/langsmith.mdx +1 -1
  150. package/.docs/raw/observability/tracing/exporters/otel.mdx +1 -1
  151. package/.docs/raw/observability/tracing/overview.mdx +2 -2
  152. package/.docs/raw/observability/tracing/processors/sensitive-data-filter.mdx +2 -2
  153. package/.docs/raw/rag/overview.mdx +1 -1
  154. package/.docs/raw/rag/retrieval.mdx +1 -1
  155. package/.docs/raw/rag/vector-databases.mdx +1 -1
  156. package/.docs/raw/reference/agents/agent.mdx +1 -2
  157. package/.docs/raw/reference/agents/generate.mdx +1 -1
  158. package/.docs/raw/reference/agents/generateLegacy.mdx +1 -1
  159. package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx +1 -1
  160. package/.docs/raw/reference/agents/getDefaultOptions.mdx +1 -1
  161. package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx +1 -1
  162. package/.docs/raw/reference/agents/getDescription.mdx +1 -1
  163. package/.docs/raw/reference/agents/getInstructions.mdx +1 -1
  164. package/.docs/raw/reference/agents/getLLM.mdx +1 -1
  165. package/.docs/raw/reference/agents/getMemory.mdx +1 -1
  166. package/.docs/raw/reference/agents/getModel.mdx +1 -1
  167. package/.docs/raw/reference/agents/getTools.mdx +69 -0
  168. package/.docs/raw/reference/agents/getVoice.mdx +1 -1
  169. package/.docs/raw/reference/agents/listAgents.mdx +1 -1
  170. package/.docs/raw/reference/agents/listScorers.mdx +1 -1
  171. package/.docs/raw/reference/agents/listTools.mdx +2 -2
  172. package/.docs/raw/reference/agents/listWorkflows.mdx +1 -1
  173. package/.docs/raw/reference/agents/network.mdx +1 -1
  174. package/.docs/raw/reference/auth/auth0.mdx +1 -1
  175. package/.docs/raw/reference/auth/clerk.mdx +1 -1
  176. package/.docs/raw/reference/auth/firebase.mdx +1 -1
  177. package/.docs/raw/reference/auth/jwt.mdx +1 -1
  178. package/.docs/raw/reference/auth/supabase.mdx +1 -1
  179. package/.docs/raw/reference/auth/workos.mdx +1 -1
  180. package/.docs/raw/reference/cli/create-mastra.mdx +1 -1
  181. package/.docs/raw/reference/cli/mastra.mdx +4 -4
  182. package/.docs/raw/reference/client-js/agents.mdx +1 -1
  183. package/.docs/raw/reference/client-js/error-handling.mdx +1 -1
  184. package/.docs/raw/reference/client-js/logs.mdx +1 -1
  185. package/.docs/raw/reference/client-js/mastra-client.mdx +2 -2
  186. package/.docs/raw/reference/client-js/memory.mdx +1 -1
  187. package/.docs/raw/reference/client-js/observability.mdx +1 -1
  188. package/.docs/raw/reference/client-js/telemetry.mdx +1 -1
  189. package/.docs/raw/reference/client-js/tools.mdx +1 -1
  190. package/.docs/raw/reference/client-js/vectors.mdx +1 -1
  191. package/.docs/raw/reference/client-js/workflows.mdx +1 -1
  192. package/.docs/raw/reference/core/addGateway.mdx +59 -0
  193. package/.docs/raw/reference/core/getAgent.mdx +1 -1
  194. package/.docs/raw/reference/core/getAgentById.mdx +1 -1
  195. package/.docs/raw/reference/core/getDeployer.mdx +1 -1
  196. package/.docs/raw/reference/core/getGateway.mdx +59 -0
  197. package/.docs/raw/reference/core/getGatewayById.mdx +62 -0
  198. package/.docs/raw/reference/core/getLogger.mdx +1 -1
  199. package/.docs/raw/reference/core/getMCPServer.mdx +2 -2
  200. package/.docs/raw/reference/core/getMCPServerById.mdx +2 -2
  201. package/.docs/raw/reference/core/getScorer.mdx +1 -1
  202. package/.docs/raw/reference/core/getScorerById.mdx +1 -1
  203. package/.docs/raw/reference/core/getServer.mdx +2 -2
  204. package/.docs/raw/reference/core/getStorage.mdx +1 -1
  205. package/.docs/raw/reference/core/getTelemetry.mdx +1 -1
  206. package/.docs/raw/reference/core/getVector.mdx +1 -1
  207. package/.docs/raw/reference/core/getWorkflow.mdx +1 -1
  208. package/.docs/raw/reference/core/listAgents.mdx +1 -1
  209. package/.docs/raw/reference/core/listGateways.mdx +53 -0
  210. package/.docs/raw/reference/core/listLogs.mdx +1 -1
  211. package/.docs/raw/reference/core/listLogsByRunId.mdx +1 -1
  212. package/.docs/raw/reference/core/listMCPServers.mdx +2 -2
  213. package/.docs/raw/reference/core/listScorers.mdx +1 -1
  214. package/.docs/raw/reference/core/listVectors.mdx +1 -1
  215. package/.docs/raw/reference/core/listWorkflows.mdx +1 -1
  216. package/.docs/raw/reference/core/mastra-class.mdx +9 -1
  217. package/.docs/raw/reference/core/mastra-model-gateway.mdx +241 -0
  218. package/.docs/raw/reference/core/setLogger.mdx +1 -1
  219. package/.docs/raw/reference/core/setStorage.mdx +1 -1
  220. package/.docs/raw/reference/core/setTelemetry.mdx +1 -1
  221. package/.docs/raw/reference/deployer/cloudflare.mdx +1 -1
  222. package/.docs/raw/reference/deployer/deployer.mdx +1 -1
  223. package/.docs/raw/reference/deployer/netlify.mdx +1 -1
  224. package/.docs/raw/reference/deployer/vercel.mdx +1 -1
  225. package/.docs/raw/reference/evals/answer-relevancy.mdx +1 -1
  226. package/.docs/raw/reference/evals/answer-similarity.mdx +1 -1
  227. package/.docs/raw/reference/evals/bias.mdx +1 -1
  228. package/.docs/raw/reference/evals/completeness.mdx +1 -1
  229. package/.docs/raw/reference/evals/content-similarity.mdx +1 -1
  230. package/.docs/raw/reference/evals/context-precision.mdx +1 -1
  231. package/.docs/raw/reference/evals/context-relevance.mdx +1 -1
  232. package/.docs/raw/reference/evals/create-scorer.mdx +1 -1
  233. package/.docs/raw/reference/evals/faithfulness.mdx +1 -1
  234. package/.docs/raw/reference/evals/hallucination.mdx +1 -1
  235. package/.docs/raw/reference/evals/keyword-coverage.mdx +1 -1
  236. package/.docs/raw/reference/evals/mastra-scorer.mdx +1 -1
  237. package/.docs/raw/reference/evals/noise-sensitivity.mdx +1 -1
  238. package/.docs/raw/reference/evals/prompt-alignment.mdx +1 -1
  239. package/.docs/raw/reference/evals/run-evals.mdx +1 -1
  240. package/.docs/raw/reference/evals/textual-difference.mdx +1 -1
  241. package/.docs/raw/reference/evals/tone-consistency.mdx +1 -1
  242. package/.docs/raw/reference/evals/tool-call-accuracy.mdx +1 -1
  243. package/.docs/raw/reference/evals/toxicity.mdx +1 -1
  244. package/.docs/raw/reference/logging/pino-logger.mdx +2 -2
  245. package/.docs/raw/reference/memory/createThread.mdx +1 -1
  246. package/.docs/raw/reference/memory/deleteMessages.mdx +1 -1
  247. package/.docs/raw/reference/memory/getThreadById.mdx +1 -1
  248. package/.docs/raw/reference/memory/listThreadsByResourceId.mdx +1 -1
  249. package/.docs/raw/reference/memory/memory-class.mdx +1 -1
  250. package/.docs/raw/reference/memory/query.mdx +1 -1
  251. package/.docs/raw/reference/memory/recall.mdx +1 -1
  252. package/.docs/raw/reference/observability/tracing/configuration.mdx +2 -2
  253. package/.docs/raw/reference/observability/tracing/exporters/arize.mdx +1 -1
  254. package/.docs/raw/reference/observability/tracing/exporters/braintrust.mdx +1 -1
  255. package/.docs/raw/reference/observability/tracing/exporters/cloud-exporter.mdx +1 -1
  256. package/.docs/raw/reference/observability/tracing/exporters/console-exporter.mdx +1 -1
  257. package/.docs/raw/reference/observability/tracing/exporters/default-exporter.mdx +1 -1
  258. package/.docs/raw/reference/observability/tracing/exporters/langfuse.mdx +1 -1
  259. package/.docs/raw/reference/observability/tracing/exporters/langsmith.mdx +1 -1
  260. package/.docs/raw/reference/observability/tracing/exporters/otel.mdx +1 -1
  261. package/.docs/raw/reference/observability/tracing/instances.mdx +2 -2
  262. package/.docs/raw/reference/observability/tracing/interfaces.mdx +2 -2
  263. package/.docs/raw/reference/observability/tracing/processors/sensitive-data-filter.mdx +1 -1
  264. package/.docs/raw/reference/observability/tracing/spans.mdx +2 -2
  265. package/.docs/raw/reference/processors/batch-parts-processor.mdx +1 -1
  266. package/.docs/raw/reference/processors/language-detector.mdx +1 -1
  267. package/.docs/raw/reference/processors/moderation-processor.mdx +1 -1
  268. package/.docs/raw/reference/processors/pii-detector.mdx +1 -1
  269. package/.docs/raw/reference/processors/prompt-injection-detector.mdx +1 -1
  270. package/.docs/raw/reference/processors/system-prompt-scrubber.mdx +1 -1
  271. package/.docs/raw/reference/processors/token-limiter-processor.mdx +1 -1
  272. package/.docs/raw/reference/processors/unicode-normalizer.mdx +1 -1
  273. package/.docs/raw/reference/rag/chunk.mdx +1 -1
  274. package/.docs/raw/reference/rag/database-config.mdx +1 -1
  275. package/.docs/raw/reference/rag/document.mdx +1 -1
  276. package/.docs/raw/reference/rag/embeddings.mdx +1 -1
  277. package/.docs/raw/reference/rag/extract-params.mdx +1 -1
  278. package/.docs/raw/reference/rag/graph-rag.mdx +1 -1
  279. package/.docs/raw/reference/rag/metadata-filters.mdx +1 -1
  280. package/.docs/raw/reference/rag/rerank.mdx +1 -1
  281. package/.docs/raw/reference/rag/rerankWithScorer.mdx +1 -1
  282. package/.docs/raw/reference/storage/cloudflare-d1.mdx +1 -1
  283. package/.docs/raw/reference/storage/cloudflare.mdx +1 -1
  284. package/.docs/raw/reference/storage/dynamodb.mdx +1 -1
  285. package/.docs/raw/reference/storage/lance.mdx +1 -1
  286. package/.docs/raw/reference/storage/libsql.mdx +1 -1
  287. package/.docs/raw/reference/storage/mongodb.mdx +1 -1
  288. package/.docs/raw/reference/storage/mssql.mdx +1 -1
  289. package/.docs/raw/reference/storage/postgresql.mdx +1 -1
  290. package/.docs/raw/reference/storage/upstash.mdx +1 -1
  291. package/.docs/raw/reference/streaming/ChunkType.mdx +1 -1
  292. package/.docs/raw/reference/streaming/agents/MastraModelOutput.mdx +1 -1
  293. package/.docs/raw/reference/streaming/agents/stream.mdx +1 -1
  294. package/.docs/raw/reference/streaming/agents/streamLegacy.mdx +1 -1
  295. package/.docs/raw/reference/streaming/workflows/observeStream.mdx +1 -1
  296. package/.docs/raw/reference/streaming/workflows/observeStreamVNext.mdx +1 -1
  297. package/.docs/raw/reference/streaming/workflows/resumeStreamVNext.mdx +1 -1
  298. package/.docs/raw/reference/streaming/workflows/stream.mdx +1 -1
  299. package/.docs/raw/reference/streaming/workflows/streamVNext.mdx +1 -1
  300. package/.docs/raw/reference/templates/overview.mdx +1 -1
  301. package/.docs/raw/reference/tools/client.mdx +1 -1
  302. package/.docs/raw/reference/tools/create-tool.mdx +3 -4
  303. package/.docs/raw/reference/tools/document-chunker-tool.mdx +1 -1
  304. package/.docs/raw/reference/tools/graph-rag-tool.mdx +2 -2
  305. package/.docs/raw/reference/tools/mcp-client.mdx +1 -1
  306. package/.docs/raw/reference/tools/mcp-server.mdx +55 -6
  307. package/.docs/raw/reference/tools/vector-query-tool.mdx +2 -2
  308. package/.docs/raw/reference/vectors/astra.mdx +1 -1
  309. package/.docs/raw/reference/vectors/chroma.mdx +1 -1
  310. package/.docs/raw/reference/vectors/couchbase.mdx +1 -1
  311. package/.docs/raw/reference/vectors/lance.mdx +1 -1
  312. package/.docs/raw/reference/vectors/libsql.mdx +1 -1
  313. package/.docs/raw/reference/vectors/mongodb.mdx +1 -1
  314. package/.docs/raw/reference/vectors/opensearch.mdx +1 -1
  315. package/.docs/raw/reference/vectors/pg.mdx +1 -1
  316. package/.docs/raw/reference/vectors/pinecone.mdx +22 -2
  317. package/.docs/raw/reference/vectors/qdrant.mdx +1 -1
  318. package/.docs/raw/reference/vectors/s3vectors.mdx +1 -1
  319. package/.docs/raw/reference/vectors/turbopuffer.mdx +1 -1
  320. package/.docs/raw/reference/vectors/upstash.mdx +1 -1
  321. package/.docs/raw/reference/vectors/vectorize.mdx +1 -1
  322. package/.docs/raw/reference/voice/azure.mdx +96 -81
  323. package/.docs/raw/reference/voice/cloudflare.mdx +1 -1
  324. package/.docs/raw/reference/voice/composite-voice.mdx +1 -1
  325. package/.docs/raw/reference/voice/deepgram.mdx +1 -1
  326. package/.docs/raw/reference/voice/elevenlabs.mdx +1 -1
  327. package/.docs/raw/reference/voice/google-gemini-live.mdx +1 -1
  328. package/.docs/raw/reference/voice/google.mdx +1 -1
  329. package/.docs/raw/reference/voice/mastra-voice.mdx +1 -1
  330. package/.docs/raw/reference/voice/murf.mdx +1 -1
  331. package/.docs/raw/reference/voice/openai-realtime.mdx +1 -1
  332. package/.docs/raw/reference/voice/openai.mdx +1 -1
  333. package/.docs/raw/reference/voice/playai.mdx +1 -1
  334. package/.docs/raw/reference/voice/sarvam.mdx +1 -1
  335. package/.docs/raw/reference/voice/speechify.mdx +1 -1
  336. package/.docs/raw/reference/voice/voice.addInstructions.mdx +1 -1
  337. package/.docs/raw/reference/voice/voice.addTools.mdx +1 -1
  338. package/.docs/raw/reference/voice/voice.answer.mdx +1 -1
  339. package/.docs/raw/reference/voice/voice.close.mdx +1 -1
  340. package/.docs/raw/reference/voice/voice.connect.mdx +1 -1
  341. package/.docs/raw/reference/voice/voice.events.mdx +1 -1
  342. package/.docs/raw/reference/voice/voice.getSpeakers.mdx +1 -1
  343. package/.docs/raw/reference/voice/voice.listen.mdx +1 -1
  344. package/.docs/raw/reference/voice/voice.off.mdx +1 -1
  345. package/.docs/raw/reference/voice/voice.on.mdx +1 -1
  346. package/.docs/raw/reference/voice/voice.send.mdx +1 -1
  347. package/.docs/raw/reference/voice/voice.speak.mdx +1 -1
  348. package/.docs/raw/reference/voice/voice.updateConfig.mdx +1 -1
  349. package/.docs/raw/reference/workflows/run-methods/cancel.mdx +1 -1
  350. package/.docs/raw/reference/workflows/run-methods/resume.mdx +1 -1
  351. package/.docs/raw/reference/workflows/run-methods/start.mdx +1 -1
  352. package/.docs/raw/reference/workflows/run.mdx +1 -1
  353. package/.docs/raw/reference/workflows/step.mdx +1 -1
  354. package/.docs/raw/reference/workflows/workflow-methods/branch.mdx +1 -1
  355. package/.docs/raw/reference/workflows/workflow-methods/commit.mdx +1 -1
  356. package/.docs/raw/reference/workflows/workflow-methods/create-run.mdx +1 -1
  357. package/.docs/raw/reference/workflows/workflow-methods/dountil.mdx +1 -1
  358. package/.docs/raw/reference/workflows/workflow-methods/dowhile.mdx +1 -1
  359. package/.docs/raw/reference/workflows/workflow-methods/foreach.mdx +1 -1
  360. package/.docs/raw/reference/workflows/workflow-methods/map.mdx +1 -1
  361. package/.docs/raw/reference/workflows/workflow-methods/parallel.mdx +1 -1
  362. package/.docs/raw/reference/workflows/workflow-methods/sendEvent.mdx +1 -1
  363. package/.docs/raw/reference/workflows/workflow-methods/sleep.mdx +1 -1
  364. package/.docs/raw/reference/workflows/workflow-methods/sleepUntil.mdx +1 -1
  365. package/.docs/raw/reference/workflows/workflow-methods/then.mdx +1 -1
  366. package/.docs/raw/reference/workflows/workflow-methods/waitForEvent.mdx +1 -1
  367. package/.docs/raw/reference/workflows/workflow.mdx +2 -2
  368. package/.docs/raw/server-db/custom-api-routes.mdx +1 -1
  369. package/.docs/raw/server-db/mastra-client.mdx +2 -2
  370. package/.docs/raw/server-db/{production-server.mdx → mastra-server.mdx} +2 -2
  371. package/.docs/raw/server-db/middleware.mdx +31 -31
  372. package/.docs/raw/server-db/request-context.mdx +3 -3
  373. package/.docs/raw/server-db/storage.mdx +1 -1
  374. package/.docs/raw/streaming/events.mdx +1 -1
  375. package/.docs/raw/streaming/overview.mdx +1 -1
  376. package/.docs/raw/streaming/tool-streaming.mdx +1 -1
  377. package/.docs/raw/streaming/workflow-streaming.mdx +1 -1
  378. package/.docs/raw/tools-mcp/advanced-usage.mdx +1 -1
  379. package/.docs/raw/tools-mcp/mcp-overview.mdx +1 -1
  380. package/.docs/raw/tools-mcp/overview.mdx +1 -1
  381. package/.docs/raw/voice/overview.mdx +1 -1
  382. package/.docs/raw/voice/speech-to-speech.mdx +1 -1
  383. package/.docs/raw/voice/speech-to-text.mdx +1 -1
  384. package/.docs/raw/voice/text-to-speech.mdx +1 -1
  385. package/.docs/raw/workflows/agents-and-tools.mdx +2 -4
  386. package/.docs/raw/workflows/control-flow.mdx +6 -1
  387. package/.docs/raw/workflows/error-handling.mdx +4 -4
  388. package/.docs/raw/workflows/human-in-the-loop.mdx +160 -213
  389. package/.docs/raw/workflows/inngest-workflow.mdx +1 -1
  390. package/.docs/raw/workflows/input-data-mapping.mdx +1 -1
  391. package/.docs/raw/workflows/overview.mdx +10 -2
  392. package/.docs/raw/workflows/snapshots.mdx +4 -3
  393. package/.docs/raw/workflows/suspend-and-resume.mdx +72 -224
  394. package/CHANGELOG.md +26 -0
  395. package/dist/stdio.js +16 -18
  396. package/package.json +10 -14
  397. package/.docs/raw/deployment/serverless-platforms/index.mdx +0 -58
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Spans | Observability | Mastra Docs"
2
+ title: "Reference: Spans | Observability"
3
3
  description: Span interfaces, methods, and lifecycle events
4
4
  ---
5
5
 
@@ -389,4 +389,4 @@ A span that performs no operations. All methods are no-ops:
389
389
 
390
390
  ### Examples
391
391
 
392
- - [Basic Tracing](/examples/v1/observability/basic-tracing) - Working with spans
392
+ - [Basic Tracing](/examples/v1/observability/basic-ai-tracing) - Working with spans
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Batch Parts Processor | Processors | Mastra Docs"
2
+ title: "Reference: Batch Parts Processor | Processors"
3
3
  description: "Documentation for the BatchPartsProcessor in Mastra, which batches multiple stream parts together to reduce frequency of emissions."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Language Detector | Processors | Mastra Docs"
2
+ title: "Reference: Language Detector | Processors"
3
3
  description: "Documentation for the LanguageDetector in Mastra, which detects language and can translate content in AI responses."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Moderation Processor | Processors | Mastra Docs"
2
+ title: "Reference: Moderation Processor | Processors"
3
3
  description: "Documentation for the ModerationProcessor in Mastra, which provides content moderation using LLM to detect inappropriate content across multiple categories."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: PII Detector | Processors | Mastra Docs"
2
+ title: "Reference: PII Detector | Processors"
3
3
  description: "Documentation for the PIIDetector in Mastra, which detects and redacts personally identifiable information (PII) from AI responses."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Prompt Injection Detector | Processors | Mastra Docs"
2
+ title: "Reference: Prompt Injection Detector | Processors"
3
3
  description: "Documentation for the PromptInjectionDetector in Mastra, which detects prompt injection attempts in user input."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: System Prompt Scrubber | Processors | Mastra Docs"
2
+ title: "Reference: System Prompt Scrubber | Processors"
3
3
  description: "Documentation for the SystemPromptScrubber in Mastra, which detects and redacts system prompts from AI responses."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Token Limiter Processor | Processors | Mastra Docs"
2
+ title: "Reference: Token Limiter Processor | Processors"
3
3
  description: "Documentation for the TokenLimiterProcessor in Mastra, which limits the number of tokens in AI responses."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Unicode Normalizer | Processors | Mastra Docs"
2
+ title: "Reference: Unicode Normalizer | Processors"
3
3
  description: "Documentation for the UnicodeNormalizer in Mastra, which normalizes Unicode text to ensure consistent formatting and remove potentially problematic characters."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Reference: .chunk() | RAG | Mastra Docs"
2
+ title: "Reference: Reference: .chunk() | RAG"
3
3
  description: Documentation for the chunk function in Mastra, which splits documents into smaller segments using various strategies.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: DatabaseConfig | RAG | Mastra Docs"
2
+ title: "Reference: DatabaseConfig | RAG"
3
3
  description: API reference for database-specific configuration types used with vector query tools in Mastra RAG systems.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: MDocument | Document Processing | RAG | Mastra Docs"
2
+ title: "Reference: MDocument | Document Processing | RAG"
3
3
  description: Documentation for the MDocument class in Mastra, which handles document processing and chunking.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Embed | RAG | Mastra Docs"
2
+ title: "Reference: Embed | RAG"
3
3
  description: Documentation for embedding functionality in Mastra using the AI SDK.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: ExtractParams | RAG | Mastra Docs"
2
+ title: "Reference: ExtractParams | RAG"
3
3
  description: Documentation for metadata extraction configuration in Mastra.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: GraphRAG | RAG | Mastra Docs"
2
+ title: "Reference: GraphRAG | RAG"
3
3
  description: Documentation for the GraphRAG class in Mastra, which implements a graph-based approach to retrieval augmented generation.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Metadata Filters | RAG | Mastra Docs"
2
+ title: "Reference: Metadata Filters | RAG"
3
3
  description: Documentation for metadata filtering capabilities in Mastra, which allow for precise querying of vector search results across different vector stores.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: rerank() | RAG | Mastra Docs"
2
+ title: "Reference: rerank() | RAG"
3
3
  description: Documentation for the rerank function in Mastra, which provides advanced reranking capabilities for vector search results.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: rerankWithScorer() | RAG | Mastra Docs"
2
+ title: "Reference: rerankWithScorer() | RAG"
3
3
  description: Documentation for the rerank function in Mastra, which provides advanced reranking capabilities for vector search results.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Cloudflare D1 Storage | Storage | Mastra Docs"
2
+ title: "Reference: Cloudflare D1 Storage | Storage"
3
3
  description: Documentation for the Cloudflare D1 SQL storage implementation in Mastra.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Cloudflare Storage | Storage | Mastra Docs"
2
+ title: "Reference: Cloudflare Storage | Storage"
3
3
  description: Documentation for the Cloudflare KV storage implementation in Mastra.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: DynamoDB Storage | Storage | Mastra Docs"
2
+ title: "Reference: DynamoDB Storage | Storage"
3
3
  description: "Documentation for the DynamoDB storage implementation in Mastra, using a single-table design with ElectroDB."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: LanceDB Storage | Storage | Mastra Docs"
2
+ title: "Reference: LanceDB Storage | Storage"
3
3
  description: Documentation for the LanceDB storage implementation in Mastra.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: LibSQL Storage | Storage | Mastra Docs"
2
+ title: "Reference: LibSQL Storage | Storage"
3
3
  description: Documentation for the LibSQL storage implementation in Mastra.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: MongoDB Storage | Storage | Mastra Docs"
2
+ title: "Reference: MongoDB Storage | Storage"
3
3
  description: Documentation for the MongoDB storage implementation in Mastra.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: MSSQL Storage | Storage | Mastra Docs"
2
+ title: "Reference: MSSQL Storage | Storage"
3
3
  description: Documentation for the MSSQL storage implementation in Mastra.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: PostgreSQL Storage | Storage | Mastra Docs"
2
+ title: "Reference: PostgreSQL Storage | Storage"
3
3
  description: Documentation for the PostgreSQL storage implementation in Mastra.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Upstash Storage | Storage | Mastra Docs"
2
+ title: "Reference: Upstash Storage | Storage"
3
3
  description: Documentation for the Upstash storage implementation in Mastra.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: ChunkType | Streaming | Mastra Docs"
2
+ title: "Reference: ChunkType | Streaming"
3
3
  description: "Documentation for the ChunkType type used in Mastra streaming responses, defining all possible chunk types and their payloads."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: MastraModelOutput | Streaming | Mastra Docs"
2
+ title: "Reference: MastraModelOutput | Streaming"
3
3
  description: "Complete reference for MastraModelOutput - the stream object returned by agent.stream() with streaming and promise-based access to model outputs."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Agent.stream() | Streaming | Mastra Docs"
2
+ title: "Reference: Agent.stream() | Streaming"
3
3
  description: "Documentation for the `Agent.stream()` method in Mastra agents, which enables real-time streaming of responses with enhanced capabilities."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Agent.streamLegacy() (Legacy) | Streaming | Mastra Docs"
2
+ title: "Reference: Agent.streamLegacy() (Legacy) | Streaming"
3
3
  description: "Documentation for the legacy `Agent.streamLegacy()` method in Mastra agents. This method is deprecated and will be removed in a future version."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Run.observeStream() | Streaming | Mastra Docs"
2
+ title: "Reference: Run.observeStream() | Streaming"
3
3
  description: Documentation for the `Run.observeStream()` method in workflows, which enables reopening the stream of an already active workflow run.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Run.observeStreamVNext() (Experimental) | Streaming | Mastra Docs"
2
+ title: "Reference: Run.observeStreamVNext() (Experimental) | Streaming"
3
3
  description: Documentation for the `Run.observeStreamVNext()` method in workflows, which enables reopening the stream of an already active workflow run.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Run.resumeStreamVNext() (Experimental) | Streaming | Mastra Docs"
2
+ title: "Reference: Run.resumeStreamVNext() (Experimental) | Streaming"
3
3
  description: Documentation for the `Run.resumeStreamVNext()` method in workflows, which enables real-time resumption and streaming of suspended workflow runs.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Run.stream() | Streaming | Mastra Docs"
2
+ title: "Reference: Run.stream() | Streaming"
3
3
  description: Documentation for the `Run.stream()` method in workflows, which allows you to monitor the execution of a workflow run as a stream.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Run.streamVNext() (Experimental) | Streaming | Mastra Docs"
2
+ title: "Reference: Run.streamVNext() (Experimental) | Streaming"
3
3
  description: Documentation for the `Run.streamVNext()` method in workflows, which enables real-time streaming of responses.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: LLM provider API keys (choose one or more) | Templates | Mastra Docs"
2
+ title: "Reference: LLM provider API keys (choose one or more) | Templates"
3
3
  description: "Complete guide to creating, using, and contributing Mastra templates"
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: MastraMCPClient (Deprecated) | Tools & MCP | Mastra Docs"
2
+ title: "Reference: MastraMCPClient (Deprecated) | Tools & MCP"
3
3
  description: API Reference for MastraMCPClient - A client implementation for the Model Context Protocol.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: createTool() | Tools & MCP | Mastra Docs"
2
+ title: "Reference: createTool() | Tools & MCP"
3
3
  description: Documentation for the `createTool()` function in Mastra, used to define custom tools for agents.
4
4
  ---
5
5
 
@@ -151,7 +151,6 @@ The `createTool()` function returns a `Tool` object.
151
151
 
152
152
  ## Related
153
153
 
154
- - [Tools Overview](/docs/v1/tools-mcp/overview)
154
+ - [MCP Overview](/docs/v1/mcp/overview)
155
155
  - [Using Tools with Agents](/docs/v1/agents/using-tools)
156
- - [Tool Request Context](/docs/v1/tools-mcp/overview#using-requestcontext)
157
- - [Advanced Tool Usage](/docs/v1/tools-mcp/advanced-usage)
156
+ - [Request Context](/docs/v1/server-db/request-context#accessing-values-with-tools)
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: createDocumentChunkerTool() | Tools & MCP | Mastra Docs"
2
+ title: "Reference: createDocumentChunkerTool() | Tools & MCP"
3
3
  description: Documentation for the Document Chunker Tool in Mastra, which splits documents into smaller chunks for efficient processing and retrieval.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: createGraphRAGTool() | Tools & MCP | Mastra Docs"
2
+ title: "Reference: createGraphRAGTool() | Tools & MCP"
3
3
  description: Documentation for the Graph RAG Tool in Mastra, which enhances RAG by building a graph of semantic relationships between documents.
4
4
  ---
5
5
 
@@ -254,7 +254,7 @@ const response = await agent.generate(
254
254
  For more information on request context, please see:
255
255
 
256
256
  - [Agent Request Context](/docs/v1/server-db/request-context)
257
- - [Tool Request Context](/docs/v1/tools-mcp/overview#using-requestcontext)
257
+ - [Request Context](/docs/v1/server-db/request-context#accessing-values-with-tools)
258
258
 
259
259
  ## Related
260
260
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: MCPClient | Tools & MCP | Mastra Docs"
2
+ title: "Reference: MCPClient | Tools & MCP"
3
3
  description: API Reference for MCPClient - A class for managing multiple Model Context Protocol servers and their tools.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: MCPServer | Tools & MCP | Mastra Docs"
2
+ title: "Reference: MCPServer | Tools & MCP"
3
3
  description: API Reference for MCPServer - A class for exposing Mastra tools and capabilities as a Model Context Protocol server.
4
4
  ---
5
5
 
@@ -186,6 +186,55 @@ The description for this generated tool will be: "Ask agent `<agent.name>` a que
186
186
 
187
187
  This allows you to quickly expose the generative capabilities of your agents through the MCP, enabling clients to "ask" your agents questions directly.
188
188
 
189
+ ### Accessing MCP Context in Tools
190
+
191
+ Tools exposed through `MCPServer` can access MCP request context (authentication, session IDs, etc.) via two different properties depending on how the tool is invoked:
192
+
193
+ | Call Pattern | Access Method |
194
+ |-------------|---------------|
195
+ | Direct tool call | `context?.mcp?.extra` |
196
+ | Agent tool call | `context?.requestContext?.get("mcp.extra")` |
197
+
198
+ **Universal pattern** (works in both contexts):
199
+ ```typescript
200
+ const mcpExtra = context?.mcp?.extra ?? context?.requestContext?.get("mcp.extra");
201
+ const authInfo = mcpExtra?.authInfo;
202
+ ```
203
+
204
+ #### Example: Tool that works in both contexts
205
+
206
+ ```typescript
207
+ import { createTool } from "@mastra/core/tools";
208
+ import { z } from "zod";
209
+
210
+ const fetchUserData = createTool({
211
+ id: "fetchUserData",
212
+ description: "Fetches user data using authentication from MCP context",
213
+ inputSchema: z.object({
214
+ userId: z.string().describe("The ID of the user to fetch"),
215
+ }),
216
+ execute: async (inputData, context) => {
217
+ // Access MCP authentication context
218
+ // When called directly via MCP: context.mcp.extra
219
+ // When called via agent: context.requestContext.get('mcp.extra')
220
+ const mcpExtra = context?.mcp?.extra || context?.requestContext?.get("mcp.extra");
221
+ const authInfo = mcpExtra?.authInfo;
222
+
223
+ if (!authInfo?.token) {
224
+ throw new Error("Authentication required");
225
+ }
226
+
227
+ const response = await fetch(`https://api.example.com/users/${inputData.userId}`, {
228
+ headers: {
229
+ Authorization: `Bearer ${authInfo.token}`,
230
+ },
231
+ });
232
+
233
+ return response.json();
234
+ },
235
+ });
236
+ ```
237
+
189
238
  ## Methods
190
239
 
191
240
  These are the functions you can call on an `MCPServer` instance to control its behavior and get information.
@@ -420,11 +469,11 @@ const server = new MCPServer({
420
469
 
421
470
  serve(async (req) => {
422
471
  const url = new URL(req.url);
423
-
472
+
424
473
  if (url.pathname === "/mcp") {
425
474
  // Convert Deno Request to Node.js-compatible format
426
475
  const { req: nodeReq, res: nodeRes } = toReqRes(req);
427
-
476
+
428
477
  await server.startHTTP({
429
478
  url,
430
479
  httpPath: "/mcp",
@@ -434,10 +483,10 @@ serve(async (req) => {
434
483
  serverless: true, // ← Enable stateless mode for serverless
435
484
  },
436
485
  });
437
-
486
+
438
487
  return toFetchResponse(nodeRes);
439
488
  }
440
-
489
+
441
490
  return new Response("Not found", { status: 404 });
442
491
  });
443
492
  ```
@@ -918,7 +967,7 @@ await serverWithPrompts.prompts.notifyListChanged();
918
967
 
919
968
  ## Examples
920
969
 
921
- For practical examples of setting up and deploying an MCPServer, see the [Deploying an MCPServer Example](/examples/v1/agents/deploying-mcp-server).
970
+ For practical examples of setting up and deploying an MCPServer, see the [Publishing an MCP Server guide](/docs/v1/mcp/publishing-mcp-server).
922
971
 
923
972
  The example at the beginning of this page also demonstrates how to instantiate `MCPServer` with both tools and agents.
924
973
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: createVectorQueryTool() | Tools & MCP | Mastra Docs"
2
+ title: "Reference: createVectorQueryTool() | Tools & MCP"
3
3
  description: Documentation for the Vector Query Tool in Mastra, which facilitates semantic search over vector stores with filtering and reranking capabilities.
4
4
  ---
5
5
 
@@ -568,7 +568,7 @@ const response = await agent.generate(
568
568
  For more information on request context, please see:
569
569
 
570
570
  - [Agent Request Context](/docs/v1/server-db/request-context)
571
- - [Tool Request Context](/docs/v1/tools-mcp/overview#using-requestcontext)
571
+ - [Request Context](/docs/v1/server-db/request-context#accessing-values-with-tools)
572
572
 
573
573
  ## Usage Without a Mastra Server
574
574
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Astra Vector Store | Vectors | Mastra Docs"
2
+ title: "Reference: Astra Vector Store | Vectors"
3
3
  description: Documentation for the AstraVector class in Mastra, which provides vector search using DataStax Astra DB.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Chroma Vector Store | Vectors | Mastra Docs"
2
+ title: "Reference: Chroma Vector Store | Vectors"
3
3
  description: Documentation for the ChromaVector class in Mastra, which provides vector search using ChromaDB.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Couchbase Vector Store | Vectors | Mastra Docs"
2
+ title: "Reference: Couchbase Vector Store | Vectors"
3
3
  description: Documentation for the CouchbaseVector class in Mastra, which provides vector search using Couchbase Vector Search.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Lance Vector Store | Vectors | Mastra Docs"
2
+ title: "Reference: Lance Vector Store | Vectors"
3
3
  description: "Documentation for the LanceVectorStore class in Mastra, which provides vector search using LanceDB, an embedded vector database based on the Lance columnar format."
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: LibSQLVector Store | Vectors | Mastra Docs"
2
+ title: "Reference: LibSQLVector Store | Vectors"
3
3
  description: Documentation for the LibSQLVector class in Mastra, which provides vector search using LibSQL with vector extensions.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: MongoDB Vector Store | Vectors | Mastra Docs"
2
+ title: "Reference: MongoDB Vector Store | Vectors"
3
3
  description: Documentation for the MongoDBVector class in Mastra, which provides vector search using MongoDB Atlas and Atlas Vector Search.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: OpenSearch Vector Store | Vectors | Mastra Docs"
2
+ title: "Reference: OpenSearch Vector Store | Vectors"
3
3
  description: Documentation for the OpenSearchVector class in Mastra, which provides vector search using OpenSearch.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: PG Vector Store | Vectors | Mastra Docs"
2
+ title: "Reference: PG Vector Store | Vectors"
3
3
  description: Documentation for the PgVector class in Mastra, which provides vector search using PostgreSQL with pgvector extension.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Pinecone Vector Store | Vectors | Mastra Docs"
2
+ title: "Reference: Pinecone Vector Store | Vectors"
3
3
  description: Documentation for the PineconeVector class in Mastra, which provides an interface to Pinecone's vector database.
4
4
  ---
5
5
 
@@ -12,6 +12,11 @@ It provides real-time vector search, with features like hybrid search, metadata
12
12
 
13
13
  <PropertiesTable
14
14
  content={[
15
+ {
16
+ name: "id",
17
+ type: "string",
18
+ description: "Unique identifier for this vector store instance",
19
+ },
15
20
  {
16
21
  name: "apiKey",
17
22
  type: "string",
@@ -20,7 +25,22 @@ It provides real-time vector search, with features like hybrid search, metadata
20
25
  {
21
26
  name: "environment",
22
27
  type: "string",
23
- description: 'Pinecone environment (e.g., "us-west1-gcp")',
28
+ isOptional: true,
29
+ description: "Pinecone environment controller host URL",
30
+ },
31
+ {
32
+ name: "cloud",
33
+ type: "'aws' | 'gcp' | 'azure'",
34
+ isOptional: true,
35
+ defaultValue: "aws",
36
+ description: "Cloud provider for Pinecone serverless",
37
+ },
38
+ {
39
+ name: "region",
40
+ type: "string",
41
+ isOptional: true,
42
+ defaultValue: "us-east-1",
43
+ description: "Region for Pinecone serverless",
24
44
  },
25
45
  ]}
26
46
  />
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Qdrant Vector Store | Vectors | Mastra Docs"
2
+ title: "Reference: Qdrant Vector Store | Vectors"
3
3
  description: Documentation for integrating Qdrant with Mastra, a vector similarity search engine for managing vectors and payloads.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Amazon S3 Vectors Store | Vectors | Mastra Docs"
2
+ title: "Reference: Amazon S3 Vectors Store | Vectors"
3
3
  description: Documentation for the S3Vectors class in Mastra, which provides vector search using Amazon S3 Vectors (Preview).
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Turbopuffer Vector Store | Vectors | Mastra Docs"
2
+ title: "Reference: Turbopuffer Vector Store | Vectors"
3
3
  description: Documentation for integrating Turbopuffer with Mastra, a high-performance vector database for efficient similarity search.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Upstash Vector Store | Vectors | Mastra Docs"
2
+ title: "Reference: Upstash Vector Store | Vectors"
3
3
  description: Documentation for the UpstashVector class in Mastra, which provides vector search using Upstash Vector.
4
4
  ---
5
5
 
@@ -1,5 +1,5 @@
1
1
  ---
2
- title: "Reference: Cloudflare Vector Store | Vectors | Mastra Docs"
2
+ title: "Reference: Cloudflare Vector Store | Vectors"
3
3
  description: Documentation for the CloudflareVector class in Mastra, which provides vector search using Cloudflare Vectorize.
4
4
  ---
5
5