@mastra/mcp-docs-server 1.1.17 → 1.1.18-alpha.4

package/.docs/models/providers/zenmux.md

@@ -1,6 +1,6 @@
 # ![ZenMux logo](https://models.dev/logos/zenmux.svg)ZenMux
 
-Access 86 ZenMux models through Mastra's model router. Authentication is handled automatically using the `ZENMUX_API_KEY` environment variable.
+Access 85 ZenMux models through Mastra's model router. Authentication is handled automatically using the `ZENMUX_API_KEY` environment variable.
 
 Learn more in the [ZenMux documentation](https://docs.zenmux.ai).
 
@@ -52,7 +52,6 @@ for await (const chunk of stream) {
 | `zenmux/google/gemini-2.5-flash-lite`         | 1.0M    |       |           |       |       |       | $0.10      | $0.40       |
 | `zenmux/google/gemini-2.5-pro`                | 1.0M    |       |           |       |       |       | $1         | $10         |
 | `zenmux/google/gemini-3-flash-preview`        | 1.0M    |       |           |       |       |       | $0.50      | $3          |
-| `zenmux/google/gemini-3-pro-image-preview`    | 1.0M    |       |           |       |       |       | $2         | $12         |
 | `zenmux/google/gemini-3-pro-preview`          | 1.0M    |       |           |       |       |       | $2         | $12         |
 | `zenmux/google/gemini-3.1-flash-lite-preview` | 1.1M    |       |           |       |       |       | $0.25      | $2          |
 | `zenmux/google/gemini-3.1-pro-preview`        | 1.0M    |       |           |       |       |       | $2         | $12         |
@@ -130,7 +129,7 @@ const agent = new Agent({
   id: "custom-agent",
   name: "custom-agent",
   model: {
-    url: "https://zenmux.ai/api/anthropic/v1",
+    url: "https://zenmux.ai/api/v1",
     id: "zenmux/anthropic/claude-3.5-haiku",
     apiKey: process.env.ZENMUX_API_KEY,
     headers: {
@@ -153,32 +152,4 @@ const agent = new Agent({
       : "zenmux/anthropic/claude-3.5-haiku";
   }
 });
-```
-
-## Direct provider installation
-
-This provider can also be installed directly as a standalone package, which can be used instead of the Mastra model router string. View the [package documentation](https://www.npmjs.com/package/@ai-sdk/anthropic) for more details.
-
-**npm**:
-
-```bash
-npm install @ai-sdk/anthropic
-```
-
-**pnpm**:
-
-```bash
-pnpm add @ai-sdk/anthropic
-```
-
-**Yarn**:
-
-```bash
-yarn add @ai-sdk/anthropic
-```
-
-**Bun**:
-
-```bash
-bun add @ai-sdk/anthropic
 ```

package/.docs/models/providers.md

@@ -11,7 +11,6 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [xAI](https://mastra.ai/models/providers/xai)
 - [302.AI](https://mastra.ai/models/providers/302ai)
 - [Abacus](https://mastra.ai/models/providers/abacus)
-- [AIHubMix](https://mastra.ai/models/providers/aihubmix)
 - [Alibaba](https://mastra.ai/models/providers/alibaba)
 - [Alibaba (China)](https://mastra.ai/models/providers/alibaba-cn)
 - [Alibaba Coding Plan](https://mastra.ai/models/providers/alibaba-coding-plan)

package/.docs/reference/agents/agent.md

@@ -6,7 +6,7 @@ The `Agent` class is the foundation for creating AI agents in Mastra. It provide
 
 ### Basic string instructions
 
-Passing instructions as a string or array of strings is the simplest way to set up an agent. This is useful for straightforward use cases where you just need to provide a prompt without additional configuration.
+Passing instructions as a string or array of strings is the simplest way to set up an agent. This is useful for straightforward use cases where you need to provide a prompt without additional configuration.
 
 ```typescript
 import { Agent } from '@mastra/core/agent'

package/.docs/reference/cli/mastra.md

@@ -4,9 +4,9 @@ You can use the Command-Line Interface (CLI) provided by Mastra to develop, buil
 
 ## `mastra dev`
 
-Starts a server which exposes [Studio](https://mastra.ai/docs/getting-started/studio) and REST endpoints for your agents, tools, and workflows. You can visit <http://localhost:4111/swagger-ui> for an overview of all available endpoints once `mastra dev` is running.
+Starts a server which exposes [Studio](https://mastra.ai/docs/studio/overview) and REST endpoints for your agents, tools, and workflows. You can visit <http://localhost:4111/swagger-ui> for an overview of all available endpoints once `mastra dev` is running.
 
-You can also [configure the server](https://mastra.ai/docs/getting-started/studio).
+You can also [configure the server](https://mastra.ai/reference/configuration).
 
 ### Flags
 
@@ -157,7 +157,7 @@ Comma-separated list of custom arguments to pass to the Node.js process, e.g. `-
 
 ## `mastra studio`
 
-Starts [Mastra Studio](https://mastra.ai/docs/getting-started/studio) as a static server. After starting, you can enter your Mastra instance URL (e.g. `http://localhost:4111`) to connect Studio to your Mastra backend. Looks for `.env` and `.env.production` files in the current working directory for configuration.
+Starts [Studio](https://mastra.ai/docs/studio/overview) as a static server. After starting, you can enter your Mastra instance URL (e.g. `http://localhost:4111`) to connect Studio to your Mastra backend. Looks for `.env` and `.env.production` files in the current working directory for configuration.
 
 ### Flags
 

package/.docs/reference/client-js/workflows.md

@@ -55,7 +55,7 @@ The `resourceId` parameter associates the workflow run with a specific resource
 
 ### `startAsync()`
 
-Start a workflow run and await the full result:
+Start a workflow run and await its completion, returning the full result as the workflow output.
 
 ```typescript
 const run = await workflow.createRun()
@@ -97,7 +97,7 @@ const result = await run.startAsync({
 
 ### `start()`
 
-Start a workflow run without waiting for completion:
+Start a workflow run without waiting for completion (fire-and-forget). Returns immediately with a success message. Use `runById()` on the workflow instance to check results later:
 
 ```typescript
 const run = await workflow.createRun()

package/.docs/reference/configuration.md

@@ -749,9 +749,9 @@ Return a `{ status, body }` object to override the default `400` response, or `u
 
 The `context` parameter indicates which part of the request failed validation:
 
-- `'query'` — query parameters
-- `'body'` — request body
-- `'path'` — path parameters
+- `'query'`: query parameters
+- `'body'`: request body
+- `'path'`: path parameters
 
 ```typescript
 import { Mastra } from '@mastra/core'
@@ -797,7 +797,7 @@ export const mastra = new Mastra({
 **Type:** `string`\
 **Default:** `/`
 
-Base path for hosting Mastra Studio. Use this to host the Studio on a sub-path of your existing application instead of the root.
+Base path for hosting [Studio](https://mastra.ai/docs/studio/overview). Use this to host the Studio on a sub-path of your existing application instead of the root.
 
 This is useful when integrating with existing applications, using authentication tools like Cloudflare Zero Trust that benefit from shared domains, or managing multiple services under a single domain.
 

package/.docs/reference/deployer/cloudflare.md

@@ -75,7 +75,7 @@ The `CloudflareDeployer` constructor accepts the same configuration options as `
 
 ## Secrets
 
-Environment variables from your `.env` file are **not** written to `wrangler.jsonc`. This prevents secrets from being committed to source control.
+Environment variables from your `.env` file aren't written to `wrangler.jsonc`. This prevents secrets from being committed to source control.
 
 To make your `.env` secrets available to your Cloudflare Worker, upload them as [Cloudflare Secrets](https://developers.cloudflare.com/workers/configuration/secrets/):
 

package/.docs/reference/deployer/vercel.md

@@ -47,7 +47,7 @@ export const mastra = new Mastra({
 
 The deployer accepts the following options:
 
-- `studio?: boolean` — Deploy [Studio](https://mastra.ai/docs/getting-started/studio) alongside your API as static assets served from Vercel's Edge CDN. Defaults to `false`.
+- `studio?: boolean` — Deploy [Studio](https://mastra.ai/docs/studio/overview) alongside your API as static assets served from Vercel's Edge CDN. Defaults to `false`.
 - `maxDuration?: number` — Function execution timeout (in seconds)
 - `memory?: number` — Function memory (in MB)
 - `regions?: string[]` — Regions to deploy the function (e.g. `['sfo1','iad1']`)

package/.docs/reference/index.md

@@ -84,6 +84,10 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [Deployer](https://mastra.ai/reference/deployer)
 - [Netlify](https://mastra.ai/reference/deployer/netlify)
 - [Vercel](https://mastra.ai/reference/deployer/vercel)
+- [createScorer()](https://mastra.ai/reference/evals/create-scorer)
+- [MastraScorer](https://mastra.ai/reference/evals/mastra-scorer)
+- [runEvals()](https://mastra.ai/reference/evals/run-evals)
+- [Scorer Utils](https://mastra.ai/reference/evals/scorer-utils)
 - [Answer Relevancy Scorer](https://mastra.ai/reference/evals/answer-relevancy)
 - [Answer Similarity Scorer](https://mastra.ai/reference/evals/answer-similarity)
 - [Bias](https://mastra.ai/reference/evals/bias)
@@ -91,30 +95,16 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [Content Similarity Scorer](https://mastra.ai/reference/evals/content-similarity)
 - [Context Precision Scorer](https://mastra.ai/reference/evals/context-precision)
 - [Context Relevance Scorer](https://mastra.ai/reference/evals/context-relevance)
-- [createScorer()](https://mastra.ai/reference/evals/create-scorer)
 - [Faithfulness](https://mastra.ai/reference/evals/faithfulness)
 - [Hallucination](https://mastra.ai/reference/evals/hallucination)
 - [Keyword Coverage Scorer](https://mastra.ai/reference/evals/keyword-coverage)
-- [MastraScorer](https://mastra.ai/reference/evals/mastra-scorer)
 - [Noise Sensitivity Scorer](https://mastra.ai/reference/evals/noise-sensitivity)
 - [Prompt Alignment Scorer](https://mastra.ai/reference/evals/prompt-alignment)
-- [runEvals()](https://mastra.ai/reference/evals/run-evals)
-- [Scorer Utils](https://mastra.ai/reference/evals/scorer-utils)
 - [Textual Difference Scorer](https://mastra.ai/reference/evals/textual-difference)
 - [Tone Consistency Scorer](https://mastra.ai/reference/evals/tone-consistency)
 - [Tool Call Accuracy Scorers](https://mastra.ai/reference/evals/tool-call-accuracy)
 - [Toxicity](https://mastra.ai/reference/evals/toxicity)
 - [Trajectory Accuracy Scorers](https://mastra.ai/reference/evals/trajectory-accuracy)
-- [Harness Class](https://mastra.ai/reference/harness/harness-class)
-- [Cloned Thread Utilities](https://mastra.ai/reference/memory/clone-utilities)
-- [Memory Class](https://mastra.ai/reference/memory/memory-class)
-- [Observational Memory](https://mastra.ai/reference/memory/observational-memory)
-- [.cloneThread()](https://mastra.ai/reference/memory/cloneThread)
-- [.createThread()](https://mastra.ai/reference/memory/createThread)
-- [.deleteMessages()](https://mastra.ai/reference/memory/deleteMessages)
-- [.getThreadById()](https://mastra.ai/reference/memory/getThreadById)
-- [.listThreads()](https://mastra.ai/reference/memory/listThreads)
-- [.recall()](https://mastra.ai/reference/memory/recall)
 - [Dataset Class](https://mastra.ai/reference/datasets/dataset)
 - [DatasetsManager Class](https://mastra.ai/reference/datasets/datasets-manager)
 - [.addItem()](https://mastra.ai/reference/datasets/addItem)
@@ -139,7 +129,18 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [.startExperimentAsync()](https://mastra.ai/reference/datasets/startExperimentAsync)
 - [.update()](https://mastra.ai/reference/datasets/update)
 - [.updateItem()](https://mastra.ai/reference/datasets/updateItem)
+- [Harness Class](https://mastra.ai/reference/harness/harness-class)
+- [Cloned Thread Utilities](https://mastra.ai/reference/memory/clone-utilities)
+- [Memory Class](https://mastra.ai/reference/memory/memory-class)
+- [Observational Memory](https://mastra.ai/reference/memory/observational-memory)
+- [.cloneThread()](https://mastra.ai/reference/memory/cloneThread)
+- [.createThread()](https://mastra.ai/reference/memory/createThread)
+- [.deleteMessages()](https://mastra.ai/reference/memory/deleteMessages)
+- [.getThreadById()](https://mastra.ai/reference/memory/getThreadById)
+- [.listThreads()](https://mastra.ai/reference/memory/listThreads)
+- [.recall()](https://mastra.ai/reference/memory/recall)
 - [PinoLogger](https://mastra.ai/reference/logging/pino-logger)
+- [Automatic Metrics](https://mastra.ai/reference/observability/metrics/automatic-metrics)
 - [Configuration](https://mastra.ai/reference/observability/tracing/configuration)
 - [Instances](https://mastra.ai/reference/observability/tracing/instances)
 - [Interfaces](https://mastra.ai/reference/observability/tracing/interfaces)
@@ -276,6 +277,7 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [LocalSandbox](https://mastra.ai/reference/workspace/local-sandbox)
 - [S3Filesystem](https://mastra.ai/reference/workspace/s3-filesystem)
 - [SandboxProcessManager](https://mastra.ai/reference/workspace/process-manager)
+- [VercelSandbox](https://mastra.ai/reference/workspace/vercel)
 - [Workspace Class](https://mastra.ai/reference/workspace/workspace-class)
 - [WorkspaceFilesystem](https://mastra.ai/reference/workspace/filesystem)
 - [WorkspaceSandbox](https://mastra.ai/reference/workspace/sandbox)

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

@@ -666,7 +666,7 @@ const selector = new ModelByInputTokens({
 
 #### Behavior
 
-- Thresholds are sorted internally, so the order in the config object does not matter.
+- Thresholds are sorted internally, so the order in the config object doesn't matter.
 - `inputTokens ≤ smallest threshold` → uses that threshold's model
 - `inputTokens > largest threshold` → `resolve()` throws an error. If this happens during an OM Observer or Reflector run, OM aborts via TripWire, so callers receive an empty `text` result or streamed `tripwire` instead of a normal assistant response.
 - OM computes the input token count for the Observer or Reflector call and resolves the matching model tier directly

package/.docs/reference/observability/metrics/automatic-metrics.md

@@ -0,0 +1,132 @@
+# Automatic metrics reference
+
+Mastra automatically extracts performance and usage metrics from traced execution. This page is the complete reference for every metric name, label, and context field that Mastra emits.
+
+For setup instructions, see the [Metrics overview](https://mastra.ai/docs/observability/metrics/overview).
+
+## When Mastra emits automatic metrics
+
+Metrics are extracted from spans when they end. The observability layer inspects each completed span, calculates duration, and (for model generation spans) reads token usage data. No manual instrumentation is needed.
+
+Metrics are routed through an internal event bus to the `DefaultExporter`, which batches and flushes them to storage. Only DuckDB and in-memory storage backends support metrics persistence today.
+
+### What affects whether a metric is available
+
+Two conditions must be true for a metric to reach storage:
+
+1. `DefaultExporter` is configured as an exporter.
+2. The storage backend supports metrics (`DuckDB` or `InMemory`).
+
+If metrics aren't appearing, see [troubleshooting](#troubleshooting).
+
+## Duration metrics
+
+Duration metrics record execution time in milliseconds, calculated from the span's start and end timestamps. Each duration metric includes a `status` label set to `ok` or `error`, derived from the span's status.
+
+| Metric name                    | Span type                    | Description                                             |
+| ------------------------------ | ---------------------------- | ------------------------------------------------------- |
+| `mastra_agent_duration_ms`     | `AGENT_RUN`                  | Execution time of an agent run                          |
+| `mastra_tool_duration_ms`      | `TOOL_CALL`, `MCP_TOOL_CALL` | Execution time of a tool call, including MCP tool calls |
+| `mastra_workflow_duration_ms`  | `WORKFLOW_RUN`               | Execution time of a workflow run                        |
+| `mastra_model_duration_ms`     | `MODEL_GENERATION`           | Execution time of a model generation                    |
+| `mastra_processor_duration_ms` | `PROCESSOR_RUN`              | Execution time of a processor run                       |
+
+## Token usage metrics
+
+Token metrics are emitted only from `MODEL_GENERATION` spans that include `usage` data. If the provider doesn't report usage, no token metrics are emitted for that span.
+
+### Input token metrics
+
+| Metric name                             | Description                                    |
+| --------------------------------------- | ---------------------------------------------- |
+| `mastra_model_total_input_tokens`       | Total input tokens                             |
+| `mastra_model_input_text_tokens`        | Text tokens in the input prompt                |
+| `mastra_model_input_cache_read_tokens`  | Tokens read from prompt cache (e.g. Anthropic) |
+| `mastra_model_input_cache_write_tokens` | Tokens written to prompt cache                 |
+| `mastra_model_input_audio_tokens`       | Audio tokens in the input (multimodal models)  |
+| `mastra_model_input_image_tokens`       | Image tokens in the input (vision models)      |
+
+### Output token metrics
+
+| Metric name                            | Description                                                |
+| -------------------------------------- | ---------------------------------------------------------- |
+| `mastra_model_total_output_tokens`     | Total output tokens                                        |
+| `mastra_model_output_text_tokens`      | Text tokens in the model's output                          |
+| `mastra_model_output_reasoning_tokens` | Reasoning / chain-of-thought tokens (e.g. OpenAI o-series) |
+| `mastra_model_output_audio_tokens`     | Audio tokens in the model's output                         |
+| `mastra_model_output_image_tokens`     | Output image tokens                                        |
+
+### Provider-reported detailed token categories
+
+The detailed breakdown metrics (everything except `total_input` and `total_output`) are only emitted when the provider reports them. If a category has zero tokens, the metric is skipped for that span. Different providers report different levels of detail. For example, not all providers report cache or audio tokens.
+
+## Cost-related context
+
+### When cost context is attached
+
+Cost context is attached to token metrics when the embedded pricing registry has a matching entry for the provider and model. The registry ships with Mastra and covers common providers and models. If no match is found, token metrics are still emitted but without cost fields.
+
+### What cost fields may be included
+
+| Field           | Description                                                                  |
+| --------------- | ---------------------------------------------------------------------------- |
+| `provider`      | Provider name (e.g. `openai`, `anthropic`)                                   |
+| `model`         | Model identifier (e.g. `gpt-4o`, `claude-sonnet-4-20250514`)                 |
+| `estimatedCost` | Estimated cost for this metric, calculated from token count and pricing tier |
+| `costUnit`      | Currency unit (e.g. `USD`)                                                   |
+| `costMetadata`  | Additional pricing context (tier information, error details)                 |
+
+## Correlation with traces
+
+### How metrics relate to spans and trace context
+
+Each metric carries a `CorrelationContext` snapshot from the span that produced it. This context is stored alongside the metric value and lets you navigate from a metric to the exact span and trace.
+
+The correlation fields are grouped into four categories:
+
+**Trace correlation**
+
+- `traceId`: trace identifier
+- `spanId`: span identifier
+- `tags`: tags from the span
+
+**Entity hierarchy**
+
+- `entityType`, `entityId`, `entityName`: The entity that produced the metric (e.g. agent, workflow)
+- `parentEntityType`, `parentEntityId`, `parentEntityName`: The parent entity
+- `rootEntityType`, `rootEntityId`, `rootEntityName`: The root entity in the call chain
+
+**Identity**
+
+- `userId`, `organizationId`, `resourceId`: Identity context from the request
+- `runId`, `sessionId`, `threadId`, `requestId`: Correlation IDs
+
+**Deployment**
+
+- `environment`: Deployment environment (e.g. `production`, `staging`)
+- `source`: Source identifier
+- `serviceName`: Service name from the observability config
+- `experimentId`: Experiment identifier, if applicable
+
+### Why correlation helps with debugging
+
+When you spot a spike in latency or token usage on the Metrics dashboard, correlation context lets you drill directly into the trace that produced the metric. From there you can inspect the individual span to find the root cause: a slow tool call, a large prompt, or an unexpected error.
+
+## Troubleshooting
+
+### No metrics are appearing
+
+- **Observability is configured**: Verify that your `Mastra` instance has an `observability` config with at least one exporter.
+- **`DefaultExporter` is present**: Other exporters (Datadog, Langfuse, etc.) don't persist metrics to Mastra storage. `DefaultExporter` is required for the Studio dashboard.
+- **Storage supports metrics**: Metrics require a separate OLAP store for observability. Relational databases like PostgreSQL, LibSQL, etc. are not supported for metrics. In-memory storage resets on restart.
+- **Sampling isn't 0%**: If sampling probability is `0` or strategy is `never`, all spans become no-ops and no metrics are extracted.
+
+### Duration metrics are missing
+
+- **Span has timestamps**: Duration is calculated from `startTime` and `endTime`. If either is missing, the metric is skipped.
+- **Span type maps to a metric**: Only `AGENT_RUN`, `TOOL_CALL`, `MCP_TOOL_CALL`, `WORKFLOW_RUN`, `MODEL_GENERATION`, and `PROCESSOR_RUN` spans produce duration metrics.
+
+### Token metrics are missing
+
+- **Span is a model generation**: Token metrics are only emitted from `MODEL_GENERATION` spans.
+- **Provider reports usage**: The model provider must include `usage` data in its response. If usage is absent, no token metrics are emitted.

package/.docs/reference/storage/cloudflare-d1.md

@@ -2,7 +2,7 @@
 
 The Cloudflare D1 storage implementation provides a serverless SQL database solution using Cloudflare D1, supporting relational operations and transactional consistency.
 
-> **Observability Not Supported:** Cloudflare D1 storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to D1, and Mastra Studio's observability features won't work with D1 as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
+> **Observability Not Supported:** Cloudflare D1 storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to D1, and [Studio's](https://mastra.ai/docs/studio/overview) observability features won't work with D1 as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
 
 > **Row Size Limit:** Cloudflare D1 enforces a **1 MiB maximum row size**. This limit can be exceeded when storing messages with base64-encoded attachments such as images. See [Handling large attachments](https://mastra.ai/docs/memory/storage) for workarounds including uploading attachments to external storage.
 

package/.docs/reference/storage/cloudflare.md

@@ -2,10 +2,10 @@
 
 Mastra provides two Cloudflare storage implementations:
 
-- **Cloudflare KV** (`CloudflareKVStorage`) - A globally distributed, eventually consistent key-value store
-- **Cloudflare Durable Objects** (`CloudflareDOStorage`) - A strongly consistent, SQLite-based storage using Durable Objects
+- **Cloudflare KV** (`CloudflareKVStorage`): A globally distributed, eventually consistent key-value store
+- **Cloudflare Durable Objects** (`CloudflareDOStorage`): A strongly consistent, SQLite-based storage using Durable Objects
 
-> **Observability Not Supported:** Cloudflare storage **does not support the observability domain**. Traces from the `DefaultExporter` cannot be persisted, and Mastra Studio's observability features won't work with Cloudflare as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
+> **Observability Not Supported:** Cloudflare storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted, and [Studio's](https://mastra.ai/docs/studio/overview) observability features won't work with Cloudflare as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
 
 ## Installation
 

package/.docs/reference/storage/convex.md

@@ -2,7 +2,7 @@
 
 The Convex storage implementation provides a serverless storage solution using [Convex](https://convex.dev), a full-stack TypeScript development platform with real-time sync and automatic caching.
 
-> **Observability Not Supported:** Convex storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to Convex, and Mastra Studio's observability features won't work with Convex as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
+> **Observability Not Supported:** Convex storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to Convex, and [Studio's](https://mastra.ai/docs/studio/overview) observability features won't work with Convex as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
 
 > **Record Size Limit:** Convex enforces a **1 MiB maximum record size**. This limit can be exceeded when storing messages with base64-encoded attachments such as images. See [Handling large attachments](https://mastra.ai/docs/memory/storage) for workarounds including uploading attachments to external storage like S3, Cloudflare R2, or [Convex file storage](https://docs.convex.dev/file-storage).
 

package/.docs/reference/storage/dynamodb.md

@@ -2,7 +2,7 @@
 
 The DynamoDB storage implementation provides a scalable and performant NoSQL database solution for Mastra, leveraging a single-table design pattern with [ElectroDB](https://electrodb.dev/).
 
-> **Observability Not Supported:** DynamoDB storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to DynamoDB, and Mastra Studio's observability features won't work with DynamoDB as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
+> **Observability Not Supported:** DynamoDB storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to DynamoDB, and [Studio's](https://mastra.ai/docs/studio/overview) observability features won't work with DynamoDB as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
 
 > **Item Size Limit:** DynamoDB enforces a **400 KB maximum item size**. This limit can be exceeded when storing messages with base64-encoded attachments such as images. See [Handling large attachments](https://mastra.ai/docs/memory/storage) for workarounds including uploading attachments to external storage.
 

package/.docs/reference/storage/lance.md

@@ -2,7 +2,7 @@
 
 The LanceDB storage implementation provides a high-performance storage solution using the LanceDB database system, which excels at handling both traditional data storage and vector operations.
 
-> **Observability Not Supported:** LanceDB storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to LanceDB, and Mastra Studio's observability features won't work with LanceDB as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
+> **Observability Not Supported:** LanceDB storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to LanceDB, and [Studio's](https://mastra.ai/docs/studio/overview) observability features won't work with LanceDB as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
 
 ## Installation
 

package/.docs/reference/storage/upstash.md

@@ -4,7 +4,7 @@ The Upstash storage implementation provides a serverless-friendly storage soluti
 
 > **Pricing:** When using Mastra with Upstash, the pay-as-you-go model can result in unexpectedly high costs due to the high volume of Redis commands generated during agent conversations. We strongly recommend using a **fixed pricing plan** for predictable costs. See [Upstash pricing](https://upstash.com/pricing/redis) for details and [GitHub issue #5850](https://github.com/mastra-ai/mastra/issues/5850) for context.
 
-> **Observability Not Supported:** Upstash storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to Upstash, and Mastra Studio's observability features won't work with Upstash as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
+> **Observability Not Supported:** Upstash storage **doesn't support the observability domain**. Traces from the `DefaultExporter` can't be persisted to Upstash, and [Studio's](https://mastra.ai/docs/studio/overview) observability features won't work with Upstash as your only storage provider. To enable observability, use [composite storage](https://mastra.ai/reference/storage/composite) to route observability data to a supported provider like ClickHouse or PostgreSQL.
 
 ## Installation
 

package/.docs/reference/workspace/vercel.md

@@ -0,0 +1,118 @@
+# VercelSandbox
+
+Executes commands as [Vercel](https://vercel.com) serverless functions. Provides globally-distributed, zero-infrastructure execution with automatic scaling.
+
+> **Info:** For interface details, see [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox).
+
+> **Warning:** VercelSandbox is stateless. There is no persistent filesystem, no interactive shell, and no support for long-running or background processes. Only `/tmp` is writable and is ephemeral between invocations.
+
+## Installation
+
+**npm**:
+
+```bash
+npm install @mastra/vercel
+```
+
+**pnpm**:
+
+```bash
+pnpm add @mastra/vercel
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/vercel
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/vercel
+```
+
+## Usage
+
+Add a `VercelSandbox` to a workspace and assign it to an agent:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { Workspace } from '@mastra/core/workspace'
+import { VercelSandbox } from '@mastra/vercel'
+
+const workspace = new Workspace({
+  sandbox: new VercelSandbox({
+    token: process.env.VERCEL_TOKEN,
+  }),
+})
+
+const agent = new Agent({
+  name: 'dev-agent',
+  model: 'anthropic/claude-sonnet-4-6',
+  workspace,
+})
+```
+
+### Team-scoped deployment with custom resources
+
+```typescript
+const workspace = new Workspace({
+  sandbox: new VercelSandbox({
+    token: process.env.VERCEL_TOKEN,
+    teamId: 'team_abc123',
+    regions: ['iad1', 'sfo1'],
+    maxDuration: 120,
+    memory: 3008,
+    env: {
+      NODE_ENV: 'production',
+    },
+  }),
+})
+```
+
+## Constructor parameters
+
+**token** (`string`): Vercel API token. Falls back to \`VERCEL\_TOKEN\` environment variable.
+
+**teamId** (`string`): Vercel team ID for team-scoped deployments.
+
+**projectName** (`string`): Existing Vercel project name. Auto-generated if omitted.
+
+**regions** (`string[]`): Deployment regions. (Default: `['iad1']`)
+
+**maxDuration** (`number`): Function maximum duration in seconds. (Default: `60`)
+
+**memory** (`number`): Function memory in MB. (Default: `1024`)
+
+**env** (`Record<string, string>`): Environment variables baked into the deployed function source. These are embedded at deploy time, not set dynamically.
+
+**commandTimeout** (`number`): Per-invocation command timeout in milliseconds. (Default: `55000`)
+
+**instructions** (`string | ((opts) => string)`): Custom instructions that override the default instructions returned by \`getInstructions()\`. Pass a string to fully replace, or a function to extend the defaults.
+
+## Properties
+
+**id** (`string`): Unique identifier for this sandbox instance.
+
+**name** (`'VercelSandbox'`): Human-readable name.
+
+**provider** (`'vercel'`): Provider type identifier.
+
+**status** (`ProviderStatus`): Current lifecycle status: \`'pending'\`, \`'starting'\`, \`'running'\`, \`'stopping'\`, \`'stopped'\`, \`'destroying'\`, \`'destroyed'\`, or \`'error'\`.
+
+## Limitations
+
+VercelSandbox uses serverless functions under the hood, which means:
+
+- **No persistent filesystem**: Files written to `/tmp` are ephemeral and cleared between invocations.
+- **No interactive shell**: Commands run via `/bin/sh -c` with no stdin streaming.
+- **No background processes**: No process manager, PIDs, or long-running tasks.
+- **No mounting**: Cloud storage mounting (S3, GCS) is not supported.
+- **Timeout limits**: Maximum execution time is bounded by `maxDuration` (default 60s).
+
+## Related
+
+- [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox)
+- [Workspace class](https://mastra.ai/reference/workspace/workspace-class)
+- [E2BSandbox](https://mastra.ai/reference/workspace/e2b-sandbox) — full-featured cloud sandbox with persistent filesystem and process management

package/CHANGELOG.md

@@ -1,5 +1,27 @@
 # @mastra/mcp-docs-server
 
+## 1.1.18-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [[`9c57f2f`](https://github.com/mastra-ai/mastra/commit/9c57f2f7241e9f94769aa99fc86c531e8207d0f9), [`5bfc691`](https://github.com/mastra-ai/mastra/commit/5bfc69104c07ba7a9b55c2f8536422c0878b9c57)]:
+  - @mastra/core@1.19.0-alpha.2
+
+## 1.1.18-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`9140989`](https://github.com/mastra-ai/mastra/commit/91409890e83f4f1d9c1b39223f1af91a6a53b549), [`d7c98cf`](https://github.com/mastra-ai/mastra/commit/d7c98cfc9d75baba9ecbf1a8835b5183d0a0aec8), [`acf5fbc`](https://github.com/mastra-ai/mastra/commit/acf5fbcb890dc7ca7167bec386ce5874dfadb997), [`24ca2ae`](https://github.com/mastra-ai/mastra/commit/24ca2ae57538ec189fabb9daee6175ad27035853), [`0762516`](https://github.com/mastra-ai/mastra/commit/07625167e029a8268ea7aaf0402416e6d8832874), [`2de3d36`](https://github.com/mastra-ai/mastra/commit/2de3d36932b7f73ad26bc403f7da26cfe89e903e), [`d3736cb`](https://github.com/mastra-ai/mastra/commit/d3736cb9ce074d2b8e8b00218a01f790fe81a1b4), [`c627366`](https://github.com/mastra-ai/mastra/commit/c6273666f9ef4c8c617c68b7d07fe878a322f85c), [`66a7412`](https://github.com/mastra-ai/mastra/commit/66a7412ec0550f3dfa01cd05b057d8c6e5b062bc)]:
+  - @mastra/core@1.18.1-alpha.1
+  - @mastra/mcp@1.4.0-alpha.0
+
+## 1.1.18-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`180aaaf`](https://github.com/mastra-ai/mastra/commit/180aaaf4d0903d33a49bc72de2d40ca69a5bc599)]:
+  - @mastra/core@1.18.1-alpha.0
+
 ## 1.1.17
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.17",
+  "version": "1.1.18-alpha.4",
   "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.18.0",
-    "@mastra/mcp": "^1.3.2"
+    "@mastra/core": "1.19.0-alpha.2",
+    "@mastra/mcp": "^1.4.0-alpha.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -46,9 +46,9 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "4.0.18",
+    "@internal/lint": "0.0.75",
     "@internal/types-builder": "0.0.50",
-    "@mastra/core": "1.18.0",
-    "@internal/lint": "0.0.75"
+    "@mastra/core": "1.19.0-alpha.2"
   },
   "homepage": "https://mastra.ai",
   "repository": {