@mastra/mcp-docs-server 1.0.0-beta.8 → 1.0.0

package/.docs/raw/reference/vectors/pinecone.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: Pinecone Vector Store | Vectors"
 description: Documentation for the PineconeVector class in Mastra, which provides an interface to Pinecone's vector database.
+packages:
+  - "@mastra/pinecone"
 ---
 
 # Pinecone Vector Store
@@ -10,6 +12,8 @@ It provides real-time vector search, with features like hybrid search, metadata
 
 ## Constructor Options
 
+The constructor accepts all [Pinecone configuration options](https://docs.pinecone.io/reference/typescript-sdk) plus Mastra-specific fields.
+
 <PropertiesTable
   content={[
     {
@@ -23,24 +27,36 @@ It provides real-time vector search, with features like hybrid search, metadata
       description: "Pinecone API key",
     },
     {
-      name: "environment",
+      name: "controllerHostUrl",
+      type: "string",
+      isOptional: true,
+      description: "Custom Pinecone controller host URL",
+    },
+    {
+      name: "additionalHeaders",
+      type: "Record<string, string>",
+      isOptional: true,
+      description: "Additional HTTP headers to include in requests",
+    },
+    {
+      name: "sourceTag",
       type: "string",
       isOptional: true,
-      description: "Pinecone environment controller host URL",
+      description: "Source tag for request tracking",
     },
     {
       name: "cloud",
       type: "'aws' | 'gcp' | 'azure'",
       isOptional: true,
       defaultValue: "aws",
-      description: "Cloud provider for Pinecone serverless",
+      description: "Cloud provider for new index creation",
     },
     {
       name: "region",
       type: "string",
       isOptional: true,
       defaultValue: "us-east-1",
-      description: "Region for Pinecone serverless",
+      description: "Region for new index creation",
     },
   ]}
 />
@@ -184,7 +200,7 @@ Returns an array of index names as strings.
 
 Returns:
 
-```typescript copy
+```typescript
 interface IndexStats {
   dimension: number;
   count: number;
@@ -306,7 +322,7 @@ Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` m
 
 Query results are returned in this format:
 
-```typescript copy
+```typescript
 interface QueryResult {
   id: string;
   score: number;
@@ -319,7 +335,7 @@ interface QueryResult {
 
 The store throws typed errors that can be caught:
 
-```typescript copy
+```typescript
 try {
   await store.query({
     indexName: "index_name",
@@ -338,7 +354,6 @@ try {
 Required environment variables:
 
 - `PINECONE_API_KEY`: Your Pinecone API key
-- `PINECONE_ENVIRONMENT`: Pinecone environment (e.g., 'us-west1-gcp')
 
 ## Hybrid Search
 

package/.docs/raw/reference/vectors/qdrant.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: Qdrant Vector Store | Vectors"
 description: Documentation for integrating Qdrant with Mastra, a vector similarity search engine for managing vectors and payloads.
+packages:
+  - "@mastra/qdrant"
 ---
 
 # Qdrant Vector Store
@@ -46,7 +48,7 @@ It provides a production-ready service with a convenient API to store, search, a
     {
       name: "dimension",
       type: "number",
-      description: "Vector dimension (must match your embedding model)",
+      description: "Vector dimension (must match your embedding model). Required for single-vector collections.",
     },
     {
       name: "metric",
@@ -55,13 +57,38 @@ It provides a production-ready service with a convenient API to store, search, a
       defaultValue: "cosine",
       description: "Distance metric for similarity search",
     },
+    {
+      name: "namedVectors",
+      type: "Record<string, { size: number; distance: 'cosine' | 'euclidean' | 'dotproduct' }>",
+      isOptional: true,
+      description: "Configuration for named vector spaces. When provided, creates a collection with multiple named vector fields.",
+    },
   ]}
 />
 
+#### Creating a Named Vectors Collection
+
+```typescript
+// Create a collection with multiple named vector spaces
+await store.createIndex({
+  indexName: "multi_modal",
+  dimension: 768, // fallback
+  namedVectors: {
+    text: { size: 768, distance: "cosine" },
+    image: { size: 512, distance: "euclidean" },
+  },
+});
+```
+
 ### upsert()
 
 <PropertiesTable
   content={[
+    {
+      name: "indexName",
+      type: "string",
+      description: "Name of the index to upsert into",
+    },
     {
       name: "vectors",
       type: "number[][]",
@@ -79,9 +106,35 @@ It provides a production-ready service with a convenient API to store, search, a
       isOptional: true,
       description: "Optional vector IDs (auto-generated if not provided)",
     },
+    {
+      name: "vectorName",
+      type: "string",
+      isOptional: true,
+      description: "Name of the vector space to upsert into when using named vectors.",
+    },
   ]}
 />
 
+#### Upserting into Named Vector Spaces
+
+```typescript
+// Upsert into the "text" vector space
+await store.upsert({
+  indexName: "multi_modal",
+  vectors: textEmbeddings,
+  metadata: textMetadata,
+  vectorName: "text",
+});
+
+// Upsert into the "image" vector space
+await store.upsert({
+  indexName: "multi_modal",
+  vectors: imageEmbeddings,
+  metadata: imageMetadata,
+  vectorName: "image",
+});
+```
+
 ### query()
 
 <PropertiesTable
@@ -116,9 +169,28 @@ It provides a production-ready service with a convenient API to store, search, a
       defaultValue: "false",
       description: "Whether to include vectors in the results",
     },
+    {
+      name: "using",
+      type: "string",
+      isOptional: true,
+      description: "Name of the vector field to query when using named vectors. Use this when your collection has multiple named vector fields.",
+    },
   ]}
 />
 
+#### Named Vectors
+
+Qdrant supports [named vectors](https://qdrant.tech/documentation/concepts/vectors/#named-vectors), allowing multiple vector fields per collection. Use the `using` parameter to specify which named vector to query against:
+
+```typescript
+const results = await store.query({
+  indexName: "my_index",
+  queryVector: embedding,
+  topK: 10,
+  using: "title_embedding", // Query against a specific named vector
+});
+```
+
 ### listIndexes()
 
 Returns an array of index names as strings.
@@ -137,7 +209,7 @@ Returns an array of index names as strings.
 
 Returns:
 
-```typescript copy
+```typescript
 interface IndexStats {
   dimension: number;
   count: number;
@@ -235,11 +307,83 @@ Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` m
   ]}
 />
 
+### createPayloadIndex()
+
+Creates a payload (metadata) index on a collection field to enable efficient filtering. This is **required** for Qdrant Cloud and any Qdrant instance with `strict_mode_config = true`.
+
+<PropertiesTable
+  content={[
+    {
+      name: "indexName",
+      type: "string",
+      description: "Name of the collection to create the payload index on",
+    },
+    {
+      name: "fieldName",
+      type: "string",
+      description: "Name of the payload field to index",
+    },
+    {
+      name: "fieldSchema",
+      type: "'keyword' | 'integer' | 'float' | 'geo' | 'text' | 'bool' | 'datetime' | 'uuid'",
+      description: "The schema type for the payload field",
+    },
+    {
+      name: "wait",
+      type: "boolean",
+      isOptional: true,
+      defaultValue: "true",
+      description: "Whether to wait for the operation to complete",
+    },
+  ]}
+/>
+
+```typescript
+// Create a keyword index for filtering by source
+await store.createPayloadIndex({
+  indexName: "my_index",
+  fieldName: "source",
+  fieldSchema: "keyword",
+});
+
+const results = await store.query({
+  indexName: "my_index",
+  queryVector: queryVector,
+  filter: { source: "document-a" },
+});
+```
+
+### deletePayloadIndex()
+
+Removes a payload index from a collection field.
+
+<PropertiesTable
+  content={[
+    {
+      name: "indexName",
+      type: "string",
+      description: "Name of the collection to delete the payload index from",
+    },
+    {
+      name: "fieldName",
+      type: "string",
+      description: "Name of the payload field index to delete",
+    },
+    {
+      name: "wait",
+      type: "boolean",
+      isOptional: true,
+      defaultValue: "true",
+      description: "Whether to wait for the operation to complete",
+    },
+  ]}
+/>
+
 ## Response Types
 
 Query results are returned in this format:
 
-```typescript copy
+```typescript
 interface QueryResult {
   id: string;
   score: number;
@@ -252,7 +396,7 @@ interface QueryResult {
 
 The store throws typed errors that can be caught:
 
-```typescript copy
+```typescript
 try {
   await store.query({
     indexName: "index_name",

package/.docs/raw/reference/vectors/s3vectors.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: Amazon S3 Vectors Store | Vectors"
 description: Documentation for the S3Vectors class in Mastra, which provides vector search using Amazon S3 Vectors (Preview).
+packages:
+  - "@mastra/s3vectors"
 ---
 
 # Amazon S3 Vectors Store
@@ -14,13 +16,13 @@ The `S3Vectors` class provides vector search using [Amazon S3 Vectors (Preview)]
 
 ## Installation
 
-```bash copy
+```bash
 npm install @mastra/s3vectors@beta
 ```
 
 ## Usage Example
 
-```typescript copy showLineNumbers
+```typescript
 import { S3Vectors } from "@mastra/s3vectors";
 
 const store = new S3Vectors({
@@ -214,7 +216,7 @@ Returns information about the index.
 
 Returns:
 
-```typescript copy
+```typescript
 interface IndexStats {
   dimension: number;
   count: number; // computed via ListVectors pagination (O(n))
@@ -305,7 +307,7 @@ Closes the underlying AWS SDK HTTP handler to free sockets.
 
 Query results are returned in this format:
 
-```typescript copy
+```typescript
 interface QueryResult {
   id: string;
   score: number; // 1/(1 + distance)
@@ -337,7 +339,7 @@ S3 Vectors supports a strict subset of operators and value types. The Mastra fil
 
 **Examples:**
 
-```typescript copy
+```typescript
 // Implicit AND
 { genre: { $in: ["documentary", "comedy"] }, year: { $gte: 2020 } }
 
@@ -359,7 +361,7 @@ S3 Vectors supports a strict subset of operators and value types. The Mastra fil
 
 The store throws typed errors that can be caught:
 
-```typescript copy
+```typescript
 try {
   await store.query({
     indexName: "index-name",

package/.docs/raw/reference/vectors/turbopuffer.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: Turbopuffer Vector Store | Vectors"
 description: Documentation for integrating Turbopuffer with Mastra, a high-performance vector database for efficient similarity search.
+packages:
+  - "@mastra/turbopuffer"
 ---
 
 # Turbopuffer Vector Store
@@ -170,7 +172,7 @@ Returns an array of index names as strings.
 
 Returns:
 
-```typescript copy
+```typescript
 interface IndexStats {
   dimension: number;
   count: number;
@@ -268,7 +270,7 @@ Delete multiple vectors by IDs or by metadata filter. Either `ids` or `filter` m
 
 Query results are returned in this format:
 
-```typescript copy
+```typescript
 interface QueryResult {
   id: string;
   score: number;
@@ -281,7 +283,7 @@ interface QueryResult {
 
 The `schemaConfigForIndex` option allows you to define explicit schemas for different indexes:
 
-```typescript copy
+```typescript
 schemaConfigForIndex: (indexName: string) => {
   // Mastra's default embedding model and index for memory messages:
   if (indexName === "memory_messages_384") {
@@ -304,7 +306,7 @@ schemaConfigForIndex: (indexName: string) => {
 
 The store throws typed errors that can be caught:
 
-```typescript copy
+```typescript
 try {
   await store.query({
     indexName: "index_name",

package/.docs/raw/reference/vectors/upstash.mdx

@@ -1,6 +1,11 @@
 ---
 title: "Reference: Upstash Vector Store | Vectors"
 description: Documentation for the UpstashVector class in Mastra, which provides vector search using Upstash Vector.
+packages:
+  - "@mastra/core"
+  - "@mastra/fastembed"
+  - "@mastra/memory"
+  - "@mastra/upstash"
 ---
 
 # Upstash Vector Store
@@ -164,7 +169,7 @@ Returns an array of index names (namespaces) as strings.
 
 Returns:
 
-```typescript copy
+```typescript
 interface IndexStats {
   dimension: number;
   count: number;
@@ -238,7 +243,7 @@ Upstash Vector supports hybrid search that combines semantic search (dense vecto
 
 ### Basic Hybrid Usage
 
-```typescript copy
+```typescript
 import { UpstashVector } from "@mastra/upstash";
 
 const vectorStore = new UpstashVector({
@@ -275,7 +280,7 @@ const results = await vectorStore.query({
 
 ### Advanced Hybrid Search Options
 
-```typescript copy
+```typescript
 import { FusionAlgorithm, QueryMode } from "@upstash/vector";
 
 // Query with specific fusion algorithm
@@ -307,7 +312,7 @@ const sparseResults = await vectorStore.query({
 
 ### Updating Hybrid Vectors
 
-```typescript copy
+```typescript
 // Update both dense and sparse components
 await vectorStore.updateVector({
   indexName: "hybrid-index",
@@ -324,7 +329,7 @@ await vectorStore.updateVector({
 
 Query results are returned in this format:
 
-```typescript copy
+```typescript
 interface QueryResult {
   id: string;
   score: number;
@@ -337,7 +342,7 @@ interface QueryResult {
 
 The store throws typed errors that can be caught:
 
-```typescript copy
+```typescript
 try {
   await store.query({
     indexName: "index_name",
@@ -358,6 +363,55 @@ Required environment variables:
 - `UPSTASH_VECTOR_URL`: Your Upstash Vector database URL
 - `UPSTASH_VECTOR_TOKEN`: Your Upstash Vector API token
 
+## Usage Example
+
+### Local embeddings with fastembed
+
+Embeddings are numeric vectors used by memory's `semanticRecall` to retrieve related messages by meaning (not keywords). This setup uses `@mastra/fastembed` to generate vector embeddings.
+
+Install `fastembed` to get started:
+
+```bash
+npm install @mastra/fastembed@beta
+```
+
+Add the following to your agent:
+
+```typescript title="src/mastra/agents/example-upstash-agent.ts"
+import { Memory } from "@mastra/memory";
+import { Agent } from "@mastra/core/agent";
+import { UpstashStore, UpstashVector } from "@mastra/upstash";
+import { fastembed } from "@mastra/fastembed";
+
+export const upstashAgent = new Agent({
+  id: "upstash-agent",
+  name: "Upstash Agent",
+  instructions:
+    "You are an AI agent with the ability to automatically recall memories from previous interactions.",
+  model: "openai/gpt-5.1",
+  memory: new Memory({
+    storage: new UpstashStore({
+      id: 'upstash-agent-storage',
+      url: process.env.UPSTASH_REDIS_REST_URL!,
+      token: process.env.UPSTASH_REDIS_REST_TOKEN!,
+    }),
+    vector: new UpstashVector({
+      id: 'upstash-agent-vector',
+      url: process.env.UPSTASH_VECTOR_REST_URL!,
+      token: process.env.UPSTASH_VECTOR_REST_TOKEN!,
+    }),
+    embedder: fastembed,
+    options: {
+      lastMessages: 10,
+      semanticRecall: {
+        topK: 3,
+        messageRange: 2,
+      },
+    },
+  }),
+});
+```
+
 ## Related
 
 - [Metadata Filters](../rag/metadata-filters)

package/.docs/raw/reference/vectors/vectorize.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: Cloudflare Vector Store | Vectors"
 description: Documentation for the CloudflareVector class in Mastra, which provides vector search using Cloudflare Vectorize.
+packages:
+  - "@mastra/vectorize"
 ---
 
 # Cloudflare Vector Store
@@ -135,7 +137,7 @@ Returns an array of index names as strings.
 
 Returns:
 
-```typescript copy
+```typescript
 interface IndexStats {
   dimension: number;
   count: number;
@@ -259,7 +261,7 @@ Deletes a vector and its associated metadata for a specific ID within an index.
 
 Query results are returned in this format:
 
-```typescript copy
+```typescript
 interface QueryResult {
   id: string;
   score: number;
@@ -272,7 +274,7 @@ interface QueryResult {
 
 The store throws typed errors that can be caught:
 
-```typescript copy
+```typescript
 try {
   await store.query({
     indexName: "index_name",

package/.docs/raw/reference/voice/azure.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: Azure | Voice"
 description: "Documentation for the AzureVoice class, providing text-to-speech and speech-to-text capabilities using Azure Cognitive Services."
+packages:
+  - "@mastra/voice-azure"
 ---
 
 # Azure

package/.docs/raw/reference/voice/cloudflare.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: Cloudflare | Voice"
 description: "Documentation for the CloudflareVoice class, providing text-to-speech capabilities using Cloudflare Workers AI."
+packages:
+  - "@mastra/voice-cloudflare"
 ---
 
 # Cloudflare

package/.docs/raw/reference/voice/composite-voice.mdx

@@ -1,6 +1,10 @@
 ---
 title: "Reference: CompositeVoice | Voice"
 description: "Documentation for the CompositeVoice class, which enables combining multiple voice providers for flexible text-to-speech and speech-to-text operations."
+packages:
+  - "@mastra/core"
+  - "@mastra/voice-openai"
+  - "@mastra/voice-playai"
 ---
 
 # CompositeVoice

package/.docs/raw/reference/voice/deepgram.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: Deepgram | Voice"
 description: "Documentation for the Deepgram voice implementation, providing text-to-speech and speech-to-text capabilities with multiple voice models and languages."
+packages:
+  - "@mastra/voice-deepgram"
 ---
 
 # Deepgram

package/.docs/raw/reference/voice/elevenlabs.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: ElevenLabs | Voice"
 description: "Documentation for the ElevenLabs voice implementation, offering high-quality text-to-speech capabilities with multiple voice models and natural-sounding synthesis."
+packages:
+  - "@mastra/voice-elevenlabs"
 ---
 
 # ElevenLabs

package/.docs/raw/reference/voice/google-gemini-live.mdx

@@ -1,6 +1,9 @@
 ---
 title: "Reference: Google Gemini Live Voice | Voice"
 description: "Documentation for the GeminiLiveVoice class, providing real-time multimodal voice interactions using Google's Gemini Live API with support for both Gemini API and Vertex AI."
+packages:
+  - "@mastra/node-audio"
+  - "@mastra/voice-google-gemini-live"
 ---
 
 # Google Gemini Live Voice

package/.docs/raw/reference/voice/google.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: Google | Voice"
 description: "Documentation for the Google Voice implementation, providing text-to-speech and speech-to-text capabilities with support for both API key and Vertex AI authentication."
+packages:
+  - "@mastra/voice-google"
 ---
 
 # Google

package/.docs/raw/reference/voice/mastra-voice.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: MastraVoice | Voice"
 description: "Documentation for the MastraVoice abstract base class, which defines the core interface for all voice services in Mastra, including speech-to-speech capabilities."
+packages:
+  - "@mastra/core"
 ---
 
 # MastraVoice

package/.docs/raw/reference/voice/murf.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: Murf | Voice"
 description: "Documentation for the Murf voice implementation, providing text-to-speech capabilities."
+packages:
+  - "@mastra/voice-murf"
 ---
 
 # Murf

package/.docs/raw/reference/voice/openai-realtime.mdx

@@ -1,6 +1,9 @@
 ---
 title: "Reference: OpenAI Realtime Voice | Voice"
 description: "Documentation for the OpenAIRealtimeVoice class, providing real-time text-to-speech and speech-to-text capabilities via WebSockets."
+packages:
+  - "@mastra/node-audio"
+  - "@mastra/voice-openai-realtime"
 ---
 
 # OpenAI Realtime Voice

package/.docs/raw/reference/voice/openai.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: OpenAI | Voice"
 description: "Documentation for the OpenAIVoice class, providing text-to-speech and speech-to-text capabilities."
+packages:
+  - "@mastra/voice-openai"
 ---
 
 # OpenAI

package/.docs/raw/reference/voice/playai.mdx

@@ -1,6 +1,8 @@
 ---
 title: "Reference: PlayAI | Voice"
 description: "Documentation for the PlayAI voice implementation, providing text-to-speech capabilities."
+packages:
+  - "@mastra/voice-playai"
 ---
 
 # PlayAI