@mastra/mcp-docs-server 1.1.23-alpha.0 → 1.1.23-alpha.3

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

@@ -660,6 +660,50 @@ Processors are executed in the order they're defined, allowing you to chain mult
 - Normalizing data formats
 - Enriching spans with business context
 
+## Span filtering
+
+Span filtering lets you reduce noise and per-span costs before data reaches your observability platform. Configure it per observability instance, so different exporters or environments can keep different levels of detail.
+
+- Use `excludeSpanTypes` to drop entire categories of spans with minimal configuration.
+- Use `spanFilter` when you need custom logic based on the exported span data.
+
+The following example demonstrates how to combine both options in a single config:
+
+```ts
+import { Mastra } from '@mastra/core'
+import { SpanType } from '@mastra/core/observability'
+import { Observability, DefaultExporter } from '@mastra/observability'
+import { LangfuseExporter } from '@mastra/langfuse'
+
+export const mastra = new Mastra({
+  observability: new Observability({
+    configs: {
+      default: {
+        serviceName: 'my-app',
+        exporters: [new DefaultExporter(), new LangfuseExporter()],
+        excludeSpanTypes: [SpanType.MODEL_CHUNK, SpanType.MODEL_STEP],
+        spanFilter: span => {
+          if (span.type === SpanType.TOOL_CALL && span.attributes?.success) {
+            return false
+          }
+
+          return true
+        },
+      },
+    },
+  }),
+})
+```
+
+Filtering happens at export time in this order:
+
+1. Internal spans are dropped unless `includeInternalSpans` is `true`.
+2. `excludeSpanTypes` removes matching span types.
+3. `spanOutputProcessors` transform the remaining spans.
+4. `spanFilter` decides whether to keep the final exported span.
+
+If `spanFilter` throws, Mastra keeps the span and logs the error to avoid silent data loss. For the full span type list and more examples, see the [Span filtering reference](https://mastra.ai/reference/observability/tracing/span-filtering).
+
 ### Custom Span Formatters
 
 Custom span formatters transform how spans appear in specific observability platforms. Unlike span processors, formatters are configured per-exporter, allowing different formatting for different destinations. Formatters support both synchronous and asynchronous operations.
@@ -1091,6 +1135,7 @@ Mastra automatically creates spans for:
 - [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
 

package/.docs/models/gateways/openrouter.md

@@ -1,6 +1,6 @@
 # ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter
 
-OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 170 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 171 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -203,4 +203,5 @@ ANTHROPIC_API_KEY=ant-...
 | `z-ai/glm-4.7`                                                  |
 | `z-ai/glm-4.7-flash`                                            |
 | `z-ai/glm-5`                                                    |
-| `z-ai/glm-5-turbo`                                              |
+| `z-ai/glm-5-turbo`                                              |
+| `z-ai/glm-5.1`                                                  |

package/.docs/models/index.md

@@ -1,6 +1,6 @@
 # Model Providers
 
-Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 3605 models from 98 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 3614 models from 99 providers through a single API.
 
 ## Features
 

package/.docs/models/providers/huggingface.md

@@ -1,6 +1,6 @@
 # ![Hugging Face logo](https://models.dev/logos/huggingface.svg)Hugging Face
 
-Access 20 Hugging Face models through Mastra's model router. Authentication is handled automatically using the `HF_TOKEN` environment variable.
+Access 21 Hugging Face models through Mastra's model router. Authentication is handled automatically using the `HF_TOKEN` environment variable.
 
 Learn more in the [Hugging Face documentation](https://huggingface.co).
 
@@ -54,6 +54,7 @@ for await (const chunk of stream) {
 | `huggingface/zai-org/GLM-4.7`                     | 205K    |       |           |       |       |       | $0.60      | $2          |
 | `huggingface/zai-org/GLM-4.7-Flash`               | 200K    |       |           |       |       |       | —          | —           |
 | `huggingface/zai-org/GLM-5`                       | 203K    |       |           |       |       |       | $1         | $3          |
+| `huggingface/zai-org/GLM-5.1`                     | 203K    |       |           |       |       |       | $1         | $3          |
 
 ## Advanced configuration
 
@@ -83,7 +84,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "huggingface/zai-org/GLM-5"
+      ? "huggingface/zai-org/GLM-5.1"
       : "huggingface/MiniMaxAI/MiniMax-M2.1";
   }
 });

package/.docs/models/providers/mixlayer.md

@@ -0,0 +1,75 @@
+# ![Mixlayer logo](https://models.dev/logos/mixlayer.svg)Mixlayer
+
+Access 5 Mixlayer models through Mastra's model router. Authentication is handled automatically using the `MIXLAYER_API_KEY` environment variable.
+
+Learn more in the [Mixlayer documentation](https://docs.mixlayer.com).
+
+```bash
+MIXLAYER_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "mixlayer/qwen/qwen3.5-122b-a10b"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Mixlayer documentation](https://docs.mixlayer.com) for details.
+
+## Models
+
+| Model                             | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| --------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `mixlayer/qwen/qwen3.5-122b-a10b` | 262K    |       |           |       |       |       | $0.40      | $3          |
+| `mixlayer/qwen/qwen3.5-27b`       | 262K    |       |           |       |       |       | $0.30      | $2          |
+| `mixlayer/qwen/qwen3.5-35b-a3b`   | 262K    |       |           |       |       |       | $0.25      | $1          |
+| `mixlayer/qwen/qwen3.5-397b-a17b` | 262K    |       |           |       |       |       | $0.60      | $4          |
+| `mixlayer/qwen/qwen3.5-9b`        | 262K    |       |           |       |       |       | $0.10      | $0.40       |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://models.mixlayer.ai/v1",
+    id: "mixlayer/qwen/qwen3.5-122b-a10b",
+    apiKey: process.env.MIXLAYER_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "mixlayer/qwen/qwen3.5-9b"
+      : "mixlayer/qwen/qwen3.5-122b-a10b";
+  }
+});
+```

package/.docs/models/providers/ollama-cloud.md

@@ -1,6 +1,6 @@
 # ![Ollama Cloud logo](https://models.dev/logos/ollama-cloud.svg)Ollama Cloud
 
-Access 34 Ollama Cloud models through Mastra's model router. Authentication is handled automatically using the `OLLAMA_API_KEY` environment variable.
+Access 35 Ollama Cloud models through Mastra's model router. Authentication is handled automatically using the `OLLAMA_API_KEY` environment variable.
 
 Learn more in the [Ollama Cloud documentation](https://docs.ollama.com/cloud).
 
@@ -46,6 +46,7 @@ for await (const chunk of stream) {
 | `ollama-cloud/glm-4.6`                | 203K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/glm-4.7`                | 203K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/glm-5`                  | 203K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/glm-5.1`                | 203K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/gpt-oss:120b`           | 131K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/gpt-oss:20b`            | 131K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/kimi-k2-thinking`       | 262K    |       |           |       |       |       | —          | —           |

package/.docs/models/providers/stepfun.md

@@ -1,6 +1,6 @@
 # ![StepFun logo](https://models.dev/logos/stepfun.svg)StepFun
 
-Access 3 StepFun models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
+Access 4 StepFun models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
 
 Learn more in the [StepFun documentation](https://platform.stepfun.com/docs/zh/overview/concept).
 
@@ -32,11 +32,12 @@ for await (const chunk of stream) {
 
 ## Models
 
-| Model                    | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `stepfun/step-1-32k`     | 33K     |       |           |       |       |       | $2         | $10         |
-| `stepfun/step-2-16k`     | 16K     |       |           |       |       |       | $5         | $16         |
-| `stepfun/step-3.5-flash` | 256K    |       |           |       |       |       | $0.10      | $0.29       |
+| Model                         | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ----------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `stepfun/step-1-32k`          | 33K     |       |           |       |       |       | $2         | $10         |
+| `stepfun/step-2-16k`          | 16K     |       |           |       |       |       | $5         | $16         |
+| `stepfun/step-3.5-flash`      | 256K    |       |           |       |       |       | $0.10      | $0.29       |
+| `stepfun/step-3.5-flash-2603` | 256K    |       |           |       |       |       | $0.10      | $0.30       |
 
 ## Advanced configuration
 
@@ -66,7 +67,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "stepfun/step-3.5-flash"
+      ? "stepfun/step-3.5-flash-2603"
       : "stepfun/step-1-32k";
   }
 });

package/.docs/models/providers.md

@@ -52,6 +52,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [MiniMax (minimaxi.com)](https://mastra.ai/models/providers/minimax-cn)
 - [MiniMax Coding Plan (minimax.io)](https://mastra.ai/models/providers/minimax-coding-plan)
 - [MiniMax Coding Plan (minimaxi.com)](https://mastra.ai/models/providers/minimax-cn-coding-plan)
+- [Mixlayer](https://mastra.ai/models/providers/mixlayer)
 - [Moark](https://mastra.ai/models/providers/moark)
 - [ModelScope](https://mastra.ai/models/providers/modelscope)
 - [Moonshot AI](https://mastra.ai/models/providers/moonshotai)

package/.docs/reference/ai-sdk/to-ai-sdk-messages.md

@@ -0,0 +1,95 @@
+# toAISdkMessages()
+
+Converts messages from various input formats to AI SDK UI message format. `toAISdkMessages()` keeps the existing AI SDK v5/default behavior. If your app is typed against AI SDK v6, pass `version: 'v6'`.
+
+`version: 'v6'` uses the MessageList AI SDK v6 UI output path. MessageList input detection and ingestion remain unchanged.
+
+## Usage example
+
+```typescript
+import { toAISdkMessages } from '@mastra/ai-sdk/ui'
+import { useChat } from 'ai/react'
+
+// Stored messages from your database, memory, or API
+const storedMessages = [
+  { id: '1', role: 'user', content: 'Hello', parts: [{ type: 'text', text: 'Hello' }] },
+  {
+    id: '2',
+    role: 'assistant',
+    content: 'Hi there!',
+    parts: [{ type: 'text', text: 'Hi there!' }],
+  },
+]
+
+export default function Chat() {
+  const { messages } = useChat({
+    initialMessages: toAISdkMessages(storedMessages, { version: 'v6' }),
+  })
+
+  return (
+    <div>
+      {messages.map(message => (
+        <div key={message.id}>
+          {message.role}: {message.parts.map(part => (part.type === 'text' ? part.text : null))}
+        </div>
+      ))}
+    </div>
+  )
+}
+```
+
+## Parameters
+
+**messages** (`MessageListInput`): Messages to convert. Can be a string, array of strings, a single message object, or an array of message objects in any supported format.
+
+**options.version** (`'v5' | 'v6'`): Selects the AI SDK message type to return. Omit it or pass \`'v5'\` for the existing default behavior. Pass \`'v6'\` when your app is typed against AI SDK v6 \`useChat()\` message types.
+
+## Returns
+
+Returns an array of AI SDK `UIMessage` objects typed for the selected version.
+
+**id** (`string`): Unique message identifier.
+
+**role** (`'user' | 'assistant' | 'system'`): The role of the message sender.
+
+**parts** (`UIMessagePart[]`): Array of UI parts including text, tool results, files, reasoning, sources, and step markers.
+
+**metadata** (`Record<string, unknown>`): Optional metadata including createdAt, threadId, resourceId, and custom fields.
+
+## Examples
+
+### Using the default AI SDK v5 types
+
+```typescript
+import { toAISdkMessages } from '@mastra/ai-sdk/ui'
+
+const messages = toAISdkMessages(['Hello', 'How can I help you today?'])
+```
+
+### Returning AI SDK v6 message types
+
+```typescript
+import { toAISdkMessages } from '@mastra/ai-sdk/ui'
+
+const messages = toAISdkMessages(['Hello', 'How can I help you today?'], {
+  version: 'v6',
+})
+```
+
+### Loading messages with Mastra client
+
+```typescript
+import { MastraClient } from '@mastra/client-js'
+import { toAISdkMessages } from '@mastra/ai-sdk/ui'
+
+const client = new MastraClient()
+
+const { messages } = await client.listThreadMessages('thread-id', { agentId: 'myAgent' })
+const uiMessages = toAISdkMessages(messages)
+```
+
+## Related
+
+- [`toAISdkStream()`](https://mastra.ai/reference/ai-sdk/to-ai-sdk-stream)
+- [`toAISdkV5Messages()`](https://mastra.ai/reference/ai-sdk/to-ai-sdk-v5-messages)
+- [`toAISdkV4Messages()`](https://mastra.ai/reference/ai-sdk/to-ai-sdk-v4-messages)

package/.docs/reference/index.md

@@ -26,6 +26,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [handleNetworkStream()](https://mastra.ai/reference/ai-sdk/handle-network-stream)
 - [handleWorkflowStream()](https://mastra.ai/reference/ai-sdk/handle-workflow-stream)
 - [networkRoute()](https://mastra.ai/reference/ai-sdk/network-route)
+- [toAISdkMessages()](https://mastra.ai/reference/ai-sdk/to-ai-sdk-messages)
 - [toAISdkStream()](https://mastra.ai/reference/ai-sdk/to-ai-sdk-stream)
 - [toAISdkV4Messages()](https://mastra.ai/reference/ai-sdk/to-ai-sdk-v4-messages)
 - [toAISdkV5Messages()](https://mastra.ai/reference/ai-sdk/to-ai-sdk-v5-messages)
@@ -150,6 +151,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [Configuration](https://mastra.ai/reference/observability/tracing/configuration)
 - [Instances](https://mastra.ai/reference/observability/tracing/instances)
 - [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces)
+- [Span filtering](https://mastra.ai/reference/observability/tracing/span-filtering)
 - [Spans](https://mastra.ai/reference/observability/tracing/spans)
 - [BatchPartsProcessor](https://mastra.ai/reference/processors/batch-parts-processor)
 - [LanguageDetector](https://mastra.ai/reference/processors/language-detector)

package/.docs/reference/observability/tracing/configuration.md

@@ -26,6 +26,8 @@ interface ObservabilityInstanceConfig {
   exporters?: ObservabilityExporter[]
   spanOutputProcessors?: SpanOutputProcessor[]
   includeInternalSpans?: boolean
+  excludeSpanTypes?: SpanType[]
+  spanFilter?: (span: AnyExportedSpan) => boolean
   requestContextKeys?: string[]
   serializationOptions?: SerializationOptions
   logging?: { enabled?: boolean; level?: LogLevel }
@@ -44,6 +46,10 @@ interface ObservabilityInstanceConfig {
 
 **includeInternalSpans** (`boolean`): Include spans internal to Mastra operations
 
+**excludeSpanTypes** (`SpanType[]`): Span types to exclude from export. Useful for reducing noise and costs in per-span billing platforms. See the \[Span filtering reference]\(/reference/observability/tracing/span-filtering) for details.
+
+**spanFilter** (`(span: AnyExportedSpan) => boolean`): Filter function to control which spans are exported. Return true to keep, false to drop. Runs after excludeSpanTypes and spanOutputProcessors. See the \[Span filtering reference]\(/reference/observability/tracing/span-filtering) for details.
+
 **requestContextKeys** (`string[]`): RequestContext keys to extract as metadata (supports dot notation)
 
 **serializationOptions** (`SerializationOptions`): Options for controlling serialization of span data (input/output/attributes)
@@ -199,4 +205,5 @@ Shuts down all observability instances and clears the registry.
 - [CloudExporter](https://mastra.ai/reference/observability/tracing/exporters/cloud-exporter) - Cloud setup
 - [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust) - Braintrust integration
 - [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse) - Langfuse integration
-- [LangSmith](https://mastra.ai/reference/observability/tracing/exporters/langsmith) - LangSmith integration
+- [LangSmith](https://mastra.ai/reference/observability/tracing/exporters/langsmith) - LangSmith integration
+- [Span filtering](https://mastra.ai/reference/observability/tracing/span-filtering) - Selectively exclude spans

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

@@ -1,6 +1,6 @@
 # CloudExporter
 
-Sends traces to Mastra Cloud for online visualization and monitoring.
+Sends tracing spans, logs, metrics, scores, and feedback to Mastra Cloud for online visualization and monitoring.
 
 ## Constructor
 
@@ -24,8 +24,11 @@ interface CloudExporterConfig extends BaseExporterConfig {
   /** Cloud access token (from env or config) */
   accessToken?: string
 
-  /** Cloud observability endpoint */
+  /** Base cloud observability endpoint */
   endpoint?: string
+
+  /** Explicit cloud traces endpoint override */
+  tracesEndpoint?: string
 }
 ```
 
@@ -39,7 +42,7 @@ Extends `BaseExporterConfig`, which includes:
 The exporter reads these environment variables if not provided in config:
 
 - `MASTRA_CLOUD_ACCESS_TOKEN` - Project-scoped access token for authentication (generate in your Mastra Cloud project under **Project Settings → Access Tokens**)
-- `MASTRA_CLOUD_TRACES_ENDPOINT` - Custom endpoint (defaults to `https://api.mastra.ai/ai/spans/publish`)
+- `MASTRA_CLOUD_TRACES_ENDPOINT` - Base cloud endpoint (defaults to `https://api.mastra.ai`)
 
 ## Properties
 
@@ -55,7 +58,59 @@ readonly name = 'mastra-cloud-observability-exporter';
 async exportTracingEvent(event: TracingEvent): Promise<void>
 ```
 
-Processes tracing events. Only exports SPAN\_ENDED events to Cloud.
+Processes tracing events for Cloud export.
+
+Only `SPAN_ENDED` tracing events are exported. `SPAN_STARTED` and `SPAN_UPDATED` are ignored. Matching spans are buffered and uploaded to the Cloud traces endpoint on the next flush.
+
+**Returns:** `Promise<void>` after the tracing event has been accepted for buffering or ignored.
+
+### `onLogEvent`
+
+```typescript
+async onLogEvent(event: LogEvent): Promise<void>
+```
+
+Processes log signals for Cloud export.
+
+Every `LogEvent` passed to this handler is buffered and exported to the Cloud logs endpoint derived from the configured base endpoint. Unlike tracing, there is no additional event-status filtering at the `CloudExporter` level. If the exporter is disabled, this method becomes a no-op.
+
+**Returns:** `Promise<void>` after the log event has been accepted for buffering.
+
+### `onMetricEvent`
+
+```typescript
+async onMetricEvent(event: MetricEvent): Promise<void>
+```
+
+Processes metric signals for Cloud export.
+
+Every `MetricEvent` passed to this handler is buffered and exported to the Cloud metrics endpoint derived from the configured base endpoint. There is no additional filtering by metric subtype or status inside `CloudExporter`; the exporter forwards every metric event it receives unless it is disabled.
+
+**Returns:** `Promise<void>` after the metric event has been accepted for buffering.
+
+### `onScoreEvent`
+
+```typescript
+async onScoreEvent(event: ScoreEvent): Promise<void>
+```
+
+Processes score signals for Cloud export.
+
+Every `ScoreEvent` passed to this handler is buffered and exported to the Cloud scores endpoint derived from the configured base endpoint. There is no extra filtering at the exporter layer beyond the disabled-exporter check, so all score events received by this method are forwarded.
+
+**Returns:** `Promise<void>` after the score event has been accepted for buffering.
+
+### `onFeedbackEvent`
+
+```typescript
+async onFeedbackEvent(event: FeedbackEvent): Promise<void>
+```
+
+Processes feedback signals for Cloud export.
+
+Every `FeedbackEvent` passed to this handler is buffered and exported to the Cloud feedback endpoint derived from the configured base endpoint. There is no feedback-type filtering inside `CloudExporter`; all feedback events received here are forwarded unless the exporter is disabled.
+
+**Returns:** `Promise<void>` after the feedback event has been accepted for buffering.
 
 ### flush
 
@@ -84,10 +139,10 @@ If no access token is provided via config or environment variable, the exporter:
 
 ### Batching
 
-The exporter batches spans for efficient network usage:
+The exporter batches tracing spans, logs, metrics, scores, and feedback for efficient network usage:
 
-- Flushes when batch size reaches `maxBatchSize`
-- Flushes when `maxBatchWaitMs` elapsed since first span in batch
+- Flushes when total buffered event count reaches `maxBatchSize`
+- Flushes when `maxBatchWaitMs` elapsed since the first buffered signal in the batch
 - Flushes on `shutdown()`
 
 ### Error handling
@@ -96,11 +151,11 @@ The exporter batches spans for efficient network usage:
 - Drops batches after all retries fail
 - Logs errors but continues processing new events
 
-### Event Processing
+### Signal Processing
 
-- Only processes `SPAN_ENDED` events
-- Ignores `SPAN_STARTED` and `SPAN_UPDATED` events
-- Formats spans to MastraCloudSpanRecord format
+- `exportTracingEvent()` only exports `SPAN_ENDED` tracing events
+- `onLogEvent()`, `onMetricEvent()`, `onScoreEvent()`, and `onFeedbackEvent()` buffer every event they receive for their respective signal type
+- All supported signal batches are uploaded to their matching Cloud publish endpoints during `flush()` and `shutdown()`
 
 ## `MastraCloudSpanRecord`
 

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

@@ -0,0 +1,95 @@
+# Span filtering
+
+Span filtering controls which spans are exported from an observability config. Use it to reduce noise, lower per-span costs, or keep only the spans that matter for a specific exporter or environment.
+
+For a shorter overview of tracing configuration, see [Tracing](https://mastra.ai/docs/observability/tracing/overview).
+
+## Usage example
+
+The following example demonstrates how to combine `excludeSpanTypes` and `spanFilter` in one observability config:
+
+```ts
+import { Mastra } from '@mastra/core'
+import { SpanType } from '@mastra/core/observability'
+import { Observability, DefaultExporter } from '@mastra/observability'
+import { LangfuseExporter } from '@mastra/langfuse'
+
+export const mastra = new Mastra({
+  observability: new Observability({
+    configs: {
+      default: {
+        serviceName: 'my-app',
+        exporters: [new DefaultExporter(), new LangfuseExporter()],
+        excludeSpanTypes: [SpanType.MODEL_CHUNK, SpanType.MODEL_STEP],
+        spanFilter: span => {
+          if (span.type === SpanType.TOOL_CALL && span.attributes?.success) {
+            return false
+          }
+
+          return true
+        },
+      },
+    },
+  }),
+})
+```
+
+## Configuration options
+
+**excludeSpanTypes** (`SpanType[]`): Drops spans by type before processors and spanFilter run. Use this for broad, low-overhead filtering.
+
+**spanFilter** (`(span: AnyExportedSpan) => boolean`): Receives the exported span and returns true to keep it or false to drop it. Use this when filtering depends on attributes, metadata, timing, or entity identifiers.
+
+### `excludeSpanTypes`
+
+Use `excludeSpanTypes` when you want to suppress whole categories of spans with minimal configuration.
+
+For the current set of supported values, see the [`SpanType` enum](https://github.com/mastra-ai/mastra/blob/main/packages/core/src/observability/types/tracing.ts).
+
+```ts
+import { SpanType } from '@mastra/core/observability'
+
+excludeSpanTypes: [SpanType.MODEL_CHUNK, SpanType.MODEL_STEP, SpanType.WORKFLOW_SLEEP]
+```
+
+### `spanFilter`
+
+When filtering depends on the exported span contents, use `spanFilter`.
+
+```ts
+import { SpanType } from '@mastra/core/observability'
+
+spanFilter: span => {
+  if (span.type === SpanType.MODEL_CHUNK) return false
+  if (span.type === SpanType.TOOL_CALL && span.attributes?.success) return false
+
+  return true
+}
+```
+
+Additional examples:
+
+```ts
+// Only export spans from production
+spanFilter: span => span.metadata?.environment === 'production'
+
+// Exclude spans from a specific entity
+spanFilter: span => span.entityId !== 'noisy-agent'
+```
+
+## Processing order
+
+Span filtering happens at export time in this order:
+
+1. Internal spans are dropped unless `includeInternalSpans` is `true`.
+2. `excludeSpanTypes` removes matching span types.
+3. `spanOutputProcessors` transform the remaining spans.
+4. `spanFilter` decides whether to keep the final exported span.
+
+If `spanFilter` throws an error, Mastra keeps the span and logs the error to avoid silent data loss.
+
+## Related
+
+- [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/tracing/processors/sensitive-data-filter) for redacting span data

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @mastra/mcp-docs-server
 
+## 1.1.23-alpha.3
+
+### Patch Changes
+
+- Updated dependencies [[`8db7663`](https://github.com/mastra-ai/mastra/commit/8db7663c9a9c735828094c359d2e327fd4f8fba3), [`715710d`](https://github.com/mastra-ai/mastra/commit/715710d12fa47cf88e09d41f13843eddc29327b0), [`378c6c4`](https://github.com/mastra-ai/mastra/commit/378c6c4755726e8d8cf83a14809b350b90d46c62), [`9f91fd5`](https://github.com/mastra-ai/mastra/commit/9f91fd538ab2a44f8cc740bcad8e51205f74fbea), [`ba6fa9c`](https://github.com/mastra-ai/mastra/commit/ba6fa9cc0f3e1912c49fd70d4c3bb8c44903ddaa)]:
+  - @mastra/core@1.24.0-alpha.1
+
+## 1.1.23-alpha.1
+
+### Patch Changes
+
+- Updated dependencies [[`153e864`](https://github.com/mastra-ai/mastra/commit/153e86476b425db7cd0dc8490050096e92964a38), [`98209a0`](https://github.com/mastra-ai/mastra/commit/98209a03c35c5479c25cca26ee0c63eff81e6d74)]:
+  - @mastra/core@1.23.1-alpha.0
+  - @mastra/mcp@1.4.2-alpha.0
+
 ## 1.1.22
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.23-alpha.0",
+  "version": "1.1.23-alpha.3",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,8 +29,8 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.3.6",
-    "@mastra/core": "1.23.0",
-    "@mastra/mcp": "^1.4.1"
+    "@mastra/core": "1.24.0-alpha.1",
+    "@mastra/mcp": "^1.4.2-alpha.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -47,8 +47,8 @@
     "typescript": "^5.9.3",
     "vitest": "4.0.18",
     "@internal/lint": "0.0.80",
-    "@internal/types-builder": "0.0.55",
-    "@mastra/core": "1.23.0"
+    "@mastra/core": "1.24.0-alpha.1",
+    "@internal/types-builder": "0.0.55"
   },
   "homepage": "https://mastra.ai",
   "repository": {