@mastra/mcp-docs-server 1.2.15 → 1.2.16-alpha.3

package/.docs/models/providers/tinfoil.md

@@ -2,7 +2,7 @@
 
 # ![Tinfoil logo](https://models.dev/logos/tinfoil.svg)Tinfoil
 
-Access 7 Tinfoil models through Mastra's model router. Authentication is handled automatically using the `TINFOIL_API_KEY` environment variable.
+Access 8 Tinfoil models through Mastra's model router. Authentication is handled automatically using the `TINFOIL_API_KEY` environment variable.
 
 Learn more in the [Tinfoil documentation](https://docs.tinfoil.sh).
 
@@ -17,7 +17,7 @@ const agent = new Agent({
   id: "my-agent",
   name: "My Agent",
   instructions: "You are a helpful assistant",
-  model: "tinfoil/gemma4-31b"
+  model: "tinfoil/deepseek-v4-flash"
 });
 
 // Generate a response
@@ -36,12 +36,13 @@ for await (const chunk of stream) {
 
 | Model                            | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | -------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `tinfoil/gemma4-31b`             | 256K    |       |           |       |       |       | $0.40      | $1          |
-| `tinfoil/glm-5-2`                | 384K    |       |           |       |       |       | $2         | $5          |
+| `tinfoil/deepseek-v4-flash`      | 1.0M    |       |           |       |       |       | $0.70      | $2          |
+| `tinfoil/gemma4-31b`             | 262K    |       |           |       |       |       | $0.40      | $1          |
+| `tinfoil/glm-5-2`                | 393K    |       |           |       |       |       | $2         | $5          |
 | `tinfoil/gpt-oss-120b`           | 131K    |       |           |       |       |       | $0.15      | $0.60       |
 | `tinfoil/gpt-oss-safeguard-120b` | 131K    |       |           |       |       |       | $0.15      | $0.60       |
-| `tinfoil/kimi-k3`                | 256K    |       |           |       |       |       | $2         | $6          |
-| `tinfoil/llama3-3-70b`           | 128K    |       |           |       |       |       | $2         | $3          |
+| `tinfoil/kimi-k3`                | 262K    |       |           |       |       |       | $4         | $20         |
+| `tinfoil/llama3-3-70b`           | 131K    |       |           |       |       |       | $2         | $3          |
 | `tinfoil/nomic-embed-text`       | 8K      |       |           |       |       |       | $0.05      | —           |
 
 ## Advanced configuration
@@ -54,7 +55,7 @@ const agent = new Agent({
   name: "custom-agent",
   model: {
     url: "https://inference.tinfoil.sh/v1",
-    id: "tinfoil/gemma4-31b",
+    id: "tinfoil/deepseek-v4-flash",
     apiKey: process.env.TINFOIL_API_KEY,
     headers: {
       "X-Custom-Header": "value"
@@ -73,7 +74,7 @@ const agent = new Agent({
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
       ? "tinfoil/nomic-embed-text"
-      : "tinfoil/gemma4-31b";
+      : "tinfoil/deepseek-v4-flash";
   }
 });
 ```

package/.docs/models/providers/xai.md

@@ -2,7 +2,7 @@
 
 # ![xAI logo](https://models.dev/logos/xai.svg)xAI
 
-Access 10 xAI models through Mastra's model router. Authentication is handled automatically using the `XAI_API_KEY` environment variable.
+Access 11 xAI models through Mastra's model router. Authentication is handled automatically using the `XAI_API_KEY` environment variable.
 
 Learn more in the [xAI documentation](https://docs.x.ai/docs/models).
 
@@ -39,6 +39,7 @@ for await (const chunk of stream) {
 | `xai/grok-4.20-multi-agent-0309`   | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `xai/grok-4.3`                     | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `xai/grok-4.5`                     | 500K    |       |           |       |       |       | $2         | $6          |
+| `xai/grok-4.6`                     | 500K    |       |           |       |       |       | $2         | $6          |
 | `xai/grok-build-0.1`               | 256K    |       |           |       |       |       | $1         | $2          |
 | `xai/grok-imagine-image`           | 8K      |       |           |       |       |       | —          | —           |
 | `xai/grok-imagine-image-quality`   | 8K      |       |           |       |       |       | —          | —           |

package/.docs/models/providers.md

@@ -50,6 +50,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [DigitalOcean](https://mastra.ai/models/providers/digitalocean)
 - [DInference](https://mastra.ai/models/providers/dinference)
 - [EBCloud](https://mastra.ai/models/providers/ebcloud)
+- [Eden AI](https://mastra.ai/models/providers/edenai)
 - [EmpirioLabs AI](https://mastra.ai/models/providers/empiriolabs)
 - [evroc](https://mastra.ai/models/providers/evroc)
 - [FastRouter](https://mastra.ai/models/providers/fastrouter)
@@ -85,6 +86,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [LucidQuery](https://mastra.ai/models/providers/lucidquery)
 - [Lynkr](https://mastra.ai/models/providers/lynkr)
 - [Meganova](https://mastra.ai/models/providers/meganova)
+- [Merge Gateway](https://mastra.ai/models/providers/merge-gateway)
 - [Meta](https://mastra.ai/models/providers/meta)
 - [MiniMax (minimax.io)](https://mastra.ai/models/providers/minimax)
 - [MiniMax (minimaxi.com)](https://mastra.ai/models/providers/minimax-cn)

package/.docs/reference/agents/getVoice.md

@@ -30,5 +30,5 @@ await agent.getVoice({
 
 ## Related
 
-- [Voice in Mastra](https://mastra.ai/guides/voice/overview)
+- [Voice in Mastra](https://mastra.ai/reference/voice/overview)
 - [Voice providers](https://mastra.ai/reference/voice/mastra-voice)

package/.docs/reference/configuration.md

@@ -419,7 +419,7 @@ export const mastra = new Mastra({
 
 Text-to-speech providers for voice synthesis capabilities. Register voice providers to enable agents to convert text responses into spoken audio.
 
-Visit the [Voice documentation](https://mastra.ai/guides/voice/overview) to learn more.
+Visit the [Voice documentation](https://mastra.ai/reference/voice/overview) to learn more.
 
 > **Note:** Most users configure voice directly on agents. This top-level configuration is for defining reusable voice providers that can be shared across multiple agents.
 

package/.docs/reference/index.md

@@ -34,6 +34,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [.listTools()](https://mastra.ai/reference/agents/listTools)
 - [.listWorkflows()](https://mastra.ai/reference/agents/listWorkflows)
 - [.network()](https://mastra.ai/reference/agents/network)
+- [Overview](https://mastra.ai/reference/ai-sdk/overview)
 - [chatRoute()](https://mastra.ai/reference/ai-sdk/chat-route)
 - [handleChatStream()](https://mastra.ai/reference/ai-sdk/handle-chat-stream)
 - [handleNetworkStream()](https://mastra.ai/reference/ai-sdk/handle-network-stream)
@@ -199,7 +200,6 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [Tools](https://mastra.ai/reference/file-based-agents/tools)
 - [Workflows](https://mastra.ai/reference/file-based-agents/workflows)
 - [Workspace](https://mastra.ai/reference/file-based-agents/workspace)
-- [API Reference](https://mastra.ai/reference/mastra-platform/api)
 - [Cloned Thread Utilities](https://mastra.ai/reference/memory/clone-utilities)
 - [Memory Class](https://mastra.ai/reference/memory/memory-class)
 - [Observational Memory](https://mastra.ai/reference/memory/observational-memory)
@@ -343,9 +343,13 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [Qdrant Vector Store](https://mastra.ai/reference/vectors/qdrant)
 - [Turbopuffer Vector Store](https://mastra.ai/reference/vectors/turbopuffer)
 - [Upstash Vector Store](https://mastra.ai/reference/vectors/upstash)
+- [Overview](https://mastra.ai/reference/voice/overview)
 - [Composite Voice](https://mastra.ai/reference/voice/composite-voice)
 - [Events](https://mastra.ai/reference/voice/voice.events)
 - [Mastra Voice](https://mastra.ai/reference/voice/mastra-voice)
+- [Speech to Speech](https://mastra.ai/reference/voice/speech-to-speech)
+- [Speech to Text](https://mastra.ai/reference/voice/speech-to-text)
+- [Text to Speech](https://mastra.ai/reference/voice/text-to-speech)
 - [.addInstructions()](https://mastra.ai/reference/voice/voice.addInstructions)
 - [.addTools()](https://mastra.ai/reference/voice/voice.addTools)
 - [.answer()](https://mastra.ai/reference/voice/voice.answer)

package/.docs/reference/manual-install.md

@@ -4,7 +4,7 @@
 
 **For AI agents:** Use this guide when tasked to create a runnable Mastra project from scratch without a CLI/boilerplate. It provides code examples for agents, tools, model configuration and how to install dependencies. Do not navigate to the quickstart guide, which is for humans. The model string is Mastra's model router format ('provider/model'; use / and not : to separate provider and model). Do not install any ai-sdk packages.
 
-Use this guide to manually build a standalone Mastra server step by step. In most cases, it's quicker to follow the [quickstart guide](https://mastra.ai/guides/getting-started/quickstart), which achieves the same result using the [`create-mastra`](https://mastra.ai/reference/cli/create-mastra) command. For existing projects, you can also use [`mastra init`](https://mastra.ai/reference/cli/mastra).
+Use this guide to manually build a standalone Mastra server step by step. In most cases, use the [`create-mastra`](https://mastra.ai/reference/cli/create-mastra) command described in [Get started](https://mastra.ai/docs). For existing projects, you can also use [`mastra init`](https://mastra.ai/reference/cli/mastra).
 
 ## Instructions
 

package/.docs/reference/migrations/network-to-supervisor.md

@@ -260,4 +260,4 @@ const stream = await supervisorAgent.stream('Research AI in education', {
 - [Agent.stream() Reference](https://mastra.ai/reference/streaming/agents/stream)
 - [Agent.generate() Reference](https://mastra.ai/reference/agents/generate)
 - [Agent Approval](https://mastra.ai/docs/agents/agent-approval)
-- [Guide: Research Coordinator](https://mastra.ai/guides/guide/research-coordinator)
+- [Guide: Research Coordinator](https://mastra.ai/blog/build-a-research-coordinator-with-supervisor-agents)

package/.docs/reference/migrations/upgrade-to-v1/tracing.md

@@ -129,8 +129,6 @@ Key changes:
 3. Use explicit `configs:` with `MastraStorageExporter`, `MastraPlatformExporter`, and `SensitiveDataFilter`
 4. Export types change from string literals (`'otlp'`) to exporter class instances (`new OtelExporter()`)
 
-See the [exporters documentation](https://mastra.ai/docs/observability/integrations/overview) for all available exporters.
-
 ### From AI Tracing
 
 If you already upgraded to AI tracing (the intermediate system), you need to install the new package and use the explicit configuration.
@@ -294,7 +292,7 @@ To migrate, follow the "From OTEL-based Telemetry" section above. For detailed c
 
 The automatic detection of instrumentation files in `/mastra` (with `.ts`, `.js`, or `.mjs` extensions) has been removed. Custom instrumentation is no longer supported through separate files.
 
-To migrate, use the built-in exporter system or implement custom exporters using the `ObservabilityExporter` interface. See the [exporters documentation](https://mastra.ai/docs/observability/integrations/overview) for details.
+To migrate, use the built-in exporter system or implement custom exporters using the `ObservabilityExporter` interface.
 
 ### `instrumentation.mjs` files
 

package/.docs/reference/observability/tracing/exporters/cloud-exporter.md

@@ -233,7 +233,6 @@ const customExporter = new CloudExporter({
 ### Documentation
 
 - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Complete guide
-- [Exporters](https://mastra.ai/docs/observability/integrations/overview): Exporter concepts
 
 ### Other Exporters
 

package/.docs/reference/observability/tracing/exporters/console-exporter.md

@@ -122,7 +122,6 @@ const exporterWithLogger = new ConsoleExporter({
 ### Documentation
 
 - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Complete guide
-- [Exporters](https://mastra.ai/docs/observability/integrations/overview): Exporter concepts
 
 ### Other Exporters
 

package/.docs/reference/observability/tracing/exporters/default-exporter.md

@@ -167,7 +167,6 @@ const customExporter = new DefaultExporter({
 ### Documentation
 
 - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Complete guide
-- [Exporters](https://mastra.ai/docs/observability/integrations/overview): Exporter concepts
 
 ### Other Exporters
 

package/.docs/reference/observability/tracing/exporters/mastra-platform-exporter.md

@@ -262,7 +262,6 @@ The original `CloudExporter` is preserved unchanged so dashboards or alert rules
 ### Documentation
 
 - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Complete guide
-- [Exporters](https://mastra.ai/docs/observability/integrations/overview): Exporter concepts
 
 ### Other Exporters
 

package/.docs/reference/observability/tracing/exporters/mastra-storage-exporter.md

@@ -181,7 +181,6 @@ The original `DefaultExporter` is preserved unchanged so dashboards or alert rul
 ### Documentation
 
 - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview): Complete guide
-- [Exporters](https://mastra.ai/docs/observability/integrations/overview): Exporter concepts
 
 ### Other Exporters
 

package/.docs/reference/observability/tracing/processors/sensitive-data-filter.md

@@ -2,27 +2,50 @@
 
 # SensitiveDataFilter
 
-A SpanOutputProcessor that redacts sensitive information from span fields.
+`SensitiveDataFilter` is a span output processor that redacts values whose field names match a configured list. [`Observability`](https://mastra.ai/reference/observability/tracing/configuration) applies it to plain observability configurations by default.
 
-## Auto-applied by default
+## Usage example
 
-`Observability` automatically appends a `SensitiveDataFilter` to every configured instance's `spanOutputProcessors` so secrets are redacted before they reach exporters such as the Mastra cloud exporter. The filter runs last (after any user-provided processors) so that sensitive data introduced or surfaced by upstream processors is still redacted. You don't need to add it manually unless you want to customize its options.
-
-To opt out or customize the auto-applied filter, use the `sensitiveDataFilter` option on the [`Observability` registry config](https://mastra.ai/reference/observability/tracing/configuration):
+Configure the automatically applied filter with the top-level `sensitiveDataFilter` option. The filter runs after user-provided span output processors so it can redact values they add or expose.
 
 ```typescript
-import { Observability } from '@mastra/observability'
+import { Mastra } from '@mastra/core/mastra'
+import { Observability, MastraStorageExporter } from '@mastra/observability'
+
+export const mastra = new Mastra({
+  observability: new Observability({
+    configs: {
+      default: {
+        serviceName: 'my-service',
+        exporters: [new MastraStorageExporter()],
+      },
+    },
+    sensitiveDataFilter: {
+      sensitiveFields: ['password', 'authorization', 'customerSecret'],
+      redactionToken: '[HIDDEN]',
+      redactionStyle: 'full',
+    },
+  }),
+})
+```
 
+Passing `sensitiveFields` replaces the default field list. Include every default field you still want to redact.
+
+To disable automatic filtering for all plain configurations, set `sensitiveDataFilter` to `false`:
+
+```typescript
 new Observability({
-  configs: {/* ... */},
-  // disable the auto-applied filter
+  configs: {
+    debug: {
+      serviceName: 'debug-service',
+      exporters: [new MastraStorageExporter()],
+    },
+  },
   sensitiveDataFilter: false,
-  // or customize it
-  // sensitiveDataFilter: { sensitiveFields: ['mySecret'], redactionStyle: 'partial' },
 })
 ```
 
-If a config already includes a `SensitiveDataFilter` in `spanOutputProcessors`, the auto-applied filter is skipped to avoid double redaction. Pre-instantiated `ObservabilityInstance` values aren't modified. Add a `SensitiveDataFilter` to their processors yourself if needed.
+If a plain configuration already contains a `SensitiveDataFilter` in `spanOutputProcessors`, `Observability` uses that instance and doesn't add another. Pre-instantiated `ObservabilityInstance` values aren't modified. Add the processor when constructing those instances if they need filtering.
 
 ## Constructor
 
@@ -30,120 +53,82 @@ If a config already includes a `SensitiveDataFilter` in `spanOutputProcessors`,
 new SensitiveDataFilter(options?: SensitiveDataFilterOptions)
 ```
 
-## `SensitiveDataFilterOptions`
+**sensitiveFields** (`string[]`): Complete list of field names to redact. Matching is case-insensitive and ignores separators. Replaces the default list when provided. (Default: `['password', 'token', 'secret', 'key', 'apikey', 'auth', 'authorization', 'bearer', 'bearertoken', 'jwt', 'credential', 'clientsecret', 'privatekey', 'refresh', 'ssn']`)
+
+**redactionToken** (`string`): Replacement value used for full redaction and short values under partial redaction. (Default: `'[REDACTED]'`)
+
+**redactionStyle** (`'full' | 'partial'`): Controls whether matched values are fully or partially redacted. (Default: `'full'`)
 
 ```typescript
 interface SensitiveDataFilterOptions {
-  /**
-   * List of sensitive field names to redact.
-   * Matching is case-insensitive and normalizes separators
-   * (api-key, api_key, Api Key → apikey).
-   * Defaults include: password, token, secret, key, apikey, auth,
-   * authorization, bearer, bearertoken, jwt, credential,
-   * clientsecret, privatekey, refresh, ssn.
-   */
   sensitiveFields?: string[]
-
-  /**
-   * The token used for full redaction.
-   * Default: "[REDACTED]"
-   */
   redactionToken?: string
-
-  /**
-   * Style of redaction to use:
-   * - "full": always replace with redactionToken
-   * - "partial": show 3 characters from the start and end, redact the middle
-   * Default: "full"
-   */
   redactionStyle?: RedactionStyle
 }
-```
-
-## `RedactionStyle`
 
-```typescript
 type RedactionStyle = 'full' | 'partial'
 ```
 
-## Methods
-
-### process
-
-```typescript
-process(span: AnySpan): AnySpan
-```
+## Redaction styles
 
-Process a span by filtering sensitive data across its key fields: attributes, metadata, input, output, and errorInfo.
+### Full redaction
 
-**Returns:** A new span with sensitive values redacted.
+Full redaction replaces each matched primitive value with `redactionToken`.
 
-### shutdown
+```jsonc
+// Before
+{ "apiKey": "sk-abc123xyz789", "userId": "user_123" }
 
-```typescript
-async shutdown(): Promise<void>
+// After
+{ "apiKey": "[REDACTED]", "userId": "user_123" }
 ```
 
-No cleanup needed for this processor.
+### Partial redaction
 
-## Properties
+Partial redaction preserves the first and last three characters. Values with six or fewer characters use `redactionToken` instead. Non-string primitive values are converted to strings before redaction.
 
 ```typescript
-readonly name = 'sensitive-data-filter';
+const filter = new SensitiveDataFilter({
+  redactionStyle: 'partial',
+})
 ```
 
-## Default sensitive fields
+```jsonc
+// Before
+{ "apiKey": "sk-abc123xyz789" }
 
-When no custom fields are provided:
-
-```typescript
-[
-  'password',
-  'token',
-  'secret',
-  'key',
-  'apikey',
-  'auth',
-  'authorization',
-  'bearer',
-  'bearertoken',
-  'jwt',
-  'credential',
-  'clientsecret',
-  'privatekey',
-  'refresh',
-  'ssn',
-]
+// After
+{ "apiKey": "sk-…789" }
 ```
 
-## Processing behavior
+## Field matching
 
-### Field Matching
+Field names are lowercased and stripped of non-alphanumeric characters before comparison:
 
-- **Case-insensitive**: `APIKey`, `apikey`, `ApiKey` all match
+- `api-key`, `api_key`, `Api Key`, and `apiKey` normalize to `apikey`.
+- Matching is exact after normalization. `token` matches `Token`, but doesn't match `promptTokens`, `tokenCount`, or `authToken`.
 
-- **Separator-agnostic**: `api-key`, `api_key`, `apiKey` are treated identically
+When a matched field contains an object or array, the filter traverses that value and redacts sensitive fields within it rather than replacing the complete structure.
 
-- **Exact matching**: After normalization, fields must match exactly
-
-  - `token` matches `token`, `Token`, `TOKEN`
-  - `token` doesn't match `promptTokens` or `tokenCount`
-
-### Redaction Styles
-
-#### Full Redaction (default)
+## Processing behavior
 
-All matched values replaced with redactionToken.
+`process()` filters these top-level span fields independently:
 
-#### Partial Redaction
+- `attributes`
+- `metadata`
+- `input`
+- `output`
+- `errorInfo`
 
-- Shows first 3 and last 3 characters
-- Values ≤ 6 characters are fully redacted
-- Non-string values are converted to strings before partial redaction
+Within each field, the processor:
 
-### Error handling
+- Traverses nested objects and arrays.
+- Parses and filters JSON strings that contain objects or arrays. It then serializes the filtered value.
+- Leaves invalid JSON strings unchanged.
+- Preserves `Date` instances.
+- Replaces repeated object references with `[Circular Reference]`.
 
-If filtering a field fails, the field is replaced with:
+If filtering fails anywhere within one top-level span field, that complete field is replaced with this marker:
 
 ```typescript
 {
@@ -153,14 +138,41 @@ If filtering a field fails, the field is replaced with:
 }
 ```
 
-### Processed Fields
+## Methods
+
+### Processing
 
-The filter recursively processes:
+#### `process(span)`
 
-- `span.attributes` - Span metadata and properties
-- `span.metadata` - Custom metadata
-- `span.input` - Input data
-- `span.output` - Output data
-- `span.errorInfo` - Error information
+Redacts the supported fields on the supplied span in place and returns the same span.
+
+```typescript
+import type { AnySpan } from '@mastra/core/observability'
+import { SensitiveDataFilter } from '@mastra/observability'
+
+const filter = new SensitiveDataFilter()
+
+export function redactSpan(span: AnySpan): AnySpan {
+  return filter.process(span)
+}
+```
+
+**span** (`AnySpan`): Span whose attributes, metadata, input, output, and error information are filtered.
+
+Returns: `AnySpan`
+
+### Lifecycle
+
+#### `shutdown()`
+
+Completes processor shutdown. The current processor has no resources or state to clean up.
+
+```typescript
+await filter.shutdown()
+```
+
+Returns: `Promise<void>`
+
+## Properties
 
-Handles nested objects, arrays, and circular references safely.
+**name** (`string`): Processor identifier. (Default: `'sensitive-data-filter'`)

package/.docs/reference/observability/tracing/span-filtering.md

@@ -94,4 +94,4 @@ If `spanFilter` throws an error, Mastra keeps the span and logs the error to avo
 
 - [Tracing overview](https://mastra.ai/docs/observability/tracing/overview) for setup and concepts
 - [Configuration API](https://mastra.ai/reference/observability/tracing/configuration) for `ObservabilityInstanceConfig`
-- [Sensitive data filter](https://mastra.ai/docs/observability/integrations/processors/sensitive-data-filter) for redacting span data
+- [Sensitive data filter](https://mastra.ai/reference/observability/tracing/processors/sensitive-data-filter) for redacting span data

package/.docs/reference/storage/overview.md

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# Storage overview
+# Storage
 
 Mastra storage is organized into domains. Each domain owns a set of tables or collections. Depending on your adapter and configuration, you may use all domains or only a subset.
 

package/.docs/reference/templates/overview.md

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# Overview
+# Templates
 
 This reference explains how to use existing Mastra templates and create your own. It also covers contributing templates to the community ecosystem.
 

package/.docs/{guides → reference}/voice/overview.md

@@ -29,7 +29,7 @@ You can then use the following voice capabilities:
 
 Turn your agent's responses into natural-sounding speech using Mastra's TTS capabilities. Choose from multiple providers like OpenAI, ElevenLabs, and more.
 
-For detailed configuration options and advanced features, check out our [Text-to-Speech guide](https://mastra.ai/guides/voice/text-to-speech).
+For detailed configuration options and advanced features, check out our [Text-to-Speech guide](https://mastra.ai/reference/voice/text-to-speech).
 
 **OpenAI**:
 
@@ -304,7 +304,7 @@ Visit the [Murf Voice Reference](https://mastra.ai/integrations/voice/murf) for
 
 ### Speech to Text (STT)
 
-Transcribe spoken content using providers like OpenAI, ElevenLabs, and more. For detailed configuration options and more, check out [Speech to Text](https://mastra.ai/guides/voice/speech-to-text).
+Transcribe spoken content using providers like OpenAI, ElevenLabs, and more. For detailed configuration options and more, check out [Speech to Text](https://mastra.ai/reference/voice/speech-to-text).
 
 You can download a sample audio file from [here](https://github.com/mastra-ai/realtime-voice-demo/raw/refs/heads/main/how_can_i_help_you.mp3).
 
@@ -537,7 +537,7 @@ Visit the [Sarvam Voice Reference](https://mastra.ai/integrations/voice/sarvam)
 
 ### Speech to Speech (STS)
 
-Create conversational experiences with speech-to-speech capabilities. The unified API enables real-time voice interactions between users and AI agents. For detailed configuration options and advanced features, check out [Speech to Speech](https://mastra.ai/guides/voice/speech-to-speech).
+Create conversational experiences with speech-to-speech capabilities. The unified API enables real-time voice interactions between users and AI agents. For detailed configuration options and advanced features, check out [Speech to Speech](https://mastra.ai/reference/voice/speech-to-speech).
 
 **OpenAI**:
 

package/.docs/{guides → reference}/voice/speech-to-speech.md

@@ -54,7 +54,7 @@ const micStream = getMicrophoneStream()
 await agent.voice.send(micStream)
 ```
 
-For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/guides/voice/overview).
+For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/reference/voice/overview).
 
 ## Use tools in realtime sessions
 

package/.docs/{guides → reference}/voice/speech-to-text.md

@@ -96,4 +96,4 @@ const transcription = await agent.voice.listen(audioStream, {
 console.log(`Transcription: ${transcription}`)
 ```
 
-For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/guides/voice/overview).
+For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/reference/voice/overview).

package/.docs/{guides → reference}/voice/text-to-speech.md

@@ -4,7 +4,7 @@
 
 Text-to-Speech (TTS) in Mastra offers a unified API for synthesizing spoken audio from text using providers. By incorporating TTS into your applications, you can enhance user experience with natural voice interactions and improve accessibility for users with visual impairments, plus create more engaging multimodal interfaces.
 
-TTS is a core component of any voice application. Combined with STT (Speech-to-Text), it forms the foundation of voice interaction systems. Newer models support STS ([Speech-to-Speech](https://mastra.ai/guides/voice/speech-to-speech)) which can be used for real-time interactions but come at high cost ($).
+TTS is a core component of any voice application. Combined with STT (Speech-to-Text), it forms the foundation of voice interaction systems. Newer models support STS ([Speech-to-Speech](https://mastra.ai/reference/voice/speech-to-speech)) which can be used for real-time interactions but come at high cost ($).
 
 ## Configuration
 
@@ -101,4 +101,4 @@ await new Promise<void>((resolve, reject) => {
 })
 ```
 
-For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/guides/voice/overview).
+For a broader overview of voice providers on agents, see [Voice in Mastra](https://mastra.ai/reference/voice/overview).

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/mcp-docs-server
 
+## 1.2.16-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`aa3e7be`](https://github.com/mastra-ai/mastra/commit/aa3e7be30f8addb0278ea74429f4df054517a287), [`90822db`](https://github.com/mastra-ai/mastra/commit/90822dba08fb2169c518e4a6d7f127c098eb46b8), [`3700208`](https://github.com/mastra-ai/mastra/commit/37002080c7838267803a7e579a7d58b908d62f36), [`8b7131e`](https://github.com/mastra-ai/mastra/commit/8b7131eb0407f58f5205e68fb27b81f026488f28), [`79c4f82`](https://github.com/mastra-ai/mastra/commit/79c4f8295f568752eeadf8a9b50010a7d9ec06ae)]:
+  - @mastra/core@1.59.0-alpha.1
+
+## 1.2.16-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`088e41e`](https://github.com/mastra-ai/mastra/commit/088e41e434ed05f2c674b254f1034ec46a57a7be), [`b2f0013`](https://github.com/mastra-ai/mastra/commit/b2f0013375588d40c03c13e843b99c0ff8872ca5), [`3b541ae`](https://github.com/mastra-ai/mastra/commit/3b541ae5d410c52b80a7e381d84d021cddb9a449), [`ae79e34`](https://github.com/mastra-ai/mastra/commit/ae79e34c0bd8674fc24c7524217bfc4a051c6136), [`a6c4399`](https://github.com/mastra-ai/mastra/commit/a6c4399763590b3dae21a2c81826e89a3b1deee4)]:
+  - @mastra/core@1.59.0-alpha.0
+
 ## 1.2.15
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.2.15",
+  "version": "1.2.16-alpha.3",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -28,7 +28,7 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.4.3",
-    "@mastra/core": "1.58.0",
+    "@mastra/core": "1.59.0-alpha.1",
     "@mastra/mcp": "^1.16.0"
   },
   "devDependencies": {
@@ -46,8 +46,8 @@
     "typescript": "^6.0.3",
     "vitest": "4.1.10",
     "@internal/lint": "0.0.122",
-    "@mastra/core": "1.58.0",
-    "@internal/types-builder": "0.0.97"
+    "@internal/types-builder": "0.0.97",
+    "@mastra/core": "1.59.0-alpha.1"
   },
   "homepage": "https://mastra.ai",
   "repository": {