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

package/.docs/organized/code-examples/workflow-with-separate-steps.md

@@ -20,15 +20,21 @@
 import { mastra } from './mastra';
 
 async function main() {
-  const myWorkflow = mastra.getWorkflow('myWorkflow');
-  const { start } = myWorkflow.createRun();
+  const run = await mastra.getWorkflow('myWorkflow').createRunAsync();
   try {
-    const res = await start({
-      triggerData: {
-        inputValue: 30,
+    const res = await run.start({
+      inputData: {
+        inputValue: 12,
       },
     });
-    console.log(res.results);
+
+    if (res.status === 'success') {
+      console.log(res.result);
+    } else if (res.status === 'failed') {
+      console.log('Workflow failed:', res.error);
+    } else {
+      console.log('Workflow suspended:', res.suspended);
+    }
   } catch (e) {
     console.log(e);
   }
@@ -54,64 +60,101 @@ export const mastra = new Mastra({
 
 ### mastra/workflows/index.ts
 ```typescript
-import { Step, Workflow } from '@mastra/core/workflows';
+import { createStep, createWorkflow } from '@mastra/core/workflows';
 import { z } from 'zod';
 
-const stepOne = new Step({
+const stepOne = createStep({
   id: 'stepOne',
-  execute: async ({ context }) => {
-    const triggerData = context?.triggerData;
-    const doubledValue = triggerData.inputValue * 2;
-    return { doubledValue };
+  inputSchema: z.object({
+    inputValue: z.number(),
+  }),
+  outputSchema: z.object({
+    doubledValue: z.number(),
+    isOriginalOdd: z.boolean(), // Track original parity
+  }),
+  execute: async ({ inputData }) => {
+    const doubledValue = inputData.inputValue * 2;
+    const isOriginalOdd = inputData.inputValue % 2 === 1;
+    return { doubledValue, isOriginalOdd };
   },
 });
 
-const stepTwo = new Step({
+const stepTwo = createStep({
   id: 'stepTwo',
-  execute: async ({ context }) => {
-    if (context?.steps.stepOne.status !== 'success') {
-      throw new Error('stepOne failed');
-    }
-    const stepOneResult = context?.steps.stepOne?.output;
-    const incrementedValue = stepOneResult.doubledValue + 1;
+  inputSchema: z.object({
+    doubledValue: z.number(),
+    isOriginalOdd: z.boolean(),
+  }),
+  outputSchema: z.object({
+    incrementedValue: z.number(),
+  }),
+  execute: async ({ inputData }) => {
+    // Increment only if original input was odd
+    const incrementedValue = inputData.doubledValue + (inputData.isOriginalOdd ? 1 : 0);
     return { incrementedValue };
   },
 });
 
-const stepThree = new Step({
+const stepThree = createStep({
   id: 'stepThree',
-  execute: async ({ context }) => {
-    const triggerData = context?.triggerData;
-    const tripledValue = triggerData.inputValue * 3;
+  inputSchema: z.object({
+    incrementedValue: z.number(),
+  }),
+  outputSchema: z.object({
+    tripledValue: z.number(),
+  }),
+  execute: async ({ inputData, getStepResult }) => {
+    try {
+      const stepTwoResult = getStepResult(stepTwo);
+      if (!stepTwoResult || typeof stepTwoResult.incrementedValue !== 'number') {
+        throw new Error('stepTwo failed or returned invalid data');
+      }
+    } catch (error) {
+      throw new Error(`stepTwo failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+
+    const tripledValue = inputData.incrementedValue * 3;
     return { tripledValue };
   },
 });
 
-const stepFour = new Step({
+const stepFour = createStep({
   id: 'stepFour',
-  execute: async ({ context }) => {
-    if (context?.steps.stepThree.status !== 'success') {
-      throw new Error('stepThree failed');
+  inputSchema: z.object({
+    tripledValue: z.number(),
+  }),
+  outputSchema: z.object({
+    isEven: z.boolean(),
+  }),
+  execute: async ({ inputData, getStepResult }) => {
+    try {
+      const stepThreeResult = getStepResult(stepThree);
+      if (!stepThreeResult || typeof stepThreeResult.tripledValue !== 'number') {
+        throw new Error('stepThree failed or returned invalid data');
+      }
+    } catch (error) {
+      throw new Error(`stepThree failed: ${error instanceof Error ? error.message : 'Unknown error'}`);
     }
-    const stepThreeResult = context?.steps.stepThree?.output;
-    const isEven = stepThreeResult.tripledValue % 2 === 0;
+
+    const isEven = inputData.tripledValue % 2 === 0;
     return { isEven };
   },
 });
 
-export const myWorkflow = new Workflow({
-  name: 'my-workflow',
-  triggerSchema: z.object({
+export const myWorkflow = createWorkflow({
+  id: 'my-workflow',
+  inputSchema: z.object({
     inputValue: z.number(),
   }),
-});
-
-myWorkflow.step(stepOne).then(stepTwo).step(stepThree).then(stepFour).commit();
-
-const { start } = myWorkflow.createRun();
-
-const result = await start({ triggerData: { inputValue: 3 } });
+  outputSchema: z.object({
+    isEven: z.boolean(),
+  }),
+})
+  .then(stepOne)
+  .then(stepTwo)
+  .then(stepThree)
+  .then(stepFour);
 
-console.log(result);
+myWorkflow.commit();
 
 ```

package/.docs/raw/agents/overview.mdx

@@ -100,6 +100,7 @@ await testAgent.generate([
       {
         type: 'image',
         image: "https://example.com/images/test-image.jpg",
+        mimeType: "image/jpeg"
       },
       {
         type: 'text',

package/.docs/raw/course/02-agent-tools-mcp/14-getting-github-mcp-url.md

@@ -1,16 +1,35 @@
-# Getting a Composio GitHub MCP URL
+# Getting a Smithery GitHub MCP URL
 
-First, you'll need to get a Composio GitHub MCP URL. This typically requires:
+First, you'll need to get a Smithery GitHub MCP URL. This typically requires:
 
-1. Setting up the Composio GitHub integration
-2. Authenticating with your GitHub account
-3. Getting your unique MCP URL
+1. Setting up a Smithery account
+2. Creating a personal access token with your GitHub account
+3. Getting your unique MCP URL via the Smithery packages
 
-For this example, we'll use an environment variable to store the URL:
+For this example, we'll use an environment variable to store the Smithery API key and profile name which can be found in the Smithery interface.
 
 ```bash
 # Add this to your .env file
-COMPOSIO_MCP_GITHUB=https://your-composio-github-mcp-url.com
+SMITHERY_API_KEY=your_smithery_api_key
+SMITHERY_PROFILE=your_smithery_profile_name
 ```
 
-Using an environment variable keeps your configuration secure and flexible. This approach allows you to easily switch between different GitHub accounts or environments without modifying your code. It also prevents sensitive information from being committed to your repository.
+Using an environment variable keeps your configuration secure and flexible. It also prevents sensitive information from being committed to your repository.
+
+We will use the Smithery packages to authenticate and create a streamable HTTP URL for the MCP server configuration
+
+```bash
+pnpm install @smithery/sdk
+```
+
+```ts
+import { createSmitheryUrl } from "@smithery/sdk";
+
+const smitheryGithubMCPServerUrl = createSmitheryUrl(
+  "https://server.smithery.ai/@smithery-ai/github",
+  {
+    apiKey: process.env.SMITHERY_API_KEY,
+    profile: process.env.SMITHERY_PROFILE,
+  },
+);
+```

package/.docs/raw/course/02-agent-tools-mcp/15-updating-mcp-config-github.md

@@ -9,7 +9,7 @@ const mcp = new MCPClient({
       url: new URL(process.env.ZAPIER_MCP_URL || ""),
     },
     github: {
-      url: new URL(process.env.COMPOSIO_MCP_GITHUB || ""),
+      url: smitheryGithubMCPServerUrl,
     },
   },
 });

package/.docs/raw/memory/memory-processors.mdx

@@ -97,9 +97,10 @@ const memoryWithMultipleProcessors = new Memory({
 
 You can create custom logic by extending the base `MemoryProcessor` class.
 
-```typescript copy showLineNumbers {4-19,23-26}
-import { Memory, CoreMessage } from "@mastra/memory";
-import { MemoryProcessor, MemoryProcessorOpts } from "@mastra/core/memory";
+```typescript copy showLineNumbers {5-20,24-27}
+import { Memory } from "@mastra/memory";
+import { CoreMessage, MemoryProcessorOpts } from "@mastra/core";
+import { MemoryProcessor } from "@mastra/core/memory";
 
 class ConversationOnlyFilter extends MemoryProcessor {
   constructor() {

package/.docs/raw/workflows/using-with-agents-and-tools.mdx

@@ -258,6 +258,31 @@ export const cityCoordinatesTool = createTool({
 });
 ```
 
+## Using workflows in agents
+
+You can also use Workflows in Agents. This agent is able to choose between using the test tool or the test workflow.
+
+```typescript
+import { openai } from "@ai-sdk/openai";
+import { Agent } from "@mastra/core/agent";
+import { testTool } from "../tools/test-tool";
+import { testWorkflow } from "../workflows/test-workflow";
+
+export const testAgent = new Agent({
+  name: "test-agent",
+  description: "Create facts for a country based on the city",
+  instructions: `Return an interesting fact about the country based on the city provided`,
+  model: openai("gpt-4o"),
+  workflows: {
+    test_workflow: testWorkflow
+  },
+  tools: {
+    test_tool: testTool
+  },
+});
+```
+
+
 ## Exposing workflows with `MCPServer`
 
 You can convert your workflows into tools by passing them into an instance of a Mastra `MCPServer`. This allows any MCP-compatible client to access your workflow.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.9-alpha.1",
+  "version": "0.13.9-alpha.2",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -32,8 +32,8 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.67",
     "zod-to-json-schema": "^3.24.5",
-    "@mastra/core": "0.13.0-alpha.1",
-    "@mastra/mcp": "^0.10.9"
+    "@mastra/core": "0.13.0-alpha.2",
+    "@mastra/mcp": "^0.10.10-alpha.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.17.1",
@@ -43,13 +43,13 @@
     "@wong2/mcp-cli": "^1.10.0",
     "cross-env": "^7.0.3",
     "eslint": "^9.30.1",
-    "hono": "^4.8.9",
+    "hono": "^4.8.11",
     "tsup": "^8.5.0",
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@internal/lint": "0.0.26",
-    "@mastra/core": "0.13.0-alpha.1"
+    "@mastra/core": "0.13.0-alpha.2",
+    "@internal/lint": "0.0.26"
   },
   "scripts": {
     "prepare-docs": "cross-env PREPARE=true node dist/prepare-docs/prepare.js",