@mastra/mcp-docs-server 1.0.0-beta.0 → 1.0.0-beta.2

package/.docs/raw/reference/processors/batch-parts-processor.mdx

@@ -65,11 +65,17 @@ const processor = new BatchPartsProcessor({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'batch-parts'",
+      description: "Processor identifier set to 'batch-parts'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processOutputStream",
       type: "(args: { part: ChunkType; streamParts: ChunkType[]; state: Record<string, any>; abort: (reason?: string) => never }) => Promise<ChunkType | null>",

package/.docs/raw/reference/processors/language-detector.mdx

@@ -107,11 +107,17 @@ const processor = new LanguageDetector({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'language-detector'",
+      description: "Processor identifier set to 'language-detector'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processInput",
       type: "(args: { messages: MastraMessageV2[]; abort: (reason?: string) => never; tracingContext?: TracingContext }) => Promise<MastraMessageV2[]>",

package/.docs/raw/reference/processors/moderation-processor.mdx

@@ -93,11 +93,17 @@ const processor = new ModerationProcessor({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'moderation'",
+      description: "Processor identifier set to 'moderation'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processInput",
       type: "(args: { messages: MastraMessageV2[]; abort: (reason?: string) => never; tracingContext?: TracingContext }) => Promise<MastraMessageV2[]>",

package/.docs/raw/reference/processors/pii-detector.mdx

@@ -100,11 +100,17 @@ const processor = new PIIDetector({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'pii-detector'",
+      description: "Processor identifier set to 'pii-detector'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processInput",
       type: "(args: { messages: MastraMessageV2[]; abort: (reason?: string) => never; tracingContext?: TracingContext }) => Promise<MastraMessageV2[]>",

package/.docs/raw/reference/processors/prompt-injection-detector.mdx

@@ -86,11 +86,17 @@ const processor = new PromptInjectionDetector({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'prompt-injection-detector'",
+      description: "Processor identifier set to 'prompt-injection-detector'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processInput",
       type: "(args: { messages: MastraMessageV2[]; abort: (reason?: string) => never; tracingContext?: TracingContext }) => Promise<MastraMessageV2[]>",

package/.docs/raw/reference/processors/system-prompt-scrubber.mdx

@@ -94,11 +94,17 @@ const processor = new SystemPromptScrubber({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'system-prompt-scrubber'",
+      description: "Processor identifier set to 'system-prompt-scrubber'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processOutputStream",
       type: "(args: { part: ChunkType; streamParts: ChunkType[]; state: Record<string, any>; abort: (reason?: string) => never; tracingContext?: TracingContext }) => Promise<ChunkType | null>",

package/.docs/raw/reference/processors/token-limiter-processor.mdx

@@ -71,11 +71,17 @@ const processor = new TokenLimiterProcessor({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'token-limiter'",
+      description: "Processor identifier set to 'token-limiter'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processOutputStream",
       type: "(args: { part: ChunkType; streamParts: ChunkType[]; state: Record<string, any>; abort: (reason?: string) => never }) => Promise<ChunkType | null>",

package/.docs/raw/reference/processors/unicode-normalizer.mdx

@@ -71,11 +71,17 @@ const processor = new UnicodeNormalizer({
 <PropertiesTable
   content={[
     {
-      name: "name",
+      name: "id",
       type: "string",
-      description: "Processor name set to 'unicode-normalizer'",
+      description: "Processor identifier set to 'unicode-normalizer'",
       isOptional: false,
     },
+    {
+      name: "name",
+      type: "string",
+      description: "Optional processor display name",
+      isOptional: true,
+    },
     {
       name: "processInput",
       type: "(args: { messages: MastraMessageV2[]; abort: (reason?: string) => never }) => MastraMessageV2[]",

package/.docs/raw/reference/storage/cloudflare-d1.mdx

@@ -10,7 +10,7 @@ The Cloudflare D1 storage implementation provides a serverless SQL database solu
 ## Installation
 
 ```bash
-npm install @mastra/cloudflare-d1@latest
+npm install @mastra/cloudflare-d1@beta
 ```
 
 ## Usage

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

@@ -10,7 +10,7 @@ The Cloudflare KV storage implementation provides a globally distributed, server
 ## Installation
 
 ```bash copy
-npm install @mastra/cloudflare@latest
+npm install @mastra/cloudflare@beta
 ```
 
 ## Usage

package/.docs/raw/reference/storage/dynamodb.mdx

@@ -19,11 +19,11 @@ The DynamoDB storage implementation provides a scalable and performant NoSQL dat
 ## Installation
 
 ```bash copy
-npm install @mastra/dynamodb@latest
+npm install @mastra/dynamodb@beta
 # or
-pnpm add @mastra/dynamodb@latest
+pnpm add @mastra/dynamodb@beta
 # or
-yarn add @mastra/dynamodb@latest
+yarn add @mastra/dynamodb@beta
 ```
 
 ## Prerequisites

package/.docs/raw/reference/storage/lance.mdx

@@ -10,7 +10,7 @@ The LanceDB storage implementation provides a high-performance storage solution
 ## Installation
 
 ```bash
-npm install @mastra/lance
+npm install @mastra/lance@beta
 ```
 
 ## Usage

package/.docs/raw/reference/storage/libsql.mdx

@@ -10,7 +10,7 @@ The LibSQL storage implementation provides a SQLite-compatible storage solution
 ## Installation
 
 ```bash copy
-npm install @mastra/libsql@latest
+npm install @mastra/libsql@beta
 ```
 
 ## Usage

package/.docs/raw/reference/storage/mongodb.mdx

@@ -10,7 +10,7 @@ The MongoDB storage implementation provides a scalable storage solution using Mo
 ## Installation
 
 ```bash copy
-npm install @mastra/mongodb@latest
+npm install @mastra/mongodb@beta
 ```
 
 ## Usage

package/.docs/raw/reference/storage/mssql.mdx

@@ -10,7 +10,7 @@ The MSSQL storage implementation provides a production-ready storage solution us
 ## Installation
 
 ```bash copy
-npm install @mastra/mssql@latest
+npm install @mastra/mssql@beta
 ```
 
 ## Usage

package/.docs/raw/reference/storage/postgresql.mdx

@@ -10,7 +10,7 @@ The PostgreSQL storage implementation provides a production-ready storage soluti
 ## Installation
 
 ```bash copy
-npm install @mastra/pg@latest
+npm install @mastra/pg@beta
 ```
 
 ## Usage

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

@@ -16,7 +16,7 @@ The Upstash storage implementation provides a serverless-friendly storage soluti
 ## Installation
 
 ```bash copy
-npm install @mastra/upstash@latest
+npm install @mastra/upstash@beta
 ```
 
 ## Usage

package/.docs/raw/reference/templates/overview.mdx

@@ -21,7 +21,7 @@ Mastra templates are pre-built project structures that demonstrate specific use
 Install a template using the `create-mastra` command:
 
 ```bash copy
-npx create-mastra@latest --template template-name
+npx create-mastra@beta --template template-name
 ```
 
 This creates a complete project with all necessary code and configuration.

package/.docs/raw/reference/tools/mcp-server.mdx

@@ -186,6 +186,55 @@ The description for this generated tool will be: "Ask agent `<agent.name>` a que
 
 This allows you to quickly expose the generative capabilities of your agents through the MCP, enabling clients to "ask" your agents questions directly.
 
+### Accessing MCP Context in Tools
+
+Tools exposed through `MCPServer` can access MCP request context (authentication, session IDs, etc.) via two different properties depending on how the tool is invoked:
+
+| Call Pattern | Access Method |
+|-------------|---------------|
+| Direct tool call | `context?.mcp?.extra` |
+| Agent tool call | `context?.requestContext?.get("mcp.extra")` |
+
+**Universal pattern** (works in both contexts):
+```typescript
+const mcpExtra = context?.mcp?.extra ?? context?.requestContext?.get("mcp.extra");
+const authInfo = mcpExtra?.authInfo;
+```
+
+#### Example: Tool that works in both contexts
+
+```typescript
+import { createTool } from "@mastra/core/tools";
+import { z } from "zod";
+
+const fetchUserData = createTool({
+  id: "fetchUserData",
+  description: "Fetches user data using authentication from MCP context",
+  inputSchema: z.object({
+    userId: z.string().describe("The ID of the user to fetch"),
+  }),
+  execute: async (inputData, context) => {
+    // Access MCP authentication context
+    // When called directly via MCP: context.mcp.extra
+    // When called via agent: context.requestContext.get('mcp.extra')
+    const mcpExtra = context?.mcp?.extra || context?.requestContext?.get("mcp.extra");
+    const authInfo = mcpExtra?.authInfo;
+
+    if (!authInfo?.token) {
+      throw new Error("Authentication required");
+    }
+
+    const response = await fetch(`https://api.example.com/users/${inputData.userId}`, {
+      headers: {
+        Authorization: `Bearer ${authInfo.token}`,
+      },
+    });
+
+    return response.json();
+  },
+});
+```
+
 ## Methods
 
 These are the functions you can call on an `MCPServer` instance to control its behavior and get information.

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

@@ -15,15 +15,16 @@ The `CouchbaseVector` class provides vector search using [Couchbase Vector Searc
 ## Installation
 
 ```bash copy
-npm install @mastra/couchbase
+npm install @mastra/couchbase@beta
 ```
 
 ## Usage Example
 
-```typescript copy showLineNumbers
+```typescript copy
 import { CouchbaseVector } from "@mastra/couchbase";
 
 const store = new CouchbaseVector({
+  id: 'couchbase-vector',
   connectionString: process.env.COUCHBASE_CONNECTION_STRING,
   username: process.env.COUCHBASE_USERNAME,
   password: process.env.COUCHBASE_PASSWORD,
@@ -37,6 +38,11 @@ const store = new CouchbaseVector({
 
 <PropertiesTable
   content={[
+    {
+      name: "id",
+      type: "string",
+      description: "Unique identifier for this vector store instance",
+    },
     {
       name: "connectionString",
       type: "string",

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

@@ -11,7 +11,7 @@ It's part of the `@mastra/libsql` package and offers efficient vector similarity
 ## Installation
 
 ```bash copy
-npm install @mastra/libsql@latest
+npm install @mastra/libsql@beta
 ```
 
 ## Usage

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

@@ -10,7 +10,7 @@ The `MongoDBVector` class provides vector search using [MongoDB Atlas Vector Sea
 ## Installation
 
 ```bash copy
-npm install @mastra/mongodb
+npm install @mastra/mongodb@beta
 ```
 
 ## Usage Example
@@ -19,6 +19,7 @@ npm install @mastra/mongodb
 import { MongoDBVector } from "@mastra/mongodb";
 
 const store = new MongoDBVector({
+  id: 'mongodb-vector',
   url: process.env.MONGODB_URL,
   database: process.env.MONGODB_DATABASE,
 });
@@ -28,6 +29,11 @@ const store = new MongoDBVector({
 
 <PropertiesTable
   content={[
+    {
+      name: "id",
+      type: "string",
+      description: "Unique identifier for this vector store instance",
+    },
     {
       name: "url",
       type: "string",

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

@@ -15,7 +15,7 @@ The `S3Vectors` class provides vector search using [Amazon S3 Vectors (Preview)]
 ## Installation
 
 ```bash copy
-npm install @mastra/s3vectors
+npm install @mastra/s3vectors@beta
 ```
 
 ## Usage Example

package/.docs/raw/server-db/mastra-client.mdx

@@ -30,28 +30,28 @@ To use the Mastra Client SDK, install the required dependencies:
   <TabItem value="npm" label="npm">
 
     ```bash copy
-    npm install @mastra/client-js@latest
+    npm install @mastra/client-js@beta
     ```
 
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
 
     ```bash copy
-    pnpm add @mastra/client-js@latest
+    pnpm add @mastra/client-js@beta
     ```
 
   </TabItem>
   <TabItem value="yarn" label="yarn">
 
     ```bash copy
-    yarn add @mastra/client-js@latest
+    yarn add @mastra/client-js@beta
     ```
 
   </TabItem>
   <TabItem value="bun" label="bun">
 
     ```bash copy
-    bun add @mastra/client-js@latest
+    bun add @mastra/client-js@beta
     ```
 
   </TabItem>

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

@@ -22,7 +22,7 @@ Mastra currently supports two MCP classes:
 To use MCP, install the required dependency:
 
 ```bash
-npm install @mastra/mcp@latest
+npm install @mastra/mcp@beta
 ```
 
 ## Configuring `MCPClient`

package/.docs/raw/voice/speech-to-text.mdx

@@ -45,7 +45,7 @@ Mastra supports several Speech-to-Text providers, each with their own capabiliti
 Each provider is implemented as a separate package that you can install as needed:
 
 ```bash
-pnpm add @mastra/voice-openai  # Example for OpenAI
+pnpm add @mastra/voice-openai@beta  # Example for OpenAI
 ```
 
 ## Using the Listen Method

package/.docs/raw/voice/text-to-speech.mdx

@@ -53,7 +53,7 @@ Mastra supports a wide range of Text-to-Speech providers, each with their own un
 Each provider is implemented as a separate package that you can install as needed:
 
 ```bash
-pnpm add @mastra/voice-openai  # Example for OpenAI
+pnpm add @mastra/voice-openai@beta  # Example for OpenAI
 ```
 
 ## Using the Speak Method

package/.docs/raw/workflows/inngest-workflow.mdx

@@ -20,7 +20,7 @@ Real-time monitoring, suspend/resume, and step-level observability are enabled v
 ## Setup
 
 ```sh
-npm install @mastra/inngest @mastra/core @mastra/deployer
+npm install @mastra/inngest@beta @mastra/core@beta @mastra/deployer@beta
 ```
 
 ## Building an Inngest Workflow

package/CHANGELOG.md

@@ -1,5 +1,22 @@
 # @mastra/mcp-docs-server
 
+## 1.0.0-beta.2
+
+### Patch Changes
+
+- Clean up mcp docs server migration tool to have a better prompt. ([#9930](https://github.com/mastra-ai/mastra/pull/9930))
+
+- Updated dependencies [[`d70e742`](https://github.com/mastra-ai/mastra/commit/d70e74243401d070e167e3bc19c329c1d98d8a5b), [`465ac05`](https://github.com/mastra-ai/mastra/commit/465ac0526a91d175542091c675181f1a96c98c46)]:
+  - @mastra/mcp@1.0.0-beta.1
+  - @mastra/core@1.0.0-beta.2
+
+## 1.0.0-beta.1
+
+### Patch Changes
+
+- Updated dependencies [[`910db9e`](https://github.com/mastra-ai/mastra/commit/910db9e0312888495eb5617b567f247d03303814), [`e7266a2`](https://github.com/mastra-ai/mastra/commit/e7266a278db02035c97a5e9cd9d1669a6b7a535d)]:
+  - @mastra/core@1.0.0-beta.1
+
 ## 1.0.0-beta.0
 
 ### Major Changes

package/dist/stdio.js

@@ -112,7 +112,7 @@ var migrationPrompts = [
     arguments: [
       {
         name: "area",
-        description: "Optional: Focus on a specific area (agents, tools, workflows, memory, evals, mcp, vectors, syncs). If not provided, gives an overview of all changes.",
+        description: "Optional: Focus on a specific area (e.g., agent, tools, workflows, memory, storage, voice). The tool will check if a migration guide exists for this area and suggest alternatives if not found. If not provided, gives an overview of all changes.",
         required: false
       }
     ]
@@ -141,24 +141,20 @@ var migrationPromptMessages = {
 };
 function getUpgradeToV1Messages(area) {
   if (area) {
-    const validAreas = ["agents", "tools", "workflows", "memory", "evals", "mcp", "vectors", "syncs"];
-    if (!validAreas.includes(area.toLowerCase())) {
-      return [
-        {
-          role: "user",
-          content: {
-            type: "text",
-            text: `Invalid area: ${area}. Valid areas are: ${validAreas.join(", ")}`
-          }
-        }
-      ];
-    }
     return [
       {
         role: "user",
         content: {
           type: "text",
-          text: `I need help migrating my Mastra ${area} code from v0.x to v1.0. Use the mastraMigration tool to get the specific migration guide for "${area}" and walk me through the changes step by step.`
+          text: `I need help migrating my Mastra ${area} code from v0.x to v1.0. Use the mastraMigration tool to:
+
+1. First, try to get the specific migration guide for "${area}" using path: "upgrade-to-v1/${area}"
+2. If that doesn't exist, try the alternate form (singular/plural):
+   - If "${area}" ends with 's', try without the 's' (e.g., "agents" \u2192 "agent")
+   - If "${area}" doesn't end with 's', try adding 's' (e.g., "agent" \u2192 "agents")
+3. If the guide exists, walk me through the changes step by step
+4. If neither form exists, list available migration guides in "upgrade-to-v1/" and suggest which ones might be relevant to "${area}"
+5. After you find the guide, collect all the codemod calls to run to codemods. These callouts are marked with ":::tip[Codemod]" in the docs. Run the codemods with "npx @mastra/codemod@beta <codemod-name> <path>" to automate all those changes. Afterwards, help me with any remaining manual changes needed.`
         }
       }
     ];
@@ -173,7 +169,7 @@ function getUpgradeToV1Messages(area) {
 1. First, list all available migration guides with path: "upgrade-to-v1/"
 2. Give me a high-level overview of what changed in each area
 3. Ask me which areas I'm using in my project so we can focus on relevant changes
-4. After I decided on the areas, check the migration guides for callouts to codemods. These callouts are marked with ":::tip[Codemod]" in the docs. Run the codemods with "npx @mastra/codemod v1" to automate all those changes. Afterwards, help me with any remaining manual changes needed.
+4. After I decided on the areas, check the migration guides for callouts to codemods. These callouts are marked with ":::tip[Codemod]" in the docs. Run the codemods with "npx @mastra/codemod@beta v1" to automate all those changes. Afterwards, help me with any remaining manual changes needed.
 
 After I tell you which areas I use, we'll go through each one systematically.`
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.0.0-beta.0",
+  "version": "1.0.0-beta.2",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -33,8 +33,8 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6",
-    "@mastra/core": "1.0.0-beta.0",
-    "@mastra/mcp": "^1.0.0-beta.0"
+    "@mastra/core": "1.0.0-beta.2",
+    "@mastra/mcp": "^1.0.0-beta.1"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.6",
@@ -50,7 +50,7 @@
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
     "@internal/lint": "0.0.53",
-    "@mastra/core": "1.0.0-beta.0"
+    "@mastra/core": "1.0.0-beta.2"
   },
   "homepage": "https://mastra.ai",
   "repository": {