@mastra/mcp-docs-server 1.1.25-alpha.4 → 1.1.25-alpha.6

package/.docs/docs/agents/adding-voice.md

@@ -343,7 +343,7 @@ Mastra supports multiple voice providers for text-to-speech (TTS) and speech-to-
 
 ## Next steps
 
-- [Voice API Reference](https://mastra.ai/reference/voice/mastra-voice) - Detailed API documentation for voice capabilities
-- [Text to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/text-to-speech) - Interactive story generator and other TTS implementations
-- [Speech to Text Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-text) - Voice memo app and other STT implementations
-- [Speech to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-speech) - Real-time voice conversation with call analysis
+- [Voice API Reference](https://mastra.ai/reference/voice/mastra-voice): Detailed API documentation for voice capabilities
+- [Text to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/text-to-speech): Interactive story generator and other TTS implementations
+- [Speech to Text Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-text): Voice memo app and other STT implementations
+- [Speech to Speech Examples](https://github.com/mastra-ai/voice-examples/tree/main/speech-to-speech): Real-time voice conversation with call analysis

package/.docs/docs/deployment/mastra-server.md

@@ -116,7 +116,7 @@ NODE_OPTIONS="--max-old-space-size=4096" mastra build
 
 ## Related
 
-- [Server Overview](https://mastra.ai/docs/server/mastra-server) - Configure server behavior, middleware, and authentication
-- [Server Adapters](https://mastra.ai/docs/server/server-adapters) - Use Express or Hono instead of `mastra build`
-- [Custom API Routes](https://mastra.ai/docs/server/custom-api-routes) - Add custom HTTP endpoints
-- [Configuration Reference](https://mastra.ai/reference/configuration) - Full configuration options
+- [Server Overview](https://mastra.ai/docs/server/mastra-server): Configure server behavior, middleware, and authentication
+- [Server Adapters](https://mastra.ai/docs/server/server-adapters): Use Express or Hono instead of `mastra build`
+- [Custom API Routes](https://mastra.ai/docs/server/custom-api-routes): Add custom HTTP endpoints
+- [Configuration Reference](https://mastra.ai/reference/configuration): Full configuration options

package/.docs/docs/deployment/monorepo.md

@@ -131,6 +131,6 @@ If you see type errors from uncompiled workspace packages, either:
 
 ## Related
 
-- [Deploy a Mastra Server](https://mastra.ai/docs/deployment/mastra-server) - Core build and deployment guide
-- [Configuration Reference](https://mastra.ai/reference/configuration) - `bundler.transpilePackages` and other options
-- [CLI Reference](https://mastra.ai/reference/cli/mastra) - Build command flags
+- [Deploy a Mastra Server](https://mastra.ai/docs/deployment/mastra-server): Core build and deployment guide
+- [Configuration Reference](https://mastra.ai/reference/configuration): `bundler.transpilePackages` and other options
+- [CLI Reference](https://mastra.ai/reference/cli/mastra): Build command flags

package/.docs/docs/evals/custom-scorers.md

@@ -515,5 +515,5 @@ console.log('Reason:', result.reason)
 
 **Examples and Resources:**
 
-- [createScorer API Reference](https://mastra.ai/reference/evals/create-scorer) - Complete technical documentation
-- [Built-in Scorers Source Code](https://github.com/mastra-ai/mastra/tree/main/packages/evals/src/scorers) - Real implementations for reference
+- [createScorer API Reference](https://mastra.ai/reference/evals/create-scorer): Complete technical documentation
+- [Built-in Scorers Source Code](https://github.com/mastra-ai/mastra/tree/main/packages/evals/src/scorers): Real implementations for reference

package/.docs/docs/mastra-platform/overview.md

@@ -1,6 +1,6 @@
 # Mastra platform
 
-The Mastra platform provides two products for deploying and managing AI applications built with the Mastra framework:
+The [Mastra platform](https://projects.mastra.ai) provides two products for deploying and managing AI applications built with the Mastra framework:
 
 - **Studio**: A hosted visual environment for testing agents, running workflows, and inspecting traces
 - **Server**: A production deployment target that runs your Mastra application as an API server

package/.docs/docs/memory/memory-processors.md

@@ -307,8 +307,8 @@ Both scenarios are safe - guardrails prevent inappropriate content from being pe
 
 ## Related documentation
 
-- [Processors](https://mastra.ai/docs/agents/processors) - General processor concepts and custom processor creation
-- [Guardrails](https://mastra.ai/docs/agents/guardrails) - Security and validation processors
-- [Memory Overview](https://mastra.ai/docs/memory/overview) - Memory types and configuration
+- [Processors](https://mastra.ai/docs/agents/processors): General processor concepts and custom processor creation
+- [Guardrails](https://mastra.ai/docs/agents/guardrails): Security and validation processors
+- [Memory Overview](https://mastra.ai/docs/memory/overview): Memory types and configuration
 
 When creating custom processors avoid mutating the input `messages` array or its objects directly.

package/.docs/docs/memory/message-history.md

@@ -100,8 +100,8 @@ await agent.stream('Hello', {
 
 You can use this history in two ways:
 
-- **Automatic inclusion** - Mastra automatically fetches and includes recent messages in the context window. By default, it includes the last 10 messages, keeping agents grounded in the conversation. You can adjust this number with `lastMessages`, but in most cases you don't need to think about it.
-- [**Manual querying**](#querying) - For more control, use the `recall()` function to query threads and messages directly. This lets you choose exactly which memories are included in the context window, or fetch messages to render conversation history in your UI.
+- **Automatic inclusion**: Mastra automatically fetches and includes recent messages in the context window. By default, it includes the last 10 messages, keeping agents grounded in the conversation. You can adjust this number with `lastMessages`, but in most cases you don't need to think about it.
+- [**Manual querying**](#querying): For more control, use the `recall()` function to query threads and messages directly. This lets you choose exactly which memories are included in the context window, or fetch messages to render conversation history in your UI.
 
 > **Tip:** When memory is enabled, [Studio](https://mastra.ai/docs/studio/overview) uses message history to display past conversations in the chat sidebar.
 

package/.docs/docs/memory/observational-memory.md

@@ -157,7 +157,7 @@ With retrieval mode enabled, OM:
 - Registers a `recall` tool the agent can call to:
 
   - Page through the raw messages behind any observation group range
-  - Search by semantic similarity (`mode: "search"` with a `query` string) — requires `vector: true`
+  - Search by semantic similarity (`mode: "search"` with a `query` string); requires `vector: true`
   - List all threads (`mode: "threads"`), browse other threads (`threadId`), and search across all threads (default `scope: 'resource'`)
   - When `scope: 'thread'`: restrict browsing and search to the current thread only
 

package/.docs/docs/memory/working-memory.md

@@ -397,4 +397,4 @@ const response = await agent.generate('What do you know about me?', {
 
 - [Working memory with template](https://github.com/mastra-ai/mastra/tree/main/examples/memory-with-template)
 - [Working memory with schema](https://github.com/mastra-ai/mastra/tree/main/examples/memory-with-schema)
-- [Per-resource working memory](https://github.com/mastra-ai/mastra/tree/main/examples/memory-per-resource-example) - Complete example showing resource-scoped memory persistence
+- [Per-resource working memory](https://github.com/mastra-ai/mastra/tree/main/examples/memory-per-resource-example): Complete example showing resource-scoped memory persistence

package/.docs/docs/observability/overview.md

@@ -83,7 +83,7 @@ export const mastra = new Mastra({
         serviceName: 'mastra',
         exporters: [
           new DefaultExporter(), // Persists traces to storage for Mastra Studio
-          new CloudExporter(), // Sends observability data to Mastra platform (if MASTRA_CLOUD_ACCESS_TOKEN is set)
+          new CloudExporter(), // Sends observability data to hosted Mastra Studio (if MASTRA_CLOUD_ACCESS_TOKEN is set)
         ],
         spanOutputProcessors: [
           new SensitiveDataFilter(), // Redacts sensitive data like passwords, tokens, keys

package/.docs/docs/observability/tracing/bridges/otel.md

@@ -205,5 +205,5 @@ If traces aren't displaying or connecting as expected:
 ## Related
 
 - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview)
-- [OpenTelemetry Exporter](https://mastra.ai/docs/observability/tracing/exporters/otel) - For sending traces to OTEL backends
-- [OtelBridge Reference](https://mastra.ai/reference/observability/tracing/bridges/otel) - API documentation
+- [OpenTelemetry Exporter](https://mastra.ai/docs/observability/tracing/exporters/otel): For sending traces to OTEL backends
+- [OtelBridge Reference](https://mastra.ai/reference/observability/tracing/bridges/otel): API documentation

package/.docs/docs/observability/tracing/exporters/cloud.md

@@ -16,7 +16,7 @@ mastra auth tokens create exporter-token
 
 This command prints a token secret that you can use as `MASTRA_CLOUD_ACCESS_TOKEN`.
 
-If you already have a Mastra Cloud access token, copy the **Observability** value from Mastra Cloud instead. You can find it in either of these places:
+If you already have an access token, copy the **Observability** value from the Mastra platform instead. You can find it in either of these places:
 
 - On the **Projects** page, open the project list and find the **Observability** row on the project card.
 - On the project **Overview** page, find the **Observability** row directly below the deployment URL.
@@ -59,7 +59,7 @@ MASTRA_PROJECT_ID=<your-project-id>
 
 Tokens created with `mastra auth tokens create` are organization-scoped, so `MASTRA_PROJECT_ID` is required.
 
-If you use a project-scoped token from Mastra Cloud instead, `CloudExporter` can route without `projectId`, but setting it explicitly is still supported.
+If you use a project-scoped token from the Mastra platform instead, `CloudExporter` can route without `projectId`, but setting it explicitly is still supported.
 
 Add both values to your environment:
 
@@ -130,7 +130,7 @@ If you prefer, rely entirely on environment variables:
 new CloudExporter()
 ```
 
-With `MASTRA_CLOUD_ACCESS_TOKEN` and `MASTRA_PROJECT_ID` set, `CloudExporter` automatically sends data to the correct Mastra Cloud project.
+With `MASTRA_CLOUD_ACCESS_TOKEN` and `MASTRA_PROJECT_ID` set, `CloudExporter` automatically sends data to the correct Mastra platform project.
 
 > **Note:** Visit [CloudExporter reference](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter) for the full list of configuration options.
 
@@ -175,9 +175,9 @@ new CloudExporter({
 })
 ```
 
-## Viewing data in Mastra Cloud
+## Viewing data in Mastra Studio
 
-After you enable `CloudExporter`, open your project in [Mastra Cloud](https://cloud.mastra.ai) to inspect the exported data.
+After you enable `CloudExporter`, open your project in [Mastra Studio](https://projects.mastra.ai) to inspect the exported data.
 
 - Open your project and select **Open Studio**.
 - In Studio, go to **Traces** to inspect agent and workflow traces.
@@ -187,7 +187,7 @@ After you enable `CloudExporter`, open your project in [Mastra Cloud](https://cl
 
 > **Note:** If you use a project-scoped token, open the project that issued the token. If you use an organization-scoped token, open the project named by `MASTRA_PROJECT_ID`.
 
-When you deploy with Mastra Cloud, set **Deployment → Service Name** to a stable value and keep it aligned with the `serviceName` in your observability config. This makes traces easier to filter in Studio through **Deployments → Service Name** when multiple services or deployments send data to the same project.
+When you deploy with Mastra Studio, set **Deployment → Service Name** to a stable value and keep it aligned with the `serviceName` in your observability config. This makes traces easier to filter in Studio through **Deployments → Service Name** when multiple services or deployments send data to the same project.
 
 ## Performance
 
@@ -198,7 +198,7 @@ When you deploy with Mastra Cloud, set **Deployment → Service Name** to a stab
 - Events are batched up to `maxBatchSize` (default: 1000).
 - Batches are sent when full or after `maxBatchWaitMs` (default: 5 seconds).
 - Failed batches are retried with exponential backoff.
-- The exporter degrades gracefully if Mastra Cloud is unreachable.
+- The exporter degrades gracefully if Mastra Studio is unreachable.
 
 ## Related
 

package/.docs/docs/observability/tracing/exporters/default.md

@@ -59,7 +59,7 @@ export const mastra = new Mastra({
         serviceName: 'mastra',
         exporters: [
           new DefaultExporter(), // Persists traces to storage for Studio
-          new CloudExporter(), // Sends observability data to Mastra platform (requires MASTRA_CLOUD_ACCESS_TOKEN)
+          new CloudExporter(), // Sends observability data to hosted Mastra Studio (requires MASTRA_CLOUD_ACCESS_TOKEN)
         ],
         spanOutputProcessors: [new SensitiveDataFilter()],
       },
@@ -203,5 +203,5 @@ new DefaultExporter({
 
 - [Tracing Overview](https://mastra.ai/docs/observability/tracing/overview)
 - [CloudExporter](https://mastra.ai/docs/observability/tracing/exporters/cloud)
-- [Composite Storage](https://mastra.ai/reference/storage/composite) - Combine multiple storage providers
+- [Composite Storage](https://mastra.ai/reference/storage/composite): Combine multiple storage providers
 - [Storage Configuration](https://mastra.ai/docs/memory/storage)

package/.docs/docs/observability/tracing/overview.md

@@ -32,7 +32,7 @@ export const mastra = new Mastra({
         serviceName: 'mastra',
         exporters: [
           new DefaultExporter(), // Persists traces to storage for Studio
-          new CloudExporter(), // Sends observability data to Mastra platform (if MASTRA_CLOUD_ACCESS_TOKEN is set)
+          new CloudExporter(), // Sends observability data to hosted Mastra Studio (if MASTRA_CLOUD_ACCESS_TOKEN is set)
         ],
         spanOutputProcessors: [
           new SensitiveDataFilter(), // Redacts sensitive data like passwords, tokens, keys
@@ -56,7 +56,7 @@ This configuration includes:
 - **Exporters**:
 
   - `DefaultExporter` - Persists traces to your configured storage for Studio
-  - `CloudExporter` - Sends observability data to Mastra platform (requires `MASTRA_CLOUD_ACCESS_TOKEN`)
+  - `CloudExporter` - Sends observability data to hosted Mastra Studio (requires `MASTRA_CLOUD_ACCESS_TOKEN`)
 
 - **Span Output Processors**: `SensitiveDataFilter` - Redacts sensitive fields
 
@@ -69,7 +69,7 @@ Exporters determine where your trace data is sent and how it's stored. They inte
 Mastra provides two built-in exporters:
 
 - **[Default](https://mastra.ai/docs/observability/tracing/exporters/default)** - Persists traces to local storage for viewing in Studio
-- **[Cloud](https://mastra.ai/docs/observability/tracing/exporters/cloud)** - Sends observability data to Mastra platform for production monitoring and collaboration
+- **[Cloud](https://mastra.ai/docs/observability/tracing/exporters/cloud)** - Sends observability data to hosted Mastra Studio for production monitoring and collaboration
 
 ### External Exporters
 
@@ -272,9 +272,9 @@ export const mastra = new Mastra({
 
 ### Common Configuration Patterns & Troubleshooting
 
-#### Maintaining Studio and Cloud Access
+#### Maintaining Studio access
 
-When adding external exporters, include `DefaultExporter` and `CloudExporter` to maintain access to Studio and Mastra Cloud:
+When adding external exporters, include `DefaultExporter` and `CloudExporter` to maintain access to Studio:
 
 ```ts
 import {
@@ -309,7 +309,7 @@ This configuration sends traces to all three destinations simultaneously:
 
 - **Arize Phoenix/AX** for external observability
 - **DefaultExporter** for Studio
-- **CloudExporter** for Mastra Cloud dashboard
+- **CloudExporter** for hosted Studio dashboard
 
 > **Info:** Remember: A single trace can be sent to multiple exporters. You don't need separate configs for each exporter unless you want different sampling rates or processors.
 
@@ -1131,27 +1131,27 @@ Mastra automatically creates spans for:
 
 ### Reference Documentation
 
-- [Configuration API](https://mastra.ai/reference/observability/tracing/configuration) - ObservabilityConfig details
-- [Tracing Classes](https://mastra.ai/reference/observability/tracing/instances) - Core classes and methods
-- [Span Interfaces](https://mastra.ai/reference/observability/tracing/spans) - Span types and lifecycle
-- [Type Definitions](https://mastra.ai/reference/observability/tracing/interfaces) - Complete interface reference
-- [Span filtering](https://mastra.ai/reference/observability/tracing/span-filtering) - Filtering behavior, span types, and examples
+- [Configuration API](https://mastra.ai/reference/observability/tracing/configuration): ObservabilityConfig details
+- [Tracing Classes](https://mastra.ai/reference/observability/tracing/instances): Core classes and methods
+- [Span Interfaces](https://mastra.ai/reference/observability/tracing/spans): Span types and lifecycle
+- [Type Definitions](https://mastra.ai/reference/observability/tracing/interfaces): Complete interface reference
+- [Span filtering](https://mastra.ai/reference/observability/tracing/span-filtering): Filtering behavior, span types, and examples
 
 ### Exporters
 
-- [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter) - Storage persistence
-- [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter) - Mastra Cloud integration
-- [ConsoleExporter](https://mastra.ai/reference/observability/tracing/exporters/console-exporter) - Debug output
-- [Arize](https://mastra.ai/reference/observability/tracing/exporters/arize) - Arize Phoenix and Arize AX integration
-- [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust) - Braintrust integration
-- [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse) - Langfuse integration
-- [MLflow](https://mastra.ai/docs/observability/tracing/exporters/otel) - MLflow OTLP endpoint setup
-- [OpenTelemetry](https://mastra.ai/reference/observability/tracing/exporters/otel) - OTEL-compatible platforms
+- [DefaultExporter](https://mastra.ai/reference/observability/tracing/exporters/default-exporter): Storage persistence
+- [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter): Mastra platform integration
+- [ConsoleExporter](https://mastra.ai/reference/observability/tracing/exporters/console-exporter): Debug output
+- [Arize](https://mastra.ai/reference/observability/tracing/exporters/arize): Arize Phoenix and Arize AX integration
+- [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust): Braintrust integration
+- [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse): Langfuse integration
+- [MLflow](https://mastra.ai/docs/observability/tracing/exporters/otel): MLflow OTLP endpoint setup
+- [OpenTelemetry](https://mastra.ai/reference/observability/tracing/exporters/otel): OTEL-compatible platforms
 
 ### Bridges
 
-- [OpenTelemetry Bridge](https://mastra.ai/reference/observability/tracing/bridges/otel) - OTEL context integration
+- [OpenTelemetry Bridge](https://mastra.ai/reference/observability/tracing/bridges/otel): OTEL context integration
 
 ### Processors
 
-- [Sensitive Data Filter](https://mastra.ai/docs/observability/tracing/processors/sensitive-data-filter) - Data redaction
+- [Sensitive Data Filter](https://mastra.ai/docs/observability/tracing/processors/sensitive-data-filter): Data redaction

package/.docs/docs/server/custom-adapters.md

@@ -373,8 +373,8 @@ app.listen(4111)
 
 ## Related
 
-- [Server Adapters](https://mastra.ai/docs/server/server-adapters) - Overview and shared concepts
-- [Hono Adapter](https://mastra.ai/reference/server/hono-adapter) - Reference implementation
-- [Express Adapter](https://mastra.ai/reference/server/express-adapter) - Reference implementation
-- [MastraServer Reference](https://mastra.ai/reference/server/mastra-server) - Full API reference
-- [createRoute() Reference](https://mastra.ai/reference/server/create-route) - Creating type-safe custom routes
+- [Server Adapters](https://mastra.ai/docs/server/server-adapters): Overview and shared concepts
+- [Hono Adapter](https://mastra.ai/reference/server/hono-adapter): Reference implementation
+- [Express Adapter](https://mastra.ai/reference/server/express-adapter): Reference implementation
+- [MastraServer Reference](https://mastra.ai/reference/server/mastra-server): Full API reference
+- [createRoute() Reference](https://mastra.ai/reference/server/create-route): Creating type-safe custom routes

package/.docs/docs/server/custom-api-routes.md

@@ -318,6 +318,6 @@ export const mastra = new Mastra({
 
 ## Related
 
-- [registerApiRoute() Reference](https://mastra.ai/reference/server/register-api-route) - Full API reference
-- [Server Middleware](https://mastra.ai/docs/server/middleware) - Global middleware configuration
-- [Mastra Server](https://mastra.ai/docs/server/mastra-server) - Server configuration options
+- [registerApiRoute() Reference](https://mastra.ai/reference/server/register-api-route): Full API reference
+- [Server Middleware](https://mastra.ai/docs/server/middleware): Global middleware configuration
+- [Mastra Server](https://mastra.ai/docs/server/mastra-server): Server configuration options

package/.docs/docs/server/middleware.md

@@ -235,30 +235,6 @@ This is useful when you want to restrict operations to a specific thread that yo
 }
 ```
 
-### Special Mastra headers
-
-When integrating with Mastra Cloud or custom clients the following headers can be inspected by middleware to tailor behavior:
-
-```typescript
-{
-  handler: async (c, next) => {
-    const isFromMastraCloud = c.req.header('x-mastra-cloud') === 'true';
-    const clientType = c.req.header('x-mastra-client-type');
-    const isStudio =
-      c.req.header('x-studio') === 'true';
-
-    if (isFromMastraCloud) {
-      // Special handling
-    }
-    await next();
-  },
-}
-```
-
-- `x-mastra-cloud`: request originates from Mastra Cloud
-- `x-mastra-client-type`: identifies the client SDK, e.g. `js` or `python`
-- `x-studio`: request triggered from Studio
-
 # Related
 
 - [Request Context](https://mastra.ai/docs/server/request-context)

package/.docs/docs/studio/observability.md

@@ -87,7 +87,7 @@ export const mastra = new Mastra({
         serviceName: 'mastra',
         exporters: [
           new DefaultExporter(), // Persists traces to storage for Mastra Studio
-          new CloudExporter(), // Sends observability data to Mastra platform (if MASTRA_CLOUD_ACCESS_TOKEN is set)
+          new CloudExporter(), // Sends observability data to hosted Mastra Studio (if MASTRA_CLOUD_ACCESS_TOKEN is set)
         ],
         spanOutputProcessors: [
           new SensitiveDataFilter(), // Redacts sensitive data like passwords, tokens, keys

package/.docs/docs/voice/speech-to-text.md

@@ -28,13 +28,13 @@ const voice = new OpenAIVoice()
 
 Mastra supports several Speech-to-Text providers, each with their own capabilities and strengths:
 
-- [**OpenAI**](https://mastra.ai/reference/voice/openai) - High-accuracy transcription with Whisper models
-- [**Azure**](https://mastra.ai/reference/voice/azure) - Microsoft's speech recognition with enterprise-grade reliability
-- [**ElevenLabs**](https://mastra.ai/reference/voice/elevenlabs) - Advanced speech recognition with support for multiple languages
-- [**Google**](https://mastra.ai/reference/voice/google) - Google's speech recognition with extensive language support
-- [**Cloudflare**](https://mastra.ai/reference/voice/cloudflare) - Edge-optimized speech recognition for low-latency applications
-- [**Deepgram**](https://mastra.ai/reference/voice/deepgram) - AI-powered speech recognition with high accuracy for various accents
-- [**Sarvam**](https://mastra.ai/reference/voice/sarvam) - Specialized in Indic languages and accents
+- [**OpenAI**](https://mastra.ai/reference/voice/openai): High-accuracy transcription with Whisper models
+- [**Azure**](https://mastra.ai/reference/voice/azure): Microsoft's speech recognition with enterprise-grade reliability
+- [**ElevenLabs**](https://mastra.ai/reference/voice/elevenlabs): Advanced speech recognition with support for multiple languages
+- [**Google**](https://mastra.ai/reference/voice/google): Google's speech recognition with extensive language support
+- [**Cloudflare**](https://mastra.ai/reference/voice/cloudflare): Edge-optimized speech recognition for low-latency applications
+- [**Deepgram**](https://mastra.ai/reference/voice/deepgram): AI-powered speech recognition with high accuracy for various accents
+- [**Sarvam**](https://mastra.ai/reference/voice/sarvam): Specialized in Indic languages and accents
 
 Each provider is implemented as a separate package that you can install as needed:
 

package/.docs/docs/voice/text-to-speech.md

@@ -33,16 +33,16 @@ const voice = new OpenAIVoice()
 
 Mastra supports a wide range of Text-to-Speech providers, each with their own unique capabilities and voice options. You can choose the provider that best suits your application's needs:
 
-- [**OpenAI**](https://mastra.ai/reference/voice/openai) - High-quality voices with natural intonation and expression
-- [**Azure**](https://mastra.ai/reference/voice/azure) - Microsoft's speech service with a wide range of voices and languages
-- [**ElevenLabs**](https://mastra.ai/reference/voice/elevenlabs) - Ultra-realistic voices with emotion and fine-grained control
-- [**PlayAI**](https://mastra.ai/reference/voice/playai) - Specialized in natural-sounding voices with various styles
-- [**Google**](https://mastra.ai/reference/voice/google) - Google's speech synthesis with multilingual support
-- [**Cloudflare**](https://mastra.ai/reference/voice/cloudflare) - Edge-optimized speech synthesis for low-latency applications
-- [**Deepgram**](https://mastra.ai/reference/voice/deepgram) - AI-powered speech technology with high accuracy
-- [**Speechify**](https://mastra.ai/reference/voice/speechify) - Text-to-speech optimized for readability and accessibility
-- [**Sarvam**](https://mastra.ai/reference/voice/sarvam) - Specialized in Indic languages and accents
-- [**Murf**](https://mastra.ai/reference/voice/murf) - Studio-quality voice overs with customizable parameters
+- [**OpenAI**](https://mastra.ai/reference/voice/openai): High-quality voices with natural intonation and expression
+- [**Azure**](https://mastra.ai/reference/voice/azure): Microsoft's speech service with a wide range of voices and languages
+- [**ElevenLabs**](https://mastra.ai/reference/voice/elevenlabs): Ultra-realistic voices with emotion and fine-grained control
+- [**PlayAI**](https://mastra.ai/reference/voice/playai): Specialized in natural-sounding voices with various styles
+- [**Google**](https://mastra.ai/reference/voice/google): Google's speech synthesis with multilingual support
+- [**Cloudflare**](https://mastra.ai/reference/voice/cloudflare): Edge-optimized speech synthesis for low-latency applications
+- [**Deepgram**](https://mastra.ai/reference/voice/deepgram): AI-powered speech technology with high accuracy
+- [**Speechify**](https://mastra.ai/reference/voice/speechify): Text-to-speech optimized for readability and accessibility
+- [**Sarvam**](https://mastra.ai/reference/voice/sarvam): Specialized in Indic languages and accents
+- [**Murf**](https://mastra.ai/reference/voice/murf): Studio-quality voice overs with customizable parameters
 
 Each provider is implemented as a separate package that you can install as needed:
 

package/.docs/docs/workspace/filesystem.md

@@ -18,10 +18,10 @@ A filesystem provider handles all file operations for a workspace:
 
 Available providers:
 
-- [`LocalFilesystem`](https://mastra.ai/reference/workspace/local-filesystem) - Stores files in a directory on disk
-- [`S3Filesystem`](https://mastra.ai/reference/workspace/s3-filesystem) - Stores files in Amazon S3 or S3-compatible storage (R2, MinIO)
-- [`GCSFilesystem`](https://mastra.ai/reference/workspace/gcs-filesystem) - Stores files in Google Cloud Storage
-- [`AgentFSFilesystem`](https://mastra.ai/reference/workspace/agentfs-filesystem) - Stores files in a Turso/SQLite database via AgentFS
+- [`LocalFilesystem`](https://mastra.ai/reference/workspace/local-filesystem): Stores files in a directory on disk
+- [`S3Filesystem`](https://mastra.ai/reference/workspace/s3-filesystem): Stores files in Amazon S3 or S3-compatible storage (R2, MinIO)
+- [`GCSFilesystem`](https://mastra.ai/reference/workspace/gcs-filesystem): Stores files in Google Cloud Storage
+- [`AgentFSFilesystem`](https://mastra.ai/reference/workspace/agentfs-filesystem): Stores files in a Turso/SQLite database via AgentFS
 
 > **Tip:** `LocalFilesystem` is the simplest way to get started as it requires no external services. For cloud storage, use `S3Filesystem` or `GCSFilesystem`. For database-backed storage without external services, use `AgentFSFilesystem`.
 

package/.docs/docs/workspace/skills.md

@@ -181,9 +181,9 @@ const workspace = new Workspace({
 
 `VersionedSkillSource` accepts three parameters:
 
-- **`versionTree`** (`SkillVersionTree`) — A manifest mapping relative file paths to blob entries (`{ entries: Record<string, { blobHash, size, mimeType?, encoding? }> }`).
-- **`blobStore`** (`BlobStore`) — A content-addressable blob store instance that holds the actual file contents referenced by hash.
-- **`versionCreatedAt`** (`Date`) — The timestamp when this skill version was published. Used as the modification time for all files in the version.
+- **`versionTree`** (`SkillVersionTree`): A manifest mapping relative file paths to blob entries (`{ entries: Record<string, { blobHash, size, mimeType?, encoding? }> }`).
+- **`blobStore`** (`BlobStore`): A content-addressable blob store instance that holds the actual file contents referenced by hash.
+- **`versionCreatedAt`** (`Date`): The timestamp when this skill version was published. Used as the modification time for all files in the version.
 
 When `skillSource` is provided, it's used instead of the workspace filesystem for skill discovery.
 

package/.docs/guides/agent-frameworks/ai-sdk.md

@@ -134,7 +134,7 @@ const { text } = await generateText({
 
 ## Related
 
-- [`withMastra()`](https://mastra.ai/reference/ai-sdk/with-mastra) - API reference for `withMastra()`
-- [Processors](https://mastra.ai/docs/agents/processors) - Learn about input and output processors
-- [Memory](https://mastra.ai/docs/memory/overview) - Overview of Mastra's memory system
-- [AI SDK UI](https://mastra.ai/guides/build-your-ui/ai-sdk-ui) - Using AI SDK UI hooks with Mastra agents, workflows, and networks
+- [`withMastra()`](https://mastra.ai/reference/ai-sdk/with-mastra): API reference for `withMastra()`
+- [Processors](https://mastra.ai/docs/agents/processors): Learn about input and output processors
+- [Memory](https://mastra.ai/docs/memory/overview): Overview of Mastra's memory system
+- [AI SDK UI](https://mastra.ai/guides/build-your-ui/ai-sdk-ui): Using AI SDK UI hooks with Mastra agents, workflows, and networks

package/.docs/guides/build-your-ui/ai-sdk-ui.md

@@ -865,10 +865,10 @@ Tools can also stream data using `context.writer.write()` for lower-level contro
 
 For live examples of Custom UI patterns, visit [Mastra's UI Dojo](https://ui-dojo.mastra.ai/). The repository includes implementations for:
 
-- [Generative UIs](https://github.com/mastra-ai/ui-dojo/blob/main/src/pages/ai-sdk/generative-user-interfaces.tsx) - Custom components for tool outputs
-- [Workflows](https://github.com/mastra-ai/ui-dojo/blob/main/src/pages/ai-sdk/workflow.tsx) - Workflow step visualization
-- [Agent Networks](https://github.com/mastra-ai/ui-dojo/blob/main/src/pages/ai-sdk/network.tsx) - Network execution display
-- [Custom Events](https://github.com/mastra-ai/ui-dojo/blob/main/src/pages/ai-sdk/generative-user-interfaces-with-custom-events.tsx) - Progress indicators with custom events
+- [Generative UIs](https://github.com/mastra-ai/ui-dojo/blob/main/src/pages/ai-sdk/generative-user-interfaces.tsx): Custom components for tool outputs
+- [Workflows](https://github.com/mastra-ai/ui-dojo/blob/main/src/pages/ai-sdk/workflow.tsx): Workflow step visualization
+- [Agent Networks](https://github.com/mastra-ai/ui-dojo/blob/main/src/pages/ai-sdk/network.tsx): Network execution display
+- [Custom Events](https://github.com/mastra-ai/ui-dojo/blob/main/src/pages/ai-sdk/generative-user-interfaces-with-custom-events.tsx): Progress indicators with custom events
 
 ## Recipes
 

package/.docs/guides/deployment/mastra-platform.md

@@ -46,13 +46,13 @@ bun add --global mastra
    mastra server deploy
    ```
 
-   If you're not already authenticated, the CLI will prompt you to log in. It'll store your credentials locally and any subsequent CLI commands will use these credentials.
+   If you're not already authenticated, the CLI prompts you to log in. It stores your credentials locally and any subsequent CLI commands use these credentials.
 
    The command runs `mastra build`, uploads the artifact, builds a Docker image, and deploys it to Railway. On first deploy, the CLI creates a `.mastra-project.json` file linking your local project to the platform. Commit this file so subsequent deploys and CI/CD target the same project.
 
    > **Note:** Environment variables from `.env`, `.env.local`, and `.env.production` are included automatically. On the first deploy, these seed the project if no env vars are set yet. After that, manage env vars through the web dashboard. Review and sanitize these files before first deploy to avoid uploading development-only or personal secrets.
 
-   See the [CLI reference](https://mastra.ai/reference/cli/mastra) for the full list of flags and CI/CD usage.
+   See the [CLI reference](https://mastra.ai/reference/cli/mastra) for the full list of flags.
 
 2. Verify your deployment at the URL printed by the CLI. Append `/api/agents` to confirm it returns a JSON list of your agents.
 
@@ -62,9 +62,128 @@ bun add --global mastra
 
 A deploy transitions through **queued → uploading → building → deploying → running** (or **failed**, **cancelled**, **crashed**, or **stopped**). Only one build runs per project at a time. If multiple deploys queue up, only the latest proceeds and the rest are cancelled. Builds running longer than 15 minutes are automatically failed. The first deploy provisions Railway infrastructure and seeds environment variables from your local `.env`. Your server URL remains stable across deploys.
 
+## CI/CD
+
+Automate deployments from GitHub Actions, GitLab CI, or any CI provider. After your first interactive deploy, CI/CD needs just two things: an API token and the `.mastra-project.json` file committed to your repository.
+
+### Create an API token
+
+1. Run the following command locally:
+
+   ```bash
+   mastra auth tokens create ci-deploy
+   ```
+
+   The CLI prints the token once. Copy it immediately — it cannot be retrieved again.
+
+2. Add the token as a secret in your CI provider. In GitHub Actions, go to **Settings → Secrets and variables → Actions** and create a secret named `MASTRA_API_TOKEN`.
+
+3. Ensure your `.mastra-project.json` file is committed to the repository. The CLI reads the `organizationId` and `projectId` from this file to target the correct project during CI deploys.
+
+### The `--yes` flag
+
+Pass `--yes` (or `-y`) to skip all confirmation prompts. Without it, the CLI waits for interactive input and your CI job hangs.
+
+```bash
+mastra server deploy --yes
+```
+
+### GitHub Actions
+
+The following workflow deploys on every push to `main`:
+
+```yaml
+name: Deploy to Mastra platform
+
+on:
+  push:
+    branches: [main]
+    paths: ['src/mastra/**']
+
+jobs:
+  deploy:
+    runs-on: ubuntu-latest
+    steps:
+      - uses: actions/checkout@v4
+      - uses: actions/setup-node@v4
+        with:
+          node-version: '22'
+          cache: 'npm'
+      - name: Install dependencies
+        run: npm install
+      - name: Deploy to Mastra platform
+        run: npx mastra server deploy --yes
+        env:
+          MASTRA_API_TOKEN: ${{ secrets.MASTRA_API_TOKEN }}
+```
+
+Adjust the `paths` filter and `working-directory` if your Mastra project is in a subdirectory (e.g. a monorepo).
+
+> **Note:** For Studio deploys, replace `mastra server deploy` with `mastra studio deploy`. The flags and environment variables are the same.
+
+### GitLab CI
+
+The following pipeline deploys on pushes to `main`:
+
+```yaml
+deploy:
+  image: node:22
+  stage: deploy
+  only:
+    - main
+  before_script:
+    - npm install
+  script:
+    - npx mastra server deploy --yes
+```
+
+Add `MASTRA_API_TOKEN` as a CI/CD variable in **Settings → CI/CD → Variables**.
+
+### Other CI providers
+
+Any CI system that runs Node.js and shell commands works with Mastra:
+
+1. Install dependencies.
+2. Set `MASTRA_API_TOKEN` as an environment variable.
+3. Run `mastra server deploy --yes` (or `mastra studio deploy --yes`).
+
+### Verify the deploy
+
+After the workflow completes, verify the deployment by hitting the health endpoint:
+
+```bash
+curl -f https://<your-project>.server.mastra.cloud/health
+```
+
+Or check the agents endpoint, which returns a JSON list of your agents:
+
+```bash
+curl -f https://<your-project>.server.mastra.cloud/api/agents
+```
+
+The following example adds a verification step to a GitHub Actions workflow:
+
+```yaml
+- name: Verify deployment
+  run: |
+    sleep 30
+    curl -f https://<your-project>.server.mastra.cloud/health
+```
+
+### Override project config with environment variables
+
+The CLI reads `organizationId` and `projectId` from `.mastra-project.json` by default. To override these values (e.g. deploying to a different project from the same repository), set the following environment variables:
+
+| Variable            | Description                                                |
+| ------------------- | ---------------------------------------------------------- |
+| `MASTRA_ORG_ID`     | Overrides the organization ID from `.mastra-project.json`. |
+| `MASTRA_PROJECT_ID` | Overrides the project ID from `.mastra-project.json`.      |
+
 ## Related
 
-- [CLI reference](https://mastra.ai/reference/cli/mastra)
+- [CLI reference: `mastra server deploy`](https://mastra.ai/reference/cli/mastra)
+- [CLI reference: `mastra studio deploy`](https://mastra.ai/reference/cli/mastra)
+- [CLI reference: `mastra auth tokens`](https://mastra.ai/reference/cli/mastra)
 - [Mastra platform overview](https://mastra.ai/docs/mastra-platform/overview)
 - [Studio deployment](https://mastra.ai/docs/studio/deployment)
 - [Deployment overview](https://mastra.ai/docs/deployment/overview)