@mastra/mcp-docs-server 1.2.24-alpha.7 → 1.2.24

package/.docs/reference/tools/graph-rag-tool.md

@@ -61,7 +61,7 @@ const graphTool = createGraphRAGTool({
 
 The tool returns an object with:
 
-**relevantContext** (`string`): Combined text from the most relevant document chunks, retrieved using graph-based ranking
+**relevantContext** (`string[]`): Array of chunk text strings for the most relevant document chunks, in rank order, retrieved using graph-based ranking. Text is read from the text field of each chunk's metadata.
 
 **sources** (`QueryResult[]`): Array of full retrieval result objects. Each object contains all information needed to reference the original document, chunk, and similarity score.
 
@@ -77,6 +77,8 @@ The tool returns an object with:
 }
 ```
 
+The graph is built from the `text` field of each result's metadata, so `document` (and `relevantContext`) contain that text. Store the chunk text under `metadata.text` when upserting.
+
 ## Default tool description
 
 The default description focuses on:

package/.docs/reference/tools/vector-query-tool.md

@@ -79,7 +79,7 @@ const queryTool = createVectorQueryTool({
 
 The tool returns an object with:
 
-**relevantContext** (`string`): Combined text from the most relevant document chunks
+**relevantContext** (`any[]`): Array of metadata objects for the most relevant chunks, in rank order (one entry per result). The chunk text is available at relevantContext\[i].text when it was stored in metadata during ingestion.
 
 **sources** (`QueryResult[]`): Array of full retrieval result objects. Each object contains all information needed to reference the original document, chunk, and similarity score.
 
@@ -95,6 +95,8 @@ The tool returns an object with:
 }
 ```
 
+`document` is only populated by vector stores whose `query()` returns document content, such as Chroma, Elasticsearch, LanceDB, and MongoDB. For other stores, such as PgVector, it's an empty string. Read the chunk text from `sources[i].metadata.text` (or whichever metadata key you stored it under).
+
 ## Default tool description
 
 The default description focuses on:
@@ -489,7 +491,7 @@ The tool is created with:
 
 - **ID**: `VectorQuery {vectorStoreName} {indexName} Tool`
 - **Input Schema**: Requires queryText and filter objects
-- **Output Schema**: Returns relevantContext string
+- **Output Schema**: Returns `relevantContext` (array of chunk metadata) and `sources` (array of `QueryResult`)
 
 ## Related
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.2.24-alpha.7",
+  "version": "1.2.24",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -27,8 +27,8 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.4.3",
-    "@mastra/mcp": "^1.17.3",
-    "@mastra/core": "1.65.0-alpha.3"
+    "@mastra/core": "1.65.0",
+    "@mastra/mcp": "^1.17.3"
   },
   "devDependencies": {
     "@hono/node-server": "^2.0.0",
@@ -44,9 +44,9 @@
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "4.1.10",
-    "@internal/types-builder": "0.0.105",
-    "@mastra/core": "1.65.0-alpha.3",
-    "@internal/lint": "0.0.130"
+    "@internal/lint": "0.0.131",
+    "@mastra/core": "1.65.0",
+    "@internal/types-builder": "0.0.106"
   },
   "homepage": "https://mastra.ai",
   "repository": {