@mastra/mcp-docs-server 0.13.11-alpha.1 → 0.13.11-alpha.2

package/.docs/organized/changelogs/mastra.md

@@ -1,5 +1,28 @@
 # mastra
 
+## 0.10.21-alpha.2
+
+### Patch Changes
+
+- 77b6cfe: Use just modelId for gpt-5 check
+- 96169cc: Create handler that returns providers user has keys for in their env
+- 33da97c: Set temperature to 1 for gpt-5 model in playground
+- c6d2603: Properly set baseUrl in playground when user sets the host or port in Mastra instance.
+- ce04175: Add update agent model handler
+- Updated dependencies [d5330bf]
+- Updated dependencies [aaf0224]
+- Updated dependencies [42cb4e9]
+- Updated dependencies [a239d41]
+- Updated dependencies [96169cc]
+- Updated dependencies [b32c50d]
+- Updated dependencies [c6d2603]
+- Updated dependencies [121a3f8]
+- Updated dependencies [ce04175]
+- Updated dependencies [ec510e7]
+  - @mastra/core@0.13.2-alpha.2
+  - @mastra/deployer@0.13.2-alpha.2
+  - @mastra/mcp@0.10.11-alpha.0
+
 ## 0.10.21-alpha.1
 
 ### Patch Changes
@@ -275,28 +298,5 @@
 - 89d2f4e: add TTS to the playground
 - Updated dependencies [510e2c8]
 - Updated dependencies [2f72fb2]
-- Updated dependencies [832691b]
-- Updated dependencies [557bb9d]
-- Updated dependencies [3f89307]
-- Updated dependencies [9eda7d4]
-- Updated dependencies [9d49408]
-- Updated dependencies [bc6b44a]
-- Updated dependencies [2ecf658]
-- Updated dependencies [7a7754f]
-- Updated dependencies [fc92d80]
-- Updated dependencies [23a6a7c]
-- Updated dependencies [09bca64]
-  - @mastra/core@0.12.0-alpha.0
-  - @mastra/deployer@0.12.0-alpha.0
-
-## 0.10.15
-
-### Patch Changes
-
-- 1a45f3a: Fix peerdeps
-
-## 0.10.14
-
-### Patch Changes
 
-... 4827 more lines hidden. See full changelog in package directory.
+... 4850 more lines hidden. See full changelog in package directory.

package/.docs/organized/code-examples/a2a.md

@@ -51,47 +51,59 @@ async function main() {
     console.log('\n-------------------\n');
 
     // Step 2: Send a message to the agent
-    const taskId = `task-${Date.now()}`;
-    console.log(`📤 Sending message to agent (Task ID: ${taskId})...`);
+    const messageId = `message-${Date.now()}`;
+    console.log(`📤 Sending message to agent (Message ID: ${messageId})...`);
 
     const query = 'What are the latest developments in AI agent networks?';
     console.log(`Query: ${query}`);
 
     const response = await a2aClient.sendMessage({
-      id: taskId,
       message: {
         role: 'user',
-        parts: [{ type: 'text', text: query }],
+        parts: [{ kind: 'text', text: query }],
+        kind: 'message',
+        messageId,
       },
     });
 
     console.log(response);
-
-    console.log(`\nTask Status: ${response.task.status}`);
+    if ('error' in response) {
+      throw new Error(response.error.message);
+    } else if ('messageId' in response.result) {
+      // Mastra's current A2A implementation will always return a task, rather than a message
+      return;
+    }
+
+    console.log(`\nTask Status: ${response.result.status.state}`);
     console.log('\n🤖 Agent Response:');
     console.log(
-      response.task.status.message?.parts[0]?.type === 'text'
-        ? response.task.status.message.parts[0].text
+      response.result.status.message?.parts[0].kind === 'text'
+        ? response.result.status.message?.parts[0].text
         : 'No response content',
     );
 
     console.log('\n-------------------\n');
 
     // Step 3: Get task status
+    const taskId = response.result.id;
     console.log(`📥 Checking task status (Task ID: ${taskId})...`);
 
     const taskStatus = await a2aClient.getTask({
       id: taskId,
     });
+    if ('error' in taskStatus) {
+      console.log(taskStatus);
+      throw new Error(taskStatus.error.message);
+    }
 
-    console.log(`Task Status: ${taskStatus.status}`);
+    console.log(`Task Status: ${taskStatus.result.status.state}`);
     console.log('\n-------------------\n');
 
     // Step 4: Demonstrate agent-to-agent communication
     console.log('🔄 Demonstrating agent-to-agent communication...');
 
     // Get another agent for A2A communication
-    const secondAgentId = process.env.SECOND_AGENT_ID || 'contentCreatorAgent';
+    const secondAgentId = 'contentCreatorAgent';
     console.log(`Connecting to second agent: ${secondAgentId}`);
 
     const secondA2aClient = client.getA2A(secondAgentId);
@@ -102,16 +114,23 @@ async function main() {
 
     const researchQuery = 'Provide a brief summary of agent networks in AI';
     const researchResponse = await a2aClient.sendMessage({
-      id: researchTaskId,
       message: {
         role: 'user',
-        parts: [{ type: 'text', text: researchQuery }],
+        parts: [{ kind: 'text', text: researchQuery }],
+        kind: 'message',
+        messageId: researchTaskId,
       },
     });
+    if ('error' in researchResponse) {
+      throw new Error(researchResponse.error.message);
+    } else if ('messageId' in researchResponse.result) {
+      // Mastra's current A2A implementation will always return a task, rather than a message
+      return;
+    }
 
     const researchResult =
-      researchResponse.task.status.message?.parts[0]?.type === 'text'
-        ? researchResponse.task.status.message.parts[0].text
+      researchResponse.result.status.message?.parts?.[0]?.kind === 'text'
+        ? researchResponse.result.status.message.parts?.[0]?.text
         : '';
     console.log('\nResearch Results:');
     console.log(researchResult.substring(0, 150) + '...');
@@ -122,17 +141,24 @@ async function main() {
 
     const contentPrompt = `Transform this research into an engaging blog post introduction:\n\n${researchResult}`;
     const contentResponse = await secondA2aClient.sendMessage({
-      id: contentTaskId,
       message: {
         role: 'user',
-        parts: [{ type: 'text', text: contentPrompt }],
+        parts: [{ kind: 'text', text: contentPrompt }],
+        kind: 'message',
+        messageId: contentTaskId,
       },
     });
+    if ('error' in contentResponse) {
+      throw new Error(contentResponse.error.message);
+    } else if ('messageId' in contentResponse.result) {
+      // Mastra's current A2A implementation will always return a task, rather than a message
+      return;
+    }
 
     console.log('\nFinal Content:');
     console.log(
-      contentResponse.task.status.message?.parts[0]?.type === 'text'
-        ? contentResponse.task.status.message.parts[0].text
+      contentResponse.result.status.message?.parts[0]?.kind === 'text'
+        ? contentResponse.result.status.message.parts[0].text
         : 'No content generated',
     );
 
@@ -159,16 +185,23 @@ export const myAgent = new Agent({
   model: openai('gpt-4o'),
 });
 
+export const contentCreatorAgent = new Agent({
+  name: 'contentCreatorAgent',
+  instructions: 'Create engaging content',
+  model: openai('gpt-4o'),
+});
+
 ```
 
 ### mastra/index.ts
 ```typescript
 import { Mastra } from '@mastra/core/mastra';
-import { myAgent } from './agents';
+import { myAgent, contentCreatorAgent } from './agents';
 
 export const mastra = new Mastra({
   agents: {
     myAgent,
+    contentCreatorAgent,
   },
 });
 

package/.docs/organized/code-examples/weather-agent.md

@@ -15,9 +15,21 @@
 ```typescript
 import { openai } from '@ai-sdk/openai';
 import { Agent } from '@mastra/core/agent';
+// import { Memory } from '@mastra/memory';
+import { LibSQLStore } from '@mastra/libsql';
+
+// import { OpenAIVoice } from '@mastra/voice-openai';
 
 import { weatherTool } from '../tools';
 
+// const voice = new OpenAIVoice();
+
+// const memory = new Memory({
+//   storage: new LibSQLStore({
+//     url: 'file:../mastra.db', // Or your database URL
+//   }),
+// });
+
 export const weatherAgent = new Agent({
   name: 'Weather Agent',
   instructions: `You are a helpful weather assistant that provides accurate weather information.
@@ -32,6 +44,8 @@ Your primary function is to help users get weather details for specific location
 Use the weatherTool to fetch current weather data.`,
   model: openai('gpt-4o'),
   tools: { weatherTool },
+  // memory,
+  // voice,
 });
 
 export const weatherReporterAgent = new Agent({

package/.docs/raw/auth/jwt.mdx

@@ -11,8 +11,10 @@ The `MastraJwtAuth` class provides a lightweight authentication mechanism for Ma
 
 ## Installation
 
+Before you can use the `MastraJwtAuth` class you have to install the `@mastra/auth` package.
+
 ```bash copy
-npm install @mastra/auth
+npm install @mastra/auth@latest
 ```
 
 ## Usage example

package/.docs/raw/evals/overview.mdx

@@ -23,6 +23,14 @@ There are different kinds of evals, each serving a specific purpose. Here are so
 2. **Classification Evals**: Measure accuracy in categorizing data based on predefined categories
 3. **Prompt Engineering Evals**: Explore impact of different instructions and input formats
 
+## Installation
+
+To access Mastra's evals feature install the `@mastra/evals` package.
+
+```bash copy
+npm install @mastra/evals@latest
+```
+
 ## Getting Started
 
 Evals need to be added to an agent. Here's an example using the summarization, content similarity, and tone consistency metrics:

package/.docs/raw/getting-started/installation.mdx

@@ -18,11 +18,15 @@ Mastra also supports other LLM providers. For a full list of supported models an
 - Node.js `v20.0` or higher
 - An API key from a supported [Model Provider](/docs/getting-started/model-providers)
 
+## Install using the `create mastra` CLI
+
+Our CLI is the fastest way to get started with Mastra. You can run `create mastra` anywhere on your machine.
+
 <Steps>
 
-## Install using the `create-mastra` CLI
+## Start the CLI wizard
 
-Our CLI is the fastest way to get started with Mastra. Run the following command to start the interactive setup:
+Run the following command to start the interactive setup:
 
 {/*
 LLM CONTEXT: This Tabs component shows different package manager commands for creating a new Mastra project.
@@ -76,14 +80,14 @@ Start with a pre-built template that demonstrates specific use cases:
 npx create-mastra@latest --template template-name
 ```
 
+> Browse available templates and learn more in [Templates](/docs/getting-started/templates).
+
 For example, to create a text-to-SQL application:
 
 ```bash copy
 npx create-mastra@latest --template text-to-sql
 ```
 
-> Browse available templates and learn more in [Templates](/docs/getting-started/templates).
-
 > See the [create-mastra](/reference/cli/create-mastra) documentation for a full list of available CLI options.
 
 ### Add your API key
@@ -95,8 +99,45 @@ OPENAI_API_KEY=<your-api-key>
 ```
 > This example uses OpenAI. Each LLM provider uses a unique name. See [Model Capabilities](/docs/getting-started/model-capability) for more information.
 
+### Launch the Mastra Development Server
+
 You can now launch the [Mastra Development Server](/docs/server-db/local-dev-playground) and test your agent using the Mastra Playground.
 
+{/*
+LLM CONTEXT: This Tabs component shows different package manager commands for starting Mastra's development server.
+Each tab displays the equivalent command for that specific package manager (npx, npm, yarn, pnpm, bun).
+This helps users choose their preferred package manager.
+All commands achieve the same result - starting Mastra's development server.
+*/}
+
+<Tabs items={["npm", "yarn", "pnpm", "bun", "Mastra CLI"]}>
+  <Tab>
+    ```bash copy
+    npm run dev
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    yarn run dev
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    pnpm run dev
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    bun run dev
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    mastra dev
+    ```
+  </Tab>
+</Tabs>
+
 </Steps>
 
 ## Install manually
@@ -335,6 +376,3 @@ To install Mastra in an existing project, use the `mastra init` command.
 
 - [Local Development](/docs/server-db/local-dev-playground)
 - [Deploy to Mastra Cloud](/docs/deployment/overview)
-
-
-/docs/server-db/local-dev-playground

package/.docs/raw/getting-started/mcp-docs-server.mdx

@@ -63,7 +63,7 @@ The tabs help users find the correct configuration format for their IDE (Cursor,
 Each tab shows the exact JSON structure and file paths needed for that IDE's MCP configuration.
 */}
 
-<Tabs items={["cursor", "windsurf", "vscode"]}>
+<Tabs items={["Cursor", "Windsurf", "VSCode"]}>
   <Tabs.Tab>
 ```json
 {
@@ -113,7 +113,7 @@ Each tab shows the Windows-specific command structure needed for that IDE's MCP
 On latest Windsurf and Cursor the direct npx command works, while it's still unconfirmed if this has been fixed for VSCode.
 */}
 
-<Tabs items={["cursor", "windsurf", "vscode"]}>
+<Tabs items={["Cursor", "Windsurf", "VSCode"]}>
   <Tabs.Tab>
 ```json
 {
@@ -252,7 +252,7 @@ Track updates for Mastra and `@mastra/*` packages:
 
 1. **Server Not Starting**
 
-   - Ensure npx is installed and working
+   - Ensure [npx](https://docs.npmjs.com/cli/v11/commands/npx) is installed and working
    - Check for conflicting MCP servers
    - Verify your configuration file syntax
    - On Windows, make sure to use the Windows-specific configuration

package/.docs/raw/memory/overview.mdx

@@ -1,3 +1,5 @@
+import { Steps } from "nextra/components";
+
 # Memory overview
 
 Memory is how agents manage the context that's available to them, it's a condensation of all chat messages into their context window.
@@ -18,13 +20,15 @@ The fastest way to see memory in action is using the built-in development playgr
 
 If you haven't already, create a new Mastra project following the main [Getting Started guide](/docs/getting-started/installation).
 
-**1. Install the memory package:**
+<Steps>
+
+### Install the memory package
 
 ```bash npm2yarn copy
 npm install @mastra/memory@latest
 ```
 
-**2. Create an agent and attach a `Memory` instance:**
+### Create an agent and attach a `Memory` instance
 
 ```typescript filename="src/mastra/agents/index.ts" {6-18}
 import { Agent } from "@mastra/core/agent";
@@ -47,15 +51,15 @@ export const myMemoryAgent = new Agent({
 });
 ```
 
-**3. Start the Development Server:**
+### Start the Development Server
 
 ```bash npm2yarn copy
 npm run dev
 ```
 
-**4. Open the playground (http://localhost:4111) and select your `MemoryAgent`:**
+### Open the playground and select your `MemoryAgent`
 
-Send a few messages and notice that it remembers information across turns:
+Open the playground at [http://localhost:4111](http://localhost:4111). Send a few messages and notice that it remembers information across turns:
 
 ```
 ➡️ You: My favorite color is blue.
@@ -64,6 +68,8 @@ Send a few messages and notice that it remembers information across turns:
 ⬅️ Agent: Your favorite color is blue.
 ```
 
+</Steps>
+
 ## Memory Threads
 
 Mastra organizes memory into threads, which are records that identify specific conversation histories, using two identifiers:

package/.docs/raw/reference/agents/agent.mdx

@@ -1,9 +1,9 @@
 ---
-title: "Reference: Agent | Agents | Mastra Docs"
+title: "Reference: Agent Class | Agents | Mastra Docs"
 description: "Documentation for the `Agent` class in Mastra, which provides the foundation for creating AI agents with various capabilities."
 ---
 
-# Agent
+# Agent Class
 
 The `Agent` class is the foundation for creating AI agents in Mastra. It provides methods for generating responses, streaming interactions, and handling voice capabilities.
 
@@ -135,3 +135,7 @@ const agent = new Agent({
   ]}
 />
 
+## Related
+
+- [Agents overview](../../docs/agents/overview.mdx)
+- [Calling Agents](../../examples/agents/calling-agents.mdx)

package/.docs/raw/reference/agents/generate.mdx

@@ -1,16 +1,16 @@
 ---
-title: "Reference: generate() | Agents | Mastra Docs"
-description: "Documentation for the `.generate()` method in Mastra agents, which produces text or structured responses."
+title: "Reference: Agent.generate() | Agents | Mastra Docs"
+description: "Documentation for the `Agent.generate()` method in Mastra agents, which produces text or structured responses."
 ---
 
-# generate()
+# Agent.generate()
 
 The `.generate()` method is used to interact with an agent to produce text or structured responses. This method accepts messages and optional generation options.
 
 ## Usage example
 
-```typescript showLineNumbers copy
-const response = await agent.generate("message for agent");
+```typescript copy
+await agent.generate("message for agent");
 ```
 
 ## Parameters
@@ -31,41 +31,6 @@ const response = await agent.generate("message for agent");
   ]}
 />
 
-## Extended usage example
-
-```typescript showLineNumbers copy
-const response = await agent.generate([
-  { role: "user", content: "message for agent" },
-  {
-    role: "user",
-    content: [
-      {
-        type: "text",
-        text: "message for agent"
-      },
-      {
-        type: "image",
-        imageUrl: "https://example.com/image.jpg",
-        mimeType: "image/jpeg"
-      }
-    ]
-  }
-], {
-  temperature: 0.7,
-  maxSteps: 3,
-  memory: {
-    thread: "user-123",
-    resource: "test-app"
-  },
-  toolChoice: "auto",
-  providerOptions: {
-    openai: {
-      reasoningEffort: "high"
-    }
-  }
-});
-```
-
 ### Options parameters
 
 <PropertiesTable
@@ -407,3 +372,46 @@ const response = await agent.generate([
     },
   ]}
 />
+
+## Extended usage example
+
+```typescript showLineNumbers copy
+await agent.generate(
+  [
+    { role: "user", content: "message for agent" },
+    {
+      role: "user",
+      content: [
+        {
+          type: "text",
+          text: "message for agent"
+        },
+        {
+          type: "image",
+          imageUrl: "https://example.com/image.jpg",
+          mimeType: "image/jpeg"
+        }
+      ]
+    }
+  ],
+  {
+    temperature: 0.7,
+    maxSteps: 3,
+    memory: {
+      thread: "user-123",
+      resource: "test-app"
+    },
+    toolChoice: "auto",
+    providerOptions: {
+      openai: {
+        reasoningEffort: "high"
+      }
+    }
+  }
+);
+```
+
+## Related
+
+- [Agent generation](../../docs/agents/overview.mdx#generate)
+- [Streaming responses](../../docs/agents/streaming.mdx)

package/.docs/raw/reference/agents/getAgent.mdx

@@ -1,16 +1,16 @@
 ---
-title: "Reference: getAgent() | Agents | Mastra Docs"
-description: "Documentation for the `.getAgent()` method in Mastra, which retrieves an agent by name."
+title: "Reference: Agent.getAgent() | Agents | Mastra Docs"
+description: "Documentation for the `Agent.getAgent()` method in Mastra, which retrieves an agent by name."
 ---
 
-# getAgent()
+# Agent.getAgent()
 
 The `.getAgent()` method is used to retrieve an agent. The method accepts a single `string` parameter for the agent's name.
 
 ## Usage example
 
-```typescript showLineNumbers copy
-const agent = mastra.getAgent("testAgent");
+```typescript copy
+mastra.getAgent("testAgent");
 ```
 
 
@@ -37,3 +37,8 @@ const agent = mastra.getAgent("testAgent");
     },
   ]}
 />
+
+## Related
+
+- [Agents overview](../../docs/agents/overview.mdx)
+- [Dynamic agents](../../docs/agents/dynamic-agents.mdx)

package/.docs/raw/reference/agents/getDefaultGenerateOptions.mdx

@@ -1,16 +1,16 @@
 ---
-title: "Reference: getDefaultGenerateOptions() | Agents | Mastra Docs"
-description: "Documentation for the `.getDefaultGenerateOptions()` method in Mastra agents, which retrieves the default options used for generate calls."
+title: "Reference: Agent.getDefaultGenerateOptions() | Agents | Mastra Docs"
+description: "Documentation for the `Agent.getDefaultGenerateOptions()` method in Mastra agents, which retrieves the default options used for generate calls."
 ---
 
-# getDefaultGenerateOptions()
+# Agent.getDefaultGenerateOptions()
 
 The `.getDefaultGenerateOptions()` method retrieves the default generation options configured for an agent, resolving them if they're a function. These options are used as the base configuration for all `generate()` calls unless overridden.
 
 ## Usage example
 
-```typescript showLineNumbers copy
-const defaultOptions = await agent.getDefaultGenerateOptions();
+```typescript copy
+await agent.getDefaultGenerateOptions();
 ```
 
 ## Parameters
@@ -27,10 +27,22 @@ const defaultOptions = await agent.getDefaultGenerateOptions();
   ]}
 />
 
+## Returns
+
+<PropertiesTable
+  content={[
+    {
+      name: "defaultOptions",
+      type: "AgentGenerateOptions | Promise<AgentGenerateOptions>",
+      description: "The default generation options configured for the agent, either as a direct object or a promise that resolves to the options.",
+    },
+  ]}
+/>
+
 ## Extended usage example
 
-```typescript showLineNumbers copy
-const defaultOptions = await agent.getDefaultGenerateOptions({
+```typescript copy
+await agent.getDefaultGenerateOptions({
   runtimeContext: new RuntimeContext()
 });
 ```
@@ -49,14 +61,7 @@ const defaultOptions = await agent.getDefaultGenerateOptions({
   ]}
 />
 
-## Returns
+## Related
 
-<PropertiesTable
-  content={[
-    {
-      name: "defaultOptions",
-      type: "AgentGenerateOptions | Promise<AgentGenerateOptions>",
-      description: "The default generation options configured for the agent, either as a direct object or a promise that resolves to the options.",
-    },
-  ]}
-/>
+- [Agent generation](../../docs/agents/overview.mdx#generate)
+- [Runtime variables](../../docs/agents/runtime-variables.mdx)