@mastra/mcp-docs-server 1.2.7-alpha.8 → 1.2.8-alpha.0

package/.docs/docs/mastra-platform/overview.md

@@ -8,9 +8,9 @@ The [Mastra platform](https://projects.mastra.ai) provides three products for de
 - [**Studio**](https://mastra.ai/docs/mastra-platform/studio): A hosted visual environment for testing agents, running workflows, and inspecting traces. Starting with Studio also gives you Observability.
 - [**Server**](https://mastra.ai/docs/mastra-platform/server): A production deployment target that runs your Mastra application as an API server. Starting with Server also gives you Observability.
 
-You can deploy Studio and Server from the CLI or connect a GitHub repository for push-to-deploy. See the [GitHub integration](https://mastra.ai/docs/mastra-platform/github) for the repository-linked flow.
+Deploy with a single command, [`mastra deploy`](https://mastra.ai/docs/mastra-platform/deploy), or connect a GitHub repository for push-to-deploy. See the [GitHub integration](https://mastra.ai/docs/mastra-platform/github) for the repository-linked flow.
 
-You can also provision [**Hosted databases**](https://mastra.ai/docs/mastra-platform/database) from your project settings to persist your application data with no manual configuration.
+Each project can run multiple [**Environments**](https://mastra.ai/docs/mastra-platform/environments) (for example `production` and `staging`) and provision [**Hosted databases**](https://mastra.ai/docs/mastra-platform/database) from the CLI or project settings to persist application data with no manual configuration.
 
 ## Get started
 
@@ -20,7 +20,7 @@ Choose the path that matches what you want to do:
 - **Deploy Studio**: Use [Studio](https://mastra.ai/docs/mastra-platform/studio) to host the visual development environment for your team. Start here if you want a shared UI for testing agents, running workflows, and inspecting traces.
 - **Deploy Server**: Use [Server](https://mastra.ai/docs/mastra-platform/server) to run your Mastra application as a production API server. Start here when you’re ready to serve agents, tools, and workflows from the cloud.
 
-## Key Concepts
+## Key concepts
 
 **Projects** are the shared parent entity across all products. A single project can have Observability, a Studio deployment, and a Server deployment. Projects belong to an **Organization**, which is the multi-tenant container for your team.
 
@@ -34,8 +34,8 @@ Your Mastra application is built from three building blocks:
 
 Develop your project locally with [`mastra dev`](https://mastra.ai/reference/cli/mastra) and open [Studio](https://mastra.ai/docs/studio/overview) to test your agents, workflows, and tools in a visual environment.
 
-Once you're ready to deploy your application to production, use [`mastra studio deploy`](https://mastra.ai/reference/cli/mastra) and [`mastra server deploy`](https://mastra.ai/reference/cli/mastra) to push your application to the cloud.
+Once you're ready to deploy your application to production, run [`mastra deploy`](https://mastra.ai/reference/cli/mastra) to push your application to the cloud.
 
-Follow the [Studio on Mastra platform](https://mastra.ai/docs/mastra-platform/studio) and [Server on Mastra platform](https://mastra.ai/docs/mastra-platform/server) docs for step-by-step instructions.
+Follow the [Deploy](https://mastra.ai/docs/mastra-platform/deploy) docs for step-by-step instructions.
 
 If you host your Mastra application on your own infrastructure, you can still send observability data to Mastra platform using the [MastraPlatformExporter](https://mastra.ai/docs/observability/integrations/exporters/mastra-platform).

package/.docs/docs/mastra-platform/server.md

@@ -6,6 +6,8 @@ Server on Mastra platform is a production deployment target that runs your Mastr
 
 You get a stable API endpoint, environment variable management, custom domain support, and deploy history out of the box.
 
+> **Note:** `mastra server deploy` is the earlier split deploy path. New projects should use the unified [`mastra deploy`](https://mastra.ai/docs/mastra-platform/deploy) command, which adds preflight validation, environments, and CLI-managed databases.
+
 > **Note:** Server deploy provisions hosted storage automatically. If you override storage with [LibSQLStore](https://mastra.ai/reference/storage/libsql) and a file URL, switch to a remotely hosted database because Mastra platform uses an ephemeral filesystem.
 
 ## Quickstart

package/.docs/docs/mastra-platform/studio.md

@@ -2,10 +2,12 @@
 
 # Studio on Mastra platform
 
-Studio on Mastra platform is a hosted visual environment for testing agents, running workflows, and inspecting traces. Use it when you want to share Studio with your team without hosting the Studio UI yourself.
+Studio on Mastra platform is a hosted visual workspace for testing agents, running workflows, and inspecting traces. Use it when you want to share Studio with your team without hosting the Studio UI yourself.
 
 You can deploy Studio from the CLI as shown below, or link a GitHub repository for push-to-deploy. See the [GitHub integration](https://mastra.ai/docs/mastra-platform/github) for the repository-linked flow.
 
+> **Note:** `mastra studio deploy` is the earlier split deploy path. New projects should use the unified [`mastra deploy`](https://mastra.ai/docs/mastra-platform/deploy) command, which adds preflight validation, environments, and CLI-managed databases.
+
 ## Quickstart
 
 1. Follow the [get started guide](https://mastra.ai/docs) to create your first Mastra project.
@@ -56,7 +58,7 @@ See the [`mastra studio deploy` CLI reference](https://mastra.ai/reference/cli/m
 
 ## Environment files
 
-The deploy bundles environment variables from a `.env` or `.env.*` file in the project directory. If no env file is present, the deploy errors with `No env file found for deploy.` after the build step. Add at least an empty `.env` file before running the command.
+A local env file is optional. When a `.env` or `.env.*` file is present in the project directory, the deploy bundles its environment variables.
 
 When multiple env files are present, the CLI prompts you to pick one. To select non-interactively, pass `--env-file`:
 
@@ -64,7 +66,7 @@ When multiple env files are present, the CLI prompts you to pick one. To select
 mastra studio deploy --env-file .env.production --yes
 ```
 
-This is also how you target multiple environments from a single codebase: maintain one env file per environment, such as `.env.staging` and `.env.production`, and pass the right one to each deploy. Each environment still requires its own Mastra platform project. See [Configuration](https://mastra.ai/docs/mastra-platform/configuration) for the multi-environment pattern.
+To run the same codebase across `production` and `staging`, use the unified [`mastra deploy --env`](https://mastra.ai/docs/mastra-platform/deploy) command instead. [Environments](https://mastra.ai/docs/mastra-platform/environments) replace the earlier pattern of one project per environment.
 
 ## Create a new project non-interactively
 

package/.docs/docs/mcp/mcp-apps.md

@@ -81,7 +81,7 @@ calculatorTool._meta = {
 }
 ```
 
-> **Note:** Visit [MCPServer reference](https://mastra.ai/reference/tools/mcp-server) for the full `appResources` configuration.
+Visit [MCPServer reference](https://mastra.ai/reference/tools/mcp-server) for the full `appResources` configuration.
 
 ## Connecting MCP Apps to agents
 
@@ -249,7 +249,7 @@ Establishes the connection to the host. Call this after registering all event ha
 await app.connect()
 ```
 
-> **Note:** See the [`App` class API reference](https://apps.extensions.modelcontextprotocol.io/api/classes/app.App.html) for the full list of methods, callbacks, and lifecycle hooks.
+See the [`App` class API reference](https://apps.extensions.modelcontextprotocol.io/api/classes/app.App.html) for the full list of methods, callbacks, and lifecycle hooks.
 
 ## Using external MCP servers with apps
 
@@ -284,7 +284,7 @@ export const mastra = new Mastra({
 })
 ```
 
-> **Note:** Visit [MCPClient reference](https://mastra.ai/reference/tools/mcp-client) for more details on proxying external servers.
+Visit [MCPClient reference](https://mastra.ai/reference/tools/mcp-client) for more details on proxying external servers.
 
 ## Sandbox security
 

package/.docs/docs/mcp/overview.md

@@ -62,7 +62,7 @@ export const testMcpClient = new MCPClient({
 })
 ```
 
-> **Info:** Visit [MCPClient](https://mastra.ai/reference/tools/mcp-client) for a full list of configuration options.
+Visit [MCPClient](https://mastra.ai/reference/tools/mcp-client) for a full list of configuration options.
 
 > **Authentication:** For connecting to OAuth-protected MCP servers, see the [OAuth Authentication](https://mastra.ai/reference/tools/mcp-client) section.
 
@@ -89,7 +89,7 @@ export const testAgent = new Agent({
 })
 ```
 
-> **Info:** Visit [Agent Class](https://mastra.ai/reference/agents/agent) for a full list of configuration options.
+Visit [Agent Class](https://mastra.ai/reference/agents/agent) for a full list of configuration options.
 
 ## Tool approval
 
@@ -129,7 +129,7 @@ export const testMcpServer = new MCPServer({
 })
 ```
 
-> **Info:** Visit [MCPServer](https://mastra.ai/reference/tools/mcp-server) for a full list of configuration options.
+Visit [MCPServer](https://mastra.ai/reference/tools/mcp-server) for a full list of configuration options.
 
 > **Authentication:** To protect your MCP server with OAuth, see the [OAuth Protection](https://mastra.ai/reference/tools/mcp-server) section.
 
@@ -160,9 +160,7 @@ export const mastra = new Mastra({
 
 ### Static tools
 
-Use the `.listTools()` method to fetch tools from all configured MCP servers. This is suitable when configuration (such as API keys) is static and consistent across users or requests. Call it once and pass the result to the `tools` property when defining your agent.
-
-> **Info:** Visit [listTools()](https://mastra.ai/reference/tools/mcp-client) for more information.
+Use the `.listTools()` method to fetch tools from all configured MCP servers. This is suitable when configuration (such as API keys) is static and consistent across users or requests. Call it once and pass the result to the `tools` property when defining your agent. Visit [listTools()](https://mastra.ai/reference/tools/mcp-client) for more information.
 
 ```typescript
 import { Agent } from '@mastra/core/agent'
@@ -211,7 +209,7 @@ async function handleRequest(userPrompt: string, userApiKey: string) {
 }
 ```
 
-> **Info:** Visit [listToolsets()](https://mastra.ai/reference/tools/mcp-client) for more information.
+Visit [listToolsets()](https://mastra.ai/reference/tools/mcp-client) for more information.
 
 ## Connecting to an MCP registry
 
@@ -412,9 +410,7 @@ As an alternative to MCP, Ampersand's AI SDK also has an adapter for Mastra, so
 
 ## MCP Apps
 
-MCP servers can serve interactive HTML UIs via the MCP Apps extension. Tools with associated `ui://` resources render sandboxed iframes in Studio — both on tool detail pages and inline in agent chat. The app iframe can call server tools and inject messages into the conversation.
-
-> **Note:** Visit [MCP Apps](https://mastra.ai/docs/mcp/mcp-apps) for setup instructions and the app bridge API.
+MCP servers can serve interactive HTML UIs via the MCP Apps extension. Tools with associated `ui://` resources render sandboxed iframes in Studio — both on tool detail pages and inline in agent chat. The app iframe can call server tools and inject messages into the conversation. Visit [MCP Apps](https://mastra.ai/docs/mcp/mcp-apps) for setup instructions and the app bridge API.
 
 ## Related
 

package/.docs/docs/memory/overview.md

@@ -77,7 +77,7 @@ Use memory when your agent needs to maintain multi-turn conversations that refer
    bun add @mastra/libsql@latest
    ```
 
-   > **Note:** For more details on available providers and how storage works in Mastra, visit the [storage](https://mastra.ai/docs/storage/overview) documentation.
+   For more details on available providers and how storage works in Mastra, visit the [storage](https://mastra.ai/docs/storage/overview) documentation.
 
 3. Add the storage provider to your main Mastra instance to enable memory across all configured agents.
 
@@ -110,7 +110,7 @@ Use memory when your agent needs to maintain multi-turn conversations that refer
    })
    ```
 
-   > **Note:** Visit [Memory Class](https://mastra.ai/reference/memory/memory-class) for a full list of configuration options.
+   Visit [Memory Class](https://mastra.ai/reference/memory/memory-class) for a full list of configuration options.
 
 5. Call your agent, for example in [Studio](https://mastra.ai/docs/studio/overview). Inside Studio, start a new chat with your agent and take a look at the right sidebar. It'll now display various memory-related information.
 
@@ -166,7 +166,7 @@ export const memoryAgent = new Agent({
 })
 ```
 
-> **Note:** See [Observational Memory](https://mastra.ai/docs/memory/observational-memory) for details on how observations and reflections work, and [the reference](https://mastra.ai/reference/memory/observational-memory) for all configuration options.
+See [Observational Memory](https://mastra.ai/docs/memory/observational-memory) for details on how observations and reflections work, and [the reference](https://mastra.ai/reference/memory/observational-memory) for all configuration options.
 
 ## Memory in multi-agent systems
 
@@ -238,7 +238,7 @@ export const memoryAgent = new Agent({
 })
 ```
 
-> **Note:** Visit [Request Context](https://mastra.ai/docs/server/request-context) for more information.
+Visit [Request Context](https://mastra.ai/docs/server/request-context) for more information.
 
 ## Related
 

package/.docs/docs/observability/integrations/exporters/mastra-platform.md

@@ -126,9 +126,7 @@ If you prefer, rely entirely on environment variables:
 new MastraPlatformExporter()
 ```
 
-With `MASTRA_PLATFORM_ACCESS_TOKEN` and `MASTRA_PROJECT_ID` set, `MastraPlatformExporter` sends data to the Mastra platform project you configured. If you also set `MASTRA_PLATFORM_OBSERVABILITY_ENDPOINT`, it sends data to that collector instead.
-
-> **Note:** Visit [MastraPlatformExporter reference](https://mastra.ai/reference/observability/tracing/exporters/mastra-platform-exporter) for the full list of configuration options.
+With `MASTRA_PLATFORM_ACCESS_TOKEN` and `MASTRA_PROJECT_ID` set, `MastraPlatformExporter` sends data to the Mastra platform project you configured. If you also set `MASTRA_PLATFORM_OBSERVABILITY_ENDPOINT`, it sends data to that collector instead. Visit [MastraPlatformExporter reference](https://mastra.ai/reference/observability/tracing/exporters/mastra-platform-exporter) for the full list of configuration options.
 
 ## Recommended configuration
 

package/.docs/docs/observability/logging.md

@@ -6,6 +6,8 @@ Mastra's logging system captures function execution, input data, and output resp
 
 When deploying to the Mastra platform, logs are shown in the dashboard. In self-hosted or custom environments, logs can be directed to files or external services depending on the configured transports.
 
+**For AI agents:** Run `npx mastra api log list '{"level":"error","page":0,"perPage":50}'` to inspect recent error logs directly instead of opening Studio or writing a temporary script. The command requires a running Mastra server with observability logging configured; start the local server with `npx mastra dev`, or pass the reachable server's base URL with `--url`. Run `npx mastra api log list --schema` before constructing different filters. Install Mastra's skill with `npx skills add mastra-ai/skills --skill mastra` for complete API CLI discovery, targeting, schema, authentication, and error-handling guidance.
+
 ## Configuring logs with `PinoLogger`
 
 When [initializing a new Mastra project](https://mastra.ai/guides/getting-started/quickstart) using the CLI, `PinoLogger` is included by default.
@@ -22,7 +24,7 @@ export const mastra = new Mastra({
 })
 ```
 
-> **Info:** Visit [PinoLogger](https://mastra.ai/reference/logging/pino-logger) for all available configuration options.
+Visit [PinoLogger](https://mastra.ai/reference/logging/pino-logger) for all available configuration options.
 
 ## Logging to observability storage
 

package/.docs/docs/observability/metrics/querying.md

@@ -4,6 +4,8 @@
 
 Mastra exposes the same five OLAP queries (`getMetricAggregate`, `getMetricBreakdown`, `getMetricTimeSeries`, `getMetricPercentiles`, and discovery helpers) through three surfaces: an in-process store accessor, the runtime HTTP API, and the `mastra api metric` CLI. All three accept the same Zod-validated input shapes, so you can move from a one-off CLI investigation to a programmatic dashboard tool without re-learning the API.
 
+**For AI agents:** Run `npx mastra api metric aggregate '{"name":"mastra_agent_duration_ms","aggregation":"avg"}'` to query average agent latency directly instead of writing a temporary script. Querying local metrics requires a running Mastra server with an OLAP-capable observability store; start the local server with `npx mastra dev`, or pass the reachable server's base URL with `--url`. Run `npx mastra api metric aggregate --schema` before constructing a different query. Install Mastra's skill with `npx skills add mastra-ai/skills --skill mastra` for complete API CLI discovery, targeting, schema, authentication, and error-handling guidance.
+
 ## When to use this
 
 - Build a custom dashboard or KPI tile alongside Studio.

package/.docs/docs/observability/tracing/overview.md

@@ -6,6 +6,8 @@ Tracing is the observability signal that records how a request moves through age
 
 This page focuses on trace-specific concepts: span hierarchy, sampling, metadata, filtering, trace IDs, and third-party trace context.
 
+**For AI agents:** Run `npx mastra api trace list '{"page":0,"perPage":20}'` to inspect recent traces directly instead of opening Studio or writing a temporary script. The command requires a running Mastra server with observability configured; start the local server with `npx mastra dev`, or pass the reachable server's base URL with `--url`. Run `npx mastra api trace list --schema` before constructing different filters. Install Mastra's skill with `npx skills add mastra-ai/skills --skill mastra` for complete API CLI discovery, targeting, schema, authentication, and error-handling guidance.
+
 ## When to use tracing
 
 - Debug unexpected agent or workflow behavior by inspecting the full execution path.
@@ -325,7 +327,7 @@ const result = await agent.generate([{ role: 'user', content: 'Sensitive operati
 })
 ```
 
-> **Tip:** For more granular control over sensitive data, consider using the [Sensitive Data Filter](https://mastra.ai/docs/observability/integrations/processors/sensitive-data-filter) processor, which can redact specific fields (like passwords, tokens, and keys) while preserving the rest of the input/output.
+For more granular control over sensitive data, consider using the [Sensitive Data Filter](https://mastra.ai/docs/observability/integrations/processors/sensitive-data-filter) processor, which can redact specific fields (like passwords, tokens, and keys) while preserving the rest of the input/output.
 
 #### Child spans and metadata extraction
 

package/.docs/docs/server/auth/auth0.md

@@ -105,7 +105,7 @@ const auth0Provider = new MastraAuthAuth0({
 })
 ```
 
-> **Info:** Visit [MastraAuthAuth0](https://mastra.ai/reference/auth/auth0) for all available configuration options.
+Visit [MastraAuthAuth0](https://mastra.ai/reference/auth/auth0) for all available configuration options.
 
 ## Client-side setup
 

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

@@ -87,7 +87,7 @@ export const mastra = new Mastra({
 })
 ```
 
-> **Info:** Visit [MastraAuthBetterAuth](https://mastra.ai/reference/auth/better-auth) for all available configuration options.
+Visit [MastraAuthBetterAuth](https://mastra.ai/reference/auth/better-auth) for all available configuration options.
 
 ## Custom authorization
 
@@ -180,7 +180,7 @@ export const mastraClient = new MastraClient({
 })
 ```
 
-> **Info:** Visit [Mastra Client SDK](https://mastra.ai/docs/server/mastra-client) for more configuration options.
+Visit [Mastra Client SDK](https://mastra.ai/docs/server/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 

package/.docs/docs/server/auth/clerk.md

@@ -88,7 +88,7 @@ export const useClerkAuth = () => {
 }
 ```
 
-> **Info:** Refer to the [Clerk documentation](https://clerk.com/docs) for more information.
+Refer to the [Clerk documentation](https://clerk.com/docs) for more information.
 
 ## Configuring `MastraClient`
 

package/.docs/docs/server/auth/firebase.md

@@ -118,7 +118,7 @@ const firebaseAuth = new MastraAuthFirebase({
 })
 ```
 
-> **Info:** Visit [MastraAuthFirebase](https://mastra.ai/reference/auth/firebase) for all available configuration options.
+Visit [MastraAuthFirebase](https://mastra.ai/reference/auth/firebase) for all available configuration options.
 
 ## Client-side setup
 

package/.docs/docs/server/auth/google.md

@@ -168,7 +168,7 @@ export const mastra = new Mastra({
 })
 ```
 
-> **Info:** Visit [MastraAuthGoogle](https://mastra.ai/reference/auth/google) for all available configuration options.
+Visit [MastraAuthGoogle](https://mastra.ai/reference/auth/google) for all available configuration options.
 
 ## Role mapping
 
@@ -242,7 +242,7 @@ export const createMastraClient = (idToken: string) => {
 }
 ```
 
-> **Info:** Visit [Mastra Client SDK](https://mastra.ai/docs/server/mastra-client) for more configuration options.
+Visit [Mastra Client SDK](https://mastra.ai/docs/server/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 

package/.docs/docs/server/auth/jwt.md

@@ -61,7 +61,7 @@ export const mastra = new Mastra({
 })
 ```
 
-> **Info:** Visit [MastraJwtAuth](https://mastra.ai/reference/auth/jwt) for all available configuration options.
+Visit [MastraJwtAuth](https://mastra.ai/reference/auth/jwt) for all available configuration options.
 
 Inside [Studio](https://mastra.ai/docs/studio/overview), go to **Settings** and under **Headers** select the **"Add Header"** button. Enter `Authorization` as the header name and `Bearer <your-jwt>` as the value.
 
@@ -80,7 +80,7 @@ export const mastraClient = new MastraClient({
 })
 ```
 
-> **Info:** Visit [Mastra Client SDK](https://mastra.ai/docs/server/mastra-client) for more configuration options.
+Visit [Mastra Client SDK](https://mastra.ai/docs/server/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 

package/.docs/docs/server/auth/okta.md

@@ -120,7 +120,7 @@ export const mastra = new Mastra({
 
 > **Note:** To link users between providers, store the Okta user ID in the other provider's user metadata. Mastra uses this ID to fetch groups from Okta.
 
-> **Info:** Visit [MastraAuthOkta](https://mastra.ai/reference/auth/okta) for all available configuration options.
+Visit [MastraAuthOkta](https://mastra.ai/reference/auth/okta) for all available configuration options.
 
 ## Role mapping
 
@@ -194,7 +194,7 @@ export const createMastraClient = (accessToken: string) => {
 }
 ```
 
-> **Info:** Visit [Mastra Client SDK](https://mastra.ai/docs/server/mastra-client) for more configuration options.
+Visit [Mastra Client SDK](https://mastra.ai/docs/server/mastra-client) for more configuration options.
 
 ### Making authenticated requests
 

package/.docs/docs/server/auth/workos.md

@@ -149,7 +149,7 @@ const workosAuth = new AdminOnlyWorkosAuth({
 })
 ```
 
-> **Info:** Visit [MastraAuthWorkos](https://mastra.ai/reference/auth/workos) for all available configuration options.
+Visit [MastraAuthWorkos](https://mastra.ai/reference/auth/workos) for all available configuration options.
 
 ## Client-side setup
 

package/.docs/docs/server/mastra-client.md

@@ -134,7 +134,7 @@ export const mastraClient = new MastraClient({
 })
 ```
 
-> **Info:** Visit [MastraClient](https://mastra.ai/reference/client-js/mastra-client) for more configuration options.
+Visit [MastraClient](https://mastra.ai/reference/client-js/mastra-client) for more configuration options.
 
 ## Credentials and session cookies
 

package/.docs/docs/server/mastra-server.md

@@ -32,7 +32,7 @@ export const mastra = new Mastra({
 })
 ```
 
-> **Info:** Visit the [configuration reference](https://mastra.ai/reference/configuration) for a full list of available server options.
+Visit the [configuration reference](https://mastra.ai/reference/configuration) for a full list of available server options.
 
 ## Deploy your server
 

package/.docs/docs/server/pubsub.md

@@ -116,7 +116,7 @@ export const mastra = new Mastra({
 })
 ```
 
-> **Note:** Visit the [PubSub reference](https://mastra.ai/reference/pubsub/base) for the full delivery contract and the configuration options for each backend.
+Visit the [PubSub reference](https://mastra.ai/reference/pubsub/base) for the full delivery contract and the configuration options for each backend.
 
 ## Related
 

package/.docs/docs/server/request-context.md

@@ -82,7 +82,7 @@ export const mastra = new Mastra({
 })
 ```
 
-> **Info:** Visit [Middleware](https://mastra.ai/docs/server/middleware) for how to use server middleware.
+Visit [Middleware](https://mastra.ai/docs/server/middleware) for how to use server middleware.
 
 ## Studio
 
@@ -188,7 +188,7 @@ export const registryAgent = new Agent({
 })
 ```
 
-> **Info:** Visit [Agent](https://mastra.ai/reference/agents/agent) for a full list of configuration options.
+Visit [Agent](https://mastra.ai/reference/agents/agent) for a full list of configuration options.
 
 ## Accessing values from workflow steps
 
@@ -210,7 +210,7 @@ const stepOne = createStep({
 })
 ```
 
-> **Info:** Visit [createStep()](https://mastra.ai/reference/workflows/step) for a full list of configuration options.
+Visit [createStep()](https://mastra.ai/reference/workflows/step) for a full list of configuration options.
 
 ## Accessing values with tools
 
@@ -232,7 +232,7 @@ export const weatherTool = createTool({
 })
 ```
 
-> **Info:** Visit [createTool()](https://mastra.ai/reference/tools/create-tool) for a full list of configuration options.
+Visit [createTool()](https://mastra.ai/reference/tools/create-tool) for a full list of configuration options.
 
 ## Reserved keys
 

package/.docs/docs/server/server-adapters.md

@@ -303,7 +303,7 @@ app.listen(4111, () => {
 })
 ```
 
-> **Info:** See the [Express Adapter](https://mastra.ai/reference/server/express-adapter) documentation for full configuration options.
+See the [Express Adapter](https://mastra.ai/reference/server/express-adapter) documentation for full configuration options.
 
 **Hono**:
 
@@ -324,7 +324,7 @@ serve({ fetch: app.fetch, port: 4111 }, () => {
 })
 ```
 
-> **Info:** See the [Hono Adapter](https://mastra.ai/reference/server/hono-adapter) documentation for full configuration options.
+See the [Hono Adapter](https://mastra.ai/reference/server/hono-adapter) documentation for full configuration options.
 
 **Fastify**:
 
@@ -352,7 +352,7 @@ app.listen({ port }, () => {
 })
 ```
 
-> **Info:** See the [Fastify Adapter](https://mastra.ai/reference/server/fastify-adapter) documentation for full configuration options.
+See the [Fastify Adapter](https://mastra.ai/reference/server/fastify-adapter) documentation for full configuration options.
 
 **Koa**:
 
@@ -387,7 +387,7 @@ app.listen(port, () => {
 })
 ```
 
-> **Info:** See the [Koa Adapter](https://mastra.ai/reference/server/koa-adapter) documentation for full configuration options.
+See the [Koa Adapter](https://mastra.ai/reference/server/koa-adapter) documentation for full configuration options.
 
 **NestJS**:
 
@@ -418,7 +418,7 @@ async function bootstrap() {
 bootstrap()
 ```
 
-> **Info:** See the [NestJS Adapter](https://mastra.ai/reference/server/nestjs-adapter) documentation for full configuration options.
+See the [NestJS Adapter](https://mastra.ai/reference/server/nestjs-adapter) documentation for full configuration options.
 
 ## Initialization flow
 
@@ -460,7 +460,7 @@ You can add your own routes to the app alongside Mastra's routes.
 - When you want Mastra-managed auth and route metadata such as `requiresAuth`, prefer `registerApiRoute()`.
 - When you mount routes directly on the framework app, use the adapter's exported `createAuthMiddleware()` helper if those routes need Mastra auth.
 
-> **Info:** Visit "Adding custom routes" for [Express](https://mastra.ai/reference/server/express-adapter) and [Hono](https://mastra.ai/reference/server/hono-adapter) for more information.
+Visit "Adding custom routes" for [Express](https://mastra.ai/reference/server/express-adapter) and [Hono](https://mastra.ai/reference/server/hono-adapter) for more information.
 
 ## Route prefixes
 
@@ -513,7 +513,7 @@ const server = new MastraServer({
 })
 ```
 
-> **Info:** See [MastraServer](https://mastra.ai/reference/server/mastra-server) for full configuration options.
+See [MastraServer](https://mastra.ai/reference/server/mastra-server) for full configuration options.
 
 ## Per-route auth overrides
 
@@ -540,7 +540,7 @@ const server = new MastraServer({
 })
 ```
 
-> **Info:** See [MastraServer](https://mastra.ai/reference/server/mastra-server) for full configuration options.
+See [MastraServer](https://mastra.ai/reference/server/mastra-server) for full configuration options.
 
 ## Accessing the app
 

package/.docs/docs/studio/auth.md

@@ -35,9 +35,7 @@ export const mastra = new Mastra({
 })
 ```
 
-Once configured, Studio shows a login screen and requires authentication for all API requests.
-
-> **Note:** Visit the [Auth docs](https://mastra.ai/docs/server/auth) for a full list of supported providers.
+Once configured, Studio shows a login screen and requires authentication for all API requests. Visit the [Auth docs](https://mastra.ai/docs/server/auth) for a full list of supported providers.
 
 ## How it works
 

package/.docs/docs/workflows/agents-and-tools.md

@@ -57,7 +57,7 @@ export const testWorkflow = createWorkflow({})
   .commit()
 ```
 
-> **Info:** Visit [Input Data Mapping](https://mastra.ai/docs/workflows/control-flow) for more information.
+Visit [Input Data Mapping](https://mastra.ai/docs/workflows/control-flow) for more information.
 
 When no `structuredOutput` option is provided, Mastra agents use a default schema that expects a `prompt` string as input and returns a `text` string as output:
 
@@ -106,9 +106,7 @@ export const testWorkflow = createWorkflow({})
   .commit()
 ```
 
-The `structuredOutput.schema` option accepts any Standard JSON Schema. The agent will generate output conforming to this schema, and the step's `outputSchema` will be automatically set to match.
-
-> **Info:** Visit [Structured Output](https://mastra.ai/docs/agents/structured-output) for more options like error handling strategies and streaming with structured output.
+The `structuredOutput.schema` option accepts any Standard JSON Schema. The agent will generate output conforming to this schema, and the step's `outputSchema` will be automatically set to match. Visit [Structured Output](https://mastra.ai/docs/agents/structured-output) for more options like error handling strategies and streaming with structured output.
 
 ## Using tools in workflows
 
@@ -157,7 +155,7 @@ export const testWorkflow = createWorkflow({})
   .commit()
 ```
 
-> **Info:** Visit [Input Data Mapping](https://mastra.ai/docs/workflows/control-flow) for more information.
+Visit [Input Data Mapping](https://mastra.ai/docs/workflows/control-flow) for more information.
 
 ## Related
 

package/.docs/docs/workflows/control-flow.md

@@ -208,7 +208,7 @@ const writerStep = createStep({
 })
 ```
 
-> **Info:** Visit [Choosing the right pattern](#choosing-the-right-pattern) to understand when to use `.parallel()` vs `.foreach()`.
+Visit [Choosing the right pattern](#choosing-the-right-pattern) to understand when to use `.parallel()` vs `.foreach()`.
 
 ## Conditional logic with `.branch()`
 

package/.docs/docs/workflows/overview.md

@@ -4,7 +4,7 @@
 
 Workflows let you define complex sequences of tasks using clear, structured steps rather than relying on the reasoning of a single agent. They give you full control over how tasks are broken down, how data moves between them, and what gets executed when. Workflows run using the built-in execution engine by default, or can be deployed to [workflow runners](https://mastra.ai/docs/deployment/workflow-runners) like Inngest for managed infrastructure.
 
-![Workflows overview](/assets/images/workflows-overview-4509c840549a01ff7386daa5101bda26.jpg)
+**For AI agents:** Run `npx mastra api workflow run start test-workflow '{"inputData":{"message":"Hello, world!"}}'` to start this workflow directly instead of writing a temporary script. The command requires a running Mastra server; start the local server with `npx mastra dev`, or pass the reachable server's base URL with `--url`. Run `npx mastra api workflow run start --schema` before constructing different input. Install Mastra's skill with `npx skills add mastra-ai/skills --skill mastra` for complete API CLI discovery, targeting, schema, authentication, and error-handling guidance.
 
 ## When to use workflows
 
@@ -101,7 +101,7 @@ const step1 = createStep({
 })
 ```
 
-> **Info:** Visit [`Step`](https://mastra.ai/reference/workflows/step) for a full list of configuration options.
+Visit [`Step`](https://mastra.ai/reference/workflows/step) for a full list of configuration options.
 
 ### Using agents and tools
 
@@ -175,7 +175,7 @@ export const testWorkflow = createWorkflow({
   .commit();
 ```
 
-> **Info:** Visit [Workflow Class](https://mastra.ai/reference/workflows/workflow) for a full list of configuration options.
+Visit [Workflow Class](https://mastra.ai/reference/workflows/workflow) for a full list of configuration options.
 
 ### Understanding control flow
 
@@ -212,7 +212,7 @@ const step1 = createStep({
 })
 ```
 
-> **Info:** Visit [Workflow State](https://mastra.ai/docs/workflows/workflow-state) for complete documentation on state schemas, initial state, persistence across suspend/resume, and nested workflows.
+Visit [Workflow State](https://mastra.ai/docs/workflows/workflow-state) for complete documentation on state schemas, initial state, persistence across suspend/resume, and nested workflows.
 
 ## Workflows as steps
 
@@ -533,7 +533,7 @@ const step1 = createStep({
 })
 ```
 
-> **Info:** Visit [Request Context](https://mastra.ai/docs/server/request-context) for more information.
+Visit [Request Context](https://mastra.ai/docs/server/request-context) for more information.
 
 > **Tip:** For type-safe request context schema validation, see [Schema Validation](https://mastra.ai/docs/server/request-context).
 

package/.docs/guides/build-your-ui/assistant-ui.md

@@ -6,7 +6,7 @@
 
 > **Info:** For a full-stack integration approach where Mastra runs directly in your Next.js API routes, see the [Full-Stack Integration Guide](https://www.assistant-ui.com/docs/integrations/frameworks/mastra/full-stack) on Assistant UI's documentation site.
 
-> **Tip:** Visit Mastra's [**"UI Dojo"**](https://ui-dojo.mastra.ai/) to see real-world examples of Assistant UI integrated with Mastra.
+Visit Mastra's [**"UI Dojo"**](https://ui-dojo.mastra.ai/) to see real-world examples of Assistant UI integrated with Mastra.
 
 ## Integration guide