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

package/.docs/raw/observability/ai-tracing/exporters/cloud.mdx

@@ -3,8 +3,6 @@ title: "Cloud Exporter | AI Tracing | Observability | Mastra Docs"
 description: "Send traces to Mastra Cloud for production monitoring"
 ---
 
-import { Callout } from "nextra/components";
-
 # Cloud Exporter
 
 The `CloudExporter` sends traces to Mastra Cloud for centralized monitoring and team collaboration. It's automatically enabled when using the default observability configuration with a valid access token.
@@ -12,6 +10,7 @@ The `CloudExporter` sends traces to Mastra Cloud for centralized monitoring and
 ## When to Use CloudExporter
 
 CloudExporter is ideal for:
+
 - **Production monitoring** - Centralized trace visualization
 - **Team collaboration** - Share traces across your organization
 - **Advanced analytics** - Insights and performance metrics
@@ -25,13 +24,13 @@ CloudExporter is ideal for:
 2. **Access Token**: Generate in Mastra Cloud → Settings → API Tokens
 3. **Environment Variables**: Set your credentials:
 
-```bash filename=".env"
+```bash title=".env"
 MASTRA_CLOUD_ACCESS_TOKEN=mst_xxxxxxxxxxxxxxxx
 ```
 
 ### Basic Setup
 
-```typescript filename="src/mastra/index.ts"
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { CloudExporter } from "@mastra/core/ai-tracing";
 
@@ -39,9 +38,9 @@ export const mastra = new Mastra({
   observability: {
     configs: {
       production: {
-        serviceName: 'my-service',
+        serviceName: "my-service",
         exporters: [
-          new CloudExporter(),  // Uses MASTRA_CLOUD_ACCESS_TOKEN env var
+          new CloudExporter(), // Uses MASTRA_CLOUD_ACCESS_TOKEN env var
         ],
       },
     },
@@ -56,7 +55,7 @@ When using the default observability configuration, CloudExporter is automatical
 ```typescript
 export const mastra = new Mastra({
   observability: {
-    default: { enabled: true },  // Automatically includes CloudExporter if token exists
+    default: { enabled: true }, // Automatically includes CloudExporter if token exists
   },
 });
 ```
@@ -69,15 +68,15 @@ new CloudExporter({
   accessToken: process.env.MASTRA_CLOUD_ACCESS_TOKEN,
 
   // Optional - for self-hosted Mastra Cloud
-  endpoint: 'https://cloud.your-domain.com',
+  endpoint: "https://cloud.your-domain.com",
 
   // Batching configuration
-  maxBatchSize: 1000,     // Max spans per batch
-  maxBatchWaitMs: 5000,   // Max wait before sending batch
+  maxBatchSize: 1000, // Max spans per batch
+  maxBatchWaitMs: 5000, // Max wait before sending batch
 
   // Diagnostic logging
-  logLevel: 'info',  // debug | info | warn | error
-})
+  logLevel: "info", // debug | info | warn | error
+});
 ```
 
 ## Viewing Traces
@@ -102,9 +101,11 @@ new CloudExporter({
 
 ## Performance
 
-<Callout type="info">
-  CloudExporter uses intelligent batching to optimize network usage. Traces are buffered and sent in batches, reducing overhead while maintaining near real-time visibility.
-</Callout>
+:::info
+
+CloudExporter uses intelligent batching to optimize network usage. Traces are buffered and sent in batches, reducing overhead while maintaining near real-time visibility.
+
+:::
 
 ### Batching Behavior
 
@@ -117,4 +118,4 @@ new CloudExporter({
 
 - [AI Tracing Overview](/docs/observability/ai-tracing/overview)
 - [DefaultExporter](/docs/observability/ai-tracing/exporters/default)
-- [Mastra Cloud Documentation](https://cloud.mastra.ai/docs)
+- [Mastra Cloud Documentation](https://cloud.mastra.ai/docs)

package/.docs/raw/observability/ai-tracing/exporters/default.mdx

@@ -5,41 +5,40 @@ description: "Store traces locally for development and debugging"
 
 # Default Exporter
 
-The `DefaultExporter` persists traces to your configured storage backend, making them accessible through the Mastra Playground. It's automatically enabled when using the default observability configuration and requires no external services.
+The `DefaultExporter` persists traces to your configured storage backend, making them accessible through Studio. It's automatically enabled when using the default observability configuration and requires no external services.
 
 ## When to Use DefaultExporter
 
 DefaultExporter is ideal for:
+
 - **Local development** - Debug and analyze traces offline
 - **Data ownership** - Complete control over your trace data
 - **Zero dependencies** - No external services required
-- **Playground integration** - View traces in Mastra Playground UI
+- **Studio integration** - View traces in Studio
 
 ## Configuration
 
 ### Prerequisites
 
 1. **Storage Backend**: Configure a storage provider (LibSQL, PostgreSQL, etc.)
-2. **Mastra Playground**: Install for viewing traces locally
+2. **Studio**: Install for viewing traces locally
 
 ### Basic Setup
 
-```typescript filename="src/mastra/index.ts"
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { DefaultExporter } from "@mastra/core/ai-tracing";
 import { LibSQLStore } from "@mastra/libsql";
 
 export const mastra = new Mastra({
   storage: new LibSQLStore({
-    url: "file:./mastra.db",  // Required for trace persistence
+    url: "file:./mastra.db", // Required for trace persistence
   }),
   observability: {
     configs: {
       local: {
-        serviceName: 'my-service',
-        exporters: [
-          new DefaultExporter(),
-        ],
+        serviceName: "my-service",
+        exporters: [new DefaultExporter()],
       },
     },
   },
@@ -56,18 +55,18 @@ export const mastra = new Mastra({
     url: "file:./mastra.db",
   }),
   observability: {
-    default: { enabled: true },  // Automatically includes DefaultExporter
+    default: { enabled: true }, // Automatically includes DefaultExporter
   },
 });
 ```
 
 ## Viewing Traces
 
-### Mastra Playground
+### Studio
 
-Access your traces through the local Playground:
+Access your traces through Studio:
 
-1. Start the Playground
+1. Start Studio
 2. Navigate to Observability
 3. Filter and search your local traces
 4. Inspect detailed span information
@@ -78,25 +77,25 @@ DefaultExporter automatically selects the optimal tracing strategy based on your
 
 ### Available Strategies
 
-| Strategy | Description | Use Case |
-|----------|-------------|----------|
-| **realtime** | Process each event immediately | Development, debugging, low traffic |
-| **batch-with-updates** | Buffer events and batch write with full lifecycle support | Low volume Production |
-| **insert-only** | Only process completed spans, ignore updates | High volume Production |
+| Strategy               | Description                                               | Use Case                            |
+| ---------------------- | --------------------------------------------------------- | ----------------------------------- |
+| **realtime**           | Process each event immediately                            | Development, debugging, low traffic |
+| **batch-with-updates** | Buffer events and batch write with full lifecycle support | Low volume Production               |
+| **insert-only**        | Only process completed spans, ignore updates              | High volume Production              |
 
 ### Strategy Configuration
 
 ```typescript
 new DefaultExporter({
-  strategy: 'auto',  // Default - let storage provider decide
+  strategy: "auto", // Default - let storage provider decide
   // or explicitly set:
   // strategy: 'realtime' | 'batch-with-updates' | 'insert-only'
 
   // Batching configuration (applies to both batch-with-updates and insert-only)
-  maxBatchSize: 1000,      // Max spans per batch
-  maxBatchWaitMs: 5000,    // Max wait before flushing
-  maxBufferSize: 10000,    // Max spans to buffer
-})
+  maxBatchSize: 1000, // Max spans per batch
+  maxBatchWaitMs: 5000, // Max wait before flushing
+  maxBufferSize: 10000, // Max spans to buffer
+});
 ```
 
 ## Storage Provider Support
@@ -105,10 +104,10 @@ Different storage providers support different tracing strategies.
 
 If you set the strategy to `'auto'`, the `DefaultExporter` automatically selects the optimal strategy for the storage provider. If you set the strategy to a mode that the storage provider doesn't support, you will get an error message.
 
-| Storage Provider | Preferred Strategy | Supported Strategies | Notes |
-|-----------------|-------------------|---------------------|--------|
-| **[LibSQL](/reference/storage/libsql)** | batch-with-updates | realtime, batch-with-updates, insert-only | Default storage, good for development |
-| **[PostgreSQL](/reference/storage/postgresql)** | batch-with-updates | batch-with-updates, insert-only | Recommended for production |
+| Storage Provider                                | Preferred Strategy | Supported Strategies                      | Notes                                 |
+| ----------------------------------------------- | ------------------ | ----------------------------------------- | ------------------------------------- |
+| **[LibSQL](/reference/storage/libsql)**         | batch-with-updates | realtime, batch-with-updates, insert-only | Default storage, good for development |
+| **[PostgreSQL](/reference/storage/postgresql)** | batch-with-updates | batch-with-updates, insert-only           | Recommended for production            |
 
 ### Strategy Benefits
 
@@ -140,29 +139,29 @@ The DefaultExporter includes robust error handling for production use:
 
 ```typescript
 // Zero config - recommended for most users
-new DefaultExporter()
+new DefaultExporter();
 
 // Development override
 new DefaultExporter({
-  strategy: 'realtime',  // Immediate visibility for debugging
-})
+  strategy: "realtime", // Immediate visibility for debugging
+});
 
 // High-throughput production
 new DefaultExporter({
-  maxBatchSize: 2000,      // Larger batches
-  maxBatchWaitMs: 10000,   // Wait longer to fill batches
-  maxBufferSize: 50000,    // Handle longer outages
-})
+  maxBatchSize: 2000, // Larger batches
+  maxBatchWaitMs: 10000, // Wait longer to fill batches
+  maxBufferSize: 50000, // Handle longer outages
+});
 
 // Low-latency production
 new DefaultExporter({
-  maxBatchSize: 100,       // Smaller batches
-  maxBatchWaitMs: 1000,    // Flush quickly
-})
+  maxBatchSize: 100, // Smaller batches
+  maxBatchWaitMs: 1000, // Flush quickly
+});
 ```
 
 ## Related
 
 - [AI Tracing Overview](/docs/observability/ai-tracing/overview)
 - [CloudExporter](/docs/observability/ai-tracing/exporters/cloud)
-- [Storage Configuration](/docs/storage/overview)
+- [Storage Configuration](/docs/server-db/storage)

package/.docs/raw/observability/ai-tracing/exporters/langfuse.mdx

@@ -3,8 +3,6 @@ title: "Langfuse Exporter | AI Tracing | Observability | Mastra Docs"
 description: "Send AI traces to Langfuse for LLM observability and analytics"
 ---
 
-import { Callout } from "nextra/components";
-
 # Langfuse Exporter
 
 [Langfuse](https://langfuse.com/) is an open-source observability platform specifically designed for LLM applications. The Langfuse exporter sends your AI traces to Langfuse, providing detailed insights into model performance, token usage, and conversation flows.
@@ -12,6 +10,7 @@ import { Callout } from "nextra/components";
 ## When to Use Langfuse
 
 Langfuse is ideal when you need:
+
 - **LLM-specific analytics** - Token usage, costs, latency breakdown
 - **Conversation tracking** - Session-based trace grouping
 - **Quality scoring** - Manual and automated evaluation scores
@@ -32,7 +31,7 @@ npm install @mastra/langfuse
 2. **API Keys**: Create public/secret key pair in Langfuse Settings → API Keys
 3. **Environment Variables**: Set your credentials
 
-```bash filename=".env"
+```bash title=".env"
 LANGFUSE_PUBLIC_KEY=pk-lf-xxxxxxxxxxxx
 LANGFUSE_SECRET_KEY=sk-lf-xxxxxxxxxxxx
 LANGFUSE_BASE_URL=https://cloud.langfuse.com  # Or your self-hosted URL
@@ -40,7 +39,7 @@ LANGFUSE_BASE_URL=https://cloud.langfuse.com  # Or your self-hosted URL
 
 ### Basic Setup
 
-```typescript filename="src/mastra/index.ts"
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { LangfuseExporter } from "@mastra/langfuse";
 
@@ -48,7 +47,7 @@ export const mastra = new Mastra({
   observability: {
     configs: {
       langfuse: {
-        serviceName: 'my-service',
+        serviceName: "my-service",
         exporters: [
           new LangfuseExporter({
             publicKey: process.env.LANGFUSE_PUBLIC_KEY!,
@@ -72,25 +71,27 @@ export const mastra = new Mastra({
 The Langfuse exporter supports two modes for sending traces:
 
 #### Realtime Mode (Development)
+
 Traces appear immediately in Langfuse dashboard, ideal for debugging:
 
 ```typescript
 new LangfuseExporter({
   publicKey: process.env.LANGFUSE_PUBLIC_KEY!,
   secretKey: process.env.LANGFUSE_SECRET_KEY!,
-  realtime: true,  // Flush after each event
-})
+  realtime: true, // Flush after each event
+});
 ```
 
 #### Batch Mode (Production)
+
 Better performance with automatic batching:
 
 ```typescript
 new LangfuseExporter({
   publicKey: process.env.LANGFUSE_PUBLIC_KEY!,
   secretKey: process.env.LANGFUSE_SECRET_KEY!,
-  realtime: false,  // Default - batch traces
-})
+  realtime: false, // Default - batch traces
+});
 ```
 
 ### Complete Configuration
@@ -102,20 +103,20 @@ new LangfuseExporter({
   secretKey: process.env.LANGFUSE_SECRET_KEY!,
 
   // Optional settings
-  baseUrl: process.env.LANGFUSE_BASE_URL,     // Default: https://cloud.langfuse.com
-  realtime: process.env.NODE_ENV === 'development',  // Dynamic mode selection
-  logLevel: 'info',  // Diagnostic logging: debug | info | warn | error
+  baseUrl: process.env.LANGFUSE_BASE_URL, // Default: https://cloud.langfuse.com
+  realtime: process.env.NODE_ENV === "development", // Dynamic mode selection
+  logLevel: "info", // Diagnostic logging: debug | info | warn | error
 
   // Langfuse-specific options
   options: {
-    environment: process.env.NODE_ENV,        // Shows in UI for filtering
-    version: process.env.APP_VERSION,         // Track different versions
-    release: process.env.GIT_COMMIT,          // Git commit hash
+    environment: process.env.NODE_ENV, // Shows in UI for filtering
+    version: process.env.APP_VERSION, // Track different versions
+    release: process.env.GIT_COMMIT, // Git commit hash
   },
-})
+});
 ```
 
 ## Related
 
 - [AI Tracing Overview](/docs/observability/ai-tracing/overview)
-- [Langfuse Documentation](https://langfuse.com/docs)
+- [Langfuse Documentation](https://langfuse.com/docs)

package/.docs/raw/observability/ai-tracing/exporters/langsmith.mdx

@@ -3,8 +3,6 @@ title: "LangSmith Exporter | AI Tracing | Observability | Mastra Docs"
 description: "Send AI traces to LangSmith for LLM observability and evaluation"
 ---
 
-import { Callout } from "nextra/components";
-
 # LangSmith Exporter
 
 [LangSmith](https://smith.langchain.com/) is LangChain's platform for monitoring and evaluating LLM applications. The LangSmith exporter sends your AI traces to LangSmith, providing insights into model performance, debugging capabilities, and evaluation workflows.
@@ -12,6 +10,7 @@ import { Callout } from "nextra/components";
 ## When to Use LangSmith
 
 LangSmith is ideal when you need:
+
 - **LangChain ecosystem integration** - Native support for LangChain applications
 - **Debugging and testing** - Detailed trace visualization and replay
 - **Evaluation pipelines** - Built-in evaluation and dataset management
@@ -32,14 +31,14 @@ npm install @mastra/langsmith
 2. **API Key**: Generate an API key in LangSmith Settings → API Keys
 3. **Environment Variables**: Set your credentials
 
-```bash filename=".env"
+```bash title=".env"
 LANGSMITH_API_KEY=ls-xxxxxxxxxxxx
 LANGSMITH_BASE_URL=https://api.smith.langchain.com  # Optional for self-hosted
 ```
 
 ### Basic Setup
 
-```typescript filename="src/mastra/index.ts"
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { LangSmithExporter } from "@mastra/langsmith";
 
@@ -47,7 +46,7 @@ export const mastra = new Mastra({
   observability: {
     configs: {
       langsmith: {
-        serviceName: 'my-service',
+        serviceName: "my-service",
         exporters: [
           new LangSmithExporter({
             apiKey: process.env.LANGSMITH_API_KEY,
@@ -69,20 +68,21 @@ new LangSmithExporter({
   apiKey: process.env.LANGSMITH_API_KEY!,
 
   // Optional settings
-  apiUrl: process.env.LANGSMITH_BASE_URL,       // Default: https://api.smith.langchain.com
-  callerOptions: {                              // HTTP client options
-    timeout: 30000,                             // Request timeout in ms
-    maxRetries: 3,                              // Retry attempts
+  apiUrl: process.env.LANGSMITH_BASE_URL, // Default: https://api.smith.langchain.com
+  callerOptions: {
+    // HTTP client options
+    timeout: 30000, // Request timeout in ms
+    maxRetries: 3, // Retry attempts
   },
-  logLevel: 'info',                             // Diagnostic logging: debug | info | warn | error
+  logLevel: "info", // Diagnostic logging: debug | info | warn | error
 
   // LangSmith-specific options
-  hideInputs: false,                            // Hide input data in UI
-  hideOutputs: false,                           // Hide output data in UI
-})
+  hideInputs: false, // Hide input data in UI
+  hideOutputs: false, // Hide output data in UI
+});
 ```
 
 ## Related
 
 - [AI Tracing Overview](/docs/observability/ai-tracing/overview)
-- [LangSmith Documentation](https://docs.smith.langchain.com/)
+- [LangSmith Documentation](https://docs.smith.langchain.com/)