@mastra/mcp-docs-server 0.13.39 → 0.13.40

package/.docs/raw/{mastra-cloud → deployment/mastra-cloud}/observability.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Understanding Tracing and Logs | Mastra Cloud | Mastra Docs"
+title: "Understanding Tracing and Logs | Mastra Cloud"
 description: Monitoring and debugging tools for Mastra Cloud deployments
 ---
 
@@ -13,7 +13,7 @@ Mastra Cloud captures execution data to help you monitor your application's beha
 
 ## Logs
 
-You can view detailed logs for debugging and monitoring your application's behavior on the [Logs](/docs/mastra-cloud/dashboard#logs) page of the Dashboard.
+You can view detailed logs for debugging and monitoring your application's behavior on the [Logs](/docs/deployment/mastra-cloud/dashboard#logs) page of the Dashboard.
 
 ![Dashboard logs](/img/mastra-cloud/mastra-cloud-dashboard-logs.jpg)
 

package/.docs/raw/{mastra-cloud → deployment/mastra-cloud}/overview.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Mastra Cloud | Mastra Cloud | Mastra Docs"
+title: "Mastra Cloud | Mastra Cloud"
 description: Deployment and monitoring service for Mastra applications
 ---
 
@@ -7,7 +7,7 @@ import { MastraCloudCallout } from "@site/src/components/MastraCloudCallout";
 
 # Mastra Cloud
 
-[Mastra Cloud](https://mastra.ai/cloud) is a platform for deploying, managing, monitoring, and debugging Mastra applications. When you [deploy](/docs/mastra-cloud/setting-up) your application, Mastra Cloud exposes your agents, tools, and workflows as REST API endpoints.
+[Mastra Cloud](https://mastra.ai/cloud) is a platform for deploying, managing, monitoring, and debugging Mastra applications. When you [deploy](/docs/deployment/mastra-cloud/setting-up) your application, Mastra Cloud exposes your agents, tools, and workflows as REST API endpoints.
 
 <MastraCloudCallout />
 
@@ -62,4 +62,4 @@ Mastra Cloud is purpose-built for Mastra agents, tools, and workflows. It handle
 
 ## Next steps
 
-- [Setting Up and Deploying](/docs/mastra-cloud/setting-up)
+- [Setting Up and Deploying](/docs/deployment/mastra-cloud/setting-up)

package/.docs/raw/{mastra-cloud → deployment/mastra-cloud}/setting-up.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Setting Up and Deploying | Mastra Cloud | Mastra Docs"
+title: "Setting Up and Deploying | Mastra Cloud"
 description: Configuration steps for Mastra Cloud projects
 ---
 
@@ -98,8 +98,8 @@ Your project is now configured with automatic deployments which occur whenever y
 
 ## Testing your application
 
-After a successful deployment you can test your agents and workflows [Studio](/docs/mastra-cloud/dashboard#studio) in Mastra Cloud, or interact with them using our [Client SDK](/docs/server-db/mastra-client).
+After a successful deployment you can test your agents and workflows [Studio](/docs/deployment/mastra-cloud/dashboard#studio) in Mastra Cloud, or interact with them using our [Client SDK](/docs/server-db/mastra-client).
 
 ## Next steps
 
-- [Navigating the Dashboard](/docs/mastra-cloud/dashboard)
+- [Navigating the Dashboard](/docs/deployment/mastra-cloud/dashboard)

package/.docs/raw/deployment/monorepo.mdx

@@ -1,11 +1,11 @@
 ---
-title: "Monorepo Deployment | Deployment | Mastra Docs"
+title: "Monorepo Deployment | Deployment"
 description: Learn how to deploy Mastra applications that are part of a monorepo setup
 ---
 
 # Monorepo Deployment
 
-Deploying Mastra in a monorepo follows the same approach as deploying a standalone application. While some [Cloud](./cloud-providers/) or [Serverless Platform](./serverless-platforms/) providers may introduce extra requirements, the core setup is the same.
+Deploying Mastra in a monorepo follows the same approach as deploying a standalone application. While some [Cloud](./cloud-providers/) or [Serverless Platform](./cloud-providers/) providers may introduce extra requirements, the core setup is the same.
 
 ## Example monorepo
 
@@ -44,7 +44,7 @@ api/
 
 ## Deployment configuration
 
-The image below shows how to select `apps/api` as the project root when deploying to [Mastra Cloud](../mastra-cloud/overview). While the interface may differ between providers, the configuration remains the same.
+The image below shows how to select `apps/api` as the project root when deploying to [Mastra Cloud](./mastra-cloud/overview). While the interface may differ between providers, the configuration remains the same.
 
 ![Deployment configuration](/img/monorepo/monorepo-mastra-cloud.jpg)
 

package/.docs/raw/deployment/overview.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Deployment Overview | Deployment | Mastra Docs"
+title: "Deployment Overview | Deployment"
 description: Learn about different deployment options for your Mastra applications
 ---
 
@@ -23,7 +23,7 @@ Mastra offers multiple deployment options to suit your application's needs, from
 - Node.js `v20.0` or higher
 - Bun
 - Deno
-- [Cloudflare](../deployment/serverless-platforms/cloudflare-deployer)
+- [Cloudflare](../deployment/cloud-providers/cloudflare-deployer)
 
 ### Mastra Cloud
 
@@ -35,7 +35,7 @@ Mastra Cloud is a deployment platform that connects to your GitHub repository, a
 - Comprehensive logs and traces
 - Custom domains for each project
 
-[View Mastra Cloud documentation →](../mastra-cloud/overview)
+[View Mastra Cloud documentation →](./mastra-cloud/overview)
 
 ### With a Web Framework
 
@@ -57,7 +57,7 @@ You can deploy Mastra as a standard Node.js HTTP server, which gives you full co
 - Deploy to VMs, containers, or PaaS platforms
 - Ideal for integrating with existing Node.js applications
 
-[Server deployment guide →](./server-deployment)
+[Building Mastra →](./building-mastra.mdx)
 
 ### Serverless Platforms
 
@@ -68,7 +68,7 @@ Mastra provides platform-specific deployers for popular serverless platforms, en
 - Simplified deployment process
 - Automatic scaling through the platform
 
-[Serverless deployment guide →](./server-deployment)
+[Building Mastra →](./building-mastra.mdx)
 
 ## Client Configuration
 

package/.docs/raw/deployment/web-framework.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Web Framework Integration | Deployment | Mastra Docs"
+title: "Web Framework Integration | Deployment"
 description: "Learn how Mastra can be deployed when integrated with a Web Framework"
 ---
 

package/.docs/raw/frameworks/agentic-uis/ai-sdk.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Using Vercel AI SDK | Frameworks | Mastra Docs"
+title: "Using Vercel AI SDK | Frameworks"
 description: "Learn how Mastra leverages the Vercel AI SDK library and how you can leverage it further with Mastra"
 ---
 
@@ -137,6 +137,10 @@ const { error, status, sendMessage, messages, regenerate, stop } = useChat({
           inputData: {
             city: messages[messages.length - 1].parts[0].text,
           },
+          //Or resumeData for resuming a suspended workflow
+          resumeData: {
+            confirmation: messages[messages.length - 1].parts[0].text
+          }
         },
       };
     },

package/.docs/raw/frameworks/agentic-uis/assistant-ui.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Using with Assistant UI | Frameworks | Mastra Docs"
+title: "Using with Assistant UI | Frameworks"
 description: "Learn how to integrate Assistant UI with Mastra"
 ---
 

package/.docs/raw/frameworks/agentic-uis/cedar-os.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Integrate Cedar-OS with Mastra | Frameworks | Mastra Docs"
+title: "Integrate Cedar-OS with Mastra | Frameworks"
 description: "Build AI-native frontends for your Mastra agents with Cedar-OS"
 ---
 

package/.docs/raw/frameworks/agentic-uis/copilotkit.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Integrate CopilotKit with Mastra | Frameworks | Mastra Docs"
+title: "Integrate CopilotKit with Mastra | Frameworks"
 description: "Learn how Mastra leverages the CopilotKit's AGUI library and how you can leverage it to build user experiences"
 ---
 

package/.docs/raw/frameworks/agentic-uis/openrouter.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Use OpenRouter with Mastra | Frameworks | Mastra Docs"
+title: "Use OpenRouter with Mastra | Frameworks"
 description: "Learn how to integrate OpenRouter with Mastra"
 ---
 

package/.docs/raw/frameworks/servers/express.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Integrate Mastra in your Express project | Frameworks | Mastra Docs"
+title: "Integrate Mastra in your Express project | Frameworks"
 description: A step-by-step guide to integrating Mastra with an Express backend.
 ---
 

package/.docs/raw/frameworks/web-frameworks/astro.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Integrate Mastra in your Astro project | Frameworks | Mastra Docs"
+title: "Integrate Mastra in your Astro project | Frameworks"
 description: A step-by-step guide to integrating Mastra with Astro.
 ---
 

package/.docs/raw/frameworks/web-frameworks/next-js.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Integrate Mastra in your Next.js project | Frameworks | Mastra Docs"
+title: "Integrate Mastra in your Next.js project | Frameworks"
 description: A step-by-step guide to integrating Mastra with Next.js.
 ---
 

package/.docs/raw/frameworks/web-frameworks/sveltekit.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Integrate Mastra in your SvelteKit project | Frameworks | Mastra Docs"
+title: "Integrate Mastra in your SvelteKit project | Frameworks"
 description: A step-by-step guide to integrating Mastra with SvelteKit.
 ---
 

package/.docs/raw/frameworks/web-frameworks/vite-react.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Integrate Mastra in your Vite/React project | Frameworks | Mastra Docs"
+title: "Integrate Mastra in your Vite/React project | Frameworks"
 description: A step-by-step guide to integrating Mastra with Vite and React.
 ---
 

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

@@ -1,5 +1,5 @@
 ---
-title: "Install Mastra | Getting Started | Mastra Docs"
+title: "Install Mastra | Getting Started"
 description: Guide on installing Mastra and setting up the necessary prerequisites for running it with various LLM providers.
 ---
 

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

@@ -1,5 +1,5 @@
 ---
-title: "Mastra Docs Server | Getting Started | Mastra Docs"
+title: "Mastra Docs Server | Getting Started"
 description: "Learn how to use the Mastra MCP documentation server in your IDE to turn it into an agentic Mastra expert."
 ---
 

package/.docs/raw/getting-started/project-structure.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Project Structure | Getting Started | Mastra Docs"
+title: "Project Structure | Getting Started"
 description: Guide on organizing folders and files in Mastra, including best practices and recommended structures.
 ---
 

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

@@ -1,5 +1,5 @@
 ---
-title: "Studio | Getting Started | Mastra Docs"
+title: "Studio | Getting Started"
 description: Guide on installing Mastra and setting up the necessary prerequisites for running it with various LLM providers.
 ---
 
@@ -99,7 +99,7 @@ The Scorers tab displays the results of your agent's scorers as they run. When m
 
 ## REST API
 
-The local development server exposes a complete set of REST API routes, allowing you to programmatically interact with your agents, workflows, and tools during development. This is particularly helpful if you plan to deploy the Mastra server, since the local development server uses the exact same API routes as the [production server](/docs/server-db/production-server), allowing you to develop and test against it with full parity.
+The local development server exposes a complete set of REST API routes, allowing you to programmatically interact with your agents, workflows, and tools during development. This is particularly helpful if you plan to deploy the Mastra server, since the local development server uses the exact same API routes as the [production server](/docs/server-db/mastra-server), allowing you to develop and test against it with full parity.
 
 You can explore all available endpoints in the OpenAPI specification at http://localhost:4111/openapi.json, which details every endpoint and its request and response schemas.
 

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

@@ -1,5 +1,5 @@
 ---
-title: "Templates | Getting Started | Mastra Docs"
+title: "Templates | Getting Started"
 description: Pre-built project structures that demonstrate common Mastra use cases and patterns
 ---
 

package/.docs/raw/index.mdx

@@ -1,5 +1,5 @@
 ---
-title: "About Mastra | Mastra Docs"
+title: "About Mastra"
 sidebar_position: 2
 sidebar_label: "Introduction"
 description: "Mastra is an all-in-one framework for building AI-powered applications and agents with a modern TypeScript stack."
@@ -53,6 +53,6 @@ Explore real-world examples in our [community showcase](/showcase).
 
 Follow the [Installation guide](/docs/getting-started/installation) for step-by-step setup with the CLI or a manual install.
 
-If you're new to AI agents, check out our [templates](/docs/getting-started/templates), [course](https://mastra.ai/book), and [YouTube videos](https://youtube.com/@mastra-ai) to start building with Mastra today.
+If you're new to AI agents, check out our [templates](/docs/getting-started/templates), [course](https://mastra.ai/course), and [YouTube videos](https://youtube.com/@mastra-ai). You can also join our [Discord](https://discord.gg/BTYqqHKUrf) community to get help and share your projects.
 
 We can't wait to see what you build ✌️

package/.docs/raw/{tools-mcp/mcp-overview.mdx → mcp/overview.mdx}

@@ -1,5 +1,5 @@
 ---
-title: "MCP Overview | Tools & MCP | Mastra Docs"
+title: "MCP Overview | MCP"
 description: Learn about the Model Context Protocol (MCP), how to use third-party tools via MCPClient, connect to registries, and share your own tools using MCPServer.
 ---
 
@@ -15,7 +15,7 @@ Mastra can also be used to author MCP servers, exposing agents, tools, and other
 Mastra currently supports two MCP classes:
 
 1. **`MCPClient`**: Connects to one or many MCP servers to access their tools, resources, prompts, and handle elicitation requests.
-2. **`MCPServer`**: Exposes Mastra tools, agents, workflows, prompts, and resources to MCP compatible clients.
+2. **`MCPServer`**: Exposes Mastra tools, agents, workflows, prompts, and resources to MCP-compatible clients.
 
 ## Getting started
 

package/.docs/raw/mcp/publishing-mcp-server.mdx

@@ -0,0 +1,137 @@
+---
+title: "Publishing an MCP Server | MCP"
+description: Guide to setting up and building a Mastra MCP server using the stdio transport, and publishing it to NPM.
+---
+
+import Steps from "@site/src/components/Steps";
+import StepItem from "@site/src/components/StepItem";
+
+# Publishing an MCP Server
+
+This example guides you through setting up a basic Mastra MCPServer using the stdio transport, building it, and preparing it for publishing to NPM.
+
+## Install dependencies
+
+Install the necessary packages:
+
+```bash
+pnpm add @mastra/mcp @mastra/core tsup
+```
+
+## Setting up an MCP Server
+
+<Steps>
+
+<StepItem>
+
+Create a file for your stdio server, for example, `/src/mastra/stdio.ts`.
+
+</StepItem>
+
+<StepItem>
+
+Add the following code to the file. Remember to import your actual Mastra tools and name the server appropriately.
+
+```typescript title="src/mastra/stdio.ts" copy
+#!/usr/bin/env node
+import { MCPServer } from "@mastra/mcp";
+import { weatherTool } from "./tools";
+
+const server = new MCPServer({
+  name: "my-mcp-server",
+  version: "1.0.0",
+  tools: { weatherTool },
+});
+
+server.startStdio().catch((error) => {
+  console.error("Error running MCP server:", error);
+  process.exit(1);
+});
+```
+
+</StepItem>
+
+<StepItem>
+
+Update your `package.json` to include the `bin` entry pointing to your built server file and a script to build the server.
+
+```json title="package.json" copy
+{
+  "bin": "dist/stdio.js",
+  "scripts": {
+    "build:mcp": "tsup src/mastra/stdio.ts --format esm --no-splitting --dts && chmod +x dist/stdio.js"
+  }
+}
+```
+
+</StepItem>
+
+<StepItem>
+
+Run the build command:
+
+```bash
+pnpm run build:mcp
+```
+
+This will compile your server code and make the output file executable.
+
+</StepItem>
+
+</Steps>
+
+## Publishing to NPM
+
+To make your MCP server available for others (or yourself) to use via `npx` or as a dependency, you can publish it to NPM.
+
+<Steps>
+
+<StepItem>
+
+Ensure you have an NPM account and are logged in (`npm login`).
+
+</StepItem>
+
+<StepItem>
+
+Make sure your package name in `package.json` is unique and available.
+
+</StepItem>
+
+<StepItem>
+
+Run the publish command from your project root after building:
+
+```bash
+npm publish --access public
+```
+
+For more details on publishing packages, refer to the [NPM documentation](https://docs.npmjs.com/creating-and-publishing-scoped-public-packages).
+
+</StepItem>
+
+</Steps>
+
+## Using a published MCP Server
+
+Once published, your MCP server can be used by an `MCPClient` by specifying the command to run your package. You can also use any other MCP client like Claude desktop, Cursor, or Windsurf.
+
+```typescript
+import { MCPClient } from "@mastra/mcp";
+
+const mcp = new MCPClient({
+  servers: {
+    // Give this MCP server instance a name
+    yourServerName: {
+      command: "npx",
+      args: ["-y", "@your-org-name/your-package-name@latest"], // Replace with your package name
+    },
+  },
+});
+
+// You can then get tools or toolsets from this configuration to use in your agent
+const tools = await mcp.getTools();
+const toolsets = await mcp.getToolsets();
+```
+
+Note: If you published without an organization scope, the `args` might just be `["-y", "your-package-name@latest"]`.

package/.docs/raw/memory/conversation-history.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Conversation History | Memory | Mastra Docs"
+title: "Conversation History | Memory"
 description: "Learn how to configure conversation history in Mastra to store recent messages from the current conversation."
 ---
 

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

@@ -1,5 +1,5 @@
 ---
-title: "Memory Processors | Memory | Mastra Docs"
+title: "Memory Processors | Memory"
 description: "Learn how to use memory processors in Mastra to filter, trim, and transform messages before they're sent to the language model to manage context window limits."
 ---
 

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

@@ -1,5 +1,5 @@
 ---
-title: "Memory overview | Memory | Mastra Docs"
+title: "Memory overview | Memory"
 description: "Learn how Mastra's memory system works with working memory, conversation history, and semantic recall."
 ---
 
@@ -67,7 +67,7 @@ All memory types are [Thread-scoped](./working-memory#thread-scoped-memory-defau
 
 To persist and recall information between conversations, memory requires a storage adapter.
 
-Supported options include [LibSQL](/docs/memory/storage/memory-with-libsql), [MongoDB](/examples/memory/memory-with-mongodb), [Postgres](/docs/memory/storage/memory-with-pg), and [Upstash](/docs/memory/storage/memory-with-upstash)
+Supported options include [LibSQL](/docs/memory/storage/memory-with-libsql), [MongoDB](/docs/memory/storage/memory-with-mongodb), [Postgres](/docs/memory/storage/memory-with-pg), and [Upstash](/docs/memory/storage/memory-with-upstash)
 
 We use LibSQL out of the box because it is file-based or in-memory, so it is easy to install and works well with Studio.
 

package/.docs/raw/memory/semantic-recall.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Semantic Recall | Memory | Mastra Docs"
+title: "Semantic Recall | Memory"
 description: "Learn how to use semantic recall in Mastra to retrieve relevant messages from past conversations using vector search and embeddings."
 ---
 
@@ -91,7 +91,7 @@ const agent = new Agent({
 **Storage/vector code Examples**:
 
 - [LibSQL](/docs/memory/storage/memory-with-libsql)
-- [MongoDB](/examples/memory/memory-with-mongodb)
+- [MongoDB](/docs/memory/storage/memory-with-mongodb)
 - [Postgres](/docs/memory/storage/memory-with-pg)
 - [Upstash](/docs/memory/storage/memory-with-upstash)
 

package/.docs/raw/memory/storage/memory-with-libsql.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Memory with LibSQL | Memory | Mastra Docs"
+title: "Memory with LibSQL | Memory"
 description: Example for how to use Mastra's memory system with LibSQL storage and vector database backend.
 ---
 

package/.docs/raw/memory/storage/memory-with-mongodb.mdx

@@ -0,0 +1,150 @@
+---
+title: "Example: Memory with MongoDB | Memory"
+description: Example for how to use Mastra's memory system with MongoDB storage and vector capabilities.
+---
+
+# Memory with MongoDB
+
+This example demonstrates how to use Mastra's memory system with MongoDB as the storage backend.
+
+## Prerequisites
+
+This example uses the `openai` model and requires a MongoDB database. Make sure to add the following to your `.env` file:
+
+```bash title=".env" copy
+OPENAI_API_KEY=<your-api-key>
+MONGODB_URI=<your-connection-string>
+MONGODB_DB_NAME=<your-db-name>
+```
+
+And install the following package:
+
+```bash copy
+npm install @mastra/mongodb
+```
+
+## Adding memory to an agent
+
+To add MongoDB memory to an agent use the `Memory` class and create a new `storage` key using `MongoDBStore`. The configuration supports both local and remote MongoDB instances.
+
+```typescript title="src/mastra/agents/example-mongodb-agent.ts" showLineNumbers copy
+import { Memory } from "@mastra/memory";
+import { Agent } from "@mastra/core/agent";
+import { openai } from "@ai-sdk/openai";
+import { MongoDBStore } from "@mastra/mongodb";
+
+export const mongodbAgent = new Agent({
+  name: "mongodb-agent",
+  instructions:
+    "You are an AI agent with the ability to automatically recall memories from previous interactions.",
+  model: openai("gpt-4o"),
+  memory: new Memory({
+    storage: new MongoDBStore({
+      url: process.env.MONGODB_URI!,
+      dbName: process.env.MONGODB_DB_NAME!,
+    }),
+    options: {
+      threads: {
+        generateTitle: true,
+      },
+    },
+  }),
+});
+```
+
+## Vector embeddings with MongoDB
+
+Embeddings are numeric vectors used by memory's `semanticRecall` to retrieve related messages by meaning (not keywords).
+
+> Note: You must use a deployment hosted on MongoDB Atlas to successfully use the MongoDB Vector database.
+
+This setup uses FastEmbed, a local embedding model, to generate vector embeddings.
+To use this, install `@mastra/fastembed`:
+
+```bash copy
+npm install @mastra/fastembed
+```
+
+Add the following to your agent:
+
+```typescript title="src/mastra/agents/example-mongodb-agent.ts" showLineNumbers copy
+import { Memory } from "@mastra/memory";
+import { Agent } from "@mastra/core/agent";
+import { openai } from "@ai-sdk/openai";
+import { MongoDBStore, MongoDBVector } from "@mastra/mongodb";
+import { fastembed } from "@mastra/fastembed";
+
+export const mongodbAgent = new Agent({
+  name: "mongodb-agent",
+  instructions:
+    "You are an AI agent with the ability to automatically recall memories from previous interactions.",
+  model: openai("gpt-4o"),
+  memory: new Memory({
+    storage: new MongoDBStore({
+      url: process.env.MONGODB_URI!,
+      dbName: process.env.MONGODB_DB_NAME!,
+    }),
+    vector: new MongoDBVector({
+      uri: process.env.MONGODB_URI!,
+      dbName: process.env.MONGODB_DB_NAME!,
+    }),
+    embedder: fastembed,
+    options: {
+      lastMessages: 10,
+      semanticRecall: {
+        topK: 3,
+        messageRange: 2,
+      },
+      threads: {
+        generateTitle: true, // generates descriptive thread titles automatically
+      },
+    },
+  }),
+});
+```
+
+## Usage example
+
+Use `memoryOptions` to scope recall for this request. Set `lastMessages: 5` to limit recency-based recall, and use `semanticRecall` to fetch the `topK: 3` most relevant messages, including `messageRange: 2` neighboring messages for context around each match.
+
+```typescript title="src/test-mongodb-agent.ts" showLineNumbers copy
+import "dotenv/config";
+
+import { mastra } from "./mastra";
+
+const threadId = "123";
+const resourceId = "user-456";
+
+const agent = mastra.getAgent("mongodbAgent");
+
+const message = await agent.stream("My name is Mastra", {
+  memory: {
+    thread: threadId,
+    resource: resourceId,
+  },
+});
+
+await message.textStream.pipeTo(new WritableStream());
+
+const stream = await agent.stream("What's my name?", {
+  memory: {
+    thread: threadId,
+    resource: resourceId,
+  },
+  memoryOptions: {
+    lastMessages: 5,
+    semanticRecall: {
+      topK: 3,
+      messageRange: 2,
+    },
+  },
+});
+
+for await (const chunk of stream.textStream) {
+  process.stdout.write(chunk);
+}
+```
+
+## Related
+
+- [Calling Agents](/docs/agents/overview)

package/.docs/raw/memory/storage/memory-with-pg.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Memory with Postgres | Memory | Mastra Docs"
+title: "Memory with Postgres | Memory"
 description: Example for how to use Mastra's memory system with PostgreSQL storage and vector capabilities.
 ---