@mastra/mcp-docs-server 1.2.15-alpha.9 → 1.2.16-alpha.1

package/.docs/{reference/workspace/e2b-sandbox.md → integrations/sandboxes/e2b.md}

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# E2BSandbox
+# E2B
 
 Executes commands in isolated [E2B](https://e2b.dev) cloud sandboxes. Provides secure, ephemeral environments with support for mounting cloud storage. For interface details, see [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox).
 
@@ -271,7 +271,7 @@ const { tool, instructions } = createCodeMode(
 - [SandboxProcessManager reference](https://mastra.ai/reference/workspace/process-manager)
 - [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox)
 - [LocalSandbox reference](https://mastra.ai/reference/workspace/local-sandbox)
-- [S3Filesystem reference](https://mastra.ai/reference/workspace/s3-filesystem)
-- [GCSFilesystem reference](https://mastra.ai/reference/workspace/gcs-filesystem)
-- [Azure Blob Filesystem reference](https://mastra.ai/reference/workspace/azure-blob-filesystem)
+- [S3Filesystem reference](https://mastra.ai/integrations/file-storage/amazon-s3)
+- [GCSFilesystem reference](https://mastra.ai/integrations/file-storage/google-cloud-storage)
+- [Azure Blob Filesystem reference](https://mastra.ai/integrations/file-storage/azure-blob)
 - [Workspace overview](https://mastra.ai/docs/workspace/overview)

package/.docs/{reference/workspace/modal-sandbox.md → integrations/sandboxes/modal.md}

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# ModalSandbox
+# Modal
 
 Executes commands in isolated [Modal](https://modal.com) cloud sandboxes. Provides secure, ephemeral environments backed by Modal's infrastructure. For interface details, see [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox).
 
@@ -163,6 +163,6 @@ See [`SandboxProcessManager` reference](https://mastra.ai/reference/workspace/pr
 
 - [SandboxProcessManager reference](https://mastra.ai/reference/workspace/process-manager)
 - [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox)
-- [E2BSandbox reference](https://mastra.ai/reference/workspace/e2b-sandbox)
-- [DaytonaSandbox reference](https://mastra.ai/reference/workspace/daytona-sandbox)
+- [E2BSandbox reference](https://mastra.ai/integrations/sandboxes/e2b)
+- [DaytonaSandbox reference](https://mastra.ai/integrations/sandboxes/daytona)
 - [Workspace overview](https://mastra.ai/docs/workspace/overview)

package/.docs/{reference/workspace/railway-sandbox.md → integrations/sandboxes/railway.md}

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# RailwaySandbox
+# Railway
 
 Executes commands in ephemeral, isolated [Railway](https://docs.railway.com/sandboxes) sandboxes. Each sandbox is an isolated Debian Linux VM provisioned on demand through the Railway TypeScript SDK. Supports command execution with streaming output, command timeouts, configurable idle timeout, `ISOLATED`/`PRIVATE` network isolation, custom base images via the Railway template builder, checkpoint-backed recovery, forking a running sandbox, and reattaching to an existing sandbox by ID. For interface details, see [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox).
 
@@ -141,6 +141,12 @@ const sandbox = new RailwaySandbox({
 
 `RailwaySandbox` refreshes the checkpoint shortly before the idle timeout. Recovery restores the latest successful checkpoint. It doesn't restore running processes or filesystem writes made after the last checkpoint.
 
+Call `snapshot()` after a filesystem update to capture the configured checkpoint immediately. It resolves without capturing when `checkpointName` isn't configured or the sandbox isn't running.
+
+```typescript
+await sandbox.snapshot()
+```
+
 Use one stable checkpoint name for each independent filesystem. Don't share a checkpoint name across unrelated sessions or projects.
 
 ### Cloned sandbox checkpoints
@@ -228,6 +234,8 @@ const result = await sandbox.executeCommand('cat', ['/tmp/state.txt'])
 
 **clone** (`(options?) => RailwaySandbox`): Construct an unstarted sibling sandbox that inherits credentials and defaults. Accepts optional id, sandboxId, env, idleTimeoutMinutes, and checkpointName overrides. The cloned sandbox uses options.checkpointName when set, otherwise it inherits the template checkpointName.
 
+**snapshot** (`() => Promise<void>`): Capture the configured recovery checkpoint immediately. Resolves without work when checkpointName is not configured or the sandbox is not running.
+
 ## Background processes
 
 `RailwaySandbox` includes a built-in process manager for spawning and managing background processes. Each spawned process runs as a Railway `exec` session.

package/.docs/{reference/workspace/vercel-sandbox.md → integrations/sandboxes/vercel.md}

@@ -1,12 +1,16 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# VercelSandbox
+# Vercel Sandboxes
+
+Run commands in isolated Vercel environments with either persistent Sandbox microVMs or stateless Serverless Functions.
+
+## Vercel Sandbox
 
 Executes commands inside [Vercel Sandbox](https://vercel.com/docs/vercel-sandbox) which is an ephemeral [Firecracker](https://firecracker-microvm.github.io/) MicroVM running Amazon Linux 2023. Provides a persistent in-session filesystem, `sudo` access, exposed ports, and background processes. For interface details, see the [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox).
 
-> **Note:** This is distinct from [`VercelServerlessSandbox`](https://mastra.ai/reference/workspace/vercel-serverless), which runs commands as stateless Vercel serverless **Functions**. `VercelSandbox` runs a full Linux MicroVM with a persistent filesystem and long-running processes.
+> **Note:** This is distinct from [`VercelServerlessSandbox`](#vercel-serverless-sandbox), which runs commands as stateless Vercel serverless **Functions**. `VercelSandbox` runs a full Linux MicroVM with a persistent filesystem and long-running processes.
 
-## Installation
+### Installation
 
 **npm**:
 
@@ -32,7 +36,7 @@ yarn add @mastra/vercel
 bun add @mastra/vercel
 ```
 
-## Authentication
+### Authentication
 
 The `@vercel/sandbox` SDK uses a Vercel OIDC token automatically when no explicit credentials are provided. If you provide `token`, `teamId`, or `projectId`, provide all three values together.
 
@@ -67,7 +71,7 @@ new VercelSandbox({
 })
 ```
 
-## Usage
+### Usage
 
 Add a `VercelSandbox` to a workspace and assign it to an agent:
 
@@ -96,7 +100,7 @@ const response = await agent.generate('Print "Hello, world!" and show the Node.j
 console.log(response.text)
 ```
 
-### Resources and exposed ports
+#### Resources and exposed ports
 
 Allocate vCPUs (2048 MB of memory per vCPU) and expose ports to reach network services running inside the sandbox:
 
@@ -115,7 +119,7 @@ const { metadata } = sandbox.getInfo()
 console.log(metadata?.domains) // { 3000: 'https://....vercel.run' }
 ```
 
-### Streaming output
+#### Streaming output
 
 Stream command output in real time via `onStdout` and `onStderr` callbacks:
 
@@ -128,7 +132,7 @@ await sandbox.executeCommand('sh', ['-c', 'for i in 1 2 3; do echo "line $i"; sl
 
 Both callbacks are optional and can be used independently.
 
-## Constructor parameters
+### Constructor parameters
 
 **id** (`string`): Unique identifier for this sandbox instance. (Default: `Auto-generated`)
 
@@ -160,7 +164,7 @@ Both callbacks are optional and can be used independently.
 
 **onDestroy** (`SandboxLifecycleHook`): Lifecycle hook called before the sandbox is destroyed.
 
-## Properties
+### Properties
 
 **id** (`string`): Sandbox instance identifier.
 
@@ -174,7 +178,7 @@ Both callbacks are optional and can be used independently.
 
 **processes** (`VercelSandboxProcessManager`): Background process manager. See SandboxProcessManager reference.
 
-## Background processes
+### Background processes
 
 `VercelSandbox` includes a process manager for spawning and managing background processes. Each spawned process runs as a detached command inside the MicroVM, with output streamed through the command logs.
 
@@ -195,11 +199,138 @@ See the [`SandboxProcessManager` reference](https://mastra.ai/reference/workspac
 
 > **Note:** The Vercel Sandbox SDK doesn't expose a stdin channel for running commands, so `handle.sendStdin()` throws. Filesystem mounting (FUSE) is also not supported by this provider.
 
-## Limits
+### Limits
 
 - Up to 32 vCPUs, with 2048 MB of memory per vCPU.
 - Up to 15 exposed ports.
 - The filesystem is ephemeral. It's persisted only within the session and lost when the sandbox stops.
 - Maximum runtime is plan-dependent (45 minutes on Hobby, up to 24 hours on Pro and Enterprise), with a default of 5 minutes.
 
-See the [Vercel Sandbox documentation](https://vercel.com/docs/vercel-sandbox) for current limits and pricing.
+See the [Vercel Sandbox documentation](https://vercel.com/docs/vercel-sandbox) for current limits and pricing.
+
+## Vercel Serverless Sandbox
+
+`VercelServerlessSandbox` executes commands as [Vercel](https://vercel.com) serverless functions. It provides globally distributed, zero-infrastructure execution with automatic scaling. For interface details, see the [WorkspaceSandbox interface](https://mastra.ai/reference/workspace/sandbox).
+
+> **Warning:** `VercelServerlessSandbox` is stateless. It doesn't provide a persistent filesystem, interactive shell, or long-running background processes. Only `/tmp` is writable, and it's ephemeral between invocations.
+
+> **Note:** For a full Linux MicroVM with a persistent filesystem, `sudo` access, exposed ports, and background processes, use [`VercelSandbox`](#vercel-sandbox), which is backed by the [Vercel Sandbox](https://vercel.com/docs/vercel-sandbox) product.
+
+### 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 `VercelServerlessSandbox` to a workspace and assign it to an agent:
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { Workspace } from '@mastra/core/workspace'
+import { VercelServerlessSandbox } from '@mastra/vercel'
+
+const workspace = new Workspace({
+  sandbox: new VercelServerlessSandbox({
+    token: process.env.VERCEL_TOKEN,
+  }),
+})
+
+const agent = new Agent({
+  id: 'dev-agent',
+  name: 'dev-agent',
+  instructions: 'You are a coding assistant working in this workspace.',
+  model: 'anthropic/claude-sonnet-4-6',
+  workspace,
+})
+```
+
+#### Team-scoped deployment with custom resources
+
+```typescript
+const workspace = new Workspace({
+  sandbox: new VercelServerlessSandbox({
+    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.
+
+**onStart** (`SandboxLifecycleHook`): Lifecycle hook called after the sandbox reaches running status.
+
+**onStop** (`SandboxLifecycleHook`): Lifecycle hook called before the sandbox stops.
+
+**onDestroy** (`SandboxLifecycleHook`): Lifecycle hook called before the sandbox is destroyed.
+
+### Properties
+
+**id** (`string`): Unique identifier for this sandbox instance.
+
+**name** (`'VercelServerlessSandbox'`): Human-readable name.
+
+**provider** (`'vercel-serverless'`): Provider type identifier.
+
+**status** (`ProviderStatus`): Current lifecycle status: 'pending', 'starting', 'running', 'stopping', 'stopped', 'destroying', 'destroyed', or 'error'.
+
+### Limitations
+
+`VercelServerlessSandbox` 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) isn't 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)
+- [E2B sandbox](https://mastra.ai/integrations/sandboxes/e2b): Full-featured cloud sandbox with persistent filesystem and process management

package/.docs/{reference → integrations}/tools/brightdata.md

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# Bright Data tools
+# Bright Data
 
 The `@mastra/brightdata` package wraps the [Bright Data SDK](https://github.com/brightdata/bright-data-sdk-node) as Mastra-compatible tools. It exposes factory functions for web search and web fetch. Each function returns a tool created with [`createTool()`](https://mastra.ai/reference/tools/create-tool) that includes full Zod input/output schemas.
 

package/.docs/{guides/guide → integrations/tools}/firecrawl.md

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# Web scraping with Firecrawl
+# Firecrawl
 
 Firecrawl is a web data API that turns websites into clean markdown or structured JSON. In this guide, you will wire Firecrawl into Mastra tools so your agents and workflows can search and scrape live web data on demand.
 
@@ -9,7 +9,7 @@ Firecrawl is a web data API that turns websites into clean markdown or structure
 - Node.js `v22.13.0` or later installed
 - A Firecrawl API key (get one at <https://firecrawl.dev>)
 - An API key from a supported [Model Provider](https://mastra.ai/models)
-- An existing Mastra project (Follow the [installation guide](https://mastra.ai/guides/getting-started/quickstart) to set up a new project)
+- An existing Mastra project. Follow [Get started](https://mastra.ai/docs) to create one.
 
 ## Installation
 

package/.docs/{reference → integrations}/tools/perplexity.md

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# Perplexity tools
+# Perplexity
 
 The `@mastra/perplexity` package wraps the [Perplexity Search API](https://docs.perplexity.ai/docs/search/quickstart) as a Mastra-compatible tool. It exposes a factory function that returns a tool created with [`createTool()`](https://mastra.ai/reference/tools/create-tool) and full Zod input/output schemas.
 

package/.docs/{reference → integrations}/tools/tavily.md

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# Tavily tools
+# Tavily
 
 The `@mastra/tavily` package wraps the [Tavily](https://app.tavily.com) API as Mastra-compatible tools. It exposes factory functions for search, extract, crawl, and map. Each function returns a tool created with [`createTool()`](https://mastra.ai/reference/tools/create-tool) that includes full Zod input/output schemas.
 

package/.docs/{reference → integrations}/voice/aws-nova-sonic.md

@@ -1,6 +1,6 @@
 > Discover all available pages from the documentation index: https://mastra.ai/llms.txt
 
-# AWS Nova Sonic voice
+# AWS Nova Sonic
 
 The `NovaSonicVoice` class provides real-time speech-to-speech capabilities backed by [AWS Bedrock Nova 2 Sonic](https://docs.aws.amazon.com/nova/latest/userguide/speech.html). It opens a bidirectional stream to the model and emits events for assistant audio, transcribed text, tool calls, turn boundaries, and interruptions.
 

package/.docs/{reference → integrations}/voice/cloudflare.md

@@ -80,6 +80,6 @@ Returns an array of available voice options, where each node contains:
 
 If you need speech-to-text capabilities in addition to text-to-speech, consider using one of these providers:
 
-- [OpenAI](https://mastra.ai/reference/voice/openai): Provides both TTS and STT
-- [Google](https://mastra.ai/reference/voice/google): Provides both TTS and STT
-- [Azure](https://mastra.ai/reference/voice/azure): Provides both TTS and STT
+- [OpenAI](https://mastra.ai/integrations/voice/openai): Provides both TTS and STT
+- [Google](https://mastra.ai/integrations/voice/google): Provides both TTS and STT
+- [Azure](https://mastra.ai/integrations/voice/azure): Provides both TTS and STT