@mastra/mcp-docs-server 0.13.6 → 0.13.7-alpha.1

package/.docs/raw/reference/tools/vector-query-tool.mdx

@@ -554,6 +554,35 @@ For more information on runtime context, please see:
 - [Runtime Variables](../../docs/agents/runtime-variables)
 - [Dynamic Context](../../docs/tools-mcp/dynamic-context)
 
+## Usage Without a Mastra Server
+
+The tool can be used by itself to retrieve documents matching a query:
+```typescript copy showLineNumbers filename="src/index.ts"
+import { openai } from "@ai-sdk/openai";
+import { RuntimeContext } from "@mastra/core/runtime-context";
+import { createVectorQueryTool } from "@mastra/rag";
+import { PgVector } from "@mastra/pg";
+
+const pgVector = new PgVector({
+  connectionString: process.env.POSTGRES_CONNECTION_STRING!,
+});
+
+const vectorQueryTool = createVectorQueryTool({
+  vectorStoreName: "pgVector", // optional since we're passing in a store
+  vectorStore: pgVector,
+  indexName: "embeddings",
+  model: openai.embedding("text-embedding-3-small"),
+});
+
+const runtimeContext = new RuntimeContext();
+const queryResult = await vectorQueryTool.execute({
+  context: { queryText: "foo", topK: 1 },
+  runtimeContext,
+});
+
+console.log(queryResult.sources);
+```
+
 ## Tool Details
 
 The tool is created with:

package/.docs/raw/tools-mcp/overview.mdx

@@ -56,7 +56,7 @@ To make tools available to an agent, you configure them in the agent's definitio
 
 ## Compatibility Layer for Tool Schemas
 
-Different models interpret schemas differely. Some error when certain schema properties are passed and some ignore certain schema properties but don't throw an error. Mastra adds a compatibility layer for tool schemas, ensuring tools work consistently across different model providers and that the schema constraints are respected.
+Different models interpret schemas differently. Some error when certain schema properties are passed and some ignore certain schema properties but don't throw an error. Mastra adds a compatibility layer for tool schemas, ensuring tools work consistently across different model providers and that the schema constraints are respected.
 
 Some providers that we include this layer for:
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.6",
+  "version": "0.13.7-alpha.1",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -32,11 +32,11 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.5",
-    "@mastra/core": "0.11.1",
-    "@mastra/mcp": "^0.10.7"
+    "@mastra/mcp": "^0.10.7",
+    "@mastra/core": "0.12.0-alpha.1"
   },
   "devDependencies": {
-    "@hono/node-server": "^1.14.4",
+    "@hono/node-server": "^1.17.1",
     "@types/jsdom": "^21.1.7",
     "@types/node": "^20.19.0",
     "@types/turndown": "^5.0.5",
@@ -48,8 +48,8 @@
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@internal/lint": "0.0.22",
-    "@mastra/core": "0.11.1"
+    "@mastra/core": "0.12.0-alpha.1",
+    "@internal/lint": "0.0.23"
   },
   "scripts": {
     "prepare-docs": "cross-env PREPARE=true node dist/prepare-docs/prepare.js",

package/.docs/organized/changelogs/%40mastra%2Fagui.md

@@ -1,302 +0,0 @@
-# @mastra/agui
-
-## 1.0.7
-
-### Patch Changes
-
-- 8cacef9: Added deprecation message to readme of @mastra/agui to switch to @ag-ui/mastra
-- Updated dependencies [f248d53]
-- Updated dependencies [2affc57]
-- Updated dependencies [66e13e3]
-- Updated dependencies [edd9482]
-- Updated dependencies [18344d7]
-- Updated dependencies [9d372c2]
-- Updated dependencies [40c2525]
-- Updated dependencies [e473f27]
-- Updated dependencies [032cb66]
-- Updated dependencies [703ac71]
-- Updated dependencies [a723d69]
-- Updated dependencies [7827943]
-- Updated dependencies [5889a31]
-- Updated dependencies [bf1e7e7]
-- Updated dependencies [65e3395]
-- Updated dependencies [4933192]
-- Updated dependencies [d1c77a4]
-- Updated dependencies [bea9dd1]
-- Updated dependencies [dcd4802]
-- Updated dependencies [cbddd18]
-- Updated dependencies [7ba91fa]
-  - @mastra/core@0.11.0
-
-## 1.0.7-alpha.0
-
-### Patch Changes
-
-- 8cacef9: Added deprecation message to readme of @mastra/agui to switch to @ag-ui/mastra
-- Updated dependencies [7827943]
-- Updated dependencies [bf1e7e7]
-- Updated dependencies [cbddd18]
-  - @mastra/core@0.11.0-alpha.0
-
-## 1.0.6
-
-### Patch Changes
-
-- 1c1c6a1: dependencies updates:
-  - Updated dependency [`hono@^4.8.4` ↗︎](https://www.npmjs.com/package/hono/v/4.8.4) (from `^4.8.3`, in `dependencies`)
-- Updated dependencies [2873c7f]
-- Updated dependencies [1c1c6a1]
-- Updated dependencies [f8ce2cc]
-- Updated dependencies [8c846b6]
-- Updated dependencies [c7bbf1e]
-- Updated dependencies [8722d53]
-- Updated dependencies [565cc0c]
-- Updated dependencies [b790fd1]
-- Updated dependencies [132027f]
-- Updated dependencies [0c85311]
-- Updated dependencies [d7ed04d]
-- Updated dependencies [cb16baf]
-- Updated dependencies [f36e4f1]
-- Updated dependencies [7f6e403]
-  - @mastra/core@0.10.11
-
-## 1.0.6-alpha.0
-
-### Patch Changes
-
-- 1c1c6a1: dependencies updates:
-  - Updated dependency [`hono@^4.8.4` ↗︎](https://www.npmjs.com/package/hono/v/4.8.4) (from `^4.8.3`, in `dependencies`)
-- Updated dependencies [2873c7f]
-- Updated dependencies [1c1c6a1]
-- Updated dependencies [565cc0c]
-  - @mastra/core@0.10.11-alpha.2
-
-## 1.0.5
-
-### Patch Changes
-
-- 9dda1ac: dependencies updates:
-  - Updated dependency [`hono@^4.8.3` ↗︎](https://www.npmjs.com/package/hono/v/4.8.3) (from `^4.7.11`, in `dependencies`)
-- Updated dependencies [9dda1ac]
-- Updated dependencies [c984582]
-- Updated dependencies [7e801dd]
-- Updated dependencies [a606c75]
-- Updated dependencies [7aa70a4]
-- Updated dependencies [764f86a]
-- Updated dependencies [1760a1c]
-- Updated dependencies [038e5ae]
-- Updated dependencies [7dda16a]
-- Updated dependencies [5ebfcdd]
-- Updated dependencies [b2d0c91]
-- Updated dependencies [4e809ad]
-- Updated dependencies [57929df]
-- Updated dependencies [b7852ed]
-- Updated dependencies [6320a61]
-  - @mastra/core@0.10.9
-
-## 1.0.5-alpha.0
-
-### Patch Changes
-
-- 9dda1ac: dependencies updates:
-  - Updated dependency [`hono@^4.8.3` ↗︎](https://www.npmjs.com/package/hono/v/4.8.3) (from `^4.7.11`, in `dependencies`)
-- Updated dependencies [9dda1ac]
-- Updated dependencies [c984582]
-- Updated dependencies [7e801dd]
-- Updated dependencies [a606c75]
-- Updated dependencies [7aa70a4]
-- Updated dependencies [764f86a]
-- Updated dependencies [1760a1c]
-- Updated dependencies [038e5ae]
-- Updated dependencies [7dda16a]
-- Updated dependencies [5ebfcdd]
-- Updated dependencies [b2d0c91]
-- Updated dependencies [4e809ad]
-- Updated dependencies [57929df]
-- Updated dependencies [b7852ed]
-- Updated dependencies [6320a61]
-  - @mastra/core@0.10.9-alpha.0
-
-## 1.0.4
-
-### Patch Changes
-
-- 362446a: dependencies updates:
-  - Updated dependency [`@copilotkit/runtime@^1.9.1` ↗︎](https://www.npmjs.com/package/@copilotkit/runtime/v/1.9.1) (from `^1.8.14`, in `dependencies`)
-- Updated dependencies [15e9d26]
-- Updated dependencies [d1baedb]
-- Updated dependencies [d8f2d19]
-- Updated dependencies [4d21bf2]
-- Updated dependencies [07d6d88]
-- Updated dependencies [9d52b17]
-- Updated dependencies [2097952]
-- Updated dependencies [792c4c0]
-- Updated dependencies [5d74aab]
-- Updated dependencies [a8b194f]
-- Updated dependencies [4fb0cc2]
-- Updated dependencies [d2a7a31]
-- Updated dependencies [502fe05]
-- Updated dependencies [144eb0b]
-- Updated dependencies [8ba1b51]
-- Updated dependencies [4efcfa0]
-- Updated dependencies [0e17048]
-  - @mastra/core@0.10.7
-
-## 1.0.4-alpha.0
-
-### Patch Changes
-
-- 362446a: dependencies updates:
-  - Updated dependency [`@copilotkit/runtime@^1.9.1` ↗︎](https://www.npmjs.com/package/@copilotkit/runtime/v/1.9.1) (from `^1.8.14`, in `dependencies`)
-- Updated dependencies [15e9d26]
-- Updated dependencies [07d6d88]
-- Updated dependencies [5d74aab]
-- Updated dependencies [144eb0b]
-  - @mastra/core@0.10.7-alpha.2
-
-## 1.0.3
-
-### Patch Changes
-
-- 63f6b7d: dependencies updates:
-  - Updated dependency [`@ai-sdk/ui-utils@^1.2.11` ↗︎](https://www.npmjs.com/package/@ai-sdk/ui-utils/v/1.2.11) (from `^1.1.19`, in `dependencies`)
-  - Updated dependency [`@copilotkit/runtime@^1.8.14` ↗︎](https://www.npmjs.com/package/@copilotkit/runtime/v/1.8.14) (from `^1.8.13`, in `dependencies`)
-  - Updated dependency [`hono@^4.7.11` ↗︎](https://www.npmjs.com/package/hono/v/4.7.11) (from `^4.5.1`, in `dependencies`)
-- Updated dependencies [63f6b7d]
-- Updated dependencies [12a95fc]
-- Updated dependencies [4b0f8a6]
-- Updated dependencies [51264a5]
-- Updated dependencies [8e6f677]
-- Updated dependencies [d70c420]
-- Updated dependencies [ee9af57]
-- Updated dependencies [36f1c36]
-- Updated dependencies [2a16996]
-- Updated dependencies [10d352e]
-- Updated dependencies [9589624]
-- Updated dependencies [53d3c37]
-- Updated dependencies [751c894]
-- Updated dependencies [577ce3a]
-- Updated dependencies [9260b3a]
-  - @mastra/core@0.10.6
-
-## 1.0.3-alpha.0
-
-### Patch Changes
-
-- 63f6b7d: dependencies updates:
-  - Updated dependency [`@ai-sdk/ui-utils@^1.2.11` ↗︎](https://www.npmjs.com/package/@ai-sdk/ui-utils/v/1.2.11) (from `^1.1.19`, in `dependencies`)
-  - Updated dependency [`@copilotkit/runtime@^1.8.14` ↗︎](https://www.npmjs.com/package/@copilotkit/runtime/v/1.8.14) (from `^1.8.13`, in `dependencies`)
-  - Updated dependency [`hono@^4.7.11` ↗︎](https://www.npmjs.com/package/hono/v/4.7.11) (from `^4.5.1`, in `dependencies`)
-- Updated dependencies [63f6b7d]
-- Updated dependencies [36f1c36]
-- Updated dependencies [10d352e]
-- Updated dependencies [53d3c37]
-  - @mastra/core@0.10.6-alpha.0
-
-## 1.0.2
-
-### Patch Changes
-
-- 187b17d: Bump for runtimecontext
-- f0d559f: Fix peerdeps for alpha channel
-- Updated dependencies [ee77e78]
-- Updated dependencies [592a2db]
-- Updated dependencies [e5dc18d]
-- Updated dependencies [ab5adbe]
-- Updated dependencies [1e8bb40]
-- Updated dependencies [1b5fc55]
-- Updated dependencies [195c428]
-- Updated dependencies [f73e11b]
-- Updated dependencies [37643b8]
-- Updated dependencies [99fd6cf]
-- Updated dependencies [c5bf1ce]
-- Updated dependencies [add596e]
-- Updated dependencies [8dc94d8]
-- Updated dependencies [ecebbeb]
-- Updated dependencies [79d5145]
-- Updated dependencies [12b7002]
-- Updated dependencies [2901125]
-  - @mastra/core@0.10.2
-
-## 1.0.2-alpha.2
-
-### Patch Changes
-
-- f0d559f: Fix peerdeps for alpha channel
-- Updated dependencies [1e8bb40]
-  - @mastra/core@0.10.2-alpha.2
-
-## 1.0.2-alpha.1
-
-### Patch Changes
-
-- Updated dependencies [ee77e78]
-- Updated dependencies [2901125]
-  - @mastra/core@0.10.2-alpha.1
-
-## 1.0.2-alpha.0
-
-### Patch Changes
-
-- 187b17d: Bump for runtimecontext
-- Updated dependencies [592a2db]
-- Updated dependencies [e5dc18d]
-  - @mastra/client-js@0.10.2-alpha.0
-  - @mastra/core@0.10.2-alpha.0
-
-## 1.0.1
-
-### Patch Changes
-
-- a4bd9cf: Make these return abstract agents
-- cc86d51: Fix missing result messages
-- Updated dependencies [d70b807]
-- Updated dependencies [6d16390]
-- Updated dependencies [1e4a421]
-- Updated dependencies [200d0da]
-- Updated dependencies [267773e]
-- Updated dependencies [bf5f17b]
-- Updated dependencies [5343f93]
-- Updated dependencies [f622cfa]
-- Updated dependencies [38aee50]
-- Updated dependencies [5c41100]
-- Updated dependencies [d6a759b]
-- Updated dependencies [6015bdf]
-  - @mastra/core@0.10.1
-  - @mastra/client-js@0.10.1
-
-## 1.0.1-alpha.4
-
-### Patch Changes
-
-- Updated dependencies [267773e]
-  - @mastra/client-js@0.10.1-alpha.3
-
-## 1.0.1-alpha.3
-
-### Patch Changes
-
-- Updated dependencies [d70b807]
-  - @mastra/core@0.10.1-alpha.3
-
-## 1.0.1-alpha.2
-
-### Patch Changes
-
-- Updated dependencies [6015bdf]
-  - @mastra/client-js@0.10.1-alpha.2
-  - @mastra/core@0.10.1-alpha.2
-
-## 1.0.1-alpha.1
-
-### Patch Changes
-
-- Updated dependencies [200d0da]
-- Updated dependencies [bf5f17b]
-- Updated dependencies [5343f93]
-- Updated dependencies [38aee50]
-- Updated dependencies [5c41100]
-- Updated dependencies [d6a759b]
-  - @mastra/core@0.10.1-alpha.1
-
-... 83 more lines hidden. See full changelog in package directory.