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

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");
 ```
 

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

@@ -9,7 +9,7 @@ The `.listAgents()` method is used to retrieve all agents that have been configu
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.listAgents();
 ```
 

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

@@ -9,7 +9,7 @@ The `.listLogs()` method is used to retrieve all logs for a specific transport I
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.listLogs("456");
 ```
 

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

@@ -9,7 +9,7 @@ The `.listLogsByRunId()` method is used to retrieve logs for a specific run ID a
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.listLogsByRunId({ runId: "123", transportId: "456" });
 ```
 

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

@@ -9,7 +9,7 @@ The `.listMCPServers()` method is used to retrieve all MCP server instances that
 
 ## Usage example
 
-```typescript copy
+```typescript
 // Register MCP servers
 const server1 = new MCPServer({
   id: 'server-one',

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

@@ -9,7 +9,7 @@ The `.listMemory()` method returns all memory instances registered with the Mast
 
 ## Usage example
 
-```typescript copy
+```typescript
 const memoryInstances = mastra.listMemory();
 
 for (const [key, memory] of Object.entries(memoryInstances)) {
@@ -36,7 +36,7 @@ This method takes no parameters.
 
 ## Example: Checking Registered Memory
 
-```typescript copy
+```typescript
 import { Mastra } from "@mastra/core";
 import { Memory } from "@mastra/memory";
 import { LibSQLStore } from "@mastra/libsql";

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

@@ -9,7 +9,7 @@ The `.listStoredAgents()` method retrieves a paginated list of agent configurati
 
 ## Usage example
 
-```typescript copy
+```typescript
 // Get Agent instances from storage
 const { agents, total, hasMore } = await mastra.listStoredAgents();
 
@@ -20,7 +20,7 @@ for (const agent of agents) {
 }
 ```
 
-```typescript copy
+```typescript
 // Get paginated results with raw storage data
 const result = await mastra.listStoredAgents({
   page: 0,
@@ -127,7 +127,7 @@ If a referenced primitive is not found, a warning is logged but the agent is sti
 
 ## Example: Iterating Through All Stored Agents
 
-```typescript copy
+```typescript
 async function getAllStoredAgents(mastra: Mastra) {
   const allAgents: Agent[] = [];
   let page = 0;
@@ -147,5 +147,5 @@ async function getAllStoredAgents(mastra: Mastra) {
 ## Related
 
 - [Mastra.getStoredAgentById()](/reference/v1/core/getStoredAgentById)
-- [Storage overview](/docs/v1/memory/storage/overview)
+- [Storage overview](/reference/v1/storage/overview)
 - [Agents overview](/docs/v1/agents/overview)

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

@@ -9,7 +9,7 @@ The `.listVectors()` method is used to retrieve all vector stores that have been
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.listVectors();
 ```
 

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

@@ -9,7 +9,7 @@ The `.listWorkflows()` method is used to retrieve all workflows that have been c
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.listWorkflows();
 ```
 

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

@@ -9,7 +9,7 @@ The `.setLogger()` method is used to set the logger for all components (agents,
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.setLogger({ logger: new PinoLogger({ name: "testLogger" }) });
 ```
 

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

@@ -9,7 +9,7 @@ The `.setStorage()` method is used to set the storage instance for the Mastra in
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.setStorage(
   new LibSQLStore({
     id: 'mastra-storage',
@@ -36,5 +36,5 @@ This method does not return a value.
 
 ## 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/setTelemetry.mdx

@@ -9,7 +9,7 @@ The `.setTelemetry()` method is used to set the telemetry configuration for all
 
 ## Usage example
 
-```typescript copy
+```typescript
 mastra.setTelemetry({ export: { type: "console" } });
 ```