@mastra/mcp-docs-server 0.13.40 → 0.13.41

package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md

@@ -1,5 +1,27 @@
 # @mastra/playground-ui
 
+## 6.9.2
+
+### Patch Changes
+
+- Fix scorer filtering for SpanScoring, add error and info message for user ([#10164](https://github.com/mastra-ai/mastra/pull/10164))
+
+- Updated dependencies [[`eebb7bb`](https://github.com/mastra-ai/mastra/commit/eebb7bb407c57342a3be3a2efbe68c696589feeb), [`c6e6d07`](https://github.com/mastra-ai/mastra/commit/c6e6d071ecf346a80dceab410af2c567c7e66a57), [`0e6df8f`](https://github.com/mastra-ai/mastra/commit/0e6df8f66340992cb1b319834657deb17368de52), [`6295fd7`](https://github.com/mastra-ai/mastra/commit/6295fd783d49075d5bf2c18ff9486e94d36aaa56), [`d813cf7`](https://github.com/mastra-ai/mastra/commit/d813cf7251695d85cc60469058384ffa74974484)]:
+  - @mastra/core@0.24.2
+  - @mastra/client-js@0.16.11
+  - @mastra/react@0.0.17
+
+## 6.9.2-alpha.0
+
+### Patch Changes
+
+- Fix scorer filtering for SpanScoring, add error and info message for user ([#10164](https://github.com/mastra-ai/mastra/pull/10164))
+
+- Updated dependencies [[`eebb7bb`](https://github.com/mastra-ai/mastra/commit/eebb7bb407c57342a3be3a2efbe68c696589feeb), [`c6e6d07`](https://github.com/mastra-ai/mastra/commit/c6e6d071ecf346a80dceab410af2c567c7e66a57), [`0e6df8f`](https://github.com/mastra-ai/mastra/commit/0e6df8f66340992cb1b319834657deb17368de52), [`6295fd7`](https://github.com/mastra-ai/mastra/commit/6295fd783d49075d5bf2c18ff9486e94d36aaa56), [`d813cf7`](https://github.com/mastra-ai/mastra/commit/d813cf7251695d85cc60469058384ffa74974484)]:
+  - @mastra/core@0.24.2-alpha.0
+  - @mastra/client-js@0.16.11-alpha.0
+  - @mastra/react@0.0.17-alpha.0
+
 ## 6.9.1
 
 ### Patch Changes
@@ -277,26 +299,4 @@
 
 ## 6.5.1
 
-### Patch Changes
-
-- Add @mastra/react to peer deps ([#8857](https://github.com/mastra-ai/mastra/pull/8857))
-
-- Updated dependencies [[`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`9ba695e`](https://github.com/mastra-ai/mastra/commit/9ba695e9ff977b8f13cc71df3b452775757361e5), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
-  - @mastra/core@0.21.1
-  - @mastra/react@0.0.7
-  - @mastra/client-js@0.16.1
-
-## 6.5.1-alpha.0
-
-### Patch Changes
-
-- Add @mastra/react to peer deps ([#8857](https://github.com/mastra-ai/mastra/pull/8857))
-
-- Updated dependencies [[`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`9ba695e`](https://github.com/mastra-ai/mastra/commit/9ba695e9ff977b8f13cc71df3b452775757361e5), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
-  - @mastra/core@0.21.1-alpha.0
-  - @mastra/react@0.0.7-alpha.0
-  - @mastra/client-js@0.16.1-alpha.0
-
-## 6.5.0
-
-... 3984 more lines hidden. See full changelog in package directory.
+... 4006 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Freact.md

@@ -1,5 +1,19 @@
 # @mastra/react-hooks
 
+## 0.0.17
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/client-js@0.16.11
+
+## 0.0.17-alpha.0
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/client-js@0.16.11-alpha.0
+
 ## 0.0.16
 
 ### Patch Changes
@@ -285,18 +299,4 @@
 
 ## 0.0.4-alpha.4
 
-### Patch Changes
-
-- Updated dependencies []:
-  - @mastra/client-js@0.15.1-alpha.4
-
-## 0.0.4-alpha.3
-
-### Patch Changes
-
-- Updated dependencies []:
-  - @mastra/client-js@0.15.1-alpha.3
-
-## 0.0.4-alpha.2
-
-... 96 more lines hidden. See full changelog in package directory.
+... 110 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fserver.md

@@ -1,5 +1,19 @@
 # @mastra/server
 
+## 0.24.2
+
+### Patch Changes
+
+- Updated dependencies [[`eebb7bb`](https://github.com/mastra-ai/mastra/commit/eebb7bb407c57342a3be3a2efbe68c696589feeb), [`c6e6d07`](https://github.com/mastra-ai/mastra/commit/c6e6d071ecf346a80dceab410af2c567c7e66a57), [`0e6df8f`](https://github.com/mastra-ai/mastra/commit/0e6df8f66340992cb1b319834657deb17368de52), [`6295fd7`](https://github.com/mastra-ai/mastra/commit/6295fd783d49075d5bf2c18ff9486e94d36aaa56), [`d813cf7`](https://github.com/mastra-ai/mastra/commit/d813cf7251695d85cc60469058384ffa74974484)]:
+  - @mastra/core@0.24.2
+
+## 0.24.2-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`eebb7bb`](https://github.com/mastra-ai/mastra/commit/eebb7bb407c57342a3be3a2efbe68c696589feeb), [`c6e6d07`](https://github.com/mastra-ai/mastra/commit/c6e6d071ecf346a80dceab410af2c567c7e66a57), [`0e6df8f`](https://github.com/mastra-ai/mastra/commit/0e6df8f66340992cb1b319834657deb17368de52), [`6295fd7`](https://github.com/mastra-ai/mastra/commit/6295fd783d49075d5bf2c18ff9486e94d36aaa56), [`d813cf7`](https://github.com/mastra-ai/mastra/commit/d813cf7251695d85cc60469058384ffa74974484)]:
+  - @mastra/core@0.24.2-alpha.0
+
 ## 0.24.1
 
 ### Patch Changes
@@ -284,19 +298,5 @@
 
 ## 0.21.0-alpha.1
 
-### Patch Changes
-
-- Updated dependencies [[`1ed9670`](https://github.com/mastra-ai/mastra/commit/1ed9670d3ca50cb60dc2e517738c5eef3968ed27), [`158381d`](https://github.com/mastra-ai/mastra/commit/158381d39335be934b81ef8a1947bccace492c25), [`fb703b9`](https://github.com/mastra-ai/mastra/commit/fb703b9634eeaff1a6eb2b5531ce0f9e8fb04727), [`37a2314`](https://github.com/mastra-ai/mastra/commit/37a23148e0e5a3b40d4f9f098b194671a8a49faf), [`05a9dee`](https://github.com/mastra-ai/mastra/commit/05a9dee3d355694d28847bfffb6289657fcf7dfa), [`e3c1077`](https://github.com/mastra-ai/mastra/commit/e3c107763aedd1643d3def5df450c235da9ff76c), [`1bccdb3`](https://github.com/mastra-ai/mastra/commit/1bccdb33eb90cbeba2dc5ece1c2561fb774b26b6), [`5ef944a`](https://github.com/mastra-ai/mastra/commit/5ef944a3721d93105675cac2b2311432ff8cc393), [`d6b186f`](https://github.com/mastra-ai/mastra/commit/d6b186fb08f1caf1b86f73d3a5ee88fb999ca3be), [`65493b3`](https://github.com/mastra-ai/mastra/commit/65493b31c36f6fdb78f9679f7e1ecf0c250aa5ee), [`a998b8f`](https://github.com/mastra-ai/mastra/commit/a998b8f858091c2ec47683e60766cf12d03001e4), [`8a37bdd`](https://github.com/mastra-ai/mastra/commit/8a37bddb6d8614a32c5b70303d583d80c620ea61)]:
-  - @mastra/core@0.21.0-alpha.1
-
-## 0.21.0-alpha.0
-
-### Minor Changes
-
-- Update structuredOutput to use response format by default with an opt in to json prompt injection. ([#8557](https://github.com/mastra-ai/mastra/pull/8557))
-  Replaced internal usage of output with structuredOutput.
-
-- Update peer dependencies to match core package version bump (0.21.0) ([#8557](https://github.com/mastra-ai/mastra/pull/8557))
-
 
-... 3979 more lines hidden. See full changelog in package directory.
+... 3993 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Fvoice-google-gemini-live.md

@@ -1,5 +1,27 @@
 # @mastra/voice-google-gemini-live
 
+## 0.11.0
+
+### Minor Changes
+
+- Backport gemini fix to 0.x ([#10234](https://github.com/mastra-ai/mastra/pull/10234))
+
+### Patch Changes
+
+- Updated dependencies [[`eebb7bb`](https://github.com/mastra-ai/mastra/commit/eebb7bb407c57342a3be3a2efbe68c696589feeb), [`c6e6d07`](https://github.com/mastra-ai/mastra/commit/c6e6d071ecf346a80dceab410af2c567c7e66a57), [`0e6df8f`](https://github.com/mastra-ai/mastra/commit/0e6df8f66340992cb1b319834657deb17368de52), [`6295fd7`](https://github.com/mastra-ai/mastra/commit/6295fd783d49075d5bf2c18ff9486e94d36aaa56), [`d813cf7`](https://github.com/mastra-ai/mastra/commit/d813cf7251695d85cc60469058384ffa74974484)]:
+  - @mastra/core@0.24.2
+
+## 0.11.0-alpha.0
+
+### Minor Changes
+
+- Backport gemini fix to 0.x ([#10234](https://github.com/mastra-ai/mastra/pull/10234))
+
+### Patch Changes
+
+- Updated dependencies [[`eebb7bb`](https://github.com/mastra-ai/mastra/commit/eebb7bb407c57342a3be3a2efbe68c696589feeb), [`c6e6d07`](https://github.com/mastra-ai/mastra/commit/c6e6d071ecf346a80dceab410af2c567c7e66a57), [`0e6df8f`](https://github.com/mastra-ai/mastra/commit/0e6df8f66340992cb1b319834657deb17368de52), [`6295fd7`](https://github.com/mastra-ai/mastra/commit/6295fd783d49075d5bf2c18ff9486e94d36aaa56), [`d813cf7`](https://github.com/mastra-ai/mastra/commit/d813cf7251695d85cc60469058384ffa74974484)]:
+  - @mastra/core@0.24.2-alpha.0
+
 ## 0.10.18
 
 ### Patch Changes
@@ -276,27 +298,5 @@
 
 ### Patch Changes
 
-- dd512a2: Integrates Google Gemini Live API into the Mastra framework
-- Updated dependencies [227c7e6]
-- Updated dependencies [12cae67]
-- Updated dependencies [fd3a3eb]
-- Updated dependencies [6faaee5]
-- Updated dependencies [4232b14]
-- Updated dependencies [a89de7e]
-- Updated dependencies [5a37d0c]
-- Updated dependencies [4bde0cb]
-- Updated dependencies [cf4f357]
-- Updated dependencies [ad888a2]
-- Updated dependencies [481751d]
-- Updated dependencies [2454423]
-- Updated dependencies [194e395]
-- Updated dependencies [a722c0b]
-- Updated dependencies [c30bca8]
-- Updated dependencies [3b5fec7]
-- Updated dependencies [a8f129d]
-  - @mastra/core@0.14.0
-
-## 0.10.7-alpha.0
-
-
-... 11 more lines hidden. See full changelog in package directory.
+
+... 33 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/create-mastra.md

@@ -1,5 +1,9 @@
 # create-mastra
 
+## 0.18.2
+
+## 0.18.2-alpha.0
+
 ## 0.18.1
 
 ## 0.18.1-alpha.0
@@ -294,9 +298,5 @@
 
 - show thread list in desc order ([#8381](https://github.com/mastra-ai/mastra/pull/8381))
 
-- Fix an issue preventing showing working memory and semantic recall in the playground ([#8358](https://github.com/mastra-ai/mastra/pull/8358))
-
-- Add observe strean to get streans after workflow has been interrupted ([#8318](https://github.com/mastra-ai/mastra/pull/8318))
-
 
-... 1820 more lines hidden. See full changelog in package directory.
+... 1824 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/mastra.md

@@ -1,5 +1,25 @@
 # mastra
 
+## 0.18.2
+
+### Patch Changes
+
+- Add support to skip dotenv/env file loading by adding MASTRA_SKIP_DOTENV ([#10246](https://github.com/mastra-ai/mastra/pull/10246))
+
+- Updated dependencies [[`eebb7bb`](https://github.com/mastra-ai/mastra/commit/eebb7bb407c57342a3be3a2efbe68c696589feeb), [`c6e6d07`](https://github.com/mastra-ai/mastra/commit/c6e6d071ecf346a80dceab410af2c567c7e66a57), [`0e6df8f`](https://github.com/mastra-ai/mastra/commit/0e6df8f66340992cb1b319834657deb17368de52), [`6295fd7`](https://github.com/mastra-ai/mastra/commit/6295fd783d49075d5bf2c18ff9486e94d36aaa56), [`d813cf7`](https://github.com/mastra-ai/mastra/commit/d813cf7251695d85cc60469058384ffa74974484)]:
+  - @mastra/core@0.24.2
+  - @mastra/deployer@0.24.2
+
+## 0.18.2-alpha.0
+
+### Patch Changes
+
+- Add support to skip dotenv/env file loading by adding MASTRA_SKIP_DOTENV ([#10246](https://github.com/mastra-ai/mastra/pull/10246))
+
+- Updated dependencies [[`eebb7bb`](https://github.com/mastra-ai/mastra/commit/eebb7bb407c57342a3be3a2efbe68c696589feeb), [`c6e6d07`](https://github.com/mastra-ai/mastra/commit/c6e6d071ecf346a80dceab410af2c567c7e66a57), [`0e6df8f`](https://github.com/mastra-ai/mastra/commit/0e6df8f66340992cb1b319834657deb17368de52), [`6295fd7`](https://github.com/mastra-ai/mastra/commit/6295fd783d49075d5bf2c18ff9486e94d36aaa56), [`d813cf7`](https://github.com/mastra-ai/mastra/commit/d813cf7251695d85cc60469058384ffa74974484)]:
+  - @mastra/core@0.24.2-alpha.0
+  - @mastra/deployer@0.24.2-alpha.0
+
 ## 0.18.1
 
 ### Patch Changes
@@ -279,24 +299,4 @@
 
 - Refactor EntryList component and Scorer and Observability pages ([#8652](https://github.com/mastra-ai/mastra/pull/8652))
 
-- Stream finalResult from network loop ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
-
-- Improve README ([#8819](https://github.com/mastra-ai/mastra/pull/8819))
-
-- Update peer dependencies to match core package version bump (0.21.0) ([#8686](https://github.com/mastra-ai/mastra/pull/8686))
-
-- Updated dependencies [[`0fb6616`](https://github.com/mastra-ai/mastra/commit/0fb66169600ed2a3dc1297b1bfa8a7693ebb6e3c), [`1ed9670`](https://github.com/mastra-ai/mastra/commit/1ed9670d3ca50cb60dc2e517738c5eef3968ed27), [`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`1dbd76a`](https://github.com/mastra-ai/mastra/commit/1dbd76aff29cc764d3a1ac7bb01172fe59cb5992), [`f59fc1e`](https://github.com/mastra-ai/mastra/commit/f59fc1e406b8912e692f6bff6cfd4754cc8d165c), [`ca5a01f`](https://github.com/mastra-ai/mastra/commit/ca5a01f0dd4dabdbfde3beeaf92c7333e0f9bb39), [`158381d`](https://github.com/mastra-ai/mastra/commit/158381d39335be934b81ef8a1947bccace492c25), [`a1799bc`](https://github.com/mastra-ai/mastra/commit/a1799bcc1b5a1cdc188f2ac0165f17a1c4ac6f7b), [`6ff6094`](https://github.com/mastra-ai/mastra/commit/6ff60946f4ecfebdeef6e21d2b230c2204f2c9b8), [`2ddb851`](https://github.com/mastra-ai/mastra/commit/2ddb8519c4b6f1d31be10ffd33b41d2b649a04ff), [`fb703b9`](https://github.com/mastra-ai/mastra/commit/fb703b9634eeaff1a6eb2b5531ce0f9e8fb04727), [`dfe856f`](https://github.com/mastra-ai/mastra/commit/dfe856f7f60ff4765b75930e7b5d82dd0f0f7d89), [`37a2314`](https://github.com/mastra-ai/mastra/commit/37a23148e0e5a3b40d4f9f098b194671a8a49faf), [`7b1ef57`](https://github.com/mastra-ai/mastra/commit/7b1ef57fc071c2aa2a2e32905b18cd88719c5a39), [`7b1ef57`](https://github.com/mastra-ai/mastra/commit/7b1ef57fc071c2aa2a2e32905b18cd88719c5a39), [`05a9dee`](https://github.com/mastra-ai/mastra/commit/05a9dee3d355694d28847bfffb6289657fcf7dfa), [`e3c1077`](https://github.com/mastra-ai/mastra/commit/e3c107763aedd1643d3def5df450c235da9ff76c), [`1908ca0`](https://github.com/mastra-ai/mastra/commit/1908ca0521f90e43779cc29ab590173ca560443c), [`1bccdb3`](https://github.com/mastra-ai/mastra/commit/1bccdb33eb90cbeba2dc5ece1c2561fb774b26b6), [`5ef944a`](https://github.com/mastra-ai/mastra/commit/5ef944a3721d93105675cac2b2311432ff8cc393), [`228228b`](https://github.com/mastra-ai/mastra/commit/228228b0b1de9291cb8887587f5cea1a8757ebad), [`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`d6b186f`](https://github.com/mastra-ai/mastra/commit/d6b186fb08f1caf1b86f73d3a5ee88fb999ca3be), [`ee68e82`](https://github.com/mastra-ai/mastra/commit/ee68e8289ea4408d29849e899bc6e78b3bd4e843), [`228228b`](https://github.com/mastra-ai/mastra/commit/228228b0b1de9291cb8887587f5cea1a8757ebad), [`ea33930`](https://github.com/mastra-ai/mastra/commit/ea339301e82d6318257720d811b043014ee44064), [`65493b3`](https://github.com/mastra-ai/mastra/commit/65493b31c36f6fdb78f9679f7e1ecf0c250aa5ee), [`a998b8f`](https://github.com/mastra-ai/mastra/commit/a998b8f858091c2ec47683e60766cf12d03001e4), [`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`8a37bdd`](https://github.com/mastra-ai/mastra/commit/8a37bddb6d8614a32c5b70303d583d80c620ea61), [`7b1ef57`](https://github.com/mastra-ai/mastra/commit/7b1ef57fc071c2aa2a2e32905b18cd88719c5a39), [`e0e1cf1`](https://github.com/mastra-ai/mastra/commit/e0e1cf1e37b9dc61099ab331a6d386e44b816310), [`135d6f2`](https://github.com/mastra-ai/mastra/commit/135d6f22a326ed1dffff858700669dff09d2c9eb)]:
-  - @mastra/deployer@0.21.0
-  - @mastra/core@0.21.0
-  - @mastra/loggers@0.10.16
-  - @mastra/mcp@0.13.5
-
-## 0.16.0-alpha.1
-
-### Minor Changes
-
-- Update peer dependencies to match core package version bump (0.21.0) ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
-
-### Patch Changes
-
-... 6437 more lines hidden. See full changelog in package directory.
+... 6457 more lines hidden. See full changelog in package directory.

package/.docs/raw/reference/vectors/pinecone.mdx

@@ -20,7 +20,22 @@ It provides real-time vector search, with features like hybrid search, metadata
     {
       name: "environment",
       type: "string",
-      description: 'Pinecone environment (e.g., "us-west1-gcp")',
+      isOptional: true,
+      description: "Pinecone environment controller host URL",
+    },
+    {
+      name: "cloud",
+      type: "'aws' | 'gcp' | 'azure'",
+      isOptional: true,
+      defaultValue: "aws",
+      description: "Cloud provider for Pinecone serverless",
+    },
+    {
+      name: "region",
+      type: "string",
+      isOptional: true,
+      defaultValue: "us-east-1",
+      description: "Region for Pinecone serverless",
     },
   ]}
 />

package/.docs/raw/reference/voice/azure.mdx

@@ -8,6 +8,8 @@ description: "Documentation for the AzureVoice class, providing text-to-speech a
 The AzureVoice class in Mastra provides text-to-speech and speech-to-text capabilities using Microsoft Azure Cognitive Services.
 
 ## Usage Example
+This requires Azure Speech Services credentials that can be provided through environment variables or directly in the configuration:
+
 
 ```typescript
 import { AzureVoice } from "@mastra/voice-azure";
@@ -15,29 +17,25 @@ import { AzureVoice } from "@mastra/voice-azure";
 // Initialize with configuration
 const voice = new AzureVoice({
   speechModel: {
-    name: "neural",
-    apiKey: "your-azure-speech-api-key",
-    region: "eastus",
+    apiKey: "your-azure-speech-api-key", // Or use AZURE_API_KEY env var
+    region: "eastus", // Or use AZURE_REGION env var
+    voiceName: "en-US-AriaNeural", // Optional: specific voice for TTS
   },
   listeningModel: {
-    name: "whisper",
-    apiKey: "your-azure-speech-api-key",
-    region: "eastus",
+    apiKey: "your-azure-speech-api-key", // Or use AZURE_API_KEY env var
+    region: "eastus", // Or use AZURE_REGION env var
+    language: "en-US", // Optional: recognition language for STT
   },
-  speaker: "en-US-JennyNeural", // Default voice
+  speaker: "en-US-JennyNeural", // Optional: default voice
 });
 
 // Convert text to speech
 const audioStream = await voice.speak("Hello, how can I help you?", {
-  speaker: "en-US-GuyNeural", // Override default voice
-  style: "cheerful", // Voice style
+  speaker: "en-US-GuyNeural", // Optional: override default voice
 });
 
 // Convert speech to text
-const text = await voice.listen(audioStream, {
-  filetype: "wav",
-  language: "en-US",
-});
+const text = await voice.listen(audioStream);
 ```
 
 ## Configuration
@@ -69,26 +67,36 @@ const text = await voice.listen(audioStream, {
 
 ### AzureSpeechConfig
 
+Configuration object for speech synthesis (`speechModel`) and recognition (`listeningModel`).
+
 <PropertiesTable
   content={[
     {
-      name: "name",
-      type: "'neural' | 'standard' | 'whisper'",
-      description: "Model type to use. 'neural' for TTS, 'whisper' for STT.",
+      name: "apiKey",
+      type: "string",
+      description:
+        "Azure Speech Services API key (NOT Azure OpenAI key). Falls back to AZURE_API_KEY environment variable.",
       isOptional: true,
     },
     {
-      name: "apiKey",
+      name: "region",
       type: "string",
       description:
-        "Azure Speech Services API key. Falls back to AZURE_SPEECH_KEY environment variable.",
+        "Azure region (e.g., 'eastus', 'westeurope'). Falls back to AZURE_REGION environment variable.",
       isOptional: true,
     },
     {
-      name: "region",
+      name: "voiceName",
+      type: "string",
+      description:
+        "Voice ID for speech synthesis (e.g., 'en-US-AriaNeural', 'en-US-JennyNeural'). Only used in speechModel. See voice list below.",
+      isOptional: true,
+    },
+    {
+      name: "language",
       type: "string",
       description:
-        "Azure region (e.g., 'eastus', 'westeurope'). Falls back to AZURE_SPEECH_REGION environment variable.",
+        "Recognition language code (e.g., 'en-US', 'fr-FR'). Only used in listeningModel.",
       isOptional: true,
     },
   ]}
@@ -111,32 +119,14 @@ Converts text to speech using Azure's neural text-to-speech service.
     {
       name: "options.speaker",
       type: "string",
-      description: "Voice ID to use for speech synthesis.",
+      description: "Voice ID to use for speech synthesis (e.g., 'en-US-JennyNeural'). Overrides the default voice.",
       isOptional: true,
       defaultValue: "Constructor's speaker value",
     },
-    {
-      name: "options.style",
-      type: "string",
-      description: "Speaking style (e.g., 'cheerful', 'sad', 'angry').",
-      isOptional: true,
-    },
-    {
-      name: "options.rate",
-      type: "string",
-      description: "Speaking rate (e.g., 'slow', 'medium', 'fast').",
-      isOptional: true,
-    },
-    {
-      name: "options.pitch",
-      type: "string",
-      description: "Voice pitch (e.g., 'low', 'medium', 'high').",
-      isOptional: true,
-    },
   ]}
 />
 
-Returns: `Promise<NodeJS.ReadableStream>`
+Returns: `Promise<NodeJS.ReadableStream>` - Audio stream in WAV format
 
 ### listen()
 
@@ -147,31 +137,19 @@ Transcribes audio using Azure's speech-to-text service.
     {
       name: "audioStream",
       type: "NodeJS.ReadableStream",
-      description: "Audio stream to transcribe.",
+      description: "Audio stream to transcribe. Must be in WAV format.",
       isOptional: false,
     },
-    {
-      name: "options.filetype",
-      type: "string",
-      description: "Audio format of the input stream.",
-      isOptional: true,
-      defaultValue: "'wav'",
-    },
-    {
-      name: "options.language",
-      type: "string",
-      description: "Language code for transcription.",
-      isOptional: true,
-      defaultValue: "'en-US'",
-    },
   ]}
 />
 
-Returns: `Promise<string>`
+Returns: `Promise<string>` - The recognized text from the audio
+
+**Note:** Language and recognition settings are configured in the `listeningModel` configuration during initialization, not passed as options to this method.
 
 ### getSpeakers()
 
-Returns an array of available voice options, where each node contains:
+Returns an array of available voice options (200+ voices), where each node contains:
 
 <PropertiesTable
   content={[
@@ -179,40 +157,77 @@ Returns an array of available voice options, where each node contains:
       name: "voiceId",
       type: "string",
       description:
-        "Unique identifier for the voice (e.g., 'en-US-JennyNeural')",
-      isOptional: false,
-    },
-    {
-      name: "name",
-      type: "string",
-      description: "Human-readable name of the voice",
+        "Unique identifier for the voice (e.g., 'en-US-JennyNeural', 'fr-FR-DeniseNeural')",
       isOptional: false,
     },
     {
-      name: "locale",
+      name: "language",
       type: "string",
-      description: "Language locale of the voice (e.g., 'en-US')",
+      description: "Language code extracted from voice ID (e.g., 'en', 'fr')",
       isOptional: false,
     },
     {
-      name: "gender",
+      name: "region",
       type: "string",
-      description: "Gender of the voice ('Male' or 'Female')",
+      description: "Region code extracted from voice ID (e.g., 'US', 'GB', 'FR')",
       isOptional: false,
     },
-    {
-      name: "styles",
-      type: "string[]",
-      description: "Available speaking styles for the voice",
-      isOptional: true,
-    },
   ]}
 />
 
-## Notes
+Returns: `Promise<Array<{ voiceId: string; language: string; region: string; }>>`
+
+## Important Notes
+
+### Azure Speech Services vs Azure OpenAI
+
+**⚠️ Critical:** This package uses **Azure Speech Services**, which is different from **Azure OpenAI Services**.
+
+- **DO NOT** use your `AZURE_OPENAI_API_KEY` for this package
+- **DO** use an Azure Speech Services subscription key (obtain from Azure Portal under "Speech Services")
+- These are separate Azure resources with different API keys and endpoints
+
+### Environment Variables
+
+API keys and regions can be provided via constructor options or environment variables:
+
+- `AZURE_API_KEY` - Your Azure Speech Services subscription key
+- `AZURE_REGION` - Your Azure region (e.g., 'eastus', 'westeurope')
+
+### Voice Capabilities
+
+- Azure offers 200+ neural voices across 50+ languages
+- Each voice ID follows the format: `{language}-{region}-{name}Neural` (e.g., 'en-US-JennyNeural')
+- Some voices include multilingual support or HD quality variants
+- Audio output is in WAV format
+- Audio input for recognition must be in WAV format
+
+## Available Voices
+
+Azure provides 200+ neural voices across many languages. Some popular English voices include:
+
+- **US English:**
+  - `en-US-AriaNeural` (Female, default)
+  - `en-US-JennyNeural` (Female)
+  - `en-US-GuyNeural` (Male)
+  - `en-US-DavisNeural` (Male)
+  - `en-US-AvaNeural` (Female)
+  - `en-US-AndrewNeural` (Male)
+
+- **British English:**
+  - `en-GB-SoniaNeural` (Female)
+  - `en-GB-RyanNeural` (Male)
+  - `en-GB-LibbyNeural` (Female)
+
+- **Australian English:**
+  - `en-AU-NatashaNeural` (Female)
+  - `en-AU-WilliamNeural` (Male)
+
+To get a complete list of all 200+ voices:
+
+```typescript
+const voices = await voice.getSpeakers();
+console.log(voices); // Array of { voiceId, language, region }
+```
 
-- API keys can be provided via constructor options or environment variables (AZURE_SPEECH_KEY and AZURE_SPEECH_REGION)
-- Azure offers a wide range of neural voices across many languages
-- Some voices support speaking styles like cheerful, sad, angry, etc.
-- Speech recognition supports multiple audio formats and languages
-- Azure's speech services provide high-quality neural voices with natural-sounding speech
+For more information, see the [Azure Neural TTS documentation](https://learn.microsoft.com/en-us/azure/cognitive-services/speech-service/language-support?tabs=tts).

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @mastra/mcp-docs-server
 
+## 0.13.41
+
+### Patch Changes
+
+- Add migration tool to mcp docs server for stable branch that will let users know to upgrade mcp docs server @latest to @beta to get the proper migration tool. ([#10200](https://github.com/mastra-ai/mastra/pull/10200))
+
+- Updated dependencies [[`f21ed89`](https://github.com/mastra-ai/mastra/commit/f21ed89577cfa00d616f10eaf10d8feb096f283e), [`eebb7bb`](https://github.com/mastra-ai/mastra/commit/eebb7bb407c57342a3be3a2efbe68c696589feeb), [`c6e6d07`](https://github.com/mastra-ai/mastra/commit/c6e6d071ecf346a80dceab410af2c567c7e66a57), [`0e6df8f`](https://github.com/mastra-ai/mastra/commit/0e6df8f66340992cb1b319834657deb17368de52), [`6295fd7`](https://github.com/mastra-ai/mastra/commit/6295fd783d49075d5bf2c18ff9486e94d36aaa56), [`d813cf7`](https://github.com/mastra-ai/mastra/commit/d813cf7251695d85cc60469058384ffa74974484)]:
+  - @mastra/mcp@0.14.3
+  - @mastra/core@0.24.2
+
+## 0.13.41-alpha.0
+
+### Patch Changes
+
+- Add migration tool to mcp docs server for stable branch that will let users know to upgrade mcp docs server @latest to @beta to get the proper migration tool. ([#10200](https://github.com/mastra-ai/mastra/pull/10200))
+
+- Updated dependencies [[`f21ed89`](https://github.com/mastra-ai/mastra/commit/f21ed89577cfa00d616f10eaf10d8feb096f283e), [`eebb7bb`](https://github.com/mastra-ai/mastra/commit/eebb7bb407c57342a3be3a2efbe68c696589feeb), [`c6e6d07`](https://github.com/mastra-ai/mastra/commit/c6e6d071ecf346a80dceab410af2c567c7e66a57), [`0e6df8f`](https://github.com/mastra-ai/mastra/commit/0e6df8f66340992cb1b319834657deb17368de52), [`6295fd7`](https://github.com/mastra-ai/mastra/commit/6295fd783d49075d5bf2c18ff9486e94d36aaa56), [`d813cf7`](https://github.com/mastra-ai/mastra/commit/d813cf7251695d85cc60469058384ffa74974484)]:
+  - @mastra/mcp@0.14.3-alpha.0
+  - @mastra/core@0.24.2-alpha.0
+
 ## 0.13.40
 
 ### Patch Changes

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAiBxC,QAAA,IAAI,MAAM,EAAE,SAAS,CAAC;AA+BtB,iBAAe,SAAS,kBAQvB;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAmBxC,QAAA,IAAI,MAAM,EAAE,SAAS,CAAC;AAiCtB,iBAAe,SAAS,kBAQvB;AAED,OAAO,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC"}

package/dist/prompts/migration.d.ts

@@ -0,0 +1,3 @@
+import type { MCPServerPrompts } from '@mastra/mcp';
+export declare const migrationPromptMessages: MCPServerPrompts;
+//# sourceMappingURL=migration.d.ts.map

package/dist/prompts/migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"migration.d.ts","sourceRoot":"","sources":["../../src/prompts/migration.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAiDpD,eAAO,MAAM,uBAAuB,EAAE,gBAcrC,CAAC"}