@mastra/mcp-docs-server 0.13.30 → 0.13.31

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

@@ -1,5 +1,77 @@
 # mastra
 
+## 0.17.0
+
+### Minor Changes
+
+- - Remove the `mastra deploy` CLI command. Use the deploy instructions of your individual platform. ([#8798](https://github.com/mastra-ai/mastra/pull/8798))
+  - Remove `--env` flag from `mastra build` command
+  - Remove `--port` flag from `mastra dev`. Use `server.port` on the `new Mastra()` class instead.
+  - Validate `--components` and `--llm` flags for `mastra create` and `mastra init`
+
+### Patch Changes
+
+- Updated dependencies [[`5253cd2`](https://github.com/mastra-ai/mastra/commit/5253cd2d5b2cf4558963fa73c6a6b36c72f8875f), [`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`11e9e8f`](https://github.com/mastra-ai/mastra/commit/11e9e8f4fb09a493ea00deda49081788f16e753b), [`00bf52b`](https://github.com/mastra-ai/mastra/commit/00bf52b89a93e6bffaaaf1714316870ad8af6572), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/deployer@0.21.1
+  - @mastra/core@0.21.1
+
+## 0.17.0-alpha.0
+
+### Minor Changes
+
+- - Remove the `mastra deploy` CLI command. Use the deploy instructions of your individual platform. ([#8798](https://github.com/mastra-ai/mastra/pull/8798))
+  - Remove `--env` flag from `mastra build` command
+  - Remove `--port` flag from `mastra dev`. Use `server.port` on the `new Mastra()` class instead.
+  - Validate `--components` and `--llm` flags for `mastra create` and `mastra init`
+
+### Patch Changes
+
+- Updated dependencies [[`5253cd2`](https://github.com/mastra-ai/mastra/commit/5253cd2d5b2cf4558963fa73c6a6b36c72f8875f), [`ca85c93`](https://github.com/mastra-ai/mastra/commit/ca85c932b232e6ad820c811ec176d98e68c59b0a), [`a1d40f8`](https://github.com/mastra-ai/mastra/commit/a1d40f88d4ce42c4508774ad22e38ac582157af2), [`11e9e8f`](https://github.com/mastra-ai/mastra/commit/11e9e8f4fb09a493ea00deda49081788f16e753b), [`00bf52b`](https://github.com/mastra-ai/mastra/commit/00bf52b89a93e6bffaaaf1714316870ad8af6572), [`01c4a25`](https://github.com/mastra-ai/mastra/commit/01c4a2506c514d5e861c004d3d2fb3791c6391f3), [`cce8aad`](https://github.com/mastra-ai/mastra/commit/cce8aad878a0dd98e5647680f3765caba0b1701c)]:
+  - @mastra/deployer@0.21.1-alpha.0
+  - @mastra/core@0.21.1-alpha.0
+
+## 0.16.0
+
+### Minor Changes
+
+- Update peer dependencies to match core package version bump (0.21.0) ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
+
+### Patch Changes
+
+- Use model-router in create-mastra starter template ([#8631](https://github.com/mastra-ai/mastra/pull/8631))
+
+- Fix typo in playground causing semantic recall to always be false when enabled. ([#8640](https://github.com/mastra-ai/mastra/pull/8640))
+
+- Update peer dependencies to match core package version bump (0.21.0) ([#8619](https://github.com/mastra-ai/mastra/pull/8619))
+
+- Create unified Sidebar component to use on Playground and Cloud ([#8655](https://github.com/mastra-ai/mastra/pull/8655))
+
+- Use only zod validation in dynamic form ([#8802](https://github.com/mastra-ai/mastra/pull/8802))
+
+- Add support for --debug options to build/dev commands to add more logging ([#8792](https://github.com/mastra-ai/mastra/pull/8792))
+
+- Add div wrapper around entity tables to fix table vertical position ([#8758](https://github.com/mastra-ai/mastra/pull/8758))
+
+- Update peer dependencies to match core package version bump (0.21.0) ([#8557](https://github.com/mastra-ai/mastra/pull/8557))
+
+- Update peer dependencies to match core package version bump (0.21.0) ([#8626](https://github.com/mastra-ai/mastra/pull/8626))
+
+- Customize AITraces type to seamlessly work on Cloud too ([#8759](https://github.com/mastra-ai/mastra/pull/8759))
+
+- Refactor EntryList component and Scorer and Observability pages ([#8652](https://github.com/mastra-ai/mastra/pull/8652))
+
+- Stream finalResult from network loop ([#8795](https://github.com/mastra-ai/mastra/pull/8795))
+
+- Improve README ([#8819](https://github.com/mastra-ai/mastra/pull/8819))
+
+- Update peer dependencies to match core package version bump (0.21.0) ([#8686](https://github.com/mastra-ai/mastra/pull/8686))
+
+- Updated dependencies [[`0fb6616`](https://github.com/mastra-ai/mastra/commit/0fb66169600ed2a3dc1297b1bfa8a7693ebb6e3c), [`1ed9670`](https://github.com/mastra-ai/mastra/commit/1ed9670d3ca50cb60dc2e517738c5eef3968ed27), [`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`1dbd76a`](https://github.com/mastra-ai/mastra/commit/1dbd76aff29cc764d3a1ac7bb01172fe59cb5992), [`f59fc1e`](https://github.com/mastra-ai/mastra/commit/f59fc1e406b8912e692f6bff6cfd4754cc8d165c), [`ca5a01f`](https://github.com/mastra-ai/mastra/commit/ca5a01f0dd4dabdbfde3beeaf92c7333e0f9bb39), [`158381d`](https://github.com/mastra-ai/mastra/commit/158381d39335be934b81ef8a1947bccace492c25), [`a1799bc`](https://github.com/mastra-ai/mastra/commit/a1799bcc1b5a1cdc188f2ac0165f17a1c4ac6f7b), [`6ff6094`](https://github.com/mastra-ai/mastra/commit/6ff60946f4ecfebdeef6e21d2b230c2204f2c9b8), [`2ddb851`](https://github.com/mastra-ai/mastra/commit/2ddb8519c4b6f1d31be10ffd33b41d2b649a04ff), [`fb703b9`](https://github.com/mastra-ai/mastra/commit/fb703b9634eeaff1a6eb2b5531ce0f9e8fb04727), [`dfe856f`](https://github.com/mastra-ai/mastra/commit/dfe856f7f60ff4765b75930e7b5d82dd0f0f7d89), [`37a2314`](https://github.com/mastra-ai/mastra/commit/37a23148e0e5a3b40d4f9f098b194671a8a49faf), [`7b1ef57`](https://github.com/mastra-ai/mastra/commit/7b1ef57fc071c2aa2a2e32905b18cd88719c5a39), [`7b1ef57`](https://github.com/mastra-ai/mastra/commit/7b1ef57fc071c2aa2a2e32905b18cd88719c5a39), [`05a9dee`](https://github.com/mastra-ai/mastra/commit/05a9dee3d355694d28847bfffb6289657fcf7dfa), [`e3c1077`](https://github.com/mastra-ai/mastra/commit/e3c107763aedd1643d3def5df450c235da9ff76c), [`1908ca0`](https://github.com/mastra-ai/mastra/commit/1908ca0521f90e43779cc29ab590173ca560443c), [`1bccdb3`](https://github.com/mastra-ai/mastra/commit/1bccdb33eb90cbeba2dc5ece1c2561fb774b26b6), [`5ef944a`](https://github.com/mastra-ai/mastra/commit/5ef944a3721d93105675cac2b2311432ff8cc393), [`228228b`](https://github.com/mastra-ai/mastra/commit/228228b0b1de9291cb8887587f5cea1a8757ebad), [`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`d6b186f`](https://github.com/mastra-ai/mastra/commit/d6b186fb08f1caf1b86f73d3a5ee88fb999ca3be), [`ee68e82`](https://github.com/mastra-ai/mastra/commit/ee68e8289ea4408d29849e899bc6e78b3bd4e843), [`228228b`](https://github.com/mastra-ai/mastra/commit/228228b0b1de9291cb8887587f5cea1a8757ebad), [`ea33930`](https://github.com/mastra-ai/mastra/commit/ea339301e82d6318257720d811b043014ee44064), [`65493b3`](https://github.com/mastra-ai/mastra/commit/65493b31c36f6fdb78f9679f7e1ecf0c250aa5ee), [`a998b8f`](https://github.com/mastra-ai/mastra/commit/a998b8f858091c2ec47683e60766cf12d03001e4), [`b5a66b7`](https://github.com/mastra-ai/mastra/commit/b5a66b748a14fc8b3f63b04642ddb9621fbcc9e0), [`8a37bdd`](https://github.com/mastra-ai/mastra/commit/8a37bddb6d8614a32c5b70303d583d80c620ea61), [`7b1ef57`](https://github.com/mastra-ai/mastra/commit/7b1ef57fc071c2aa2a2e32905b18cd88719c5a39), [`e0e1cf1`](https://github.com/mastra-ai/mastra/commit/e0e1cf1e37b9dc61099ab331a6d386e44b816310), [`135d6f2`](https://github.com/mastra-ai/mastra/commit/135d6f22a326ed1dffff858700669dff09d2c9eb)]:
+  - @mastra/deployer@0.21.0
+  - @mastra/core@0.21.0
+  - @mastra/loggers@0.10.16
+  - @mastra/mcp@0.13.5
+
 ## 0.16.0-alpha.1
 
 ### Minor Changes
@@ -226,77 +298,5 @@
 - 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
-
-- 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))
 
-... 6146 more lines hidden. See full changelog in package directory.
+... 6218 more lines hidden. See full changelog in package directory.

package/.docs/organized/code-examples/heads-up-game.md

@@ -7,15 +7,15 @@
   },
   "dependencies": {
     "@ai-sdk/openai": "^1.3.23",
-    "@mastra/core": "^0.20.2",
-    "@mastra/libsql": "^0.15.1",
-    "@mastra/loggers": "^0.10.15",
-    "@mastra/memory": "^0.15.6",
+    "@mastra/core": "^0.21.0",
+    "@mastra/libsql": "^0.15.2",
+    "@mastra/loggers": "^0.10.16",
+    "@mastra/memory": "^0.15.7",
     "zod": "^3.25.76"
   },
   "devDependencies": {
     "@types/node": "^24.3.0",
-    "mastra": "^0.15.1",
+    "mastra": "^0.16.0",
     "typescript": "^5.9.2"
   }
 }

package/.docs/raw/agents/agent-memory.mdx

@@ -37,7 +37,7 @@ Mastra supports multiple storage providers. Popular options include:
 - [Cloudflare D1](../../reference/storage/cloudflare-d1.mdx)
 
 <Callout type="warning">
-`LibSQLStore` works well for local development and when deploying to [Mastra Cloud](../mastra-cloud/overview.mdx), but may not be supported by some [serverless platforms](../deployment/serverless-platforms/index.mdx) or [cloud providers](../deployment/cloud-providers/index.mdx).
+`LibSQLStore` works well for local development and when deploying to [Mastra Cloud](../mastra-cloud/overview.mdx), but may not be supported by some [serverless platforms](../deployment/serverless-platforms) or [cloud providers](../deployment/cloud-providers).
 </Callout>
 
 ### Shared storage

package/.docs/raw/agents/networks.mdx

@@ -65,7 +65,6 @@ const agentStep1 = createStep({
           text: z.string(),
         })
       },
-      maxSteps: 1
     });
 
     return { text: resp.object.text };
@@ -88,7 +87,6 @@ const agentStep2 = createStep({
           text: z.string(),
         })
       },
-      maxSteps: 1
     });
 
     return { text: resp.object.text };

package/.docs/raw/agents/overview.mdx

@@ -137,7 +137,7 @@ instructions: {
 
 Register your agent in the Mastra instance to make it available throughout your application. Once registered, it can be called from workflows, tools, or other agents, and has access to shared resources such as memory, logging, and observability features:
 
-```typescript showLineNumbers filename="src/mastra/index.ts" copy
+```typescript {6} showLineNumbers filename="src/mastra/index.ts" copy
 import { Mastra } from "@mastra/core/mastra";
 import { testAgent } from './agents/test-agent';
 
@@ -156,7 +156,7 @@ const testAgent = mastra.getAgent("testAgent");
 ```
 <Callout type="info">
   <p>
-    `mastra.getAgent()` is preferred over a direct import, since it preserves the Mastra instance configuration (tools registered, telemetry, vector stores configuration for agent memory, etc.)
+    `mastra.getAgent()` is preferred over a direct import, since it provides access to the Mastra instance configuration (logger, telemetry, storage, registered agents, and vector stores).
   </p>
 </Callout>
 
@@ -251,12 +251,78 @@ const response = await testAgent.generate(
         keywords: z.array(z.string())
       })
     },
-    maxSteps: 1
   }
 );
 
 console.log(response.object);
 ```
+
+### With Tool Calling
+
+Use the `model` property to ensure that your agent can execute multi-step LLM calls with tool calling.
+
+```typescript showLineNumbers copy
+import { z } from "zod";
+
+const response = await testAgentWithTools.generate(
+  [
+    {
+      role: "system",
+      content: "Provide a summary and keywords for the following text:"
+    },
+    {
+      role: "user",
+      content: "Please use your test tool and let me know the results"
+    }
+  ],
+  {
+    structuredOutput: {
+      schema: z.object({
+        summary: z.string(),
+        keywords: z.array(z.string())
+      }),
+      model: "openai/gpt-4o"
+    },
+  }
+);
+
+console.log(response.object);
+console.log(response.toolResults)
+```
+
+### Response format
+
+By default `structuredOutput` will use `response_format` to pass the schema to the model provider. If the model provider does not natively support `response_format` it's possible that this will error or not give the desired results. To keep using the same model use `jsonPromptInjection` to bypass response format and inject a system prompt message to coerce the model to return structured output.
+
+```typescript showLineNumbers copy
+import { z } from "zod";
+
+const response = await testAgentThatDoesntSupportStructuredOutput.generate(
+  [
+    {
+      role: "system",
+      content: "Provide a summary and keywords for the following text:"
+    },
+    {
+      role: "user",
+      content: "Monkey, Ice Cream, Boat"
+    }
+  ],
+  {
+    structuredOutput: {
+      schema: z.object({
+        summary: z.string(),
+        keywords: z.array(z.string())
+      }),
+      jsonPromptInjection: true
+    },
+  }
+);
+
+console.log(response.object);
+```
+
+
 ## Working with images
 
 Agents can analyze and describe images by processing both the visual content and any text within them. To enable image analysis, pass an object with `type: 'image'` and the image URL in the `content` array. You can combine image content with text prompts to guide the agent's analysis.
@@ -346,42 +412,9 @@ export const testAgent = new Agent({
 
 > See [Runtime Context](../server-db/runtime-context.mdx) for more information.
 
-## Testing agents locally
-There are two ways to run and test agents.
-
-<Steps>
-
-### Mastra Playground
-
-With the Mastra Dev Server running you can test an agent from the Mastra Playground by visiting [http://localhost:4111/agents](http://localhost:4111/agents) in your browser.
-
-> For more information, see the [Local Dev Playground](/docs/server-db/local-dev-playground) documentation.
-
-### Command line
-
-Create an agent response using `.generate()` or `.stream()`.
-
-```typescript {7} filename="src/test-agent.ts" showLineNumbers copy
-import "dotenv/config";
-
-import { mastra } from "./mastra";
-
-const agent = mastra.getAgent("testAgent");
-
-const response = await agent.generate("Help me organize my day");
-
-console.log(response.text);
-```
-
-> See [.generate()](../../reference/agents/generate.mdx) or [.stream()](../../reference/agents/stream.mdx) for more information.
-
-To test this agent, run the following:
-
-```bash copy
-npx tsx src/test-agent.ts
-```
+## Testing with Mastra Playground
 
-</Steps>
+Use the Mastra [Playground](../server-db/local-dev-playground.mdx) to test agents with different messages, inspect tool calls and responses, and debug agent behavior.
 
 ## Related
 

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

@@ -91,5 +91,5 @@ export const weatherAgent = new Agent({
 
 - [Tools Overview](../tools-mcp/overview.mdx)
 - [Agent Memory](./agent-memory.mdx)
-- [Runtime Context](./runtime-context.mdx)
+- [Runtime Context](../server-db/runtime-context.mdx)
 - [Calling Agents](../../examples/agents/calling-agents.mdx)