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

package/.docs/raw/reference/observability/ai-tracing/configuration.mdx

@@ -1,9 +1,9 @@
 ---
-title: "Configuration | AI Tracing | Reference"
+title: "Reference: Configuration | Observability | Mastra Docs"
 description: AI Tracing configuration types and registry functions
 ---
 
-import { PropertiesTable } from "@/components/properties-table";
+import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # Configuration
 
@@ -91,10 +91,10 @@ interface TracingConfig {
 
 ```typescript
 type SamplingStrategy =
-  | { type: 'always' }
-  | { type: 'never' }
-  | { type: 'ratio', probability: number }
-  | { type: 'custom', sampler: (options?: TracingOptions) => boolean };
+  | { type: "always" }
+  | { type: "never" }
+  | { type: "ratio"; probability: number }
+  | { type: "custom"; sampler: (options?: TracingOptions) => boolean };
 ```
 
 ## ConfigSelector
@@ -102,7 +102,7 @@ type SamplingStrategy =
 ```typescript
 type ConfigSelector = (
   options: ConfigSelectorOptions,
-  availableConfigs: Map<string, AITracing>
+  availableConfigs: Map<string, AITracing>,
 ) => string | undefined;
 ```
 
@@ -120,7 +120,7 @@ interface ConfigSelectorOptions {
 ## setupAITracing
 
 ```typescript
-function setupAITracing(config: ObservabilityRegistryConfig): void
+function setupAITracing(config: ObservabilityRegistryConfig): void;
 ```
 
 Initializes AI tracing from configuration. Called automatically by Mastra constructor.
@@ -131,8 +131,8 @@ Initializes AI tracing from configuration. Called automatically by Mastra constr
 function registerAITracing(
   name: string,
   instance: AITracing,
-  isDefault?: boolean
-): void
+  isDefault?: boolean,
+): void;
 ```
 
 Registers a tracing config in the global registry.
@@ -140,7 +140,7 @@ Registers a tracing config in the global registry.
 ## getAITracing
 
 ```typescript
-function getAITracing(name: string): AITracing | undefined
+function getAITracing(name: string): AITracing | undefined;
 ```
 
 Retrieves a tracing config by name.
@@ -148,7 +148,7 @@ Retrieves a tracing config by name.
 ## getDefaultAITracing
 
 ```typescript
-function getDefaultAITracing(): AITracing | undefined
+function getDefaultAITracing(): AITracing | undefined;
 ```
 
 Returns the default tracing config.
@@ -157,8 +157,8 @@ Returns the default tracing config.
 
 ```typescript
 function getSelectedAITracing(
-  options: ConfigSelectorOptions
-): AITracing | undefined
+  options: ConfigSelectorOptions,
+): AITracing | undefined;
 ```
 
 Returns the tracing config selected by the config selector or default.
@@ -166,7 +166,7 @@ Returns the tracing config selected by the config selector or default.
 ## setSelector
 
 ```typescript
-function setSelector(selector: ConfigSelector): void
+function setSelector(selector: ConfigSelector): void;
 ```
 
 Sets the global config selector function.
@@ -174,7 +174,7 @@ Sets the global config selector function.
 ## unregisterAITracing
 
 ```typescript
-function unregisterAITracing(name: string): boolean
+function unregisterAITracing(name: string): boolean;
 ```
 
 Removes a tracing config from the registry.
@@ -182,7 +182,7 @@ Removes a tracing config from the registry.
 ## shutdownAITracingRegistry
 
 ```typescript
-async function shutdownAITracingRegistry(): Promise<void>
+async function shutdownAITracingRegistry(): Promise<void>;
 ```
 
 Shuts down all tracing configs and clears the registry.
@@ -190,7 +190,7 @@ Shuts down all tracing configs and clears the registry.
 ## clearAITracingRegistry
 
 ```typescript
-function clearAITracingRegistry(): void
+function clearAITracingRegistry(): void;
 ```
 
 Clears all configs without shutdown.
@@ -198,7 +198,7 @@ Clears all configs without shutdown.
 ## getAllAITracing
 
 ```typescript
-function getAllAITracing(): ReadonlyMap<string, AITracing>
+function getAllAITracing(): ReadonlyMap<string, AITracing>;
 ```
 
 Returns all registered tracing configs.
@@ -206,7 +206,7 @@ Returns all registered tracing configs.
 ## hasAITracing
 
 ```typescript
-function hasAITracing(name: string): boolean
+function hasAITracing(name: string): boolean;
 ```
 
 Checks if a tracing instance exists and is enabled.
@@ -214,21 +214,25 @@ Checks if a tracing instance exists and is enabled.
 ## See Also
 
 ### Documentation
+
 - [AI Tracing Overview](/docs/observability/ai-tracing/overview) - Concepts and usage guide
 - [Sampling Strategies](/docs/observability/ai-tracing/overview#sampling-strategies) - Sampling configuration details
 - [Multi-Config Setup](/docs/observability/ai-tracing/overview#multi-config-setup) - Using multiple configurations
 
 ### Reference
-- [AITracing Classes](/reference/observability/ai-tracing/ai-tracing) - Core tracing classes
+
+- [AITracing Classes](/reference/observability/ai-tracing/) - Core tracing classes
 - [Interfaces](/reference/observability/ai-tracing/interfaces) - Type definitions
 - [Span Reference](/reference/observability/ai-tracing/span) - Span lifecycle
 
 ### Examples
+
 - [Basic AI Tracing](/examples/observability/basic-ai-tracing) - Getting started
 
 ### Exporters
+
 - [DefaultExporter](/reference/observability/ai-tracing/exporters/default-exporter) - Storage configuration
 - [CloudExporter](/reference/observability/ai-tracing/exporters/cloud-exporter) - Cloud setup
 - [Braintrust](/reference/observability/ai-tracing/exporters/braintrust) - Braintrust integration
 - [Langfuse](/reference/observability/ai-tracing/exporters/langfuse) - Langfuse integration
-- [LangSmith](/reference/observability/ai-tracing/exporters/langsmith) - LangSmith integration
+- [LangSmith](/reference/observability/ai-tracing/exporters/langsmith) - LangSmith integration

package/.docs/raw/reference/observability/ai-tracing/exporters/arize.mdx

@@ -1,9 +1,9 @@
 ---
-title: "ArizeExporter | Exporters | AI Tracing | Reference"
+title: "Reference: ArizeExporter | Observability | Mastra Docs"
 description: Arize exporter for AI tracing using OpenInference
 ---
 
-import { PropertiesTable } from "@/components/properties-table";
+import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # ArizeExporter
 
@@ -33,7 +33,7 @@ interface ArizeExporterConfig {
   // Inherited from OtelExporterConfig
   timeout?: number;
   batchSize?: number;
-  logLevel?: 'debug' | 'info' | 'warn' | 'error';
+  logLevel?: "debug" | "info" | "warn" | "error";
   resourceAttributes?: Record<string, any>;
 }
 ```
@@ -43,19 +43,22 @@ interface ArizeExporterConfig {
     {
       name: "endpoint",
       type: "string",
-      description: "Collector endpoint for trace exports (e.g., 'http://localhost:6006/v1/traces' for Phoenix). Required for Phoenix. Optional for Arize AX (defaults to https://otlp.arize.com/v1/traces).",
+      description:
+        "Collector endpoint for trace exports (e.g., 'http://localhost:6006/v1/traces' for Phoenix). Required for Phoenix. Optional for Arize AX (defaults to https://otlp.arize.com/v1/traces).",
       required: false,
     },
     {
       name: "apiKey",
       type: "string",
-      description: "API key for authentication. Required for Phoenix Cloud and Arize AX. Optional for self-hosted Phoenix.",
+      description:
+        "API key for authentication. Required for Phoenix Cloud and Arize AX. Optional for self-hosted Phoenix.",
       required: false,
     },
     {
       name: "spaceId",
       type: "string",
-      description: "Arize AX space identifier. Required when sending traces to Arize AX.",
+      description:
+        "Arize AX space identifier. Required when sending traces to Arize AX.",
       required: false,
     },
     {
@@ -73,7 +76,8 @@ interface ArizeExporterConfig {
     {
       name: "timeout",
       type: "number",
-      description: "Timeout in milliseconds before exporting spans (default: 30000)",
+      description:
+        "Timeout in milliseconds before exporting spans (default: 30000)",
       required: false,
     },
     {
@@ -128,24 +132,24 @@ Flushes pending data and shuts down the client.
 ### Phoenix Configuration
 
 ```typescript
-import { ArizeExporter } from '@mastra/arize';
+import { ArizeExporter } from "@mastra/arize";
 
 const exporter = new ArizeExporter({
-  endpoint: 'http://localhost:6006/v1/traces',
+  endpoint: "http://localhost:6006/v1/traces",
   apiKey: process.env.PHOENIX_API_KEY, // Optional for local Phoenix
-  projectName: 'my-ai-project',
+  projectName: "my-ai-project",
 });
 ```
 
 ### Arize AX Configuration
 
 ```typescript
-import { ArizeExporter } from '@mastra/arize';
+import { ArizeExporter } from "@mastra/arize";
 
 const exporter = new ArizeExporter({
   spaceId: process.env.ARIZE_SPACE_ID!,
   apiKey: process.env.ARIZE_API_KEY!,
-  projectName: 'my-ai-project',
+  projectName: "my-ai-project",
 });
 ```
 

package/.docs/raw/reference/observability/ai-tracing/exporters/braintrust.mdx

@@ -1,9 +1,9 @@
 ---
-title: "BraintrustExporter | Exporters | AI Tracing | Reference"
+title: "Reference: BraintrustExporter | Observability | Mastra Docs"
 description: Braintrust exporter for AI tracing
 ---
 
-import { PropertiesTable } from "@/components/properties-table";
+import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # BraintrustExporter
 
@@ -22,7 +22,7 @@ interface BraintrustExporterConfig {
   apiKey?: string;
   endpoint?: string;
   projectName?: string;
-  logLevel?: 'debug' | 'info' | 'warn' | 'error';
+  logLevel?: "debug" | "info" | "warn" | "error";
   tuningParameters?: Record<string, any>;
 }
 ```
@@ -91,22 +91,22 @@ Flushes pending data and shuts down the client.
 ## Usage
 
 ```typescript
-import { BraintrustExporter } from '@mastra/braintrust';
+import { BraintrustExporter } from "@mastra/braintrust";
 
 const exporter = new BraintrustExporter({
   apiKey: process.env.BRAINTRUST_API_KEY,
-  projectName: 'my-ai-project',
+  projectName: "my-ai-project",
 });
 ```
 
 ## Span Type Mapping
 
-| AI Span Type | Braintrust Type |
-|--------------|-----------------|
-| `MODEL_GENERATION` | `llm` |
-| `MODEL_CHUNK` | `llm` |
-| `TOOL_CALL` | `tool` |
-| `MCP_TOOL_CALL` | `tool` |
-| `WORKFLOW_CONDITIONAL_EVAL` | `function` |
-| `WORKFLOW_WAIT_EVENT` | `function` |
-| All others | `task` |
+| AI Span Type                | Braintrust Type |
+| --------------------------- | --------------- |
+| `MODEL_GENERATION`          | `llm`           |
+| `MODEL_CHUNK`               | `llm`           |
+| `TOOL_CALL`                 | `tool`          |
+| `MCP_TOOL_CALL`             | `tool`          |
+| `WORKFLOW_CONDITIONAL_EVAL` | `function`      |
+| `WORKFLOW_WAIT_EVENT`       | `function`      |
+| All others                  | `task`          |

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

@@ -1,9 +1,9 @@
 ---
-title: "CloudExporter | Exporters | AI Tracing | Reference"
+title: "Reference: CloudExporter | Observability | Mastra Docs"
 description: API reference for the CloudExporter
 ---
 
-import { PropertiesTable } from "@/components/properties-table";
+import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # CloudExporter
 
@@ -32,19 +32,19 @@ new CloudExporter(config?: CloudExporterConfig)
 interface CloudExporterConfig {
   /** Maximum number of spans per batch. Default: 1000 */
   maxBatchSize?: number;
-  
+
   /** Maximum wait time before flushing in milliseconds. Default: 5000 */
   maxBatchWaitMs?: number;
-  
+
   /** Maximum retry attempts. Default: 3 */
   maxRetries?: number;
-  
+
   /** Cloud access token (from env or config) */
   accessToken?: string;
-  
+
   /** Cloud AI tracing endpoint */
   endpoint?: string;
-  
+
   /** Optional logger */
   logger?: IMastraLogger;
 }
@@ -97,12 +97,14 @@ Flushes remaining events and performs cleanup.
 ### Authentication
 
 If no access token is provided via config or environment variable, the exporter:
+
 - Logs a warning with sign-up information
 - Operates as a no-op (discards all events)
 
 ### Batching
 
 The exporter batches spans for efficient network usage:
+
 - Flushes when batch size reaches `maxBatchSize`
 - Flushes when `maxBatchWaitMs` elapsed since first span in batch
 - Flushes on `shutdown()`
@@ -146,31 +148,34 @@ interface MastraCloudSpanRecord {
 ## Usage
 
 ```typescript
-import { CloudExporter } from '@mastra/core/ai-tracing';
+import { CloudExporter } from "@mastra/core/ai-tracing";
 
 // Uses environment variable for token
 const exporter = new CloudExporter();
 
 // Explicit configuration
 const customExporter = new CloudExporter({
-  accessToken: 'your-token',
+  accessToken: "your-token",
   maxBatchSize: 500,
-  maxBatchWaitMs: 2000
+  maxBatchWaitMs: 2000,
 });
 ```
 
 ## See Also
 
 ### Documentation
+
 - [AI Tracing Overview](/docs/observability/ai-tracing/overview) - Complete guide
 - [Exporters](/docs/observability/ai-tracing/overview#exporters) - Exporter concepts
 
 ### Other Exporters
+
 - [DefaultExporter](/reference/observability/ai-tracing/exporters/default-exporter) - Storage persistence
 - [ConsoleExporter](/reference/observability/ai-tracing/exporters/console-exporter) - Debug output
 - [Langfuse](/reference/observability/ai-tracing/exporters/langfuse) - Langfuse integration
 - [Braintrust](/reference/observability/ai-tracing/exporters/braintrust) - Braintrust integration
 
 ### Reference
+
 - [Configuration](/reference/observability/ai-tracing/configuration) - Configuration options
-- [Interfaces](/reference/observability/ai-tracing/interfaces) - Type definitions
+- [Interfaces](/reference/observability/ai-tracing/interfaces) - Type definitions

package/.docs/raw/reference/observability/ai-tracing/exporters/console-exporter.mdx

@@ -1,9 +1,9 @@
 ---
-title: "ConsoleExporter | Exporters | AI Tracing | Reference"
+title: "Reference: ConsoleExporter | Observability | Mastra Docs"
 description: API reference for the ConsoleExporter
 ---
 
-import { PropertiesTable } from "@/components/properties-table";
+import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # ConsoleExporter
 
@@ -20,7 +20,8 @@ new ConsoleExporter(logger?: IMastraLogger)
     {
       name: "logger",
       type: "IMastraLogger",
-      description: "Logger instance to use. Falls back to ConsoleLogger with INFO level if not provided",
+      description:
+        "Logger instance to use. Falls back to ConsoleLogger with INFO level if not provided",
       required: false,
     },
   ]}
@@ -112,8 +113,8 @@ The exporter outputs different formats based on event type:
 ## Usage
 
 ```typescript
-import { ConsoleExporter } from '@mastra/core/ai-tracing';
-import { ConsoleLogger, LogLevel } from '@mastra/core/logger';
+import { ConsoleExporter } from "@mastra/core/ai-tracing";
+import { ConsoleLogger, LogLevel } from "@mastra/core/logger";
 
 // Use default logger (INFO level)
 const exporter = new ConsoleExporter();
@@ -134,15 +135,18 @@ const exporterWithLogger = new ConsoleExporter(customLogger);
 ## See Also
 
 ### Documentation
+
 - [AI Tracing Overview](/docs/observability/ai-tracing/overview) - Complete guide
 - [Exporters](/docs/observability/ai-tracing/overview#exporters) - Exporter concepts
 
 ### Other Exporters
+
 - [DefaultExporter](/reference/observability/ai-tracing/exporters/default-exporter) - Storage persistence
 - [CloudExporter](/reference/observability/ai-tracing/exporters/cloud-exporter) - Mastra Cloud
 - [Langfuse](/reference/observability/ai-tracing/exporters/langfuse) - Langfuse integration
 - [Braintrust](/reference/observability/ai-tracing/exporters/braintrust) - Braintrust integration
 
 ### Reference
+
 - [Configuration](/reference/observability/ai-tracing/configuration) - Configuration options
-- [Interfaces](/reference/observability/ai-tracing/interfaces) - Type definitions
+- [Interfaces](/reference/observability/ai-tracing/interfaces) - Type definitions

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

@@ -1,9 +1,9 @@
 ---
-title: "DefaultExporter | Exporters | AI Tracing | Reference"
+title: "Reference: DefaultExporter | Observability | Mastra Docs"
 description: API reference for the DefaultExporter
 ---
 
-import { PropertiesTable } from "@/components/properties-table";
+import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # DefaultExporter
 
@@ -26,7 +26,8 @@ new DefaultExporter(config?: BatchingConfig, logger?: IMastraLogger)
     {
       name: "logger",
       type: "IMastraLogger",
-      description: "Logger instance. Falls back to ConsoleLogger with INFO level if not provided",
+      description:
+        "Logger instance. Falls back to ConsoleLogger with INFO level if not provided",
       required: false,
     },
   ]}
@@ -38,28 +39,28 @@ new DefaultExporter(config?: BatchingConfig, logger?: IMastraLogger)
 interface BatchingConfig {
   /** Maximum number of spans per batch. Default: 1000 */
   maxBatchSize?: number;
-  
+
   /** Maximum total buffer size before emergency flush. Default: 10000 */
   maxBufferSize?: number;
-  
+
   /** Maximum time to wait before flushing batch in milliseconds. Default: 5000 */
   maxBatchWaitMs?: number;
-  
+
   /** Maximum number of retry attempts. Default: 4 */
   maxRetries?: number;
-  
+
   /** Base retry delay in milliseconds (uses exponential backoff). Default: 500 */
   retryDelayMs?: number;
-  
+
   /** Tracing strategy or 'auto' for automatic selection. Default: 'auto' */
-  strategy?: TracingStrategy | 'auto';
+  strategy?: TracingStrategy | "auto";
 }
 ```
 
 ## TracingStrategy
 
 ```typescript
-type TracingStrategy = 'realtime' | 'batch-with-updates' | 'insert-only';
+type TracingStrategy = "realtime" | "batch-with-updates" | "insert-only";
 ```
 
 ### Strategy Behaviors
@@ -76,7 +77,7 @@ readonly name = 'tracing-default-exporter';
 
 ## Methods
 
-### __registerMastra
+### \_\_registerMastra
 
 ```typescript
 __registerMastra(mastra: Mastra): void
@@ -127,13 +128,14 @@ When `strategy: 'auto'` (default), the exporter queries the storage adapter for
 interface AITracingStrategy {
   /** Strategies supported by this adapter */
   supported: TracingStrategy[];
-  
+
   /** Preferred strategy for optimal performance */
   preferred: TracingStrategy;
 }
 ```
 
 The exporter will:
+
 1. Use the storage adapter's preferred strategy if available
 2. Fall back to the first supported strategy if preferred isn't available
 3. Log a warning if a user-specified strategy isn't supported
@@ -143,6 +145,7 @@ The exporter will:
 ### Flush Triggers
 
 The buffer flushes when any of these conditions are met:
+
 - Buffer size reaches `maxBatchSize`
 - Time since first buffered event exceeds `maxBatchWaitMs`
 - Buffer size reaches `maxBufferSize` (emergency flush)
@@ -151,6 +154,7 @@ The buffer flushes when any of these conditions are met:
 ### Retry Logic
 
 Failed flushes are retried with exponential backoff:
+
 - Retry delay: `retryDelayMs * 2^attempt`
 - Maximum attempts: `maxRetries`
 - Batch is dropped after all retries fail
@@ -158,6 +162,7 @@ Failed flushes are retried with exponential backoff:
 ### Out-of-Order Handling
 
 For `batch-with-updates` strategy:
+
 - Tracks which spans have been created
 - Rejects updates/ends for spans not yet created
 - Logs warnings for out-of-order events
@@ -166,7 +171,7 @@ For `batch-with-updates` strategy:
 ## Usage
 
 ```typescript
-import { DefaultExporter } from '@mastra/core/ai-tracing';
+import { DefaultExporter } from "@mastra/core/ai-tracing";
 
 // Default configuration
 const exporter = new DefaultExporter();
@@ -175,22 +180,25 @@ const exporter = new DefaultExporter();
 const customExporter = new DefaultExporter({
   maxBatchSize: 500,
   maxBatchWaitMs: 2000,
-  strategy: 'batch-with-updates'
+  strategy: "batch-with-updates",
 });
 ```
 
 ## See Also
 
 ### Documentation
+
 - [AI Tracing Overview](/docs/observability/ai-tracing/overview) - Complete guide
 - [Exporters](/docs/observability/ai-tracing/overview#exporters) - Exporter concepts
 
 ### Other Exporters
+
 - [CloudExporter](/reference/observability/ai-tracing/exporters/cloud-exporter) - Mastra Cloud
 - [ConsoleExporter](/reference/observability/ai-tracing/exporters/console-exporter) - Debug output
 - [Langfuse](/reference/observability/ai-tracing/exporters/langfuse) - Langfuse integration
 - [Braintrust](/reference/observability/ai-tracing/exporters/braintrust) - Braintrust integration
 
 ### Reference
+
 - [Configuration](/reference/observability/ai-tracing/configuration) - Configuration options
-- [Interfaces](/reference/observability/ai-tracing/interfaces) - Type definitions
+- [Interfaces](/reference/observability/ai-tracing/interfaces) - Type definitions

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

@@ -1,9 +1,9 @@
 ---
-title: "LangfuseExporter | Exporters | AI Tracing | Reference"
+title: "Reference: LangfuseExporter | Observability | Mastra Docs"
 description: Langfuse exporter for AI tracing
 ---
 
-import { PropertiesTable } from "@/components/properties-table";
+import PropertiesTable from "@site/src/components/PropertiesTable";
 
 # LangfuseExporter
 
@@ -23,7 +23,7 @@ interface LangfuseExporterConfig {
   secretKey?: string;
   baseUrl?: string;
   realtime?: boolean;
-  logLevel?: 'debug' | 'info' | 'warn' | 'error';
+  logLevel?: "debug" | "info" | "warn" | "error";
   options?: any;
 }
 ```
@@ -98,12 +98,12 @@ Flushes pending data and shuts down the client.
 ## Usage
 
 ```typescript
-import { LangfuseExporter } from '@mastra/langfuse';
+import { LangfuseExporter } from "@mastra/langfuse";
 
 const exporter = new LangfuseExporter({
   publicKey: process.env.LANGFUSE_PUBLIC_KEY,
   secretKey: process.env.LANGFUSE_SECRET_KEY,
-  baseUrl: 'https://cloud.langfuse.com',
+  baseUrl: "https://cloud.langfuse.com",
   realtime: true,
 });
 ```
@@ -113,4 +113,4 @@ const exporter = new LangfuseExporter({
 - Root spans → Langfuse traces
 - `MODEL_GENERATION` spans → Langfuse generations
 - All other spans → Langfuse spans
-- Event spans → Langfuse events
+- Event spans → Langfuse events