@mastra/mcp-docs-server 0.13.2-alpha.3 → 0.13.3-alpha.0

package/.docs/organized/code-examples/openapi-spec-writer.md

@@ -2,14 +2,6 @@
 ```json
 {
   "name": "examples-openapi-spec-writer",
-  "type": "module",
-  "private": true,
-  "scripts": {
-    "dev": "next dev --turbopack",
-    "build": "next build",
-    "start": "next start",
-    "lint": "next lint"
-  },
   "dependencies": {
     "@ai-sdk/openai": "^1.3.22",
     "@mastra/core": "latest",
@@ -50,20 +42,8 @@
   "peerDependencies": {
     "react": ">= 0.14.0 || 19",
     "react-dom": ">= 0.14.0 || 19"
-  },
-  "version": "0.0.1",
-  "pnpm": {
-    "overrides": {
-      "@mastra/core": "link:../../packages/core",
-      "@mastra/firecrawl": "link:../../integrations/firecrawl",
-      "@mastra/github": "link:../../integrations/github",
-      "@mastra/loggers": "link:../../packages/loggers",
-      "@mastra/rag": "link:../../packages/rag"
-    }
-  },
-  "packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39"
+  }
 }
-
 ```
 
 ### lib/hooks/useCopyToClipboard.ts

package/.docs/organized/code-examples/quick-start.md

@@ -2,16 +2,6 @@
 ```json
 {
   "name": "examples-quick-start",
-  "type": "module",
-  "private": true,
-  "description": "",
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "MIT",
   "devDependencies": {
     "@types/node": "^20.17.57",
     "tsx": "^4.19.3",
@@ -26,18 +16,8 @@
     "@mastra/loggers": "latest",
     "@mastra/memory": "latest",
     "ai": "latest"
-  },
-  "pnpm": {
-    "overrides": {
-      "@mastra/core": "link:../../packages/core",
-      "@mastra/loggers": "link:../../packages/loggers",
-      "@mastra/memory": "link:../../packages/memory"
-    }
-  },
-  "version": "0.0.1",
-  "packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39"
+  }
 }
-
 ```
 
 ### index.ts

package/.docs/organized/code-examples/stock-price-tool.md

@@ -2,17 +2,6 @@
 ```json
 {
   "name": "examples-stock-price-tool",
-  "type": "module",
-  "private": true,
-  "main": "index.js",
-  "scripts": {
-    "dev": "mastra dev",
-    "test": "cross-env NODE_OPTIONS='--experimental-vm-modules --max-old-space-size=8192' jest"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "MIT",
-  "description": "",
   "dependencies": {
     "@ai-sdk/openai": "latest",
     "@mastra/core": "latest",
@@ -23,17 +12,8 @@
     "jest": "^29.7.0",
     "mastra": "latest",
     "ts-jest": "^29.2.6"
-  },
-  "pnpm": {
-    "overrides": {
-      "@mastra/core": "link:../../packages/core",
-      "mastra": "link:../../packages/cli"
-    }
-  },
-  "version": "0.0.1",
-  "packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39"
+  }
 }
-
 ```
 
 ### index.ts

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

@@ -2,32 +2,13 @@
 ```json
 {
   "name": "examples-weather-agent",
-  "type": "module",
-  "private": true,
-  "description": "",
-  "main": "index.js",
-  "scripts": {
-    "dev": "npx tsx src/mastra/index.ts"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "MIT",
   "dependencies": {
     "@ai-sdk/openai": "^1.3.22",
     "@mastra/core": "latest",
     "@mastra/libsql": "latest",
     "zod": "^3.25.67"
-  },
-  "version": "0.0.1",
-  "pnpm": {
-    "overrides": {
-      "@mastra/core": "link:../../packages/core",
-      "@mastra/libsql": "link:../../stores/libsql"
-    }
-  },
-  "packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39"
+  }
 }
-
 ```
 
 ### mastra/agents/index.ts

package/.docs/organized/code-examples/workflow-ai-recruiter.md

@@ -2,18 +2,6 @@
 ```json
 {
   "name": "examples-workflow-ai-recruiter",
-  "type": "module",
-  "private": true,
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "dev": "mastra dev",
-    "start:dev": "npx bun src/mastra/index.ts"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "MIT",
-  "description": "",
   "devDependencies": {
     "@types/node": "^20.17.57",
     "mastra": "latest",
@@ -26,17 +14,8 @@
     "@mastra/core": "latest",
     "ai": "latest",
     "mastra": "latest"
-  },
-  "version": "0.0.1",
-  "pnpm": {
-    "overrides": {
-      "@mastra/core": "link:../../packages/core",
-      "mastra": "link:../../packages/cli"
-    }
-  },
-  "packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39"
+  }
 }
-
 ```
 
 ### mastra/index.ts

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

@@ -2,16 +2,6 @@
 ```json
 {
   "name": "workflow-with-inline-steps",
-  "main": "index.js",
-  "private": true,
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "dev": "mastra dev"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "MIT",
-  "description": "",
   "devDependencies": {
     "@types/node": "^20.17.57",
     "mastra": "latest",
@@ -21,17 +11,8 @@
   },
   "dependencies": {
     "@mastra/core": "latest"
-  },
-  "pnpm": {
-    "overrides": {
-      "@mastra/core": "link:../../packages/core",
-      "mastra": "link:../../packages/cli"
-    }
-  },
-  "version": "0.0.1-alpha.2",
-  "packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39"
+  }
 }
-
 ```
 
 ### mastra/index.ts

package/.docs/organized/code-examples/workflow-with-memory.md

@@ -2,16 +2,6 @@
 ```json
 {
   "name": "examples-workflow-with-memory",
-  "type": "module",
-  "private": true,
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "MIT",
-  "description": "",
   "devDependencies": {
     "@types/node": "^20.17.57",
     "tsx": "^4.19.3",
@@ -23,18 +13,8 @@
     "@mastra/core": "latest",
     "@mastra/memory": "latest",
     "@mastra/pg": "latest"
-  },
-  "version": "0.0.1",
-  "pnpm": {
-    "overrides": {
-      "@mastra/core": "link:../../packages/core",
-      "@mastra/memory": "link:../../packages/memory",
-      "@mastra/pg": "link:../../stores/pg"
-    }
-  },
-  "packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39"
+  }
 }
-
 ```
 
 ### mastra/agents/index.ts

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

@@ -2,18 +2,6 @@
 ```json
 {
   "name": "examples-workflow-with-separate-steps",
-  "type": "module",
-  "private": true,
-  "main": "index.js",
-  "scripts": {
-    "test": "echo \"Error: no test specified\" && exit 1",
-    "dev": "mastra dev",
-    "start:workflow": "npx tsx src/index.ts"
-  },
-  "keywords": [],
-  "author": "",
-  "license": "MIT",
-  "description": "",
   "devDependencies": {
     "@types/node": "^20.17.57",
     "mastra": "latest",
@@ -23,17 +11,8 @@
   },
   "dependencies": {
     "@mastra/core": "latest"
-  },
-  "pnpm": {
-    "overrides": {
-      "@mastra/core": "link:../../packages/core",
-      "mastra": "link:../../packages/mastra"
-    }
-  },
-  "version": "0.0.1-alpha.2",
-  "packageManager": "pnpm@10.10.0+sha512.d615db246fe70f25dcfea6d8d73dee782ce23e2245e3c4f6f888249fb568149318637dca73c2c5c8ef2a4ca0d5657fb9567188bfab47f566d1ee6ce987815c39"
+  }
 }
-
 ```
 
 ### index.ts

package/.docs/raw/course/01-first-agent/08-exporting-your-agent.md

@@ -18,13 +18,14 @@ export const mastra = new Mastra({
     url: ":memory:",
   }),
   logger: new PinoLogger({
-    name: 'Mastra',
-    level: 'info',
+    name: "Mastra",
+    level: "info",
   }),
 });
 ```
 
 This creates a new Mastra instance that includes:
+
 - Your financial agent
 - In-memory storage for development
 - A logger for debugging and monitoring

package/.docs/raw/course/01-first-agent/11-creating-transactions-tool.md

@@ -29,7 +29,7 @@ export const getTransactionsTool = createTool({
 const getTransactions = async () => {
   // This URL points to a public Google Sheet with transaction data
   const url =
-    "https://docs.google.com/spreadsheets/d/e/2PACX-1vTQWaCzJAFsF4owWRHQRLo4G0-ERv31c74OOZFnqLiTLaP7NweoiX7IXvzQud2H6bdUPnIqZEA485Ux/pubhtml?gid=0&single=true";
+    "https://docs.google.com/spreadsheets/d/e/2PACX-1vTQWaCzJAFsF4owWRHQRLo4G0-ERv31c74OOZFnqLiTLaP7NweoiX7IXvzQud2H6bdUPnIqZEA485Ux/pub?gid=0&single=true&output=csv";
   const response = await fetch(url);
   const data = await response.text();
   return {

package/.docs/raw/course/03-agent-memory/24-working-memory-in-practice.md

@@ -12,17 +12,14 @@ By using working memory effectively, you can create agents that feel more person
 Here are some best practices for using working memory effectively:
 
 1. **Be selective about what goes into working memory**
-
    - Focus on information that will be relevant across multiple conversations
    - Don't overload working memory with transient details
 
 2. **Use clear instructions**
-
    - Give your agent explicit guidance on when and how to update working memory
    - Instruct it to check memory before asking for information the user has already provided
 
 3. **Design a thoughtful template**
-
    - Structure your template based on the specific needs of your agent
    - Include sections for different types of information
    - Use clear labels and organization to make information easy to find

package/.docs/raw/course/03-agent-memory/29-memory-best-practices.md

@@ -3,32 +3,26 @@
 As you build memory-enhanced agents, keep these best practices in mind:
 
 1. **Be selective about what goes into working memory**
-
    - Focus on information that will be relevant across multiple conversations
    - Don't overload working memory with transient details
 
 2. **Use clear instructions**
-
    - Give your agent explicit guidance on when and how to update working memory
    - Instruct it to check memory before asking for information the user has already provided
 
 3. **Choose appropriate memory parameters**
-
    - Adjust `lastMessages`, `topK`, and `messageRange` based on your use case
    - More isn't always better - larger context windows can dilute focus
 
 4. **Consider privacy implications**
-
    - Be transparent with users about what information is being stored
    - Implement appropriate security measures for sensitive information
 
 5. **Test thoroughly**
-
    - Verify that your agent correctly recalls information across different scenarios
    - Test edge cases like conflicting information or corrections
 
 6. **Design thoughtful templates**
-
    - Structure your working memory templates based on your agent's specific needs
    - Include clear sections and organization to make information easy to find
 

package/.docs/raw/course/04-workflows/05-chaining-steps-together.md

@@ -14,7 +14,7 @@ export const contentWorkflow = createWorkflow({
   description: "Validates and enhances content",
   inputSchema: z.object({
     content: z.string(),
-    type: z.enum(["article", "blog", "social"]).default("article")
+    type: z.enum(["article", "blog", "social"]).default("article"),
   }),
   outputSchema: z.object({
     content: z.string(),
@@ -23,9 +23,9 @@ export const contentWorkflow = createWorkflow({
     metadata: z.object({
       readingTime: z.number(),
       difficulty: z.enum(["easy", "medium", "hard"]),
-      processedAt: z.string()
-    })
-  })
+      processedAt: z.string(),
+    }),
+  }),
 })
   .then(validateContentStep)
   .then(enhanceContentStep)
@@ -49,8 +49,9 @@ export const contentWorkflow = createWorkflow({
 ## Schema Validation
 
 The workflow automatically validates:
+
 - Input data matches the workflow's input schema
 - Each step's output matches the next step's input schema
 - Final output matches the workflow's output schema
 
-Your workflow is now ready to run! Next, you'll test the complete workflow.
+Your workflow is now ready to run! Next, you'll test the complete workflow.

package/.docs/raw/course/04-workflows/18-understanding-conditional-branching.md

@@ -5,14 +5,16 @@ Learn how to create workflows that take different paths based on data conditions
 ## What is Conditional Branching?
 
 Conditional branching allows workflows to:
+
 - **Make decisions**: Choose different processing paths based on data
-- **Handle variations**: Process different content types differently  
+- **Handle variations**: Process different content types differently
 - **Optimize performance**: Skip unnecessary steps for certain inputs
 - **Customize behavior**: Provide different experiences based on conditions
 
 ## Real-World Example
 
 Imagine a content processing workflow that:
+
 - **Short content** (< 50 words): Gets quick processing
 - **Medium content** (50-200 words): Gets standard processing
 - **Long content** (> 200 words): Gets detailed processing with extra analysis
@@ -28,6 +30,7 @@ Imagine a content processing workflow that:
 ```
 
 Where:
+
 - **condition**: An async function that returns `true` or `false`
 - **step**: The step to execute if the condition is `true`
 
@@ -39,7 +42,7 @@ Conditions are functions that examine the input data:
 // Example condition function
 async ({ inputData }) => {
   return inputData.wordCount < 50;
-}
+};
 ```
 
 ## Multiple Paths
@@ -55,4 +58,4 @@ async ({ inputData }) => {
 - **Flexibility**: Handle different scenarios in one workflow
 - **Maintainability**: Clear logic for different processing paths
 
-Next, you'll create a workflow with conditional branches!
+Next, you'll create a workflow with conditional branches!

package/.docs/raw/deployment/cloud-providers/amazon-ec2.mdx

@@ -0,0 +1,81 @@
+---
+title: "Amazon EC2"
+description: "Deploy your Mastra applications to Amazon EC2."
+---
+
+import { Callout, Steps } from "nextra/components";
+import ServerConfig from "@/components/content-blocks/server-config.mdx";
+
+## Amazon EC2
+
+Deploy your Mastra applications to Amazon EC2 (Elastic Cloud Compute).
+
+<Callout>
+  This guide assumes your Mastra application has been created using the default
+  `npx create-mastra@latest` command.
+  For more information on how to create a new Mastra application,
+  refer to our [getting started guide](/docs/getting-started/installation)
+</Callout>
+
+### Setting up EC2
+
+<Steps>
+
+#### Log into your AWS console
+
+Navigate to the [AWS Management Console](https://aws.amazon.com/console/) and sign in to your account.
+
+#### Navigate to EC2
+
+Head over to **All services** in the left side navigation. Under **Compute**, click on **EC2**.
+
+#### Launch a virtual server instance
+
+Click on **Launch instance** to create a new EC2 instance.
+
+#### Configure your instance details
+
+Add the following details for your instance:
+
+- **Name**: Give your instance a descriptive name
+- **Application and OS Images**: For this example, we'll use the **Amazon Linux** environment
+- **Instance type**: Select **t3.micro** (eligible for free tier)
+- **Key pair**: Select an existing key pair or create a new one for secure login
+- **Network settings**: Ensure to **allow HTTPS and HTTP traffic from the internet** by checking the appropriate boxes
+
+#### Launch your instance
+
+Review your configuration and click **Launch instance**.
+
+#### Connect to your instance
+
+You'll be redirected to a next steps page. You can connect to your instance either:
+
+- **Through the browser**: Click the **Connect** button for browser-based access
+- **Via SSH**: Use your key pair to SSH into the instance (instructions available when you click **Connect**)
+
+</Steps>
+
+### Server Configuration
+
+Once you have access to your EC2 instance (either via SSH or browser), follow these steps to set up your server environment:
+
+<ServerConfig />
+
+### Connect to your Mastra server
+
+You can now connect to your Mastra server from your client application using a `MastraClient` from the `@mastra/client-js` package.
+
+Refer to the [`MastraClient` documentation](/docs/client-js/overview) for more information.
+
+```typescript copy showLineNumbers
+import { MastraClient } from "@mastra/client-js";
+
+const mastraClient = new MastraClient({
+  baseUrl: "https://<your-domain-name>",
+});
+```
+
+## Next steps
+
+- [Mastra Client SDK](/docs/client-js/overview)

package/.docs/raw/deployment/cloud-providers/azure-app-services.mdx

@@ -0,0 +1,136 @@
+---
+title: "Azure App Services"
+description: "Deploy your Mastra applications to Azure App Services."
+---
+
+import { Callout, Steps } from "nextra/components";
+
+## Azure App Services
+
+Deploy your Mastra applications to Azure App Services.
+
+<Callout>
+  This guide assumes your Mastra application has been created using the default
+  `npx create-mastra@latest` command.
+  For more information on how to create a new Mastra application,
+  refer to our [getting started guide](/docs/getting-started/installation)
+</Callout>
+
+### Prerequisites
+
+- An Azure account with an active subscription
+- A GitHub repository containing your Mastra application
+- Your Mastra application should be created using `npx create-mastra@latest`
+
+### Deployment Steps
+
+<Steps>
+
+#### Create a new App Service
+
+- Log in to the [Azure Portal](https://portal.azure.com)
+- Navigate to **App Services** or search for it in the top search bar
+- Click **Create** to create a new App Service
+- In the drop-down, select **Web App**
+
+#### Configure App Service settings
+
+- **Subscription**: Select your Azure subscription
+- **Resource Group**: Create a new resource group or select an existing one
+- **Instance name**: Enter a unique name for your app (this will be part of your URL)
+- **Publish**: Select **Code**
+- **Runtime stack**: Select **Node 22 LTS**
+- **Operating System**: Select **Linux**
+- **Region**: Choose a region close to your users
+- **Linux Plan**: You may have the option of choosing a plan depending on the region you chose, pick an appropriate one for your needs.
+- Click **Review + Create**
+- Wait for validation to complete, then click **Create**
+
+#### Wait for deployment
+
+- Wait for the deployment to complete
+- Once finished, click **Go to resource** under the next steps section
+
+#### Configure environment variables
+
+Before setting up deployment, configure your environment variables:
+
+- Navigate to **Settings** > **Environment variables** in the left sidebar
+- Add your required environment variables such as:
+  - Model provider API keys (e.g., `OPENAI_API_KEY`)
+  - Database connection strings
+  - Any other configuration values your Mastra application requires
+- Click **Apply** to save the changes
+
+#### Set up GitHub deployment
+
+- Navigate to **Deployment Center** in the left sidebar
+- Select **GitHub** as your source
+- Sign in to GitHub if you're not already authenticated with Azure
+- In this example, we will keep GitHub Actions as our provider.
+- Select your organization, repository, and branch
+- Azure will generate a GitHub workflow file and you can preview it before proceeding
+- Click **Save** (the save button is located at the top of the page)
+
+#### Modify the GitHub workflow
+
+<Callout type="warning">
+The default workflow generated by Azure will fail for Mastra applications and needs to be modified.
+</Callout>
+
+After Azure creates the workflow, it will trigger a GitHub Actions run and merge the workflow file into your branch. **Cancel this initial run** as it will fail without the necessary modifications.
+
+Pull the latest changes to your local repository and modify the generated workflow file (`.github/workflows/main_<your-app-name>.yml`):
+
+1. **Update the build step**: Find the step named "npm install, build, and test" and:
+   - Change the step name to "npm install and build"
+   - Remove the `npm test` command from the run section
+
+2. **Update the zip artifact step**: Find the "Zip artifact for deployment" step and replace the zip command with:
+
+   ```yaml
+   run: (cd .mastra/output && zip ../../release.zip -r .)
+   ```
+
+   This ensures only the build outputs from `.mastra/output` are included in the deployment package.
+
+#### Deploy your changes
+
+- Commit and push your workflow modifications
+- The build will be automatically triggered in the **Deployment Center** in your Azure dashboard
+- Monitor the deployment progress until it completes successfully
+
+#### Access your application
+
+- Once the build is successful, wait a few moments for the application to start
+- Access your deployed application using the default URL provided in the **Overview** tab in the Azure portal
+- Your application will be available at `https://<your-app-name>.azurewebsites.net`
+
+</Steps>
+
+### Connect to your Mastra server
+
+You can now connect to your Mastra server from your client application using a `MastraClient` from the `@mastra/client-js` package.
+
+Refer to the [`MastraClient` documentation](/docs/client-js/overview) for more information.
+
+```typescript copy showLineNumbers
+import { MastraClient } from "@mastra/client-js";
+
+const mastraClient = new MastraClient({
+  baseUrl: "https://<your-app-name>.azurewebsites.net",
+});
+```
+
+<Callout>
+Azure App Services uses an ephemeral file system for some pricing tiers.
+For production applications, avoid using Mastra storage providers that rely on the local file system,
+such as `LibSQLStore` with a file URL. Consider using cloud-based storage solutions instead.
+</Callout>
+
+## Next steps
+
+- [Mastra Client SDK](/docs/client-js/overview)
+- [Configure custom domains](https://docs.microsoft.com/en-us/azure/app-service/app-service-web-tutorial-custom-domain)
+- [Enable HTTPS](https://docs.microsoft.com/en-us/azure/app-service/configure-ssl-bindings)
+

package/.docs/raw/deployment/cloud-providers/index.mdx

@@ -12,4 +12,6 @@ Deploy your Mastra applicaitons to popular cloud providers.
 
 <CardGrid>
   <CardGridItem title="Digital Ocean" description="Deploy your Mastra applications to Digital Ocean" href="./cloud-providers/digital-ocean" />
+  <CardGridItem title="Amazon EC2" description="Deploy your Mastra applications to Amazon EC2" href="./cloud-providers/amazon-ec2" />
+  <CardGridItem title="Azure App Services" description="Deploy your Mastra applications to Azure App Services" href="./cloud-providers/azure-app-services" />
 </CardGrid>