@mastra/mcp-docs-server 0.13.27 → 0.13.28-alpha.0

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

@@ -1,5 +1,81 @@
 # mastra
 
+## 0.14.2-alpha.0
+
+### Patch Changes
+
+- streamLegacy/generateLegacy clarification in playground ([#8468](https://github.com/mastra-ai/mastra/pull/8468))
+
+- Fix useStreamWorkflow unmounting breaking stream call ([#8449](https://github.com/mastra-ai/mastra/pull/8449))
+
+- Remove shell from dev ([#8466](https://github.com/mastra-ai/mastra/pull/8466))
+
+- Updated dependencies [[`10e633a`](https://github.com/mastra-ai/mastra/commit/10e633a07d333466d9734c97acfc3dbf757ad2d0)]:
+  - @mastra/core@0.20.1-alpha.0
+  - @mastra/deployer@0.20.1-alpha.0
+
+## 0.14.1
+
+### Patch Changes
+
+- Make init versions latest pkgs ([#8434](https://github.com/mastra-ai/mastra/pull/8434))
+
+## 0.14.1-alpha.0
+
+### Patch Changes
+
+- Make init versions latest pkgs ([#8434](https://github.com/mastra-ai/mastra/pull/8434))
+
+## 0.14.0
+
+### Minor Changes
+
+- Breaking change to move the agent.streamVNext/generateVNext implementation to the default stream/generate. The old stream/generate have now been moved to streamLegacy and generateLegacy ([#8097](https://github.com/mastra-ai/mastra/pull/8097))
+
+### Patch Changes
+
+- Remove log drains UI from the playground ([#8379](https://github.com/mastra-ai/mastra/pull/8379))
+
+- add refetch interval to traces to make it feel "instant" ([#8386](https://github.com/mastra-ai/mastra/pull/8386))
+
+- better memory message ([#8382](https://github.com/mastra-ai/mastra/pull/8382))
+
+- Add doc url to netlify gateway ([#8356](https://github.com/mastra-ai/mastra/pull/8356))
+
+- fix codeblock line number color contrast for legacy traces ([#8385](https://github.com/mastra-ai/mastra/pull/8385))
+
+- Model router documentation and playground UI improvements ([#8372](https://github.com/mastra-ai/mastra/pull/8372))
+
+  **Documentation generation (`@mastra/core`):**
+  - Fixed inverted dynamic model selection logic in provider examples
+  - Improved copy: replaced marketing language with action-oriented descriptions
+  - Added generated file comments with timestamps to all MDX outputs so maintainers know not to directly edit generated files
+
+  **Playground UI model picker (`@mastra/playground-ui`):**
+  - Fixed provider field clearing when typing in model input
+  - Added responsive layout (stacks on mobile, side-by-side on desktop)
+  - Improved general styling of provider/model pickers
+
+  **Environment variables (`@mastra/deployer`):**
+  - Properly handle array of env vars (e.g., NETLIFY_TOKEN, NETLIFY_SITE_ID)
+  - Added correct singular/plural handling for "environment variable(s)"
+
+- fix playground message history initial state for v1 models ([#8427](https://github.com/mastra-ai/mastra/pull/8427))
+
+- show thread list in desc order ([#8381](https://github.com/mastra-ai/mastra/pull/8381))
+
+- Fix an issue preventing showing working memory and semantic recall in the playground ([#8358](https://github.com/mastra-ai/mastra/pull/8358))
+
+- Fix shell option breaking server start on windows env ([#8377](https://github.com/mastra-ai/mastra/pull/8377))
+
+- Add observe strean to get streans after workflow has been interrupted ([#8318](https://github.com/mastra-ai/mastra/pull/8318))
+
+- Updated dependencies [[`00cb6bd`](https://github.com/mastra-ai/mastra/commit/00cb6bdf78737c0fac14a5a0c7b532a11e38558a), [`869ba22`](https://github.com/mastra-ai/mastra/commit/869ba222e1d6b58fc1b65e7c9fd55ca4e01b8c2f), [`1b73665`](https://github.com/mastra-ai/mastra/commit/1b73665e8e23f5c09d49fcf3e7d709c75259259e), [`989a4db`](https://github.com/mastra-ai/mastra/commit/989a4dbbaf07a2794d0e1863714c6d10f1244d6b), [`f7d7475`](https://github.com/mastra-ai/mastra/commit/f7d747507341aef60ed39e4b49318db1f86034a6), [`084b77b`](https://github.com/mastra-ai/mastra/commit/084b77b2955960e0190af8db3f77138aa83ed65c), [`a93ff84`](https://github.com/mastra-ai/mastra/commit/a93ff84b5e1af07ee236ac8873dac9b49aa5d501), [`bc5aacb`](https://github.com/mastra-ai/mastra/commit/bc5aacb646d468d325327e36117129f28cd13bf6), [`03622f8`](https://github.com/mastra-ai/mastra/commit/03622f86e9d7342197f80f95333ea3ff65c783ae), [`6b5af12`](https://github.com/mastra-ai/mastra/commit/6b5af12ce9e09066e0c32e821c203a6954498bea), [`bf60e4a`](https://github.com/mastra-ai/mastra/commit/bf60e4a89c515afd9570b7b79f33b95e7d07c397), [`d41aee5`](https://github.com/mastra-ai/mastra/commit/d41aee526d124e35f42720a08e64043229193679), [`e8fe13c`](https://github.com/mastra-ai/mastra/commit/e8fe13c4b4c255a42520127797ec394310f7c919), [`3ca833d`](https://github.com/mastra-ai/mastra/commit/3ca833dc994c38e3c9b4f9b4478a61cd8e07b32a), [`1edb8d1`](https://github.com/mastra-ai/mastra/commit/1edb8d1cfb963e72a12412990fb9170936c9904c), [`fbf6e32`](https://github.com/mastra-ai/mastra/commit/fbf6e324946332d0f5ed8930bf9d4d4479cefd7a), [`4753027`](https://github.com/mastra-ai/mastra/commit/4753027ee889288775c6958bdfeda03ff909af67)]:
+  - @mastra/core@0.20.0
+  - @mastra/deployer@0.20.0
+  - @mastra/mcp@0.13.3
+  - @mastra/loggers@0.10.15
+
 ## 0.14.0-alpha.0
 
 ### Minor Changes
@@ -222,81 +298,5 @@
 
 ### Patch Changes
 
-- Get rid off swr one for all ([#7931](https://github.com/mastra-ai/mastra/pull/7931))
-
-- Updated dependencies [[`a61f23f`](https://github.com/mastra-ai/mastra/commit/a61f23fbbca4b88b763d94f1d784c47895ed72d7), [`d1dc606`](https://github.com/mastra-ai/mastra/commit/d1dc6067b0557a71190b68d56ee15b48c26d2411), [`d3bd4d4`](https://github.com/mastra-ai/mastra/commit/d3bd4d482a685bbb67bfa89be91c90dca3fa71ad)]:
-  - @mastra/core@0.17.2-alpha.0
-  - @mastra/deployer@0.17.2-alpha.0
-
-## 0.13.1
-
-### Patch Changes
-
-- fix workflow resuming issue in the playground ([#7988](https://github.com/mastra-ai/mastra/pull/7988))
-
-- Updated dependencies [[`fd00e63`](https://github.com/mastra-ai/mastra/commit/fd00e63759cbcca3473c40cac9843280b0557cff), [`ab610f6`](https://github.com/mastra-ai/mastra/commit/ab610f6f41dbfe6c9502368671485ca7a0aac09b), [`e6bda5f`](https://github.com/mastra-ai/mastra/commit/e6bda5f954ee8493ea18adc1a883f0a5b785ad9b)]:
-  - @mastra/core@0.17.1
-  - @mastra/deployer@0.17.1
-
-## 0.13.1-alpha.0
-
-### Patch Changes
-
-- fix workflow resuming issue in the playground ([#7988](https://github.com/mastra-ai/mastra/pull/7988))
-
-- Updated dependencies [[`fd00e63`](https://github.com/mastra-ai/mastra/commit/fd00e63759cbcca3473c40cac9843280b0557cff), [`ab610f6`](https://github.com/mastra-ai/mastra/commit/ab610f6f41dbfe6c9502368671485ca7a0aac09b), [`e6bda5f`](https://github.com/mastra-ai/mastra/commit/e6bda5f954ee8493ea18adc1a883f0a5b785ad9b)]:
-  - @mastra/core@0.17.1-alpha.0
-  - @mastra/deployer@0.17.1-alpha.0
-
-## 0.13.0
-
-### Minor Changes
-
-- Improved workspace dependency resolution during development and builds. This makes the build process more reliable when working with monorepos and workspace packages, reducing potential bundling errors and improving development experience. ([#7619](https://github.com/mastra-ai/mastra/pull/7619))
-
-### Patch Changes
-
-- clean up console logs in monorepo ([#7926](https://github.com/mastra-ai/mastra/pull/7926))
-
-- update playground workflows to use createRunAsync instead of createRun ([#7903](https://github.com/mastra-ai/mastra/pull/7903))
-
-- Improve the `mastra init` CLI. ([#7837](https://github.com/mastra-ai/mastra/pull/7837))
-
-  Previously, when you ran `mastra init` in a directory without a `package.json` file you'd receive no output. Now the CLI shows an error with next steps. Additionally, `mastra init` now also installs `zod` if not present already.
-
-- Add support for running the Mastra dev server over HTTPS for local development. ([#7871](https://github.com/mastra-ai/mastra/pull/7871))
-  - Add `--https` flag for `mastra dev`. This automatically creates a local key and certificate for you.
-  - Alternatively, you can provide your own key and cert through `server.https`:
-
-    ```ts
-    // src/mastra/index.ts
-    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'),
-        },
-      },
-    });
-    ```
-
-- avoid refetching on error when resolving a workflow in cloud ([#7842](https://github.com/mastra-ai/mastra/pull/7842))
-
-- fix scorers table link full row ([#7915](https://github.com/mastra-ai/mastra/pull/7915))
-
-- dependencies updates: ([#7810](https://github.com/mastra-ai/mastra/pull/7810))
-  - Updated dependency [`strip-json-comments@^5.0.3` ↗︎](https://www.npmjs.com/package/strip-json-comments/v/5.0.3) (from `^5.0.2`, in `dependencies`)
-
-- adjust the way we display scorers in agent metadata ([#7910](https://github.com/mastra-ai/mastra/pull/7910))
-
-- fix minor playground stuff for observability ([#7765](https://github.com/mastra-ai/mastra/pull/7765))
-
-- Handle zod intersections in dynamic form ([#7768](https://github.com/mastra-ai/mastra/pull/7768))
-
-- Playground ui -pass runtimeContext to client SDK get methods ([#7767](https://github.com/mastra-ai/mastra/pull/7767))
-
 
-... 5891 more lines hidden. See full changelog in package directory.
+... 5967 more lines hidden. See full changelog in package directory.

package/.docs/raw/agents/runtime-context.mdx

@@ -1,9 +1,9 @@
 ---
-title: "Runtime context | Agents | Mastra Docs"
+title: "Runtime Context | Agents | Mastra Docs"
 description: Learn how to use Mastra's RuntimeContext to provide dynamic, request-specific configuration to agents.
 ---
 
-# Agent Runtime Context
+# Runtime Context
 
 Mastra provides `RuntimeContext`, a dependency injection system that lets you configure agents with runtime variables. If you find yourself creating multiple agents that perform similar tasks, runtime context allows you to consolidate them into a single, more flexible agent.
 
@@ -46,9 +46,9 @@ export const testWeatherAgent = new Agent({
 
 ### Example tool
 
-This tool exports a `WeatherRuntimeContext` type, which can be used anywhere `RuntimeContext` is used to enable type-safe access to runtime configuration.
+This tool exports a `WeatherRuntimeContext` type, enabling type-safe access to runtime configuration wherever the tool’s `runtimeContext` is used. It extracts `city` from `context`, which is derived from the user message passed to `.generate()`, and uses it to query a weather service API.
 
-```typescript {4-6} filename="src/mastra/tools/test-weather-tool.ts" showLineNumbers copy
+```typescript {4-6, 15} filename="src/mastra/tools/test-weather-tool.ts" showLineNumbers copy
 import { createTool } from "@mastra/core/tools";
 import { z } from "zod";
 
@@ -58,26 +58,21 @@ export type WeatherRuntimeContext = {
 
 export const testWeatherTool = createTool({
   id: "test-weather-tool",
-  description: "Get weather for a location",
+  description: "Fetches the current weather for a given city",
   inputSchema: z.object({
-    location: z.string()
-  }),
-  outputSchema: z.object({
-    metric: z.string(),
-    temperature: z.number(),
-    weather: z.string()
+    city: z.string()
   }),
   execute: async ({ context, runtimeContext }) => {
-    const { location } = context;
+    const { city } = context;
     const unit = runtimeContext.get("temperature-unit") as WeatherRuntimeContext["temperature-unit"];
 
-    const temperature = 30;
-    const weather = "Sunny";
+    const response = await fetch(`https://weather.service?city=${city}`);
+    const { temperature, conditions } = await response.json();
 
     return {
       metric: unit === "celsius" ? "°C" : "°F",
       temperature,
-      weather
+      conditions
     };
   }
 });
@@ -96,7 +91,7 @@ const agent = mastra.getAgent("testWeatherAgent");
 
 const runtimeContext = new RuntimeContext<WeatherRuntimeContext>();
 
-runtimeContext.set("temperature-unit", "fahrenheit");
+runtimeContext.set("temperature-unit", "celsius");
 
 const response = await agent.generate("What's the weather in London?", {
   runtimeContext

package/.docs/raw/agents/using-tools-and-mcp.mdx

@@ -22,7 +22,7 @@ import { z } from "zod";
 
 export const weatherTool = createTool({
   id: "weather-tool",
-  description: "Fetches the current weather information for a given city",
+  description: "Fetches the current weather for a given city",
   inputSchema: z.object({
     city: z.string(),
   }),

package/.docs/raw/getting-started/model-providers.mdx

@@ -29,6 +29,8 @@ const result = await agent.generate("What is the weather like?");
 
 <Callout>
   **[→ View all 38 providers and 7 gateways](../../models)**
+
+  Explore our complete catalog with logos, model counts, and documentation for each provider.
 </Callout>
 
 ## Configuration
@@ -56,6 +58,6 @@ const agent = new Agent({
 ## Learn More
 
 - [📚 Browse All Model Providers](../../models) - Complete list with examples
-- [🚀 Agent Documentation](/reference/agents/agent) - Using models with agents
-- [⚙️ Environment Variables](/docs/deployment/environment-variables) - Configuration guide
-- [🔧 Tool Configuration](/docs/tools/overview) - Adding tools to agents
+- [🚀 Agent Documentation](../../reference/agents/agent.mdx) - Using models with agents
+- [⚙️ Environment Variables](../getting-started/installation.mdx#add-your-api-key) - Configuration guide
+- [🔧 Tool Configuration](../agents/using-tools-and-mcp.mdx#adding-tools-to-an-agent) - Adding tools to agents

package/.docs/raw/reference/streaming/ChunkType.mdx

@@ -1,16 +1,12 @@
 ---
-title: "Reference: ChunkType (Experimental) | Agents | Mastra Docs"
+title: "Reference: ChunkType | Agents | Mastra Docs"
 description: "Documentation for the ChunkType type used in Mastra streaming responses, defining all possible chunk types and their payloads."
 ---
 
 import { Callout } from "nextra/components";
 import { PropertiesTable } from "@/components/properties-table";
 
-# ChunkType (Experimental)
-
-<Callout type="important">
-  <strong className="block">Experimental API: </strong>This type is part of the experimental `.stream()` method. The API may change as we refine the feature based on feedback.
-</Callout>
+# ChunkType
 
 The `ChunkType` type defines the mastra format of stream chunks that can be emitted during streaming responses from agents.
 

package/.docs/raw/reference/streaming/agents/MastraModelOutput.mdx

@@ -6,11 +6,7 @@ description: "Complete reference for MastraModelOutput - the stream object retur
 import { Callout } from "nextra/components";
 import { PropertiesTable } from "@/components/properties-table";
 
-# MastraModelOutput (Experimental)
-
-<Callout type="important">
-  <strong className="block">Experimental API: </strong>This type is part of the experimental `.stream()` method. The API may change as we refine the feature based on feedback.
-</Callout>
+# MastraModelOutput
 
 The `MastraModelOutput` class is returned by [.stream()](./stream.mdx) and provides both streaming and promise-based access to model outputs. It supports structured output generation, tool calls, reasoning, and comprehensive usage tracking.
 

package/.docs/raw/workflows/overview.mdx

@@ -1,18 +1,32 @@
 ---
 title: "Handling Complex LLM Operations | Workflows | Mastra"
-description: "Workflows in Mastra help you orchestrate complex sequences of operations with features like branching, parallel execution, resource suspension, and more."
+description: "Workflows in Mastra help you orchestrate complex sequences of tasks with features like branching, parallel execution, resource suspension, and more."
 ---
 
 import { Steps } from "nextra/components";
 
 # Workflows overview
 
-Workflows let you define and orchestrate complex sequences of tasks as **typed steps** connected by data flows. Each step has clearly defined inputs and outputs validated by Zod schemas.
-
-A workflow manages execution order, dependencies, branching, parallelism, and error handling — enabling you to build robust, reusable processes. Steps can be nested or cloned to compose larger workflows.
+Workflows allow you to define and manage complex sequences of tasks by connecting them with clear, structured processes. Unlike a single agent, which operates independently, workflows enable you to orchestrate multiple steps with specific logic, tools, and external services. This approach provides more control and predictability, ensuring consistent results by allowing you to determine what tasks are performed and when they are completed.
 
 ![Workflows overview](/image/workflows/workflows-overview.jpg)
 
+## When to use a workflow
+
+For example, you might want to perform a sequence of tasks:
+
+1. Handle a user question like “Can I return my last order?”
+2. Fetch user-specific data from a database using their `user_id`.
+3. Check return eligibility via an external API or business logic.
+4. Make a conditional decision (e.g. approve, deny, escalate) based on the data.
+5. Generate a tailored response based on the outcome.
+
+Each of these tasks is created as a **step** in a workflow, giving you fine-grained control over data flow, execution order, and side effects.
+
+> **📹 Watch**:  → An introduction to workflows, and how they compare to agents [YouTube (7 minutes)](https://youtu.be/0jg2g3sNvgw)
+
+## Building workflows
+
 You create workflows by:
 
 - Defining **steps** with `createStep`, specifying input/output schemas and business logic.
@@ -21,7 +35,10 @@ You create workflows by:
 
 This structure provides full type safety and runtime validation, ensuring data integrity across the entire workflow.
 
-> **📹 Watch**:  → An introduction to workflows, and how they compare to agents [YouTube (7 minutes)](https://youtu.be/0jg2g3sNvgw)
+### Visual testing
+
+Use the [Playground](../server-db/local-dev-playground.mdx#workflows) to visualize workflow execution in real time. It shows which steps are running, completed, or suspended.
+
 
 ## Getting started
 

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 0.13.28-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`10e633a`](https://github.com/mastra-ai/mastra/commit/10e633a07d333466d9734c97acfc3dbf757ad2d0)]:
+  - @mastra/core@0.20.1-alpha.0
+
 ## 0.13.27
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "0.13.27",
+  "version": "0.13.28-alpha.0",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -33,7 +33,7 @@
     "uuid": "^11.1.0",
     "zod": "^3.25.76",
     "zod-to-json-schema": "^3.24.6",
-    "@mastra/core": "0.20.0",
+    "@mastra/core": "0.20.1-alpha.0",
     "@mastra/mcp": "^0.13.3"
   },
   "devDependencies": {
@@ -49,8 +49,8 @@
     "tsx": "^4.19.4",
     "typescript": "^5.8.3",
     "vitest": "^3.2.4",
-    "@internal/lint": "0.0.45",
-    "@mastra/core": "0.20.0"
+    "@mastra/core": "0.20.1-alpha.0",
+    "@internal/lint": "0.0.46"
   },
   "homepage": "https://mastra.ai",
   "repository": {