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

package/.docs/raw/rag/retrieval.mdx

@@ -26,7 +26,7 @@ Mastra provides flexible retrieval options with support for semantic search, fil
 
 The simplest approach is direct semantic search. This method uses vector similarity to find chunks that are semantically similar to the query:
 
-```ts showLineNumbers copy
+```ts
 import { embed } from "ai";
 import { PgVector } from "@mastra/pg";
 import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
@@ -56,7 +56,7 @@ The `topK` parameter specifies the maximum number of most similar results to ret
 
 Results include both the text content and a similarity score:
 
-```ts showLineNumbers copy
+```ts
 [
   {
     text: "Climate change poses significant challenges...",
@@ -68,7 +68,6 @@ Results include both the text content and a similarity score:
     score: 0.82,
     metadata: { source: "article1.txt" },
   },
-  // ... more results
 ];
 ```
 
@@ -84,7 +83,7 @@ For detailed information about available operators and syntax, see the [Metadata
 
 Basic filtering examples:
 
-```ts showLineNumbers copy
+```ts
 // Simple equality filter
 const results = await pgVector.query({
   indexName: "embeddings",
@@ -152,7 +151,7 @@ Common use cases for metadata filtering:
 
 Sometimes you want to give your agent the ability to query a vector database directly. The Vector Query Tool allows your agent to be in charge of retrieval decisions, combining semantic search with optional filtering and reranking based on the agent's understanding of the user's needs.
 
-```ts showLineNumbers copy
+```ts
 import { createVectorQueryTool } from "@mastra/rag";
 import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
 
@@ -182,7 +181,7 @@ These configurations are for **query-time options** like namespaces, performance
 Connection credentials (URLs, auth tokens) are configured when you instantiate the vector store class (e.g., `new LibSQLVector({ connectionUrl: '...' })`).
 :::
 
-```ts showLineNumbers copy
+```ts
 import { createVectorQueryTool } from "@mastra/rag";
 import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
 
@@ -257,7 +256,7 @@ const lanceQueryTool = createVectorQueryTool({
 
 You can also override these configurations at runtime using the request context:
 
-```ts showLineNumbers copy
+```ts
 import { RequestContext } from "@mastra/core/request-context";
 
 const requestContext = new RequestContext();
@@ -284,7 +283,7 @@ When implementing filtering, these prompts are required in the agent's instructi
 <Tabs>
   <TabItem value="pgvector" label="pgVector">
 
-```ts showLineNumbers copy
+```ts
 import { PGVECTOR_PROMPT } from "@mastra/pg";
 
 export const ragAgent = new Agent({
@@ -303,7 +302,7 @@ export const ragAgent = new Agent({
 
   <TabItem value="pinecone" label="Pinecone">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { PINECONE_PROMPT } from "@mastra/pinecone";
 
 export const ragAgent = new Agent({
@@ -322,7 +321,7 @@ export const ragAgent = new Agent({
 
   <TabItem value="qdrant" label="Qdrant">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { QDRANT_PROMPT } from "@mastra/qdrant";
 
 export const ragAgent = new Agent({
@@ -341,7 +340,7 @@ export const ragAgent = new Agent({
 
   <TabItem value="chroma" label="Chroma">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { CHROMA_PROMPT } from "@mastra/chroma";
 
 export const ragAgent = new Agent({
@@ -360,7 +359,7 @@ export const ragAgent = new Agent({
 
   <TabItem value="astra" label="Astra">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { ASTRA_PROMPT } from "@mastra/astra";
 
 export const ragAgent = new Agent({
@@ -377,9 +376,9 @@ export const ragAgent = new Agent({
 
   </TabItem>
 
-  <TabItem value="libsql" label="LibSQL">
+  <TabItem value="libsql" label="libSQL">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { LIBSQL_PROMPT } from "@mastra/libsql";
 
 export const ragAgent = new Agent({
@@ -398,7 +397,7 @@ export const ragAgent = new Agent({
 
   <TabItem value="upstash" label="Upstash">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { UPSTASH_PROMPT } from "@mastra/upstash";
 
 export const ragAgent = new Agent({
@@ -417,7 +416,7 @@ export const ragAgent = new Agent({
 
   <TabItem value="vectorize" label="Vectorize">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { VECTORIZE_PROMPT } from "@mastra/vectorize";
 
 export const ragAgent = new Agent({
@@ -436,7 +435,7 @@ export const ragAgent = new Agent({
 
   <TabItem value="mongodb" label="MongoDB">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { MONGODB_PROMPT } from "@mastra/mongodb";
 
 export const ragAgent = new Agent({
@@ -455,7 +454,7 @@ export const ragAgent = new Agent({
 
   <TabItem value="opensearch" label="OpenSearch">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { OPENSEARCH_PROMPT } from "@mastra/opensearch";
 
 export const ragAgent = new Agent({
@@ -474,7 +473,7 @@ export const ragAgent = new Agent({
 
   <TabItem value="s3vectors" label="S3Vectors">
 
-```ts title="vector-store.ts" showLineNumbers copy
+```ts title="vector-store.ts"
 import { S3VECTORS_PROMPT } from "@mastra/s3vectors";
 
 export const ragAgent = new Agent({
@@ -503,7 +502,7 @@ Initial vector similarity search can sometimes miss nuanced relevance. Re-rankin
 
 Here's how to use re-ranking:
 
-```ts showLineNumbers copy
+```ts
 import {
   rerankWithScorer as rerank,
   MastraAgentRelevanceScorer
@@ -547,11 +546,11 @@ For semantic scoring to work properly during re-ranking, each result must includ
 
 You can also use other relevance score providers like Cohere or ZeroEntropy:
 
-```ts showLineNumbers copy
+```ts
 const relevanceProvider = new CohereRelevanceScorer("rerank-v3.5");
 ```
 
-```ts showLineNumbers copy
+```ts
 const relevanceProvider = new ZeroEntropyRelevanceScorer("zerank-1");
 ```
 

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