@mastra/mcp-docs-server 1.0.0-beta.13 → 1.0.0-beta.14

package/.docs/raw/reference/ai-sdk/chat-route.mdx

@@ -15,7 +15,7 @@ Use [`handleChatStream()`](/reference/v1/ai-sdk/handle-chat-stream) if you need
 
 This example shows how to set up a chat route at the `/chat` endpoint that uses an agent with the ID `weatherAgent`.
 
-```typescript title="src/mastra/index.ts" copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { chatRoute } from "@mastra/ai-sdk";
 
@@ -33,7 +33,7 @@ export const mastra = new Mastra({
 
 You can also use dynamic agent routing based on an `agentId`. The URL `/chat/weatherAgent` will resolve to the agent with the ID `weatherAgent`.
 
-```typescript title="src/mastra/index.ts" copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { chatRoute } from "@mastra/ai-sdk";
 

package/.docs/raw/reference/ai-sdk/handle-chat-stream.mdx

@@ -17,7 +17,7 @@ Use [`chatRoute()`](/reference/v1/ai-sdk/chat-route) if you want to create a cha
 
 Next.js App Router example:
 
-```typescript title="app/api/chat/route.ts" copy
+```typescript title="app/api/chat/route.ts"
 import { handleChatStream } from '@mastra/ai-sdk';
 import { createUIMessageStreamResponse } from 'ai';
 import { mastra } from '@/src/mastra';

package/.docs/raw/reference/ai-sdk/handle-network-stream.mdx

@@ -16,7 +16,7 @@ Use [`networkRoute()`](/reference/v1/ai-sdk/network-route) if you want to create
 
 Next.js App Router example:
 
-```typescript title="app/api/network/route.ts" copy
+```typescript title="app/api/network/route.ts"
 import { handleNetworkStream } from '@mastra/ai-sdk';
 import { createUIMessageStreamResponse } from 'ai';
 import { mastra } from '@/src/mastra';

package/.docs/raw/reference/ai-sdk/handle-workflow-stream.mdx

@@ -25,7 +25,7 @@ See [Workflow Streaming](/docs/v1/streaming/workflow-streaming#streaming-agent-t
 
 Next.js App Router example:
 
-```typescript title="app/api/workflow/route.ts" copy
+```typescript title="app/api/workflow/route.ts"
 import { handleWorkflowStream } from '@mastra/ai-sdk';
 import { createUIMessageStreamResponse } from 'ai';
 import { mastra } from '@/src/mastra';

package/.docs/raw/reference/ai-sdk/network-route.mdx

@@ -15,7 +15,7 @@ Use [`handleNetworkStream()`](/reference/v1/ai-sdk/handle-network-stream) if you
 
 This example shows how to set up a network route at the `/network` endpoint that uses an agent with the ID `weatherAgent`.
 
-```typescript title="src/mastra/index.ts" copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { networkRoute } from "@mastra/ai-sdk";
 
@@ -33,7 +33,7 @@ export const mastra = new Mastra({
 
 You can also use dynamic agent routing based on an `agentId`. The URL `/network/weatherAgent` will resolve to the agent with the ID `weatherAgent`.
 
-```typescript title="src/mastra/index.ts" copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { networkRoute } from "@mastra/ai-sdk";
 

package/.docs/raw/reference/ai-sdk/to-ai-sdk-stream.mdx

@@ -15,7 +15,7 @@ This is useful when building custom streaming endpoints outside Mastra's provide
 
 Next.js App Router example:
 
-```typescript title="app/api/chat/route.ts" copy
+```typescript title="app/api/chat/route.ts"
 import { mastra } from "../../mastra";
 import { createUIMessageStream, createUIMessageStreamResponse } from "ai";
 import { toAISdkStream } from "@mastra/ai-sdk";
@@ -124,7 +124,7 @@ The second parameter is an options object:
 
 ### Converting a workflow stream
 
-```typescript title="app/api/workflow/route.ts" copy {13}
+```typescript title="app/api/workflow/route.ts" {13}
 import { mastra } from "../../mastra";
 import { createUIMessageStream, createUIMessageStreamResponse } from "ai";
 import { toAISdkStream } from "@mastra/ai-sdk";
@@ -151,7 +151,7 @@ export async function POST(req: Request) {
 
 ### Converting a network stream
 
-```typescript title="app/api/network/route.ts" copy {12}
+```typescript title="app/api/network/route.ts" {12}
 import { mastra } from "../../mastra";
 import { createUIMessageStream, createUIMessageStreamResponse } from "ai";
 import { toAISdkStream } from "@mastra/ai-sdk";
@@ -177,7 +177,7 @@ export async function POST(req: Request) {
 
 ### Converting an agent stream with reasoning enabled
 
-```typescript title="app/api/reasoning/route.ts" copy {8-12,17-20}
+```typescript title="app/api/reasoning/route.ts" {8-12,17-20}
 import { mastra } from "../../mastra";
 import { createUIMessageStream, createUIMessageStreamResponse } from "ai";
 import { toAISdkStream } from "@mastra/ai-sdk";
@@ -211,7 +211,7 @@ export async function POST(req: Request) {
 
 ### Using messageMetadata
 
-```typescript title="app/api/chat-with-metadata/route.ts" copy {13-19}
+```typescript title="app/api/chat-with-metadata/route.ts" {13-19}
 import { mastra } from "../../mastra";
 import { createUIMessageStream, createUIMessageStreamResponse } from "ai";
 import { toAISdkStream } from "@mastra/ai-sdk";
@@ -246,7 +246,7 @@ export async function POST(req: Request) {
 
 If you're using the Mastra client SDK (`@mastra/client-js`) on the client side and want to convert streams to AI SDK format:
 
-```typescript title="client-stream-to-ai-sdk.ts" copy {14-23,25-35}
+```typescript title="client-stream-to-ai-sdk.ts" {14-23,25-35}
 import { MastraClient } from "@mastra/client-js";
 import { createUIMessageStream } from "ai";
 import { toAISdkStream } from "@mastra/ai-sdk";

package/.docs/raw/reference/ai-sdk/to-ai-sdk-v4-messages.mdx

@@ -11,7 +11,7 @@ Converts messages from various input formats to AI SDK V4 UI message format. Thi
 
 ## Usage example
 
-```typescript title="app/chat/page.tsx" copy
+```typescript title="app/chat/page.tsx"
 import { toAISdkV4Messages } from "@mastra/ai-sdk";
 import { useChat } from "ai/react"; // AI SDK V4
 
@@ -107,7 +107,7 @@ Returns an array of AI SDK V4 `UIMessage` objects with the following structure:
 
 ### Converting simple text messages
 
-```typescript copy
+```typescript
 import { toAISdkV4Messages } from "@mastra/ai-sdk";
 
 const messages = toAISdkV4Messages(["Hello", "How can I help you today?"]);
@@ -116,7 +116,7 @@ const messages = toAISdkV4Messages(["Hello", "How can I help you today?"]);
 
 ### Loading messages with Mastra client
 
-```typescript copy
+```typescript
 import { MastraClient } from "@mastra/client-js";
 import { toAISdkV4Messages } from "@mastra/ai-sdk";
 

package/.docs/raw/reference/ai-sdk/to-ai-sdk-v5-messages.mdx

@@ -11,7 +11,7 @@ Converts messages from various input formats to AI SDK V5 UI message format. Thi
 
 ## Usage example
 
-```typescript title="app/chat/page.tsx" copy
+```typescript title="app/chat/page.tsx"
 import { toAISdkV5Messages } from "@mastra/ai-sdk";
 import { useChat } from "ai/react";
 
@@ -87,7 +87,7 @@ Returns an array of AI SDK V5 `UIMessage` objects with the following structure:
 
 ### Converting simple text messages
 
-```typescript copy
+```typescript
 import { toAISdkV5Messages } from "@mastra/ai-sdk";
 
 const messages = toAISdkV5Messages(["Hello", "How can I help you today?"]);
@@ -96,7 +96,7 @@ const messages = toAISdkV5Messages(["Hello", "How can I help you today?"]);
 
 ### Loading messages with Mastra client
 
-```typescript copy
+```typescript
 import { MastraClient } from "@mastra/client-js";
 import { toAISdkV5Messages } from "@mastra/ai-sdk";
 

package/.docs/raw/reference/ai-sdk/with-mastra.mdx

@@ -11,7 +11,7 @@ Wraps an AI SDK model with Mastra processors and/or memory.
 
 ## Usage example
 
-```typescript title="src/example.ts" copy
+```typescript title="src/example.ts"
 import { openai } from '@ai-sdk/openai';
 import { generateText } from 'ai';
 import { withMastra } from '@mastra/ai-sdk';

package/.docs/raw/reference/ai-sdk/workflow-route.mdx

@@ -23,7 +23,7 @@ See [Workflow Streaming](/docs/v1/streaming/workflow-streaming#streaming-agent-t
 
 This example shows how to set up a workflow route at the `/workflow` endpoint that uses a workflow with the ID `weatherWorkflow`.
 
-```typescript title="src/mastra/index.ts" copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { workflowRoute } from "@mastra/ai-sdk";
 
@@ -41,7 +41,7 @@ export const mastra = new Mastra({
 
 You can also use dynamic workflow routing based on a `workflowId`. The URL `/workflow/weatherWorkflow` will resolve to the workflow with the ID `weatherWorkflow`.
 
-```typescript title="src/mastra/index.ts" copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { workflowRoute } from "@mastra/ai-sdk";
 

package/.docs/raw/reference/auth/auth0.mdx

@@ -9,12 +9,11 @@ The `MastraAuthAuth0` class provides authentication for Mastra using Auth0. It v
 
 ## Usage example
 
-```typescript title="src/mastra/index.ts" showLineNumbers copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { MastraAuthAuth0 } from "@mastra/auth-auth0";
 
 export const mastra = new Mastra({
-  // ..
   server: {
     auth: new MastraAuthAuth0({
       domain: process.env.AUTH0_DOMAIN,

package/.docs/raw/reference/auth/clerk.mdx

@@ -9,12 +9,11 @@ The `MastraAuthClerk` class provides authentication for Mastra applications usin
 
 ## Usage example
 
-```typescript title="src/mastra/index.ts" showLineNumbers copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { MastraAuthClerk } from "@mastra/auth-clerk";
 
 export const mastra = new Mastra({
-  // ..
   server: {
     auth: new MastraAuthClerk({
       jwksUri: process.env.CLERK_JWKS_URI,

package/.docs/raw/reference/auth/firebase.mdx

@@ -11,13 +11,12 @@ The `MastraAuthFirebase` class provides authentication for Mastra using Firebase
 
 ### Basic usage with environment variables
 
-```typescript title="src/mastra/index.ts" showLineNumbers copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { MastraAuthFirebase } from "@mastra/auth-firebase";
 
 // Automatically uses FIREBASE_SERVICE_ACCOUNT and FIRESTORE_DATABASE_ID env vars
 export const mastra = new Mastra({
-  // ..
   server: {
     auth: new MastraAuthFirebase(),
   },
@@ -26,12 +25,11 @@ export const mastra = new Mastra({
 
 ### Custom configuration
 
-```typescript title="src/mastra/index.ts" showLineNumbers copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { MastraAuthFirebase } from "@mastra/auth-firebase";
 
 export const mastra = new Mastra({
-  // ..
   server: {
     auth: new MastraAuthFirebase({
       serviceAccount: "/path/to/service-account-key.json",

package/.docs/raw/reference/auth/jwt.mdx

@@ -9,12 +9,11 @@ The `MastraJwtAuth` class provides a lightweight authentication mechanism for Ma
 
 ## Usage example
 
-```typescript title="src/mastra/index.ts" showLineNumbers copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { MastraJwtAuth } from "@mastra/auth";
 
 export const mastra = new Mastra({
-  // ..
   server: {
     auth: new MastraJwtAuth({
       secret: "<your-secret>",

package/.docs/raw/reference/auth/supabase.mdx

@@ -9,12 +9,11 @@ The `MastraAuthSupabase` class provides authentication for Mastra using Supabase
 
 ## Usage example
 
-```typescript title="src/mastra/index.ts" showLineNumbers copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { MastraAuthSupabase } from "@mastra/auth-supabase";
 
 export const mastra = new Mastra({
-  // ..
   server: {
     auth: new MastraAuthSupabase({
       url: process.env.SUPABASE_URL,

package/.docs/raw/reference/auth/workos.mdx

@@ -9,12 +9,11 @@ The `MastraAuthWorkos` class provides authentication for Mastra using WorkOS. It
 
 ## Usage example
 
-```typescript title="src/mastra/index.ts" showLineNumbers copy
+```typescript title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { MastraAuthWorkos } from "@mastra/auth-workos";
 
 export const mastra = new Mastra({
-  // ..
   server: {
     auth: new MastraAuthWorkos({
       apiKey: process.env.WORKOS_API_KEY,

package/.docs/raw/reference/cli/create-mastra.mdx

@@ -15,28 +15,28 @@ The `create-mastra` command **creates** a new standalone Mastra project. Use thi
 <Tabs>
 <TabItem value="npm" label="npm">
 
-```bash copy
+```bash
 npx create-mastra@beta
 ```
 
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
-```bash copy
+```bash
 yarn dlx create-mastra@beta
 ```
 
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
-```bash copy
+```bash
 pnpm create mastra@beta
 ```
 
 </TabItem>
 <TabItem value="bun" label="bun">
 
-```bash copy
+```bash
 bun create mastra@beta
 ```
 
@@ -48,28 +48,28 @@ bun create mastra@beta
 <Tabs>
 <TabItem value="npm" label="npm">
 
-```bash copy
+```bash
 npx create-mastra@beta my-mastra-project -- --template coding-agent
 ```
 
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
-```bash copy
+```bash
 yarn dlx create-mastra@beta --template coding-agent
 ```
 
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
-```bash copy
+```bash
 pnpm create mastra@beta --template coding-agent
 ```
 
 </TabItem>
 <TabItem value="bun" label="bun">
 
-```bash copy
+```bash
 bun create mastra@beta --template coding-agent
 ```
 
@@ -183,12 +183,12 @@ By default, Mastra collects anonymous information about your project like your O
 
 You can opt out of the CLI analytics by setting an environment variable:
 
-```bash copy
+```bash
 MASTRA_TELEMETRY_DISABLED=1
 ```
 
 You can also set this while using other `mastra` commands:
 
-```bash copy
+```bash
 MASTRA_TELEMETRY_DISABLED=1 npx create-mastra@beta
 ```

package/.docs/raw/reference/cli/mastra.mdx

@@ -41,7 +41,7 @@ You can set certain environment variables to modify the behavior of `mastra dev`
 
 Set `MASTRA_DEV_NO_CACHE=1` to force a full rebuild rather than using the cached assets under `.mastra/`:
 
-```bash copy
+```bash
 MASTRA_DEV_NO_CACHE=1 mastra dev
 ```
 
@@ -51,7 +51,7 @@ This helps when you are debugging bundler plugins or suspect stale output.
 
 `MASTRA_CONCURRENCY` caps how many expensive operations run in parallel (primarily build and evaluation steps). For example:
 
-```bash copy
+```bash
 MASTRA_CONCURRENCY=4 mastra dev
 ```
 
@@ -61,7 +61,7 @@ Leave it unset to let the CLI pick a sensible default for the machine.
 
 When using providers supported by the Vercel AI SDK you can redirect requests through proxies or internal gateways by setting a base URL. For OpenAI:
 
-```bash copy
+```bash
 OPENAI_API_KEY=<your-api-key> \
 OPENAI_BASE_URL=https://openrouter.example/v1 \
 mastra dev
@@ -69,7 +69,7 @@ mastra dev
 
 For Anthropic:
 
-```bash copy
+```bash
 ANTHROPIC_API_KEY=<your-api-key> \
 ANTHROPIC_BASE_URL=https://anthropic.internal \
 mastra dev
@@ -98,7 +98,7 @@ You can set certain environment variables to modify the behavior of `mastra buil
 
 For CI or when running in resource constrained environments you can cap how many expensive tasks run at once by setting `MASTRA_CONCURRENCY`.
 
-```bash copy
+```bash
 MASTRA_CONCURRENCY=2 mastra build
 ```
 
@@ -152,13 +152,13 @@ Read the [Scorers overview](/docs/v1/evals/overview) to learn more.
 
 Add a new scorer to your project. You can use an interactive prompt:
 
-```bash copy
+```bash
 mastra scorers add
 ```
 
 Or provide a scorer name directly:
 
-```bash copy
+```bash
 mastra scorers add answer-relevancy
 ```
 
@@ -258,13 +258,13 @@ By default, Mastra collects anonymous information about your project like your O
 
 You can opt out of the CLI analytics by setting an environment variable:
 
-```bash copy
+```bash
 MASTRA_TELEMETRY_DISABLED=1
 ```
 
 You can also set this while using other `mastra` commands:
 
-```bash copy
+```bash
 MASTRA_TELEMETRY_DISABLED=1 mastra dev
 ```
 

package/.docs/raw/reference/client-js/agents.mdx

@@ -24,7 +24,6 @@ Get an instance of a specific agent by its ID:
 ```typescript title="src/mastra/agents/my-agent.ts"
 export const myAgent = new Agent({
   id: "my-agent",
-  // ...
 });
 ```
 
@@ -123,7 +122,7 @@ while (true) {
 
 To stream AI SDK-formatted parts on the client from an `agent.stream(...)` response, wrap `response.processDataStream` into a `ReadableStream<ChunkType>` and use `toAISdkStream`:
 
-```typescript title="client-ai-sdk-transform.ts" copy
+```typescript title="client-ai-sdk-transform.ts"
 import { createUIMessageStream } from "ai";
 import { toAISdkStream } from "@mastra/ai-sdk";
 import type { ChunkType, MastraModelOutput } from "@mastra/core/stream";

package/.docs/raw/reference/client-js/mastra-client.mdx

@@ -9,7 +9,7 @@ The Mastra Client SDK provides a simple and type-safe interface for interacting
 
 ## Usage example
 
-```typescript title="lib/mastra/mastra-client.ts" showLineNumbers copy
+```typescript title="lib/mastra/mastra-client.ts"
 import { MastraClient } from "@mastra/client-js";
 
 export const mastraClient = new MastraClient({

package/.docs/raw/reference/core/getAgent.mdx

@@ -9,7 +9,7 @@ The `.getAgent()` method is used to retrieve an agent. The method accepts a sing
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.getAgent("testAgent");
 ```
 

package/.docs/raw/reference/core/getAgentById.mdx

@@ -9,7 +9,7 @@ The `.getAgentById()` method is used to retrieve an agent by its ID. The method
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.getAgentById("test-agent-123");
 ```
 

package/.docs/raw/reference/core/getDeployer.mdx

@@ -9,7 +9,7 @@ The `.getDeployer()` method is used to retrieve the deployer instance that has b
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.getDeployer();
 ```
 

package/.docs/raw/reference/core/getLogger.mdx

@@ -9,7 +9,7 @@ The `.getLogger()` method is used to retrieve the logger instance that has been
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.getLogger();
 ```
 

package/.docs/raw/reference/core/getMCPServer.mdx

@@ -9,7 +9,7 @@ The `.getMCPServer()` method retrieves an MCP server instance by its registry ke
 
 ## Usage example
 
-```typescript copy
+```typescript
 // Register an MCP server with a registry key
 const myServer = new MCPServer({
   id: 'my-mcp-server',

package/.docs/raw/reference/core/getMCPServerById.mdx

@@ -9,7 +9,7 @@ The `.getMCPServerById()` method retrieves an MCP server instance by its intrins
 
 ## Usage example
 
-```typescript copy
+```typescript
 // Register an MCP server with a registry key
 const myServer = new MCPServer({
   id: 'my-mcp-server',

package/.docs/raw/reference/core/getMemory.mdx

@@ -9,7 +9,7 @@ The `.getMemory()` method retrieves a memory instance from the Mastra registry b
 
 ## Usage example
 
-```typescript copy
+```typescript
 const memory = mastra.getMemory("conversationMemory");
 
 // Use the memory instance
@@ -47,7 +47,7 @@ const thread = await memory.createThread({
 
 ## Example: Registering and Retrieving Memory
 
-```typescript copy
+```typescript
 import { Mastra } from "@mastra/core";
 import { Memory } from "@mastra/memory";
 import { LibSQLStore } from "@mastra/libsql";

package/.docs/raw/reference/core/getServer.mdx

@@ -9,7 +9,7 @@ The `.getServer()` method is used to retrieve the server configuration that has
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.getServer();
 ```
 

package/.docs/raw/reference/core/getStorage.mdx

@@ -9,7 +9,7 @@ The `.getStorage()` method is used to retrieve the storage instance that has bee
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.getStorage();
 ```
 
@@ -32,5 +32,5 @@ This method does not accept any parameters.
 
 ## Related
 
-- [Storage overview](/docs/v1/memory/storage/overview)
+- [Storage overview](/reference/v1/storage/overview)
 - [Storage reference](/reference/v1/storage/libsql)

package/.docs/raw/reference/core/getStoredAgentById.mdx

@@ -9,7 +9,7 @@ The `.getStoredAgentById()` method retrieves an agent configuration from storage
 
 ## Usage example
 
-```typescript copy
+```typescript
 // Get an Agent instance from storage
 const agent = await mastra.getStoredAgentById("my-stored-agent");
 
@@ -19,7 +19,7 @@ if (agent) {
 }
 ```
 
-```typescript copy
+```typescript
 // Get the raw storage data instead of an Agent instance
 const storedConfig = await mastra.getStoredAgentById("my-stored-agent", { raw: true });
 
@@ -179,5 +179,5 @@ When using `raw: true`, the returned object has the following structure:
 ## Related
 
 - [Mastra.listStoredAgents()](/reference/v1/core/listStoredAgents)
-- [Storage overview](/docs/v1/memory/storage/overview)
+- [Storage overview](/reference/v1/storage/overview)
 - [Agents overview](/docs/v1/agents/overview)

package/.docs/raw/reference/core/getTelemetry.mdx

@@ -9,7 +9,7 @@ The `.getTelemetry()` method is used to retrieve the telemetry instance that has
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.getTelemetry();
 ```
 

package/.docs/raw/reference/core/getVector.mdx

@@ -9,7 +9,7 @@ The `.getVector()` method is used to retrieve a vector store by its name. The me
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.getVector("testVectorStore");
 ```
 

package/.docs/raw/reference/core/getWorkflow.mdx

@@ -9,7 +9,7 @@ The `.getWorkflow()` method is used to retrieve a workflow by its ID. The method
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.getWorkflow("testWorkflow");
 ```