@mastra/mcp-docs-server 0.13.37 → 0.13.39-alpha.0

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

@@ -1,10 +1,8 @@
 ---
-title: "Local Project Structure | Getting Started | Mastra Docs"
+title: "Project Structure | Getting Started | Mastra Docs"
 description: Guide on organizing folders and files in Mastra, including best practices and recommended structures.
 ---
 
-import { FileTree, Callout } from "nextra/components";
-
 # Project Structure
 
 Your new Mastra project, created with the `create mastra` command, comes with a predefined set of files and folders to help you get started.
@@ -15,61 +13,55 @@ Mastra is a framework, but it's **unopinionated** about how you organize or colo
 
 A project created with the `create mastra` command looks like this:
 
-<FileTree>
-  <FileTree.Folder name="src" defaultOpen>
-    <FileTree.Folder name="mastra" defaultOpen>
-      <FileTree.Folder name="agents" defaultOpen>
-        <FileTree.File name="weather-agent.ts" />
-      </FileTree.Folder>
-      <FileTree.Folder name="tools" defaultOpen>
-        <FileTree.File name="weather-tool.ts" />
-      </FileTree.Folder>
-      <FileTree.Folder name="workflows" defaultOpen>
-        <FileTree.File name="weather-workflow.ts" />
-      </FileTree.Folder>
-      <FileTree.Folder name="scorers" defaultOpen>
-        <FileTree.File name="weather-scorer.ts" />
-      </FileTree.Folder>
-      <FileTree.File name="index.ts" />
-    </FileTree.Folder>
-  </FileTree.Folder>
-  <FileTree.File name=".env.example" />
-  <FileTree.File name="package.json" />
-  <FileTree.File name="tsconfig.json" />
-</FileTree>
-
-<Callout type="info">
+```
+src/
+├── mastra/
+│   ├── agents/
+│   │   └── weather-agent.ts
+│   ├── tools/
+│   │   └── weather-tool.ts
+│   ├── workflows/
+│   │   └── weather-workflow.ts
+│   ├── scorers/
+│   │   └── weather-scorer.ts
+│   └── index.ts
+├── .env.example
+├── package.json
+└── tsconfig.json
+```
+
+:::info
 Tip - Use the predefined files as templates. Duplicate and adapt them to quickly create your own agents, tools, workflows, etc.
-</Callout>
+:::
 
 ### Folders
 
 Folders organize your agent's resources, like agents, tools, and workflows.
 
-| Folder                 | Description |
-| ---------------------- | ------------ |
-| `src/mastra`           | Entry point for all Mastra-related code and configuration.|
-| `src/mastra/agents`    | Define and configure your agents - their behavior, goals, and tools. |
-| `src/mastra/workflows` | Define multi-step workflows that orchestrate agents and tools together. |
-| `src/mastra/tools`     | Create reusable tools that your agents can call |
-| `src/mastra/mcp`       | (Optional) Implement custom MCP servers to share your tools with external agents |
-| `src/mastra/scorers`   | (Optional) Define scorers for evaluating agent performance over time |
+| Folder                 | Description                                                                                                                              |
+| ---------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+| `src/mastra`           | Entry point for all Mastra-related code and configuration.                                                                               |
+| `src/mastra/agents`    | Define and configure your agents - their behavior, goals, and tools.                                                                     |
+| `src/mastra/workflows` | Define multi-step workflows that orchestrate agents and tools together.                                                                  |
+| `src/mastra/tools`     | Create reusable tools that your agents can call                                                                                          |
+| `src/mastra/mcp`       | (Optional) Implement custom MCP servers to share your tools with external agents                                                         |
+| `src/mastra/scorers`   | (Optional) Define scorers for evaluating agent performance over time                                                                     |
 | `src/mastra/public`    | (Optional) Contents are copied into the `.build/output` directory during the build process, making them available for serving at runtime |
 
 ### Top-level files
 
 Top-level files define how your Mastra project is configured, built, and connected to its environment.
 
-| File                  | Description |
-| --------------------- | ------------ |
-| `src/mastra/index.ts` | Central entry point where you configure and initialize Mastra. |
+| File                  | Description                                                                                                       |
+| --------------------- | ----------------------------------------------------------------------------------------------------------------- |
+| `src/mastra/index.ts` | Central entry point where you configure and initialize Mastra.                                                    |
 | `.env.example`        | Template for environment variables - copy and rename to `.env` to add your secret [model provider](/models) keys. |
-| `package.json`        | Defines project metadata, dependencies, and available npm scripts. |
-| `tsconfig.json`       | Configures TypeScript options such as path aliases, compiler settings, and build output. |
+| `package.json`        | Defines project metadata, dependencies, and available npm scripts.                                                |
+| `tsconfig.json`       | Configures TypeScript options such as path aliases, compiler settings, and build output.                          |
 
 ## Next steps
 
 - Read more about [Mastra's features](/docs#why-mastra).
 - Integrate Mastra with your frontend framework: [Next.js](/docs/frameworks/web-frameworks/next-js), [React](/docs/frameworks/web-frameworks/vite-react), or [Astro](/docs/frameworks/web-frameworks/astro).
 - Build an agent from scratch following one of our [guides](/guides).
-- Watch conceptual guides on our [YouTube channel](https://www.youtube.com/@mastra-ai) and [subscribe](https://www.youtube.com/@mastra-ai?sub_confirmation=1)!
+- Watch conceptual guides on our [YouTube channel](https://www.youtube.com/@mastra-ai) and [subscribe](https://www.youtube.com/@mastra-ai?sub_confirmation=1)!

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

@@ -1,72 +1,69 @@
 ---
-title: "Playground"
+title: "Studio | Getting Started | Mastra Docs"
 description: Guide on installing Mastra and setting up the necessary prerequisites for running it with various LLM providers.
 ---
 
-import YouTube from "@/components/youtube";
-import { Tabs, Tab } from "@/components/tabs";
-import { VideoPlayer } from "@/components/video-player"
-import { Callout } from "nextra/components";
+import YouTube from "@site/src/components/YouTube-player";
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+import { VideoPlayer } from "@site/src/components/video-player";
 
-# Playground
+# Studio
 
-Playground provides an interactive UI for building and testing your agents, along with a REST API that exposes your Mastra application as a local service. This lets you start building without worrying about integration right away.
+Studio provides an interactive UI for building and testing your agents, along with a REST API that exposes your Mastra application as a local service. This lets you start building without worrying about integration right away.
 
-As your project evolves, Playground's development environment helps you iterate on your agent quickly. Meanwhile, Observability and Scorer features give you visibility into performance at every stage.
+As your project evolves, Studio's development environment helps you iterate on your agent quickly. Meanwhile, Observability and Scorer features give you visibility into performance at every stage.
 
-To get started, run Playground locally using the instructions below, or [deploy to Mastra Cloud](https://mastra.ai/docs/mastra-cloud/setting-up) to collaborate with your team.
+To get started, run Studio locally using the instructions below, or [create a project in Mastra Cloud](https://mastra.ai/docs/mastra-cloud/setting-up) to collaborate with your team.
 
-<YouTube id="spGlcTEjuXY" startTime={126}/>
+<YouTube id="ojGu6Bi4wYk" />
 
-## Start Playground
+## Start Studio
 
 If you created your application with `create mastra`, start the local development server using the `dev` script. You can also run it directly with `mastra dev`.
 
-<Tabs items={["npm", "pnpm", "yarn", "bun", "mastra"]}>
-  <Tab>
+<Tabs>
+  <TabItem value="npm" label="npm">
     ```bash copy
     npm run dev
     ```
-  </Tab>
-  <Tab>
+  </TabItem>
+  <TabItem value="pnpm" label="pnpm">
     ```bash copy
     pnpm run dev
     ```
-  </Tab>
-  <Tab>
+  </TabItem>
+  <TabItem value="yarn" label="yarn">
     ```bash copy
     yarn run dev
     ```
-  </Tab>
-  <Tab>
+  </TabItem>
+  <TabItem value="bun" label="bun">
     ```bash copy
     bun run dev
     ```
-  </Tab>
-  <Tab>
+  </TabItem>
+  <TabItem value="mastra" label="mastra">
     ```bash copy
     mastra dev
     ```
-  </Tab>
+  </TabItem>
 </Tabs>
 
 Once the server's running, you can:
 
-- Open the Playground UI at http://localhost:4111/ to test your agent interactively.
-- Visit  http://localhost:4111/swagger-ui to discover and interact with the underlying REST API.
+- Open the Studio UI at http://localhost:4111/ to test your agent interactively.
+- Visit http://localhost:4111/swagger-ui to discover and interact with the underlying REST API.
 
-## Playground UI
+## Studio UI
 
-The Playground UI provides an interactive development environment for you to test your agents, workflows, and tools, observe exactly what happens under the hood with each interaction, and tweak things as you go. 
+The Studio UI provides an interactive development environment for you to test your agents, workflows, and tools, observe exactly what happens under the hood with each interaction, and tweak things as you go.
 
 ### Agents
 
-
 Chat with your agent directly, dynamically switch [models](/models), and tweak settings like temperature and top-p to understand how they affect the output.
 
-<VideoPlayer
-  src="https://res.cloudinary.com/mastra-assets/video/upload/v1751406022/local-dev-agents-playground_100_m3begx.mp4"
-/>
+<VideoPlayer src="https://res.cloudinary.com/mastra-assets/video/upload/v1751406022/local-dev-agents-playground_100_m3begx.mp4" />
 
 When you interact with your agent, you can follow each step of its reasoning, view tool call outputs, and [observe](#observability) traces and logs to see how responses are generated. You can also attach [scorers](#scorers) to measure and compare response quality over time.
 
@@ -74,9 +71,7 @@ When you interact with your agent, you can follow each step of its reasoning, vi
 
 Visualize your workflow as a graph and run it step by step with a custom input. During execution, the interface updates in real time to show the active step and the path taken.
 
-<VideoPlayer
-  src="https://res.cloudinary.com/mastra-assets/video/upload/v1751406027/local-dev-workflows-playground_100_rbc466.mp4"
-/>
+<VideoPlayer src="https://res.cloudinary.com/mastra-assets/video/upload/v1751406027/local-dev-workflows-playground_100_rbc466.mp4" />
 
 When running a workflow, you can also view detailed traces showing tool calls, raw JSON outputs, and any errors that might have occured along the way.
 
@@ -84,24 +79,20 @@ When running a workflow, you can also view detailed traces showing tool calls, r
 
 Run tools in isolation to observe their behavior. Test them before assigning them to your agent, or isolate them to debug issues should something go wrong.
 
-<VideoPlayer
-  src="https://res.cloudinary.com/mastra-assets/video/upload/v1751406316/local-dev-agents-tools_100_fe1jdt.mp4"
-/>
-### MCP
-List the MCP servers attached to your Mastra instance and explore their available tools.
+<VideoPlayer src="https://res.cloudinary.com/mastra-assets/video/upload/v1751406316/local-dev-agents-tools_100_fe1jdt.mp4" />
+### MCP List the MCP servers attached to your Mastra instance and explore their
+available tools.
 
-![MCP Servers Playground](/image/local-dev/local-dev-mcp-server-playground.jpg)
+![MCP Servers Studio](/img/local-dev/local-dev-mcp-server-playground.jpg)
 
 ### Observability
 
-
-When you run an agent or workflow, the Observability tab displays traces that highlight the key AI operations such as model calls, tool executions, and workflow steps. Follow these traces to see how data moves, where time is spent, and what's happening under the hood. 
+When you run an agent or workflow, the Observability tab displays traces that highlight the key AI operations such as model calls, tool executions, and workflow steps. Follow these traces to see how data moves, where time is spent, and what's happening under the hood.
 
 ![](https://mastra.ai/_next/image?url=%2Ftracingafter.png&w=1920&q=75)
 
 AI Tracing filters out low-level framework details so your traces stay focused and readable.
 
-
 ### Scorers
 
 The Scorers tab displays the results of your agent's scorers as they run. When messages pass through your agent, the defined scorers evaluate each output asynchronously and render their results here. This allows you to understand how your scorers respond to different interactions, compare performance across test cases, and identify areas for improvement.
@@ -110,13 +101,13 @@ The Scorers tab displays the results of your agent's scorers as they run. When m
 
 The local development server exposes a complete set of REST API routes, allowing you to programmatically interact with your agents, workflows, and tools during development. This is particularly helpful if you plan to deploy the Mastra server, since the local development server uses the exact same API routes as the [production server](/docs/server-db/production-server), allowing you to develop and test against it with full parity.
 
-You can explore all available endpoints in the OpenAPI specification at http://localhost:4111/openapi.json, which details every endpoint and its request and response schemas. 
+You can explore all available endpoints in the OpenAPI specification at http://localhost:4111/openapi.json, which details every endpoint and its request and response schemas.
 
 To explore the API interactively, visit the Swagger UI at http://localhost:4111/swagger-ui. Here, you can discover endpoints and test them directly from your browser.
 
-<Callout type="info">
+:::info
 The OpenAPI and Swagger endpoints are disabled in production by default. To enable them, set `server.build.openAPIDocs` and `server.build.swaggerUI` to `true` respectively.
-</Callout>
+:::
 
 ## Configuration
 
@@ -141,18 +132,19 @@ Mastra supports local HTTPS development through the [`--https`](/reference/cli/m
 
 ```typescript
 import { Mastra } from "@mastra/core/mastra";
-import fs from 'node:fs';
+import fs from "node:fs";
 
 export const mastra = new Mastra({
   server: {
     https: {
-      key: fs.readFileSync('path/to/key.pem'),
-      cert: fs.readFileSync('path/to/cert.pem')
-    }
+      key: fs.readFileSync("path/to/key.pem"),
+      cert: fs.readFileSync("path/to/cert.pem"),
+    },
   },
 });
 ```
+
 ## Next steps
 
 - Learn more about Mastra's suggested [project structure](/docs/getting-started/project-structure).
-- Integrate Mastra with your frontend framework of choice - [Next.js](/docs/frameworks/web-frameworks/next-js), [React](/docs/frameworks/web-frameworks/vite-react), or [Astro](/docs/frameworks/web-frameworks/astro).
+- Integrate Mastra with your frontend framework of choice - [Next.js](/docs/frameworks/web-frameworks/next-js), [React](/docs/frameworks/web-frameworks/vite-react), or [Astro](/docs/frameworks/web-frameworks/astro).

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

@@ -3,8 +3,8 @@ title: "Templates | Getting Started | Mastra Docs"
 description: Pre-built project structures that demonstrate common Mastra use cases and patterns
 ---
 
-import { Callout } from "nextra/components";
-import { Tabs, Tab } from "@/components/tabs";
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
 
 # Templates
 
@@ -14,27 +14,27 @@ Templates are pre-built Mastra projects that demonstrate specific use cases and
 
 Install a template using the `create-mastra` command:
 
-<Tabs items={["npm", "yarn", "pnpm", "bun"]}>
-  <Tab>
+<Tabs>
+  <TabItem value="npm" label="npm">
     ```bash copy
     npx create-mastra@latest --template template-name
     ```
-  </Tab>
-  <Tab>
+  </TabItem>
+  <TabItem value="yarn" label="yarn">
     ```bash copy
     yarn dlx create-mastra@latest --template template-name
     ```
-  </Tab>
-  <Tab>
+  </TabItem>
+  <TabItem value="pnpm" label="pnpm">
     ```bash copy
     pnpm create mastra@latest --template template-name
     ```
-  </Tab>
-  <Tab>
+  </TabItem>
+  <TabItem value="bun" label="bun">
     ```bash copy
     bun create mastra@latest --template template-name
     ```
-  </Tab>
+  </TabItem>
 </Tabs>
 
 For example, to create a text-to-SQL application:
@@ -48,14 +48,17 @@ npx create-mastra@latest --template text-to-sql
 After installation:
 
 1. **Navigate to your project**:
+
    ```bash copy
    cd your-project-name
    ```
 
 2. **Configure environment variables**:
+
    ```bash copy
    cp .env.example .env
    ```
+
    Edit `.env` with your API keys as specified in the template's README.
 
 3. **Start development**:
@@ -63,8 +66,8 @@ After installation:
    npm run dev
    ```
 
-<Callout type="info">
-  Each template includes a comprehensive README with specific setup instructions and usage examples.
-</Callout>
+:::info
+Each template includes a comprehensive README with specific setup instructions and usage examples.
+:::
 
-For detailed information on creating templates, see the [Templates Reference](/reference/templates).
+For detailed information on creating templates, see the [Templates Reference](/reference/templates/overview).

package/.docs/raw/index.mdx

@@ -1,9 +1,11 @@
 ---
 title: "About Mastra | Mastra Docs"
+sidebar_position: 2
+sidebar_label: "Introduction"
 description: "Mastra is an all-in-one framework for building AI-powered applications and agents with a modern TypeScript stack."
 ---
 
-import YouTube from "@/components/youtube";
+import YouTube from "@site/src/components/YouTube-player";
 
 # About Mastra
 
@@ -21,18 +23,17 @@ Some highlights include:
 
 - [**Model routing**](/models) - Connect to 40+ providers through one standard interface. Use models from OpenAI, Anthropic, Gemini, and more.
 
-- [**Agents**](/docs/agents/overview) - Build autonomous agents that use LLMs and tools to solve open-ended tasks. Agents reason about goals, decide which tools to use,  and iterate internally until the model emits a final answer or an optional stopping condition is met.
+- [**Agents**](/docs/agents/overview) - Build autonomous agents that use LLMs and tools to solve open-ended tasks. Agents reason about goals, decide which tools to use, and iterate internally until the model emits a final answer or an optional stopping condition is met.
 
 - [**Workflows**](/docs/workflows/overview) - When you need explicit control over execution, use Mastra's graph-based workflow engine to orchestrate complex multi-step processes. Mastra workflows use an intuitive syntax for control flow (`.then()`, `.branch()`, `.parallel()`).
 
 - [**Human-in-the-loop**](/docs/workflows/suspend-and-resume) - Suspend an agent or workflow and await user input or approval before resuming. Mastra uses [storage](/docs/server-db/storage) to remember execution state, so you can pause indefinitely and resume where you left off.
 
-- **Context management** - Give your agents the right context at the right time. Provide [conversation history](/docs/memory/conversation-history), [retrieve](/docs/rag/overview) data from your sources (APIs, databases, files), and add human-like [working](/docs/memory/working-memory) and [semantic](/docs/memory/semantic-recall) memory so your agents behave coherently. 
+- **Context management** - Give your agents the right context at the right time. Provide [conversation history](/docs/memory/conversation-history), [retrieve](/docs/rag/overview) data from your sources (APIs, databases, files), and add human-like [working](/docs/memory/working-memory) and [semantic](/docs/memory/semantic-recall) memory so your agents behave coherently.
 
 - **Integrations** - Bundle agents and workflows into existing React, Next.js, or Node.js apps, or ship them as standalone endpoints. When building UIs, integrate with agentic libraries like Vercel's AI SDK UI and CopilotKit to bring your AI assistant to life on the web.
 
-- **Production essentials** - Shipping reliable agents takes ongoing insight, evaluation, and iteration. With built-in [evals](/docs/evals/overview) and [observability](/docs/observability/overview), Mastra gives you the tools to observe, measure, and refine continuously.
-
+- **Production essentials** - Shipping reliable agents takes ongoing insight, evaluation, and iteration. With built-in [scorers](/docs/scorers/overview) and [observability](/docs/observability/overview), Mastra gives you the tools to observe, measure, and refine continuously.
 
 ## What can you build?
 
@@ -46,13 +47,12 @@ Some highlights include:
 
 - Decision-support tools that analyse data and provide actionable recommendations.
 
-Explore real-world examples in our [case studies](/blog/category/case-studies) and [community showcase](/showcase).
-
+Explore real-world examples in our [community showcase](/showcase).
 
 ## Get started
 
 Follow the [Installation guide](/docs/getting-started/installation) for step-by-step setup with the CLI or a manual install.
 
-If you're new to AI agents, check out our [templates](/docs/getting-started/templates), [course](/course), and [YouTube videos](https://youtube.com/@mastra-ai) to start building with Mastra today.
+If you're new to AI agents, check out our [templates](/docs/getting-started/templates), [course](https://mastra.ai/book), and [YouTube videos](https://youtube.com/@mastra-ai) to start building with Mastra today.
 
-We can't wait to see what you build ✌️ 
+We can't wait to see what you build ✌️

package/.docs/raw/mastra-cloud/dashboard.mdx

@@ -1,13 +1,13 @@
 ---
-title: Understanding the Mastra Cloud Dashboard
+title: "Navigating the Dashboard | Mastra Cloud | Mastra Docs"
 description: Details of each feature available in Mastra Cloud
 ---
 
-import { MastraCloudCallout } from '@/components/mastra-cloud-callout'
+import { MastraCloudCallout } from "@site/src/components/MastraCloudCallout";
 
 # Navigating the Dashboard
 
-This page explains how to navigate the Mastra Cloud dashboard, where you can configure your project, view deployment details, and interact with agents and workflows using the built-in [Playground](/docs/mastra-cloud/dashboard#playground).
+This page explains how to navigate the Mastra Cloud dashboard, where you can configure your project, view deployment details, and interact with agents and workflows using the built-in [Studio](/docs/mastra-cloud/dashboard#studio).
 
 <MastraCloudCallout />
 
@@ -15,7 +15,7 @@ This page explains how to navigate the Mastra Cloud dashboard, where you can con
 
 The **Overview** page provides details about your application, including its domain URL, status, latest deployment, and connected agents and workflows.
 
-![Project dashboard](/image/mastra-cloud/mastra-cloud-project-dashboard.jpg)
+![Project dashboard](/img/mastra-cloud/mastra-cloud-project-dashboard.jpg)
 
 Key features:
 
@@ -25,7 +25,7 @@ Each project shows its current deployment status, active domains, and environmen
 
 The **Deployments** page shows recent builds and gives you quick access to detailed build logs. Click any row to view more information about a specific deployment.
 
-![Dashboard deployment](/image/mastra-cloud/mastra-cloud-dashboard-deployments.jpg)
+![Dashboard deployment](/img/mastra-cloud/mastra-cloud-dashboard-deployments.jpg)
 
 Key features:
 
@@ -35,7 +35,7 @@ Each deployment includes its current status, the Git branch it was deployed from
 
 The **Logs** page is where you'll find detailed information to help debug and monitor your application's behavior in the production environment.
 
-![Dashboard logs](/image/mastra-cloud/mastra-cloud-dashboard-logs.jpg)
+![Dashboard logs](/img/mastra-cloud/mastra-cloud-dashboard-logs.jpg)
 
 Key features:
 
@@ -45,7 +45,7 @@ Each log includes a severity level and detailed messages showing agent, workflow
 
 On the **Settings** page you can modify the configuration of your application.
 
-![Dashboard settings](/image/mastra-cloud/mastra-cloud-dashboard-settings.jpg)
+![Dashboard settings](/img/mastra-cloud/mastra-cloud-dashboard-settings.jpg)
 
 Key features:
 
@@ -53,13 +53,13 @@ You can manage environment variables, edit key project settings like the name an
 
 > Changes to configuration require a new deployment before taking effect.
 
-## Playground
+## Studio
 
 ### Agents
 
 On the **Agents** page you'll see all agents used in your application. Click any agent to interact using the chat interface.
 
-![Dashboard playground agents](/image/mastra-cloud/mastra-cloud-dashboard-playground-agents.jpg)
+![Dashboard Studio agents](/img/mastra-cloud/mastra-cloud-dashboard-playground-agents.jpg)
 
 Key features:
 
@@ -69,7 +69,7 @@ Test your agents in real time using the chat interface, review traces of each in
 
 On the **Workflows** page you'll see all workflows used in your application. Click any workflow to interact using the runner interface.
 
-![Dashboard playground workflows](/image/mastra-cloud/mastra-cloud-dashboard-playground-workflows.jpg)
+![Dashboard Studio workflows](/img/mastra-cloud/mastra-cloud-dashboard-playground-workflows.jpg)
 
 Key features:
 
@@ -79,7 +79,7 @@ Visualize your workflow with a step-by-step graph, view execution traces, and ru
 
 On the **Tools** page you'll see all tools used by your agents. Click any tool to interact using the input interface.
 
-![Dashboard playground tools](/image/mastra-cloud/mastra-cloud-dashboard-playground-tools.jpg)
+![Dashboard Studio tools](/img/mastra-cloud/mastra-cloud-dashboard-playground-tools.jpg)
 
 Key features:
 
@@ -89,7 +89,7 @@ Test your tools by providing an input that matches the schema and viewing the st
 
 The **MCP Servers** page lists all MCP Servers included in your application. Click any MCP Server for more information.
 
-![Dashboard playground mcp servers](/image/mastra-cloud/mastra-cloud-dashboard-playground-mcpservers.jpg)
+![Dashboard Studio mcp servers](/img/mastra-cloud/mastra-cloud-dashboard-playground-mcpservers.jpg)
 
 Key features:
 

package/.docs/raw/mastra-cloud/observability.mdx

@@ -1,9 +1,9 @@
 ---
-title: Observability in Mastra Cloud
+title: "Understanding Tracing and Logs | Mastra Cloud | Mastra Docs"
 description: Monitoring and debugging tools for Mastra Cloud deployments
 ---
 
-import { MastraCloudCallout } from '@/components/mastra-cloud-callout'
+import { MastraCloudCallout } from "@site/src/components/MastraCloudCallout";
 
 # Understanding Tracing and Logs
 
@@ -15,7 +15,7 @@ Mastra Cloud captures execution data to help you monitor your application's beha
 
 You can view detailed logs for debugging and monitoring your application's behavior on the [Logs](/docs/mastra-cloud/dashboard#logs) page of the Dashboard.
 
-![Dashboard logs](/image/mastra-cloud/mastra-cloud-dashboard-logs.jpg)
+![Dashboard logs](/img/mastra-cloud/mastra-cloud-dashboard-logs.jpg)
 
 Key features:
 
@@ -23,24 +23,23 @@ Each log entry includes its severity level and a detailed message showing agent,
 
 ## Traces
 
-More detailed traces are available for both agents and workflows by using a [logger](/docs/observability/logging) or enabling [telemetry](/docs/observability/tracing) using one of our [supported providers](/reference/observability/providers).
+More detailed traces are available for both agents and workflows by using a [logger](/docs/observability/logging) or enabling [telemetry](/docs/observability/ai-tracing/overview) using one of our [supported providers](/reference/observability/otel-tracing/providers/).
 
 ### Agents
 
-With a [logger](/docs/observability/logging) enabled, you can view detailed outputs from your agents in the **Traces** section of the Agents Playground.
+With a [logger](/docs/observability/logging) enabled, you can view detailed outputs from your agents in the **Traces** section in Studio.
 
-![observability agents](/image/mastra-cloud/mastra-cloud-observability-agents.jpg)
+![observability agents](/img/mastra-cloud/mastra-cloud-observability-agents.jpg)
 
 Key features:
 
 Tools passed to the agent during generation are standardized using `convertTools`. This includes retrieving client-side tools, memory tools, and tools exposed from workflows.
 
-
 ### Workflows
 
-With a [logger](/docs/observability/logging) enabled, you can view detailed outputs from your workflows in the **Traces** section of the Workflows Playground.
+With a [logger](/docs/observability/logging) enabled, you can view detailed outputs from your workflows in the **Traces** section in Studio.
 
-![observability workflows](/image/mastra-cloud/mastra-cloud-observability-workflows.jpg)
+![observability workflows](/img/mastra-cloud/mastra-cloud-observability-workflows.jpg)
 
 Key features:
 
@@ -49,4 +48,4 @@ Workflows are created using `createWorkflow`, which sets up steps, metadata, and
 ## Next steps
 
 - [Logging](/docs/observability/logging)
-- [Tracing](/docs/observability/tracing)
+- [Tracing](/docs/observability/ai-tracing/overview)

package/.docs/raw/mastra-cloud/overview.mdx

@@ -1,10 +1,9 @@
 ---
-title: Mastra Cloud
+title: "Mastra Cloud | Mastra Cloud | Mastra Docs"
 description: Deployment and monitoring service for Mastra applications
 ---
 
-import { MastraCloudCallout } from '@/components/mastra-cloud-callout'
-import { FileTree } from "nextra/components";
+import { MastraCloudCallout } from "@site/src/components/MastraCloudCallout";
 
 # Mastra Cloud
 
@@ -16,7 +15,7 @@ import { FileTree } from "nextra/components";
 
 Deploy and manage your applications with automated builds, organized projects, and no additional configuration.
 
-![Platform features](/image/mastra-cloud/mastra-cloud-platform-features.jpg)
+![Platform features](/img/mastra-cloud/mastra-cloud-platform-features.jpg)
 
 Key features:
 
@@ -26,33 +25,28 @@ Mastra Cloud supports zero-config deployment, continuous integration with GitHub
 
 Monitor and debug your applications with detailed output logs, deployment state, and interactive tools.
 
-![Project dashboard](/image/mastra-cloud/mastra-cloud-project-dashboard.jpg)
+![Project dashboard](/img/mastra-cloud/mastra-cloud-project-dashboard.jpg)
 
 Key features:
 
-The Project Dashboard gives you an overview of your application's status and deployments, with access to logs and a built-in playground for testing agents and workflows.
+The Project Dashboard gives you an overview of your application's status and deployments, with access to logs and a Studio for testing agents and workflows.
 
 ## Project structure
 
 Use a standard Mastra project structure for proper detection and deployment.
 
-<FileTree>
-  <FileTree.Folder name="src" defaultOpen>
-    <FileTree.Folder name="mastra" defaultOpen>
-      <FileTree.Folder name="agents" defaultOpen>
-        <FileTree.File name="agent-name.ts" />
-      </FileTree.Folder>
-      <FileTree.Folder name="tools" defaultOpen>
-        <FileTree.File name="tool-name.ts" />
-      </FileTree.Folder>
-      <FileTree.Folder name="workflows" defaultOpen>
-        <FileTree.File name="workflow-name.ts" />
-      </FileTree.Folder>
-      <FileTree.File name="index.ts" />
-    </FileTree.Folder>
-  </FileTree.Folder>
-  <FileTree.File name="package.json" />
-</FileTree>
+```shell
+src
+└── mastra
+    ├── agents
+    │   └── agent-name.ts
+    ├── tools
+    │   └── tool-name.ts
+    ├── workflows
+    │   └── workflow-name.ts
+    └── index.ts
+package.json
+```
 
 Mastra Cloud scans your repository for: