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

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)

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

@@ -56,10 +56,10 @@ This method does not accept any parameters.
 
 ## Related Methods
 
-- [Mastra.getMCPServer()]/reference/v1/core/getMCPServer) - Retrieve an MCP server by its registry key
-- [Mastra.getMCPServerById()]/reference/v1/core/getMCPServerById) - Retrieve an MCP server by its intrinsic `id` property
+- [Mastra.getMCPServer()](/reference/v1/core/getMCPServer) - Retrieve an MCP server by its registry key
+- [Mastra.getMCPServerById()](/reference/v1/core/getMCPServerById) - Retrieve an MCP server by its intrinsic `id` property
 
 ## 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/setLogger.mdx

@@ -45,5 +45,5 @@ This method does not return a value.
 
 ## 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/setTelemetry.mdx

@@ -32,5 +32,5 @@ This method does not return a value.
 
 ## Related
 
-- [Logging]/docs/v1/logging)
-- [PinoLogger]/reference/v1/logging/pino-logger)
+- [Logging](/docs/v1/logging)
+- [PinoLogger](/reference/v1/logging/pino-logger)