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

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

@@ -0,0 +1,152 @@
+---
+title: "Example: Memory with MongoDB | Memory | Mastra Docs"
+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@beta
+```
+
+## 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({
+  id: "mongodb-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@beta
+```
+
+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({
+  id: "mongodb-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/v1/agents/overview)

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

@@ -19,7 +19,7 @@ DATABASE_URL=<your-connection-string>
 And install the following package:
 
 ```bash copy
-npm install @mastra/pg
+npm install @mastra/pg@beta
 ```
 
 ## Adding memory to an agent
@@ -57,7 +57,7 @@ Embeddings are numeric vectors used by memory’s `semanticRecall` to retrieve r
 Install `fastembed` to get started:
 
 ```bash copy
-npm install @mastra/fastembed
+npm install @mastra/fastembed@beta
 ```
 
 Add the following to your agent:

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

@@ -24,7 +24,7 @@ You can get your Upstash credentials by signing up at [upstash.com](https://upst
 And install the following package:
 
 ```bash copy
-npm install @mastra/upstash
+npm install @mastra/upstash@beta
 ```
 
 ## Adding memory to an agent
@@ -63,7 +63,7 @@ Embeddings are numeric vectors used by memory’s `semanticRecall` to retrieve r
 Install `fastembed` to get started:
 
 ```bash copy
-npm install @mastra/fastembed
+npm install @mastra/fastembed@beta
 ```
 
 Add the following to your agent:

package/.docs/raw/observability/overview.mdx

@@ -43,11 +43,11 @@ export const mastra = new Mastra({
 
 With this basic setup, you will see Traces and Logs in both Studio and in Mastra Cloud.
 
-We also support various external tracing providers like Langfuse, Braintrust, and any OpenTelemetry-compatible platform (Datadog, New Relic, SigNoz, etc.). See more about this in the [Tracing]/docs/v1/observability/tracing/overview) documentation.
+We also support various external tracing providers like Langfuse, Braintrust, and any OpenTelemetry-compatible platform (Datadog, New Relic, SigNoz, etc.). See more about this in the [Tracing](/docs/v1/observability/tracing/overview) documentation.
 
 ## What's Next?
 
-- **[Set up Tracing]/docs/v1/observability/tracing/overview)**: Configure tracing for your application
-- **[Configure Logging]/docs/v1/logging)**: Add structured logging
-- **[View Examples]/examples/v1/observability/basic-tracing)**: See observability in action
-- **[API Reference]/reference/v1/observability/tracing/instances)**: Detailed configuration options
+- **[Set up Tracing](/docs/v1/observability/tracing/overview)**: Configure tracing for your application
+- **[Configure Logging](/docs/v1/logging)**: Add structured logging
+- **[View Examples](/examples/v1/observability/basic-tracing)**: See observability in action
+- **[API Reference](/reference/v1/observability/tracing/instances)**: Detailed configuration options

package/.docs/raw/observability/tracing/exporters/arize.mdx

@@ -10,7 +10,7 @@ description: "Send traces to Arize Phoenix or Arize AX using OpenTelemetry and O
 ## Installation
 
 ```bash npm2yarn
-npm install @mastra/arize
+npm install @mastra/arize@beta
 ```
 
 ## Configuration
@@ -188,7 +188,7 @@ This exporter implements the [OpenInference Semantic Conventions](https://github
 
 ## Related
 
-- [Tracing Overview]/docs/v1/observability/tracing/overview)
+- [Tracing Overview](/docs/v1/observability/tracing/overview)
 - [Phoenix Documentation](https://docs.arize.com/phoenix)
 - [Arize AX Documentation](https://docs.arize.com/)
 - [OpenInference Specification](https://github.com/Arize-ai/openinference/tree/main/spec)

package/.docs/raw/observability/tracing/exporters/braintrust.mdx

@@ -10,7 +10,7 @@ description: "Send traces to Braintrust for evaluation and monitoring"
 ## Installation
 
 ```bash npm2yarn
-npm install @mastra/braintrust
+npm install @mastra/braintrust@beta
 ```
 
 ## Configuration
@@ -67,5 +67,5 @@ new BraintrustExporter({
 
 ## Related
 
-- [Tracing Overview]/docs/v1/observability/tracing/overview)
+- [Tracing Overview](/docs/v1/observability/tracing/overview)
 - [Braintrust Documentation](https://www.braintrust.dev/docs)

package/.docs/raw/observability/tracing/exporters/cloud.mdx

@@ -110,6 +110,6 @@ CloudExporter uses intelligent batching to optimize network usage. Traces are bu
 
 ## Related
 
-- [Tracing Overview]/docs/v1/observability/tracing/overview)
-- [DefaultExporter]/docs/v1/observability/tracing/exporters/default)
+- [Tracing Overview](/docs/v1/observability/tracing/overview)
+- [DefaultExporter](/docs/v1/observability/tracing/exporters/default)
 - [Mastra Cloud Documentation](https://cloud.mastra.ai/docs)

package/.docs/raw/observability/tracing/exporters/default.mdx

@@ -102,8 +102,8 @@ If you set the strategy to `'auto'`, the `DefaultExporter` automatically selects
 
 | Storage Provider                                | Preferred Strategy | Supported Strategies                      | Notes                                 |
 | ----------------------------------------------- | ------------------ | ----------------------------------------- | ------------------------------------- |
-| **[LibSQL]/reference/v1/storage/libsql)**         | batch-with-updates | realtime, batch-with-updates, insert-only | Default storage, good for development |
-| **[PostgreSQL]/reference/v1/storage/postgresql)** | batch-with-updates | batch-with-updates, insert-only           | Recommended for production            |
+| **[LibSQL](/reference/v1/storage/libsql)**         | batch-with-updates | realtime, batch-with-updates, insert-only | Default storage, good for development |
+| **[PostgreSQL](/reference/v1/storage/postgresql)** | batch-with-updates | batch-with-updates, insert-only           | Recommended for production            |
 
 ### Strategy Benefits
 
@@ -158,6 +158,6 @@ new DefaultExporter({
 
 ## Related
 
-- [Tracing Overview]/docs/v1/observability/tracing/overview)
-- [CloudExporter]/docs/v1/observability/tracing/exporters/cloud)
-- [Storage Configuration]/docs/v1/server-db/storage)
+- [Tracing Overview](/docs/v1/observability/tracing/overview)
+- [CloudExporter](/docs/v1/observability/tracing/exporters/cloud)
+- [Storage Configuration](/docs/v1/server-db/storage)

package/.docs/raw/observability/tracing/exporters/langfuse.mdx

@@ -10,7 +10,7 @@ description: "Send traces to Langfuse for LLM observability and analytics"
 ## Installation
 
 ```bash npm2yarn
-npm install @mastra/langfuse
+npm install @mastra/langfuse@beta
 ```
 
 ## Configuration
@@ -109,5 +109,5 @@ new LangfuseExporter({
 
 ## Related
 
-- [Tracing Overview]/docs/v1/observability/tracing/overview)
+- [Tracing Overview](/docs/v1/observability/tracing/overview)
 - [Langfuse Documentation](https://langfuse.com/docs)

package/.docs/raw/observability/tracing/exporters/langsmith.mdx

@@ -10,7 +10,7 @@ description: "Send traces to LangSmith for LLM observability and evaluation"
 ## Installation
 
 ```bash npm2yarn
-npm install @mastra/langsmith
+npm install @mastra/langsmith@beta
 ```
 
 ## Configuration
@@ -75,5 +75,5 @@ new LangSmithExporter({
 
 ## Related
 
-- [Tracing Overview]/docs/v1/observability/tracing/overview)
+- [Tracing Overview](/docs/v1/observability/tracing/overview)
 - [LangSmith Documentation](https://docs.smith.langchain.com/)

package/.docs/raw/observability/tracing/exporters/otel.mdx

@@ -20,19 +20,19 @@ Each provider requires specific protocol packages. Install the base exporter plu
 ### For HTTP/Protobuf Providers (SigNoz, New Relic, Laminar)
 
 ```bash npm2yarn
-npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-proto
+npm install @mastra/otel-exporter@beta @opentelemetry/exporter-trace-otlp-proto
 ```
 
 ### For gRPC Providers (Dash0)
 
 ```bash npm2yarn
-npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-grpc @grpc/grpc-js
+npm install @mastra/otel-exporter@beta @opentelemetry/exporter-trace-otlp-grpc @grpc/grpc-js
 ```
 
 ### For HTTP/JSON Providers (Traceloop)
 
 ```bash npm2yarn
-npm install @mastra/otel-exporter @opentelemetry/exporter-trace-otlp-http
+npm install @mastra/otel-exporter@beta @opentelemetry/exporter-trace-otlp-http
 ```
 
 ## Provider Configurations
@@ -249,6 +249,6 @@ Install the suggested package for your provider.
 
 ## Related
 
-- [Tracing Overview]/docs/v1/observability/tracing/overview)
+- [Tracing Overview](/docs/v1/observability/tracing/overview)
 - [OpenTelemetry GenAI Conventions](https://opentelemetry.io/docs/specs/semconv/gen-ai/)
-- [OTEL Exporter Reference]/reference/v1/observability/tracing/exporters/otel)
+- [OTEL Exporter Reference](/reference/v1/observability/tracing/exporters/otel)

package/.docs/raw/observability/tracing/overview.mdx

@@ -85,18 +85,18 @@ Exporters determine where your trace data is sent and how it's stored. Choosing
 
 Mastra provides two built-in exporters that work out of the box:
 
-- **[Default]/docs/v1/observability/tracing/exporters/default)** - Persists traces to local storage for viewing in Studio
-- **[Cloud]/docs/v1/observability/tracing/exporters/cloud)** - Sends traces to Mastra Cloud for production monitoring and collaboration
+- **[Default](/docs/v1/observability/tracing/exporters/default)** - Persists traces to local storage for viewing in Studio
+- **[Cloud](/docs/v1/observability/tracing/exporters/cloud)** - Sends traces to Mastra Cloud for production monitoring and collaboration
 
 ### External Exporters
 
 In addition to the internal exporters, Mastra supports integration with popular observability platforms. These exporters allow you to leverage your existing monitoring infrastructure and take advantage of platform-specific features like alerting, dashboards, and correlation with other application metrics.
 
-- **[Arize]/docs/v1/observability/tracing/exporters/arize)** - Exports traces to Arize Phoenix or Arize AX using OpenInference semantic conventions
-- **[Braintrust]/docs/v1/observability/tracing/exporters/braintrust)** - Exports traces to Braintrust's eval and observability platform
-- **[Langfuse]/docs/v1/observability/tracing/exporters/langfuse)** - Sends traces to the Langfuse open-source LLM engineering platform
-- **[LangSmith]/docs/v1/observability/tracing/exporters/langsmith)** - Pushes traces into LangSmith's observability and evaluation toolkit
-- **[OpenTelemetry]/docs/v1/observability/tracing/exporters/otel)** - Deliver traces to any OpenTelemetry-compatible observability system
+- **[Arize](/docs/v1/observability/tracing/exporters/arize)** - Exports traces to Arize Phoenix or Arize AX using OpenInference semantic conventions
+- **[Braintrust](/docs/v1/observability/tracing/exporters/braintrust)** - Exports traces to Braintrust's eval and observability platform
+- **[Langfuse](/docs/v1/observability/tracing/exporters/langfuse)** - Sends traces to the Langfuse open-source LLM engineering platform
+- **[LangSmith](/docs/v1/observability/tracing/exporters/langsmith)** - Pushes traces into LangSmith's observability and evaluation toolkit
+- **[OpenTelemetry](/docs/v1/observability/tracing/exporters/otel)** - Deliver traces to any OpenTelemetry-compatible observability system
   - Supports: Dash0, Laminar, New Relic, SigNoz, Traceloop, Zipkin, and others!
 
 ## Sampling Strategies
@@ -522,7 +522,7 @@ Span processors allow you to transform, filter, or enrich trace data before it's
 
 ### Built-in Processors
 
-- [Sensitive Data Filter]/docs/v1/observability/tracing/processors/sensitive-data-filter) redacts sensitive information. It is enabled in the default observability config.
+- [Sensitive Data Filter](/docs/v1/observability/tracing/processors/sensitive-data-filter) redacts sensitive information. It is enabled in the default observability config.
 
 ### Creating Custom Processors
 
@@ -753,25 +753,25 @@ Mastra automatically creates spans for:
 
 ### Examples
 
-- [Basic Tracing Example]/examples/v1/observability/basic-tracing) - Working implementation
+- [Basic Tracing Example](/examples/v1/observability/basic-tracing) - Working implementation
 
 ### Reference Documentation
 
-- [Configuration API]/reference/v1/observability/tracing/configuration) - ObservabilityConfig details
-- [Tracing Classes]/reference/v1/observability/tracing/instances) - Core classes and methods
-- [Span Interfaces]/reference/v1/observability/tracing/spans) - Span types and lifecycle
-- [Type Definitions]/reference/v1/observability/tracing/interfaces) - Complete interface reference
+- [Configuration API](/reference/v1/observability/tracing/configuration) - ObservabilityConfig details
+- [Tracing Classes](/reference/v1/observability/tracing/instances) - Core classes and methods
+- [Span Interfaces](/reference/v1/observability/tracing/spans) - Span types and lifecycle
+- [Type Definitions](/reference/v1/observability/tracing/interfaces) - Complete interface reference
 
 ### Exporters
 
-- [DefaultExporter]/reference/v1/observability/tracing/exporters/default-exporter) - Storage persistence
-- [CloudExporter]/reference/v1/observability/tracing/exporters/cloud-exporter) - Mastra Cloud integration
-- [ConsoleExporter]/reference/v1/observability/tracing/exporters/console-exporter) - Debug output
-- [Arize]/reference/v1/observability/tracing/exporters/arize) - Arize Phoenix and Arize AX integration
-- [Braintrust]/reference/v1/observability/tracing/exporters/braintrust) - Braintrust integration
-- [Langfuse]/reference/v1/observability/tracing/exporters/langfuse) - Langfuse integration
-- [OpenTelemetry]/reference/v1/observability/tracing/exporters/otel) - OTEL-compatible platforms
+- [DefaultExporter](/reference/v1/observability/tracing/exporters/default-exporter) - Storage persistence
+- [CloudExporter](/reference/v1/observability/tracing/exporters/cloud-exporter) - Mastra Cloud integration
+- [ConsoleExporter](/reference/v1/observability/tracing/exporters/console-exporter) - Debug output
+- [Arize](/reference/v1/observability/tracing/exporters/arize) - Arize Phoenix and Arize AX integration
+- [Braintrust](/reference/v1/observability/tracing/exporters/braintrust) - Braintrust integration
+- [Langfuse](/reference/v1/observability/tracing/exporters/langfuse) - Langfuse integration
+- [OpenTelemetry](/reference/v1/observability/tracing/exporters/otel) - OTEL-compatible platforms
 
 ### Processors
 
-- [Sensitive Data Filter]/docs/v1/observability/tracing/processors/sensitive-data-filter) - Data redaction
+- [Sensitive Data Filter](/docs/v1/observability/tracing/processors/sensitive-data-filter) - Data redaction

package/.docs/raw/observability/tracing/processors/sensitive-data-filter.mdx

@@ -292,5 +292,5 @@ This ensures that processing errors don't prevent traces from being exported or
 
 ## Related
 
-- [SensitiveDataFilter API]/reference/v1/observability/tracing/processors/sensitive-data-filter)
-- [Basic Tracing Example]/examples/v1/observability/basic-tracing)
+- [SensitiveDataFilter API](/reference/v1/observability/tracing/processors/sensitive-data-filter)
+- [Basic Tracing Example](/examples/v1/observability/basic-tracing)

package/.docs/raw/rag/overview.mdx

@@ -73,5 +73,5 @@ Mastra supports multiple vector stores for embedding persistence and similarity
 
 ## More resources
 
-- [Chain of Thought RAG Example]/examples/v1/rag/usage/cot-rag)
+- [Chain of Thought RAG Example](/examples/v1/rag/usage/cot-rag)
 - [All RAG Examples](/examples/v1/) (including different chunking strategies, embedding models, and vector stores)

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

@@ -110,13 +110,13 @@ export const agent = new Agent({
       type: "string",
       isOptional: true,
       description:
-        "Optional unique identifier for the agent. Defaults to `name` if not provided.",
+        "Unique identifier for the agent. Defaults to `name` if not provided.",
     },
     {
       name: "name",
       type: "string",
       isOptional: false,
-      description: "Unique identifier for the agent.",
+      description: "Display name for the agent. Used as the identifier if `id` is not provided.",
     },
     {
       name: "description",

package/.docs/raw/reference/cli/create-mastra.mdx

@@ -16,28 +16,28 @@ The `create-mastra` command **creates** a new standalone Mastra project. Use thi
 <TabItem value="npm" label="npm">
 
 ```bash copy
-npx create-mastra@latest
+npx create-mastra@beta
 ```
 
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
 ```bash copy
-yarn dlx create-mastra@latest
+yarn dlx create-mastra@beta
 ```
 
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
 ```bash copy
-pnpm create mastra@latest
+pnpm create mastra@beta
 ```
 
 </TabItem>
 <TabItem value="bun" label="bun">
 
 ```bash copy
-bun create mastra@latest
+bun create mastra@beta
 ```
 
 </TabItem>
@@ -49,28 +49,28 @@ bun create mastra@latest
 <TabItem value="npm" label="npm">
 
 ```bash copy
-npx create-mastra@latest my-mastra-project -- --template coding-agent
+npx create-mastra@beta my-mastra-project -- --template coding-agent
 ```
 
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
 ```bash copy
-yarn dlx create-mastra@latest --template coding-agent
+yarn dlx create-mastra@beta --template coding-agent
 ```
 
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
 ```bash copy
-pnpm create mastra@latest --template coding-agent
+pnpm create mastra@beta --template coding-agent
 ```
 
 </TabItem>
 <TabItem value="bun" label="bun">
 
 ```bash copy
-bun create mastra@latest --template coding-agent
+bun create mastra@beta --template coding-agent
 ```
 
 </TabItem>
@@ -81,7 +81,7 @@ Check out the [full list](https://mastra.ai/api/templates.json) of templates and
 You can also use any GitHub repo as a template (it has to be a valid Mastra project):
 
 ```bash
-npx create-mastra@latest my-mastra-project -- --template mastra-ai/template-coding-agent
+npx create-mastra@beta my-mastra-project -- --template mastra-ai/template-coding-agent
 ```
 
 ## CLI flags
@@ -190,5 +190,5 @@ MASTRA_TELEMETRY_DISABLED=1
 You can also set this while using other `mastra` commands:
 
 ```bash copy
-MASTRA_TELEMETRY_DISABLED=1 npx create-mastra@latest
+MASTRA_TELEMETRY_DISABLED=1 npx create-mastra@beta
 ```

package/.docs/raw/reference/cli/mastra.mdx

@@ -9,9 +9,9 @@ You can use the Command-Line Interface (CLI) provided by Mastra to develop, buil
 
 ## `mastra dev`
 
-Starts a server which exposes [Studio]/docs/v1/getting-started/studio) and REST endpoints for your agents, tools, and workflows. You can visit [http://localhost:4111/swagger-ui](http://localhost:4111/swagger-ui) for an overview of all available endpoints once `mastra dev` is running.
+Starts a server which exposes [Studio](/docs/v1/getting-started/studio) and REST endpoints for your agents, tools, and workflows. You can visit [http://localhost:4111/swagger-ui](http://localhost:4111/swagger-ui) for an overview of all available endpoints once `mastra dev` is running.
 
-You can also [configure the server]/docs/v1/getting-started/studio#configuration).
+You can also [configure the server](/docs/v1/getting-started/studio#configuration).
 
 ### Flags
 
@@ -19,7 +19,7 @@ The command accepts [common flags][common-flags] and the following additional fl
 
 #### `--https`
 
-Enable local HTTPS support. [Learn more]/docs/v1/getting-started/studio#local-https).
+Enable local HTTPS support. [Learn more](/docs/v1/getting-started/studio#local-https).
 
 #### `--inspect`
 
@@ -85,7 +85,7 @@ Under the hood Mastra's Rollup server locates your Mastra entry file and bundles
 
 The output in `.mastra` can be deployed to any cloud server using [`mastra start`](#mastra-start).
 
-If you're deploying to a [serverless platform]/docs/v1/deployment/serverless-platforms) you need to install the correct deployer in order to receive the correct output in `.mastra`.
+If you're deploying to a [serverless platform](/docs/v1/deployment/serverless-platforms) you need to install the correct deployer in order to receive the correct output in `.mastra`.
 
 It accepts [common flags][common-flags].
 
@@ -109,7 +109,7 @@ You need to run `mastra build` before using `mastra start`.
 
 :::
 
-Starts a local server to serve your built Mastra application in production mode. By default, [OTEL Tracing]/docs/v1/observability/tracing/overview) is enabled.
+Starts a local server to serve your built Mastra application in production mode. By default, [OTEL Tracing](/docs/v1/observability/tracing/overview) is enabled.
 
 ### Flags
 
@@ -121,7 +121,7 @@ The path to your built Mastra output directory. Defaults to `.mastra/output`.
 
 #### `--no-telemetry`
 
-Disable the [OTEL Tracing]/docs/v1/observability/tracing/overview).
+Disable the [OTEL Tracing](/docs/v1/observability/tracing/overview).
 
 ## `mastra lint`
 
@@ -133,7 +133,7 @@ It accepts [common flags][common-flags].
 
 The `mastra scorers` command provides management capabilities for evaluation scorers that measure the quality, accuracy, and performance of AI-generated outputs.
 
-Read the [Scorers overview]/docs/v1/evals/overview) to learn more.
+Read the [Scorers overview](/docs/v1/evals/overview) to learn more.
 
 ### `add`
 

package/.docs/raw/reference/core/getLogger.mdx

@@ -32,5 +32,5 @@ This method does not accept any parameters.
 
 ## Related
 
-- [Logging overview]/docs/v1/logging)
-- [Logger reference]/reference/v1/logging/pino-logger)
+- [Logging overview](/docs/v1/logging)
+- [Logger reference](/reference/v1/logging/pino-logger)

package/.docs/raw/reference/core/getMCPServer.mdx

@@ -59,8 +59,8 @@ const serverById = mastra.getMCPServerById('my-mcp-server');
 
 ## Related Methods
 
-- [Mastra.getMCPServerById()]/reference/v1/core/getMCPServerById) - Retrieve an MCP server by its intrinsic `id` property
-- [Mastra.listMCPServers()]/reference/v1/core/listMCPServers) - List all registered MCP servers
+- [Mastra.getMCPServerById()](/reference/v1/core/getMCPServerById) - Retrieve an MCP server by its intrinsic `id` property
+- [Mastra.listMCPServers()](/reference/v1/core/listMCPServers) - List all registered MCP servers
 
 ## See Also
 

package/.docs/raw/reference/core/getMCPServerById.mdx

@@ -72,10 +72,10 @@ const serverByKey = mastra.getMCPServer('customKey');
 
 ## Related Methods
 
-- [Mastra.getMCPServer()]/reference/v1/core/getMCPServer) - Retrieve an MCP server by its registry key
-- [Mastra.listMCPServers()]/reference/v1/core/listMCPServers) - List all registered MCP servers
+- [Mastra.getMCPServer()](/reference/v1/core/getMCPServer) - Retrieve an MCP server by its registry key
+- [Mastra.listMCPServers()](/reference/v1/core/listMCPServers) - List all registered MCP servers
 
 ## See Also
 
-- [MCP overview]/docs/v1/tools-mcp/mcp-overview)
-- [MCP server reference]/reference/v1/tools/mcp-server)
+- [MCP overview](/docs/v1/tools-mcp/mcp-overview)
+- [MCP server reference](/reference/v1/tools/mcp-server)

package/.docs/raw/reference/core/getTelemetry.mdx

@@ -32,5 +32,5 @@ This method does not accept any parameters.
 
 ## Related
 
-- [Tracing]/docs/v1/observability/tracing/overview)
-- [Observability Configuration]/reference/v1/observability/tracing/configuration)
+- [Tracing](/docs/v1/observability/tracing/overview)
+- [Observability Configuration](/reference/v1/observability/tracing/configuration)

package/.docs/raw/reference/core/listLogs.mdx

@@ -92,5 +92,5 @@ mastra.listLogs("456");
 
 ## Related
 
-- [Logging overview]/docs/v1/logging)
-- [Logger reference]/reference/v1/logging/pino-logger)
+- [Logging overview](/docs/v1/logging)
+- [Logger reference](/reference/v1/logging/pino-logger)

package/.docs/raw/reference/core/listLogsByRunId.mdx

@@ -83,5 +83,5 @@ mastra.listLogsByRunId({ runId: "123", transportId: "456" });
 
 ## Related
 
-- [Logging overview]/docs/v1/logging)
-- [Logger reference]/reference/v1/logging/pino-logger)
+- [Logging overview](/docs/v1/logging)
+- [Logger reference](/reference/v1/logging/pino-logger)