@mastra/mcp-docs-server 0.13.32 → 0.13.34-alpha.0

package/.docs/organized/changelogs/%40mastra%2Fplayground-ui.md

@@ -1,5 +1,40 @@
 # @mastra/playground-ui
 
+## 6.6.2-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`2b031e2`](https://github.com/mastra-ai/mastra/commit/2b031e25ca10cd3e4d63e6a27f909cba26d91405)]:
+  - @mastra/core@0.22.2-alpha.0
+  - @mastra/client-js@0.16.4-alpha.0
+  - @mastra/react@0.0.10-alpha.0
+
+## 6.6.1
+
+### Patch Changes
+
+- Fix subagent link not working in agents overview pane ([#9099](https://github.com/mastra-ai/mastra/pull/9099))
+
+- Fix wrong MCP link in playground ([#9103](https://github.com/mastra-ai/mastra/pull/9103))
+
+- Updated dependencies []:
+  - @mastra/core@0.22.1
+  - @mastra/client-js@0.16.3
+  - @mastra/react@0.0.9
+
+## 6.6.1-alpha.0
+
+### Patch Changes
+
+- Fix subagent link not working in agents overview pane ([#9099](https://github.com/mastra-ai/mastra/pull/9099))
+
+- Fix wrong MCP link in playground ([#9103](https://github.com/mastra-ai/mastra/pull/9103))
+
+- Updated dependencies []:
+  - @mastra/core@0.22.1-alpha.0
+  - @mastra/client-js@0.16.3-alpha.0
+  - @mastra/react@0.0.9-alpha.0
+
 ## 6.6.0
 
 ### Minor Changes
@@ -264,39 +299,4 @@
 
 - Convert WorkflowWatchResult to WorkflowResult in workflow graph ([#8541](https://github.com/mastra-ai/mastra/pull/8541))
 
-- remove icons in entity lists ([#8520](https://github.com/mastra-ai/mastra/pull/8520))
-
-- extract mcp servers into playground + use a table instead of custom stuff ([#8521](https://github.com/mastra-ai/mastra/pull/8521))
-
-- add client search to all entities ([#8523](https://github.com/mastra-ai/mastra/pull/8523))
-
-- Fixed an issue where model router was adding /chat/completions to API urls when it shouldn't. ([#8589](https://github.com/mastra-ai/mastra/pull/8589))
-  fixed an issue with provider ID rendering in playground UI
-
-- UX for the agents page ([#8517](https://github.com/mastra-ai/mastra/pull/8517))
-
-- add icons into playground titles + a link to the entity doc ([#8518](https://github.com/mastra-ai/mastra/pull/8518))
-
-- Updated dependencies [[`c621613`](https://github.com/mastra-ai/mastra/commit/c621613069173c69eb2c3ef19a5308894c6549f0), [`12b1189`](https://github.com/mastra-ai/mastra/commit/12b118942445e4de0dd916c593e33ec78dc3bc73), [`4783b30`](https://github.com/mastra-ai/mastra/commit/4783b3063efea887825514b783ba27f67912c26d), [`076b092`](https://github.com/mastra-ai/mastra/commit/076b0924902ff0f49d5712d2df24c4cca683713f), [`2aee9e7`](https://github.com/mastra-ai/mastra/commit/2aee9e7d188b8b256a4ddc203ccefb366b4867fa), [`c582906`](https://github.com/mastra-ai/mastra/commit/c5829065a346260f96c4beb8af131b94804ae3ad), [`fa2eb96`](https://github.com/mastra-ai/mastra/commit/fa2eb96af16c7d433891a73932764960d3235c1d), [`ee9108f`](https://github.com/mastra-ai/mastra/commit/ee9108fa29bb8368fc23df158c9f0645b2d7b65c), [`4783b30`](https://github.com/mastra-ai/mastra/commit/4783b3063efea887825514b783ba27f67912c26d), [`a739d0c`](https://github.com/mastra-ai/mastra/commit/a739d0c8b37cd89569e04a6ca0827083c6167e19), [`603e927`](https://github.com/mastra-ai/mastra/commit/603e9279db8bf8a46caf83881c6b7389ccffff7e), [`cd45982`](https://github.com/mastra-ai/mastra/commit/cd4598291cda128a88738734ae6cbef076ebdebd), [`874f74d`](https://github.com/mastra-ai/mastra/commit/874f74da4b1acf6517f18132d035612c3ecc394a), [`b728a45`](https://github.com/mastra-ai/mastra/commit/b728a45ab3dba59da0f5ee36b81fe246659f305d), [`0baf2ba`](https://github.com/mastra-ai/mastra/commit/0baf2bab8420277072ef1f95df5ea7b0a2f61fe7), [`10e633a`](https://github.com/mastra-ai/mastra/commit/10e633a07d333466d9734c97acfc3dbf757ad2d0), [`a6d69c5`](https://github.com/mastra-ai/mastra/commit/a6d69c5fb50c0875b46275811fece5862f03c6a0), [`84199af`](https://github.com/mastra-ai/mastra/commit/84199af8673f6f9cb59286ffb5477a41932775de), [`7f431af`](https://github.com/mastra-ai/mastra/commit/7f431afd586b7d3265075e73106eb73167edbb86), [`26e968d`](https://github.com/mastra-ai/mastra/commit/26e968db2171ded9e4d47aa1b4f19e1e771158d0), [`cbd3fb6`](https://github.com/mastra-ai/mastra/commit/cbd3fb65adb03a7c0df193cb998aed5ac56675ee)]:
-  - @mastra/core@0.20.1
-  - @mastra/client-js@0.15.1
-  - @mastra/react@0.0.4
-
-## 6.4.0-alpha.4
-
-### Minor Changes
-
-- Update peer dependencies to match core package version bump (0.20.1) ([#8589](https://github.com/mastra-ai/mastra/pull/8589))
-
-### Patch Changes
-
-- Fixed an issue where model router was adding /chat/completions to API urls when it shouldn't. ([#8589](https://github.com/mastra-ai/mastra/pull/8589))
-  fixed an issue with provider ID rendering in playground UI
-- Updated dependencies [[`b728a45`](https://github.com/mastra-ai/mastra/commit/b728a45ab3dba59da0f5ee36b81fe246659f305d)]:
-  - @mastra/core@0.20.1-alpha.4
-  - @mastra/client-js@0.15.1-alpha.4
-  - @mastra/react@0.0.4-alpha.4
-
-## 6.3.1-alpha.3
-
-... 3768 more lines hidden. See full changelog in package directory.
+... 3803 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/%40mastra%2Freact.md

@@ -1,5 +1,26 @@
 # @mastra/react-hooks
 
+## 0.0.10-alpha.0
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/client-js@0.16.4-alpha.0
+
+## 0.0.9
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/client-js@0.16.3
+
+## 0.0.9-alpha.0
+
+### Patch Changes
+
+- Updated dependencies []:
+  - @mastra/client-js@0.16.3-alpha.0
+
 ## 0.0.8
 
 ### Patch Changes

package/.docs/organized/changelogs/%40mastra%2Fserver.md

@@ -1,5 +1,30 @@
 # @mastra/server
 
+## 0.22.2-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`2b031e2`](https://github.com/mastra-ai/mastra/commit/2b031e25ca10cd3e4d63e6a27f909cba26d91405)]:
+  - @mastra/core@0.22.2-alpha.0
+
+## 0.22.1
+
+### Patch Changes
+
+- Get agent registered on a parent agent via API ([#9106](https://github.com/mastra-ai/mastra/pull/9106))
+
+- Updated dependencies []:
+  - @mastra/core@0.22.1
+
+## 0.22.1-alpha.0
+
+### Patch Changes
+
+- Get agent registered on a parent agent via API ([#9106](https://github.com/mastra-ai/mastra/pull/9106))
+
+- Updated dependencies []:
+  - @mastra/core@0.22.1-alpha.0
+
 ## 0.22.0
 
 ### Minor Changes
@@ -273,30 +298,5 @@
 - Updated dependencies [[`4a70ccc`](https://github.com/mastra-ai/mastra/commit/4a70ccc5cfa12ae9c2b36545a5814cd98e5a0ead), [`0992b8b`](https://github.com/mastra-ai/mastra/commit/0992b8bf0f4f1ba7ad9940883ec4bb8d867d3105), [`283bea0`](https://github.com/mastra-ai/mastra/commit/283bea07adbaf04a27fa3ad2df611095e0825195)]:
   - @mastra/core@0.19.1
 
-## 0.19.1-alpha.1
-
-### Patch Changes
-
-- Updated dependencies [[`4a70ccc`](https://github.com/mastra-ai/mastra/commit/4a70ccc5cfa12ae9c2b36545a5814cd98e5a0ead)]:
-  - @mastra/core@0.19.1-alpha.1
-
-## 0.19.1-alpha.0
-
-### Patch Changes
-
-- Added Mastra model router to Playground UI ([#8332](https://github.com/mastra-ai/mastra/pull/8332))
-
-- Updated dependencies [[`0992b8b`](https://github.com/mastra-ai/mastra/commit/0992b8bf0f4f1ba7ad9940883ec4bb8d867d3105), [`283bea0`](https://github.com/mastra-ai/mastra/commit/283bea07adbaf04a27fa3ad2df611095e0825195)]:
-  - @mastra/core@0.19.1-alpha.0
-
-## 0.19.0
-
-### Patch Changes
-
-- Support passing tracing options for start/resume workflows for server APIs and client sdk ([#8277](https://github.com/mastra-ai/mastra/pull/8277))
-
-- add a way to hide the deploy mastra cloud button ([#8137](https://github.com/mastra-ai/mastra/pull/8137))
-
-- Update peer deps ([#8154](https://github.com/mastra-ai/mastra/pull/8154))
 
-... 3821 more lines hidden. See full changelog in package directory.
+... 3846 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/create-mastra.md

@@ -1,5 +1,11 @@
 # create-mastra
 
+## 0.17.3-alpha.0
+
+## 0.17.2
+
+## 0.17.2-alpha.0
+
 ## 0.17.1
 
 ### Patch Changes
@@ -292,11 +298,5 @@
 
 ## 0.13.3-alpha.0
 
-### Patch Changes
-
-- Add types in the streamVNext codepath, fixes for various issues across multiple packages surfaced from type issues, align return types. ([#8010](https://github.com/mastra-ai/mastra/pull/8010))
-
-- Add model fallbacks to playground ([#7427](https://github.com/mastra-ai/mastra/pull/7427))
-
 
-... 1768 more lines hidden. See full changelog in package directory.
+... 1774 more lines hidden. See full changelog in package directory.

package/.docs/organized/changelogs/mastra.md

@@ -1,5 +1,33 @@
 # mastra
 
+## 0.17.3-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`2b031e2`](https://github.com/mastra-ai/mastra/commit/2b031e25ca10cd3e4d63e6a27f909cba26d91405)]:
+  - @mastra/core@0.22.2-alpha.0
+  - @mastra/deployer@0.22.2-alpha.0
+
+## 0.17.2
+
+### Patch Changes
+
+- Fix a bug where `mastra init` didn't work correctly when core dependencies were missing in the project ([#9070](https://github.com/mastra-ai/mastra/pull/9070))
+
+- Updated dependencies [[`69ff5d5`](https://github.com/mastra-ai/mastra/commit/69ff5d58e4bc4054ce76bbb25a8fa5d3177c49ea)]:
+  - @mastra/deployer@0.22.1
+  - @mastra/core@0.22.1
+
+## 0.17.2-alpha.0
+
+### Patch Changes
+
+- Fix a bug where `mastra init` didn't work correctly when core dependencies were missing in the project ([#9070](https://github.com/mastra-ai/mastra/pull/9070))
+
+- Updated dependencies [[`69ff5d5`](https://github.com/mastra-ai/mastra/commit/69ff5d58e4bc4054ce76bbb25a8fa5d3177c49ea)]:
+  - @mastra/deployer@0.22.1-alpha.0
+  - @mastra/core@0.22.1-alpha.0
+
 ## 0.17.1
 
 ### Patch Changes
@@ -270,33 +298,5 @@
 
 - Mutable shared workflow run state ([#8545](https://github.com/mastra-ai/mastra/pull/8545))
 
-- avoid refetching memory threads and messages on window focus ([#8519](https://github.com/mastra-ai/mastra/pull/8519))
-
-- add tripwire reason in playground ([#8568](https://github.com/mastra-ai/mastra/pull/8568))
-
-- Save waiting step status in snapshot ([#8576](https://github.com/mastra-ai/mastra/pull/8576))
-
-- Convert WorkflowWatchResult to WorkflowResult in workflow graph ([#8541](https://github.com/mastra-ai/mastra/pull/8541))
-
-- add new deploy to cloud button ([#8549](https://github.com/mastra-ai/mastra/pull/8549))
-
-- remove icons in entity lists ([#8520](https://github.com/mastra-ai/mastra/pull/8520))
-
-- add client search to all entities ([#8523](https://github.com/mastra-ai/mastra/pull/8523))
-
-- UX for the agents page ([#8517](https://github.com/mastra-ai/mastra/pull/8517))
-
-- add icons into playground titles + a link to the entity doc ([#8518](https://github.com/mastra-ai/mastra/pull/8518))
-
-- Updated dependencies [[`c621613`](https://github.com/mastra-ai/mastra/commit/c621613069173c69eb2c3ef19a5308894c6549f0), [`ee17cec`](https://github.com/mastra-ai/mastra/commit/ee17cec065f4454740c9cc8f8a841027a5990f57), [`12b1189`](https://github.com/mastra-ai/mastra/commit/12b118942445e4de0dd916c593e33ec78dc3bc73), [`4783b30`](https://github.com/mastra-ai/mastra/commit/4783b3063efea887825514b783ba27f67912c26d), [`076b092`](https://github.com/mastra-ai/mastra/commit/076b0924902ff0f49d5712d2df24c4cca683713f), [`2aee9e7`](https://github.com/mastra-ai/mastra/commit/2aee9e7d188b8b256a4ddc203ccefb366b4867fa), [`c582906`](https://github.com/mastra-ai/mastra/commit/c5829065a346260f96c4beb8af131b94804ae3ad), [`fa2eb96`](https://github.com/mastra-ai/mastra/commit/fa2eb96af16c7d433891a73932764960d3235c1d), [`4783b30`](https://github.com/mastra-ai/mastra/commit/4783b3063efea887825514b783ba27f67912c26d), [`a739d0c`](https://github.com/mastra-ai/mastra/commit/a739d0c8b37cd89569e04a6ca0827083c6167e19), [`a9c4cb7`](https://github.com/mastra-ai/mastra/commit/a9c4cb7d6a35de23ca51066f166a66e0e4cca418), [`603e927`](https://github.com/mastra-ai/mastra/commit/603e9279db8bf8a46caf83881c6b7389ccffff7e), [`cd45982`](https://github.com/mastra-ai/mastra/commit/cd4598291cda128a88738734ae6cbef076ebdebd), [`874f74d`](https://github.com/mastra-ai/mastra/commit/874f74da4b1acf6517f18132d035612c3ecc394a), [`0baf2ba`](https://github.com/mastra-ai/mastra/commit/0baf2bab8420277072ef1f95df5ea7b0a2f61fe7), [`26e968d`](https://github.com/mastra-ai/mastra/commit/26e968db2171ded9e4d47aa1b4f19e1e771158d0), [`cbd3fb6`](https://github.com/mastra-ai/mastra/commit/cbd3fb65adb03a7c0df193cb998aed5ac56675ee)]:
-  - @mastra/core@0.20.1-alpha.1
-  - @mastra/deployer@0.20.1-alpha.1
-  - @mastra/mcp@0.13.4-alpha.0
-
-## 0.14.2-alpha.0
-
-### Patch Changes
-
-- streamLegacy/generateLegacy clarification in playground ([#8468](https://github.com/mastra-ai/mastra/pull/8468))
 
-... 6260 more lines hidden. See full changelog in package directory.
+... 6288 more lines hidden. See full changelog in package directory.

package/.docs/raw/deployment/cloud-providers/aws-lambda.mdx

@@ -160,7 +160,7 @@ Enable Function URL for external access:
 3. Set **Auth type** to **NONE** (for public access)
 4. Configure **CORS** settings:
    - **Allow-Origin**: `*` (restrict to your domain in production)
-   - **Allow-Headers**: `content-type`
+   - **Allow-Headers**: `content-type` (`x-amzn-request-context` is also required when used with services like Cloudfront/API Gateway)
    - **Allow-Methods**: `*` (audit and restrict in production)
 5. Click **Save**
 

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

@@ -3,70 +3,73 @@ title: "Local Project Structure | Getting Started | Mastra Docs"
 description: Guide on organizing folders and files in Mastra, including best practices and recommended structures.
 ---
 
-import { FileTree } from "nextra/components";
+import { FileTree, Callout } from "nextra/components";
 
 # Project Structure
 
-This page provides a guide for organizing folders and files in Mastra. Mastra is a modular framework, and you can use any of the modules separately or together.
+Your new Mastra project, created with the `create mastra` command, comes with a predefined set of files and folders to help you get started.
 
-You could write everything in a single file, or separate each agent, tool, and workflow into their own files.
+Mastra is a framework, but it's **unopinionated** about how you organize or colocate your files. The CLI provides a sensible default structure that works well for most projects, but you're free to adapt it to your workflow or team conventions. You could even build your entire project in a single file if you wanted! Whatever structure you choose, keep it consistent to ensure your code stays maintainable and easy to navigate.
 
-We don't enforce a specific folder structure, but we do recommend some best practices, and the CLI will scaffold a project with a sensible structure.
+## Default project structure
 
-## Example Project Structure
-
-A default project created with the CLI looks like this:
+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="agent-name.ts" />
+        <FileTree.File name="weather-agent.ts" />
       </FileTree.Folder>
       <FileTree.Folder name="tools" defaultOpen>
-        <FileTree.File name="tool-name.ts" />
+        <FileTree.File name="weather-tool.ts" />
       </FileTree.Folder>
       <FileTree.Folder name="workflows" defaultOpen>
-        <FileTree.File name="workflow-name.ts" />
+        <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" />
+  <FileTree.File name=".env.example" />
   <FileTree.File name="package.json" />
   <FileTree.File name="tsconfig.json" />
 </FileTree>
-{/*
-```
-root/
-├── src/
-│   └── mastra/
-│       ├── agents/
-│       │   └── index.ts
-│       ├── tools/
-│       │   └── index.ts
-│       ├── workflows/
-│       │   └── index.ts
-│       ├── index.ts
-├── .env
-├── package.json
-├── tssconfig.json
-``` */}
-
-### Top-level Folders
-
-| Folder                 | Description                          |
-| ---------------------- | ------------------------------------ |
-| `src/mastra`           | Core application folder              |
-| `src/mastra/agents`    | Agent configurations and definitions |
-| `src/mastra/tools`     | Custom tool definitions              |
-| `src/mastra/workflows` | Workflow definitions                 |
-
-### Top-level Files
-
-| File                  | Description                                         |
-| --------------------- | --------------------------------------------------- |
-| `src/mastra/index.ts` | Main configuration file for Mastra                  |
-| `.env`                | Environment variables                               |
-| `package.json`        | Node.js project metadata, scripts, and dependencies |
-| `tsconfig.json`       | TypeScript compiler configuration                   |
+
+<Callout type="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 |
+| `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. |
+| `.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. |
+
+## 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)!

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

@@ -0,0 +1,158 @@
+---
+title: "Playground"
+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";
+
+# Playground
+
+Playground helps you build agents quickly. It provides an interactive UI for testing your agents and workflows, along with a REST API that exposes your Mastra application as a local service. This lets you start building without having to integrate Mastra into your project right away.
+
+As your project evolves, Playground enables you to iterate quickly. Features like Observability and Scorers give you visibility into performance at every stage of development.
+
+To get started, run Playground locally using the instructions below, or [deploy to Mastra Cloud](/docs/mastra-cloud/setting-up) to access the Playground remotely and collaborate with your team.
+
+<YouTube id="spGlcTEjuXY" startTime={126}/>
+
+## Launch Playground
+
+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>
+    ```bash copy
+    npm run dev
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    pnpm run dev
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    yarn run dev
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    bun run dev
+    ```
+  </Tab>
+  <Tab>
+    ```bash copy
+    mastra dev
+    ```
+  </Tab>
+</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.
+
+## Playground 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. 
+
+### 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"
+/>
+
+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.
+
+### Workflows
+
+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"
+/>
+
+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.
+
+### Tools
+
+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.
+
+![MCP Servers Playground](/image/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. 
+
+![](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.
+
+## REST API
+
+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. 
+
+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">
+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
+
+### Port
+
+By default, the development server runs at http://localhost:4111. You can change the `host` and `port` in the Mastra server configuration:
+
+```typescript
+import { Mastra } from "@mastra/core/mastra";
+
+export const mastra = new Mastra({
+  server: {
+    port: 8080,
+    host: "0.0.0.0",
+  },
+});
+```
+
+### Local HTTPS
+
+Mastra supports local HTTPS development through the [`--https`](/reference/cli/mastra#--https) flag, which automatically creates and manages certificates for your project. When you run `mastra dev --https`, a private key and certificate are generated for localhost (or your configured host). For custom certificate management, you can provide your own key and certificate files through the server configuration:
+
+```typescript
+import { Mastra } from "@mastra/core/mastra";
+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')
+    }
+  },
+});
+```
+## 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).

package/.docs/raw/reference/workflows/step.mdx

@@ -152,4 +152,4 @@ const step1 = createStep({
 ## Related
 
 - [Control flow](../../docs/workflows/control-flow.mdx)
-- [Using agents and tools](../../docs/workflows/using-with-agents-and-tools.mdx)
+- [Using agents and tools](../../docs/workflows/agents-and-tools.mdx)

package/.docs/raw/tools-mcp/overview.mdx

@@ -1,11 +1,11 @@
 ---
-title: "Tools Overview | Tools & MCP | Mastra Docs"
+title: "Using Tools | Tools & MCP | Mastra Docs"
 description: Understand what tools are in Mastra, how to add them to agents, and best practices for designing effective tools.
 ---
 
 import { Steps } from "nextra/components";
 
-# Tools Overview
+# Using Tools
 
 Tools are functions that agents can execute to perform specific tasks or access external information. They extend an agent's capabilities beyond simple text generation, allowing interaction with APIs, databases, or other systems.