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

package/.docs/raw/rag/vector-databases.mdx

@@ -15,7 +15,7 @@ After generating embeddings, you need to store them in a database that supports
 <Tabs>
   <TabItem value="mongodb" label="MongoDB">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { MongoDBVector } from "@mastra/mongodb";
 
 const store = new MongoDBVector({
@@ -41,7 +41,7 @@ For detailed setup instructions and best practices, see the [official MongoDB At
 
   <TabItem value="pg-vector" label="PgVector">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { PgVector } from "@mastra/pg";
 
 const store = new PgVector({
@@ -70,7 +70,7 @@ For detailed setup instructions and best practices, see the [official pgvector r
 
   <TabItem value="pinecone" label="Pinecone">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { PineconeVector } from "@mastra/pinecone";
 
 const store = new PineconeVector({
@@ -92,7 +92,7 @@ await store.upsert({
 
   <TabItem value="qdrant" label="Qdrant">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { QdrantVector } from "@mastra/qdrant";
 
 const store = new QdrantVector({
@@ -117,7 +117,7 @@ await store.upsert({
 
   <TabItem value="chroma" label="Chroma">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { ChromaVector } from "@mastra/chroma";
 
 // Running Chroma locally
@@ -147,7 +147,7 @@ await store.upsert({
 
   <TabItem value="astra" label="Astra">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { AstraVector } from "@mastra/astra";
 
 const store = new AstraVector({
@@ -170,9 +170,9 @@ await store.upsert({
 
   </TabItem>
 
-  <TabItem value="libsql" label="LibSQL">
+  <TabItem value="libsql" label="libSQL">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { LibSQLVector } from "@mastra/core/vector/libsql";
 
 const store = new LibSQLVector({
@@ -197,7 +197,7 @@ await store.upsert({
 
   <TabItem value="upstash" label="Upstash">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { UpstashVector } from "@mastra/upstash";
 
 // In upstash they refer to the store as an index
@@ -220,7 +220,7 @@ await store.upsert({
 
   <TabItem value="cloudflare" label="Cloudflare">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { CloudflareVector } from "@mastra/vectorize";
 
 const store = new CloudflareVector({
@@ -242,7 +242,7 @@ await store.upsert({
 
   <TabItem value="opensearch" label="OpenSearch">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { OpenSearchVector } from "@mastra/opensearch";
 
 const store = new OpenSearchVector({ url: process.env.OPENSEARCH_URL });
@@ -263,7 +263,7 @@ await store.upsert({
 
   <TabItem value="elasticsearch" label="ElasticSearch">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { ElasticSearchVector } from "@mastra/elasticsearch";
 
 const store = new ElasticSearchVector({ url: process.env.ELASTICSEARCH_URL });
@@ -283,7 +283,7 @@ await store.upsert({
   </TabItem>
   <TabItem value="couchbase" label="Couchbase">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { CouchbaseVector } from "@mastra/couchbase";
 
 const store = new CouchbaseVector({
@@ -308,7 +308,7 @@ await store.upsert({
   </TabItem>
   <TabItem value="lancedb" label="Lance">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { LanceVectorStore } from "@mastra/lance";
 
 const store = await LanceVectorStore.create("/path/to/db");
@@ -334,7 +334,7 @@ For detailed setup instructions and best practices, see the [official LanceDB do
   </TabItem>
   <TabItem value="s3vectors" label="S3 Vectors">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { S3Vectors } from "@mastra/s3vectors";
 
 const store = new S3Vectors({
@@ -368,7 +368,7 @@ Once initialized, all vector stores share the same interface for creating indexe
 
 Before storing embeddings, you need to create an index with the appropriate dimension size for your embedding model:
 
-```ts title="store-embeddings.ts" showLineNumbers copy
+```ts title="store-embeddings.ts"
 // Create an index with dimension 1536 (for text-embedding-3-small)
 await store.createIndex({
   indexName: "myCollection",
@@ -445,7 +445,7 @@ Each vector database enforces specific naming conventions for indexes and collec
     - Example: `my_collection_123` is valid
     - Example: `my-collection` is not valid (contains hyphen)
   </TabItem>
-  <TabItem value="libsql" label="LibSQL">
+  <TabItem value="libsql" label="libSQL">
     Index names must:
     - Start with a letter or underscore
     - Contain only letters, numbers, and underscores
@@ -514,7 +514,7 @@ Each vector database enforces specific naming conventions for indexes and collec
 
 After creating an index, you can store embeddings along with their basic metadata:
 
-```ts title="store-embeddings.ts" showLineNumbers copy
+```ts title="store-embeddings.ts"
 // Store embeddings with their corresponding metadata
 await store.upsert({
   indexName: "myCollection", // index name
@@ -541,7 +541,7 @@ Vector stores support rich metadata (any JSON-serializable fields) for filtering
 Metadata is crucial for vector storage - without it, you'd only have numerical embeddings with no way to return the original text or filter results. Always store at least the source text as metadata.
 :::
 
-```ts showLineNumbers copy
+```ts
 // Store embeddings with rich metadata for better organization and filtering
 await store.upsert({
   indexName: "myCollection",
@@ -581,7 +581,7 @@ When building RAG applications, you often need to clean up stale vectors when do
 
 The most common use case is deleting all vectors for a specific document when a user deletes it:
 
-```ts title="delete-vectors.ts" showLineNumbers copy
+```ts title="delete-vectors.ts"
 // Delete all vectors for a specific document
 await store.deleteVectors({
   indexName: "myCollection",
@@ -598,7 +598,7 @@ This is particularly useful when:
 
 You can also use complex filters to delete vectors matching multiple conditions:
 
-```ts title="delete-vectors-advanced.ts" showLineNumbers copy
+```ts title="delete-vectors-advanced.ts"
 // Delete all vectors for multiple documents
 await store.deleteVectors({
   indexName: "myCollection",
@@ -623,7 +623,7 @@ await store.deleteVectors({
 
 If you have specific vector IDs to delete, you can pass them directly:
 
-```ts title="delete-by-ids.ts" showLineNumbers copy
+```ts title="delete-by-ids.ts"
 // Delete specific vectors by their IDs
 await store.deleteVectors({
   indexName: "myCollection",

package/.docs/raw/reference/agents/agent.mdx

@@ -11,7 +11,7 @@ The `Agent` class is the foundation for creating AI agents in Mastra. It provide
 
 ### Basic string instructions
 
-```typescript title="src/mastra/agents/string-agent.ts" showLineNumbers copy
+```typescript title="src/mastra/agents/string-agent.ts"
 import { Agent } from "@mastra/core/agent";
 
 // String instructions
@@ -49,7 +49,7 @@ export const agent3 = new Agent({
 
 Use CoreSystemMessage format to access additional properties like `providerOptions` for provider-specific configurations:
 
-```typescript title="src/mastra/agents/core-message-agent.ts" showLineNumbers copy
+```typescript title="src/mastra/agents/core-message-agent.ts"
 import { Agent } from "@mastra/core/agent";
 
 export const agent = new Agent({
@@ -71,7 +71,7 @@ export const agent = new Agent({
 
 ### Multiple CoreSystemMessages
 
-```typescript title="src/mastra/agents/multi-message-agent.ts" showLineNumbers copy
+```typescript title="src/mastra/agents/multi-message-agent.ts"
 import { Agent } from "@mastra/core/agent";
 
 // This could be customizable based on the user

package/.docs/raw/reference/agents/generate.mdx

@@ -11,7 +11,7 @@ The `.generate()` method enables non-streaming response generation from an agent
 
 ## Usage example
 
-```typescript copy
+```typescript
 // Default Mastra format
 const mastraResult = await agent.generate("message for agent");
 

package/.docs/raw/reference/agents/generateLegacy.mdx

@@ -15,7 +15,7 @@ The `.generateLegacy()` method is the legacy version of the agent generation API
 
 ## Usage example
 
-```typescript copy
+```typescript
 await agent.generateLegacy("message for agent");
 ```
 
@@ -546,7 +546,7 @@ const result = await agent.generate("message", {
 
 ## Extended usage example
 
-```typescript showLineNumbers copy
+```typescript
 import { z } from "zod";
 import {
   ModerationProcessor,

package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx

@@ -15,7 +15,7 @@ Agents can be configured with default generation options for controlling model b
 
 ## Usage example
 
-```typescript copy
+```typescript
 await agent.getDefaultGenerateOptionsLegacy();
 ```
 
@@ -48,7 +48,7 @@ await agent.getDefaultGenerateOptionsLegacy();
 
 ## Extended usage example
 
-```typescript copy
+```typescript
 await agent.getDefaultGenerateOptionsLegacy({
   requestContext: new RequestContext(),
 });

package/.docs/raw/reference/agents/getDefaultOptions.mdx

@@ -9,7 +9,7 @@ Agents can be configured with default options for memory usage, output format, a
 
 ## Usage example
 
-```typescript copy
+```typescript
 await agent.getDefaultOptions();
 ```
 
@@ -42,7 +42,7 @@ await agent.getDefaultOptions();
 
 ## Extended usage example
 
-```typescript copy
+```typescript
 await agent.getDefaultOptions({
   requestContext: new RequestContext(),
 });

package/.docs/raw/reference/agents/getDefaultStreamOptions.mdx

@@ -15,7 +15,7 @@ Agents can be configured with default streaming options for memory usage, output
 
 ## Usage example
 
-```typescript copy
+```typescript
 await agent.getDefaultStreamOptionsLegacy();
 ```
 
@@ -48,7 +48,7 @@ await agent.getDefaultStreamOptionsLegacy();
 
 ## Extended usage example
 
-```typescript copy
+```typescript
 await agent.getDefaultStreamOptionsLegacy({
   requestContext: new RequestContext(),
 });

package/.docs/raw/reference/agents/getDescription.mdx

@@ -9,7 +9,7 @@ The `.getDescription()` method retrieves the description configured for an agent
 
 ## Usage example
 
-```typescript copy
+```typescript
 agent.getDescription();
 ```
 

package/.docs/raw/reference/agents/getInstructions.mdx

@@ -9,7 +9,7 @@ The `.getInstructions()` method retrieves the instructions configured for an age
 
 ## Usage example
 
-```typescript copy
+```typescript
 await agent.getInstructions();
 ```
 
@@ -42,7 +42,7 @@ await agent.getInstructions();
 
 ## Extended usage example
 
-```typescript copy
+```typescript
 await agent.getInstructions({
   requestContext: new RequestContext(),
 });

package/.docs/raw/reference/agents/getLLM.mdx

@@ -9,7 +9,7 @@ The `.getLLM()` method retrieves the language model instance configured for an a
 
 ## Usage example
 
-```typescript copy
+```typescript
 await agent.getLLM();
 ```
 
@@ -43,7 +43,7 @@ await agent.getLLM();
 
 ## Extended usage example
 
-```typescript copy
+```typescript
 await agent.getLLM({
   requestContext: new RequestContext(),
   model: "openai/gpt-5.1",

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

@@ -9,7 +9,7 @@ The `.getMemory()` method retrieves the memory system associated with an agent.
 
 ## Usage example
 
-```typescript copy
+```typescript
 await agent.getMemory();
 ```
 
@@ -42,7 +42,7 @@ await agent.getMemory();
 
 ## Extended usage example
 
-```typescript copy
+```typescript
 await agent.getMemory({
   requestContext: new RequestContext(),
 });

package/.docs/raw/reference/agents/getModel.mdx

@@ -9,7 +9,7 @@ The `.getModel()` method retrieves the language model configured for an agent, r
 
 ## Usage example
 
-```typescript copy
+```typescript
 await agent.getModel();
 ```
 
@@ -42,7 +42,7 @@ await agent.getModel();
 
 ## Extended usage example
 
-```typescript copy
+```typescript
 await agent.getModel({
   requestContext: new RequestContext(),
 });

package/.docs/raw/reference/agents/getTools.mdx

@@ -9,7 +9,7 @@ The `.getTools()` method retrieves the tools configured for an agent, resolving
 
 ## Usage example
 
-```typescript copy
+```typescript
 await agent.getTools();
 ```
 
@@ -42,7 +42,7 @@ await agent.getTools();
 
 ## Extended usage example
 
-```typescript copy
+```typescript
 await agent.getTools({
   requestContext: new RequestContext(),
 });

package/.docs/raw/reference/agents/getVoice.mdx

@@ -9,7 +9,7 @@ The `.getVoice()` method retrieves the voice provider configured for an agent, r
 
 ## Usage example
 
-```typescript copy
+```typescript
 await agent.getVoice();
 ```
 
@@ -42,7 +42,7 @@ await agent.getVoice();
 
 ## Extended usage example
 
-```typescript copy
+```typescript
 await agent.getVoice({
   requestContext: new RequestContext(),
 });

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

@@ -9,7 +9,7 @@ The `.listAgents()` method retrieves the sub-agents configured for an agent, res
 
 ## Usage example
 
-```typescript copy
+```typescript
 await agent.listAgents();
 ```
 
@@ -42,7 +42,7 @@ await agent.listAgents();
 
 ## Extended usage example
 
-```typescript copy
+```typescript
 import { RequestContext } from "@mastra/core/request-context";
 
 await agent.listAgents({

package/.docs/raw/reference/agents/listScorers.mdx

@@ -9,7 +9,7 @@ The `.listScorers()` method retrieves the scoring configuration configured for a
 
 ## Usage example
 
-```typescript copy
+```typescript
 await agent.listScorers();
 ```
 
@@ -42,7 +42,7 @@ await agent.listScorers();
 
 ## Extended usage example
 
-```typescript copy
+```typescript
 await agent.listScorers({
   requestContext: new RequestContext(),
 });

package/.docs/raw/reference/agents/listTools.mdx

@@ -9,7 +9,7 @@ The `.listTools()` method retrieves the tools configured for an agent, resolving
 
 ## Usage example
 
-```typescript copy
+```typescript
 await agent.listTools();
 ```
 
@@ -42,7 +42,7 @@ await agent.listTools();
 
 ## Extended usage example
 
-```typescript copy
+```typescript
 await agent.listTools({
   requestContext: new RequestContext(),
 });

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

@@ -9,7 +9,7 @@ The `.listWorkflows()` method retrieves the workflows configured for an agent, r
 
 ## Usage example
 
-```typescript copy
+```typescript
 await agent.listWorkflows();
 ```
 
@@ -42,7 +42,7 @@ await agent.listWorkflows();
 
 ## Extended usage example
 
-```typescript copy
+```typescript
 await agent.listWorkflows({
   requestContext: new RequestContext(),
 });

package/.docs/raw/reference/agents/network.mdx

@@ -15,7 +15,7 @@ The `.network()` method enables multi-agent collaboration and routing. This meth
 
 ## Usage example
 
-```typescript copy
+```typescript
 import { Agent } from "@mastra/core/agent";
 import { agent1, agent2 } from "./agents";
 import { workflow1 } from "./workflows";

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