@mastra/mcp-docs-server 1.1.8 → 1.1.9-alpha.1

package/.docs/models/providers/zenmux.md

@@ -1,6 +1,6 @@
 # ![ZenMux logo](https://models.dev/logos/zenmux.svg)ZenMux
 
-Access 67 ZenMux models through Mastra's model router. Authentication is handled automatically using the `ZENMUX_API_KEY` environment variable.
+Access 69 ZenMux models through Mastra's model router. Authentication is handled automatically using the `ZENMUX_API_KEY` environment variable.
 
 Learn more in the [ZenMux documentation](https://docs.zenmux.ai).
 
@@ -54,6 +54,7 @@ for await (const chunk of stream) {
 | `zenmux/google/gemini-2.5-pro`             | 1.0M    |       |           |       |       |       | $1         | $10         |
 | `zenmux/google/gemini-3-flash-preview`     | 1.0M    |       |           |       |       |       | $0.50      | $3          |
 | `zenmux/google/gemini-3-pro-preview`       | 1.0M    |       |           |       |       |       | $2         | $12         |
+| `zenmux/google/gemini-3.1-pro-preview`     | 1.0M    |       |           |       |       |       | $2         | $12         |
 | `zenmux/inclusionai/ling-1t`               | 128K    |       |           |       |       |       | $0.56      | $2          |
 | `zenmux/inclusionai/ring-1t`               | 128K    |       |           |       |       |       | $0.56      | $2          |
 | `zenmux/kuaishou/kat-coder-pro-v1`         | 256K    |       |           |       |       |       | $0.30      | $1          |
@@ -74,6 +75,7 @@ for await (const chunk of stream) {
 | `zenmux/openai/gpt-5.1-codex-mini`         | 400K    |       |           |       |       |       | $0.25      | $2          |
 | `zenmux/openai/gpt-5.2`                    | 400K    |       |           |       |       |       | $2         | $14         |
 | `zenmux/openai/gpt-5.2-codex`              | 400K    |       |           |       |       |       | $2         | $14         |
+| `zenmux/openai/gpt-5.2-pro`                | 400K    |       |           |       |       |       | $21        | $168        |
 | `zenmux/qwen/qwen3-coder-plus`             | 1.0M    |       |           |       |       |       | $1         | $5          |
 | `zenmux/qwen/qwen3-max`                    | 256K    |       |           |       |       |       | $1         | $6          |
 | `zenmux/stepfun/step-3`                    | 66K     |       |           |       |       |       | $0.21      | $0.57       |
@@ -102,9 +104,9 @@ for await (const chunk of stream) {
 | `zenmux/z-ai/glm-4.7-flashx`               | 200K    |       |           |       |       |       | $0.07      | $0.42       |
 | `zenmux/z-ai/glm-5`                        | 200K    |       |           |       |       |       | $0.58      | $3          |
 
-## Advanced Configuration
+## Advanced configuration
 
-### Custom Headers
+### Custom headers
 
 ```typescript
 const agent = new Agent({
@@ -121,7 +123,7 @@ const agent = new Agent({
 });
 ```
 
-### Dynamic Model Selection
+### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
@@ -136,7 +138,7 @@ const agent = new Agent({
 });
 ```
 
-## Direct Provider Installation
+## Direct provider installation
 
 This provider can also be installed directly as a standalone package, which can be used instead of the Mastra model router string. View the [package documentation](https://www.npmjs.com/package/@ai-sdk/anthropic) for more details.
 

package/.docs/models/providers/zhipuai-coding-plan.md

@@ -44,9 +44,9 @@ for await (const chunk of stream) {
 | `zhipuai-coding-plan/glm-4.7`        | 205K    |       |           |       |       |       | —          | —           |
 | `zhipuai-coding-plan/glm-5`          | 205K    |       |           |       |       |       | —          | —           |
 
-## Advanced Configuration
+## Advanced configuration
 
-### Custom Headers
+### Custom headers
 
 ```typescript
 const agent = new Agent({
@@ -63,7 +63,7 @@ const agent = new Agent({
 });
 ```
 
-### Dynamic Model Selection
+### Dynamic model selection
 
 ```typescript
 const agent = new Agent({

package/.docs/models/providers/zhipuai.md

@@ -44,9 +44,9 @@ for await (const chunk of stream) {
 | `zhipuai/glm-4.7-flash` | 200K    |       |           |       |       |       | —          | —           |
 | `zhipuai/glm-5`         | 205K    |       |           |       |       |       | $1         | $3          |
 
-## Advanced Configuration
+## Advanced configuration
 
-### Custom Headers
+### Custom headers
 
 ```typescript
 const agent = new Agent({
@@ -63,7 +63,7 @@ const agent = new Agent({
 });
 ```
 
-### Dynamic Model Selection
+### Dynamic model selection
 
 ```typescript
 const agent = new Agent({

package/.docs/models/providers.md

@@ -14,14 +14,18 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [AIHubMix](https://mastra.ai/models/providers/aihubmix)
 - [Alibaba](https://mastra.ai/models/providers/alibaba)
 - [Alibaba (China)](https://mastra.ai/models/providers/alibaba-cn)
+- [Alibaba Coding Plan](https://mastra.ai/models/providers/alibaba-coding-plan)
+- [Alibaba Coding Plan (China)](https://mastra.ai/models/providers/alibaba-coding-plan-cn)
 - [Bailing](https://mastra.ai/models/providers/bailing)
 - [Baseten](https://mastra.ai/models/providers/baseten)
 - [Berget.AI](https://mastra.ai/models/providers/berget)
 - [Cerebras](https://mastra.ai/models/providers/cerebras)
 - [Chutes](https://mastra.ai/models/providers/chutes)
+- [Clarifai](https://mastra.ai/models/providers/clarifai)
 - [CloudFerro Sherlock](https://mastra.ai/models/providers/cloudferro-sherlock)
 - [Cloudflare Workers AI](https://mastra.ai/models/providers/cloudflare-workers-ai)
 - [Cortecs](https://mastra.ai/models/providers/cortecs)
+- [D.Run (China)](https://mastra.ai/models/providers/drun)
 - [Deep Infra](https://mastra.ai/models/providers/deepinfra)
 - [evroc](https://mastra.ai/models/providers/evroc)
 - [FastRouter](https://mastra.ai/models/providers/fastrouter)

package/.docs/reference/agents/agent.md

@@ -1,4 +1,4 @@
-# Agent Class
+# Agent class
 
 The `Agent` class is the foundation for creating AI agents in Mastra. It provides methods for generating responses, streaming interactions, and handling voice capabilities.
 
@@ -40,7 +40,7 @@ export const agent3 = new Agent({
 })
 ```
 
-### Single CoreSystemMessage
+### Single `CoreSystemMessage`
 
 Use CoreSystemMessage format to access additional properties like `providerOptions` for provider-specific configurations:
 
@@ -63,7 +63,7 @@ export const agent = new Agent({
 })
 ```
 
-### Multiple CoreSystemMessages
+### Multiple `CoreSystemMessages`
 
 ```typescript
 import { Agent } from '@mastra/core/agent'

package/.docs/reference/agents/generateLegacy.md

@@ -126,7 +126,7 @@ await agent.generateLegacy('message for agent')
 
 **toolCalls.args** (`any`): The arguments passed to the tool.
 
-## Migration to New API
+## Migration to new API
 
 > **Info:** The new `.generate()` method offers enhanced capabilities including AI SDK v5+ compatibility, better structured output handling, and improved streaming support. See the [migration guide](https://mastra.ai/guides/migrations/vnext-to-standard-apis) for detailed migration instructions.
 

package/.docs/reference/agents/getDefaultGenerateOptions.md

@@ -2,7 +2,7 @@
 
 > **Warning:** **Deprecated**: This method is deprecated and only works with V1 models. For V2 models, use the new [`.getDefaultOptions()`](https://mastra.ai/reference/agents/getDefaultOptions) method instead.
 
-Agents can be configured with default generation options for controlling model behavior, output formatting and tool and workflow calls. The `.getDefaultGenerateOptionsLegacy()` method retrieves these defaults, resolving them if they are functions. These options apply to all `generateLegacy()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
+Agents can be configured with default generation options for controlling model behavior, output formatting and tool and workflow calls. The `.getDefaultGenerateOptionsLegacy()` method retrieves these defaults, resolving them if they're functions. These options apply to all `generateLegacy()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
 
 ## Usage example
 

package/.docs/reference/agents/getDefaultOptions.md

@@ -1,6 +1,6 @@
 # Agent.getDefaultOptions()
 
-Agents can be configured with default options for memory usage, output format, and iteration steps. The `.getDefaultOptions()` method returns these defaults, resolving them if they are functions. These options apply to all `stream()` and `generate()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
+Agents can be configured with default options for memory usage, output format, and iteration steps. The `.getDefaultOptions()` method returns these defaults, resolving them if they're functions. These options apply to all `stream()` and `generate()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
 
 ## Usage example
 

package/.docs/reference/agents/getDefaultStreamOptions.md

@@ -2,7 +2,7 @@
 
 > **Warning:** **Deprecated**: This method is deprecated and only works with V1 models. For V2 models, use the new [`.getDefaultOptions()`](https://mastra.ai/reference/agents/getDefaultOptions) method instead.
 
-Agents can be configured with default streaming options for memory usage, output format, and iteration steps. The `.getDefaultStreamOptionsLegacy()` method returns these defaults, resolving them if they are functions. These options apply to all `streamLegacy()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
+Agents can be configured with default streaming options for memory usage, output format, and iteration steps. The `.getDefaultStreamOptionsLegacy()` method returns these defaults, resolving them if they're functions. These options apply to all `streamLegacy()` calls unless overridden and are useful for inspecting an agent’s unknown defaults.
 
 ## Usage example
 

package/.docs/reference/agents/getDescription.md

@@ -1,6 +1,6 @@
 # Agent.getDescription()
 
-The `.getDescription()` method retrieves the description configured for an agent. This method returns a simple string description that describes the agent's purpose and capabilities.
+The `.getDescription()` method retrieves the description configured for an agent. This method returns a string description that describes the agent's purpose and capabilities.
 
 ## Usage example
 

package/.docs/reference/agents/network.md

@@ -1,5 +1,7 @@
 # Agent.network()
 
+> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use the [supervisor pattern](https://mastra.ai/docs/agents/supervisor-agents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/guides/migrations/network-to-supervisor) to upgrade.
+
 The `.network()` method enables multi-agent collaboration and routing. This method accepts messages and optional execution options.
 
 ## Usage example
@@ -130,7 +132,7 @@ await agent.network(`
 
 **objectStream** (`ReadableStream<Partial<OUTPUT>>`): A stream of partial objects during structured output generation. Useful for streaming partial results as they're being generated.
 
-## Structured Output
+## Structured output
 
 When you need typed, validated results from your network, use the `structuredOutput` option. The network will generate a response matching your schema after task completion.
 
@@ -186,9 +188,9 @@ When using structured output, additional chunk types are emitted:
 - `network-object`: Emitted with partial objects during streaming
 - `network-object-result`: Emitted with the final structured object
 
-## Aborting a Network
+## Aborting a network
 
-Use `abortSignal` to cancel a running network. When aborted, the network stops routing, cancels any in-progress sub-agent, tool, or workflow execution, and does not save partial results to memory.
+Use `abortSignal` to cancel a running network. When aborted, the network stops routing, cancels any in-progress sub-agent, tool, or workflow execution, and doesn't save partial results to memory.
 
 ```typescript
 const controller = new AbortController()

package/.docs/reference/ai-sdk/handle-chat-stream.md

@@ -40,6 +40,8 @@ export async function POST(req: Request) {
 
 **params.runId** (`string`): The run ID. Required when \`resumeData\` is provided.
 
+**params.providerOptions** (`Record<string, Record<string, unknown>>`): Provider-specific options passed to the language model (e.g. \`{ openai: { reasoningEffort: "high" } }\`). Merged with \`defaultOptions.providerOptions\`, with \`params\` taking precedence.
+
 **params.requestContext** (`RequestContext`): Request context to pass to the agent execution.
 
 **defaultOptions** (`AgentExecutionOptions`): Default options passed to agent execution. These are merged with params, with params taking precedence.

package/.docs/reference/ai-sdk/handle-network-stream.md

@@ -1,5 +1,7 @@
 # handleNetworkStream()
 
+> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use the [supervisor pattern](https://mastra.ai/docs/agents/supervisor-agents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/guides/migrations/network-to-supervisor) to upgrade.
+
 Framework-agnostic handler for streaming network execution in AI SDK-compatible format. Use this function directly when you need to handle network streaming outside Hono or Mastra's own [apiRoutes](https://mastra.ai/docs/server/custom-api-routes) feature.
 
 `handleNetworkStream()` returns a `ReadableStream` that you can wrap with [`createUIMessageStreamResponse()`](https://ai-sdk.dev/docs/reference/ai-sdk-ui/create-ui-message-stream-response).

package/.docs/reference/ai-sdk/network-route.md

@@ -1,5 +1,7 @@
 # networkRoute()
 
+> **Deprecated:** Agent networks are deprecated and will be removed in a future release. Use the [supervisor pattern](https://mastra.ai/docs/agents/supervisor-agents) with `agent.stream()` or `agent.generate()` instead. See the [migration guide](https://mastra.ai/guides/migrations/network-to-supervisor) to upgrade.
+
 Creates a network route handler for streaming network execution using the AI SDK format. This function registers an HTTP `POST` endpoint that accepts messages, executes an agent network, and streams the response back to the client in AI SDK-compatible format. Agent networks allow a routing agent to delegate tasks to other agents. You have to use it inside a [custom API route](https://mastra.ai/docs/server/custom-api-routes).
 
 Use [`handleNetworkStream()`](https://mastra.ai/reference/ai-sdk/handle-network-stream) if you need a framework-agnostic handler.

package/.docs/reference/ai-sdk/to-ai-sdk-stream.md

@@ -152,7 +152,7 @@ export async function POST(req: Request) {
 }
 ```
 
-### Using messageMetadata
+### Using `messageMetadata`
 
 ```typescript
 import { mastra } from '../../mastra'

package/.docs/reference/ai-sdk/to-ai-sdk-v4-messages.md

@@ -57,7 +57,7 @@ Returns an array of AI SDK V4 `UIMessage` objects with the following structure:
 
 ## Examples
 
-### Converting simple text messages
+### Converting text messages
 
 ```typescript
 import { toAISdkV4Messages } from '@mastra/ai-sdk'

package/.docs/reference/ai-sdk/to-ai-sdk-v5-messages.md

@@ -54,7 +54,7 @@ Returns an array of AI SDK V5+ `UIMessage` objects with the following structure:
 
 ## Examples
 
-### Converting simple text messages
+### Converting text messages
 
 ```typescript
 import { toAISdkV5Messages } from '@mastra/ai-sdk/ui'

package/.docs/reference/auth/auth0.md

@@ -1,4 +1,4 @@
-# MastraAuthAuth0 Class
+# MastraAuthAuth0 class
 
 The `MastraAuthAuth0` class provides authentication for Mastra using Auth0. It verifies incoming requests using Auth0-issued JWT tokens and integrates with the Mastra server using the `auth` option.
 
@@ -18,7 +18,7 @@ export const mastra = new Mastra({
 })
 ```
 
-> **Note:** You can omit the constructor parameters if you have the appropriately named environment variables (`AUTH0_DOMAIN` and `AUTH0_AUDIENCE`) set. In that case, simply use `new MastraAuthAuth0()` without any arguments.
+> **Note:** You can omit the constructor parameters if you have the appropriately named environment variables (`AUTH0_DOMAIN` and `AUTH0_AUDIENCE`) set. In that case, use `new MastraAuthAuth0()` without any arguments.
 
 ## Constructor parameters
 
@@ -30,27 +30,27 @@ export const mastra = new Mastra({
 
 **authorizeUser** (`(user: Auth0User) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, allows all authenticated users with valid tokens.
 
-## Environment Variables
+## Environment variables
 
-The following environment variables are automatically used when constructor options are not provided:
+The following environment variables are automatically used when constructor options aren't provided:
 
 **AUTH0\_DOMAIN** (`string`): Your Auth0 domain. Can be found in your Auth0 Dashboard under Applications > Settings.
 
 **AUTH0\_AUDIENCE** (`string`): Your Auth0 API identifier. This is the identifier you set when creating an API in your Auth0 Dashboard.
 
-## Default Authorization Behavior
+## Default authorization behavior
 
 By default, `MastraAuthAuth0` validates Auth0 JWT tokens and allows access to all authenticated users:
 
 1. **Token Verification**: The JWT token is verified using Auth0's public keys (JWKS)
 2. **Signature Validation**: Ensures the token was signed by your Auth0 tenant
-3. **Expiration Check**: Verifies the token has not expired
+3. **Expiration Check**: Verifies the token hasn't expired
 4. **Audience Validation**: Confirms the token was issued for your specific API (audience)
 5. **Issuer Validation**: Ensures the token was issued by your Auth0 domain
 
 If all validations pass, the user is considered authorized. To implement custom authorization logic (e.g., role-based access control), provide a custom `authorizeUser` function.
 
-## Auth0 User Type
+## Auth0 user type
 
 The `Auth0User` type used in the `authorizeUser` function corresponds to the decoded JWT token payload, which typically includes:
 

package/.docs/reference/auth/better-auth.md

@@ -1,4 +1,4 @@
-# MastraAuthBetterAuth Class
+# MastraAuthBetterAuth class
 
 The `MastraAuthBetterAuth` class provides authentication for Mastra applications using Better Auth. It verifies incoming requests with Better Auth sessions and integrates with the Mastra server using the `auth` option.
 
@@ -43,7 +43,7 @@ export const mastra = new Mastra({
 
 **protected** (`Array<string | RegExp | [string, Methods | Methods[]]>`): Protected routes that require authentication. Supports exact paths, wildcards, and path params.
 
-## BetterAuthUser Type
+## `BetterAuthUser` type
 
 The `BetterAuthUser` type contains the session and user information returned by Better Auth:
 

package/.docs/reference/auth/clerk.md

@@ -1,4 +1,4 @@
-# MastraAuthClerk Class
+# MastraAuthClerk class
 
 The `MastraAuthClerk` class provides authentication for Mastra applications using Clerk. It verifies incoming requests with Clerk-issued JWT tokens and integrates with the Mastra server using the `auth` option.
 

package/.docs/reference/auth/firebase.md

@@ -1,4 +1,4 @@
-# MastraAuthFirebase Class
+# MastraAuthFirebase class
 
 The `MastraAuthFirebase` class provides authentication for Mastra using Firebase Authentication. It verifies incoming requests using Firebase ID tokens and integrates with the Mastra server using the `auth` option.
 
@@ -44,9 +44,9 @@ export const mastra = new Mastra({
 
 **authorizeUser** (`(user: FirebaseUser) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, checks for the presence of a document in the 'user\_access' collection keyed by the user's UID.
 
-## Environment Variables
+## Environment variables
 
-The following environment variables are automatically used when constructor options are not provided:
+The following environment variables are automatically used when constructor options aren't provided:
 
 **FIREBASE\_SERVICE\_ACCOUNT** (`string`): Path to Firebase service account JSON file. Used if serviceAccount option is not provided.
 
@@ -54,7 +54,7 @@ The following environment variables are automatically used when constructor opti
 
 **FIREBASE\_DATABASE\_ID** (`string`): Alternative environment variable for Firestore database ID. Used if FIRESTORE\_DATABASE\_ID is not set.
 
-## Default Authorization Behavior
+## Default authorization behavior
 
 By default, `MastraAuthFirebase` uses Firestore to manage user access:
 
@@ -63,7 +63,7 @@ By default, `MastraAuthFirebase` uses Firestore to manage user access:
 3. If the document exists, the user is authorized; otherwise, access is denied
 4. The Firestore database used is determined by the `databaseId` parameter or environment variables
 
-## Firebase User Type
+## Firebase user type
 
 The `FirebaseUser` type used in the `authorizeUser` function corresponds to Firebase's `DecodedIdToken` interface, which includes:
 

package/.docs/reference/auth/jwt.md

@@ -1,4 +1,4 @@
-# MastraJwtAuth Class
+# MastraJwtAuth class
 
 The `MastraJwtAuth` class provides a lightweight authentication mechanism for Mastra using JSON Web Tokens (JWTs). It verifies incoming requests based on a shared secret and integrates with the Mastra server using the `auth` option.
 

package/.docs/reference/auth/supabase.md

@@ -1,4 +1,4 @@
-# MastraAuthSupabase Class
+# MastraAuthSupabase class
 
 The `MastraAuthSupabase` class provides authentication for Mastra using Supabase Auth. It verifies incoming requests using Supabase's authentication system and integrates with the Mastra server using the `auth` option.
 

package/.docs/reference/auth/workos.md

@@ -1,4 +1,4 @@
-# MastraAuthWorkos Class
+# MastraAuthWorkos class
 
 The `MastraAuthWorkos` class provides authentication for Mastra using WorkOS. It verifies incoming requests using WorkOS access tokens and integrates with the Mastra server using the `auth` option.
 
@@ -18,7 +18,7 @@ export const mastra = new Mastra({
 })
 ```
 
-> **Note:** You can omit the constructor parameters if you have the appropriately named environment variables (`WORKOS_API_KEY` and `WORKOS_CLIENT_ID`) set. In that case, simply use `new MastraAuthWorkos()` without any arguments.
+> **Note:** You can omit the constructor parameters if you have the appropriately named environment variables (`WORKOS_API_KEY` and `WORKOS_CLIENT_ID`) set. In that case, use `new MastraAuthWorkos()` without any arguments.
 
 ## Constructor parameters
 
@@ -30,15 +30,15 @@ export const mastra = new Mastra({
 
 **authorizeUser** (`(user: WorkosUser) => Promise<boolean> | boolean`): Custom authorization function to determine if a user should be granted access. Called after token verification. By default, checks if the user has an 'admin' role in any organization membership.
 
-## Environment Variables
+## Environment variables
 
-The following environment variables are automatically used when constructor options are not provided:
+The following environment variables are automatically used when constructor options aren't provided:
 
 **WORKOS\_API\_KEY** (`string`): Your WorkOS API key. Can be found in your WorkOS Dashboard under API Keys.
 
 **WORKOS\_CLIENT\_ID** (`string`): Your WorkOS Client ID. Can be found in your WorkOS Dashboard under Applications.
 
-## Default Authorization Behavior
+## Default authorization behavior
 
 By default, `MastraAuthWorkos` implements role-based authorization that checks for admin access:
 
@@ -53,7 +53,7 @@ This means that by default, only users with admin privileges in at least one org
 
 To implement custom authorization logic (e.g., allow all authenticated users, check for specific roles, or implement custom business logic), provide a custom `authorizeUser` function.
 
-## WorkOS User Type
+## WorkOS user type
 
 The `WorkosUser` type used in the `authorizeUser` function corresponds to the JWT token payload returned by WorkOS. WorkOS allows administrators to set up custom JWT templates, so the exact structure may vary based on your configuration. Here's an example of what the user object might look like:
 

package/.docs/reference/cli/mastra.md

@@ -1,4 +1,4 @@
-# CLI Commands
+# CLI commands
 
 You can use the Command-Line Interface (CLI) provided by Mastra to develop, build, and start your Mastra project.
 
@@ -30,7 +30,7 @@ Comma-separated list of custom arguments to pass to the Node.js process, e.g. `-
 
 #### `--request-context-presets`
 
-Path to a JSON file containing named [request context](https://mastra.ai/docs/server/request-context) presets. When provided, a dropdown appears in Studio's request context editor, letting you quickly switch between preset configurations.
+Path to a JSON file containing named [request context](https://mastra.ai/docs/server/request-context) presets. When provided, a dropdown displays in Studio's request context editor, letting you quickly switch between preset configurations.
 
 ```bash
 mastra dev --request-context-presets ./presets.json
@@ -57,7 +57,7 @@ Set `MASTRA_SKIP_PEERDEP_CHECK=1` to skip the peer dependency version mismatch c
 MASTRA_SKIP_PEERDEP_CHECK=1 mastra dev
 ```
 
-This is useful during monorepo development when peer dependencies may be bumped but packages are not yet published.
+This is useful during monorepo development when peer dependencies may be bumped but packages aren't yet published.
 
 #### Disable build caching
 
@@ -101,7 +101,7 @@ These are forwarded to the Mastra model router and will work with any `"openai/.
 
 ## `mastra build`
 
-The `mastra build` command bundles your Mastra project into a production-ready Hono server. [Hono](https://hono.dev/) is a lightweight, type-safe web framework that makes it easy to deploy Mastra agents as HTTP endpoints with middleware support.
+The `mastra build` command bundles your Mastra project into a production-ready Hono server. [Hono](https://hono.dev/) is a lightweight, type-safe web framework that makes it straightforward to deploy Mastra agents as HTTP endpoints with middleware support.
 
 Under the hood Mastra's Rollup server locates your Mastra entry file and bundles it to a production-ready Hono server. During that bundling it tree-shakes your code and generates source maps for debugging.
 
@@ -253,7 +253,7 @@ If enabled, example code is written to the list of components (e.g. example agen
 
 #### `--no-example`
 
-Do not include example code. Useful when using the `--default` flag.
+Don't include example code. Useful when using the `--default` flag.
 
 #### `--mcp`