@mastra/mcp-docs-server 1.1.25 → 1.1.26-alpha.2

package/.docs/docs/agents/overview.md

@@ -52,6 +52,8 @@ When referencing an agent from your Mastra instance, use `mastra.getAgentById()`
 
 Returns the full response after all tool calls and steps complete. The result includes `text`, `toolCalls`, `toolResults`, `steps`, and token `usage` statistics.
 
+See the [`Agent.generate()` reference](https://mastra.ai/reference/agents/generate) for the response shape, including tool call and tool result payloads.
+
 ```ts
 const agent = mastra.getAgentById('test-agent')
 const response = await agent.generate('Help me organize my day')
@@ -62,6 +64,8 @@ console.log(response.text)
 
 Returns a stream you can consume as tokens arrive. The result exposes `textStream` for incremental output and promises for `toolCalls`, `toolResults`, `steps`, and token `usage` that resolve when the stream finishes.
 
+See the [`MastraModelOutput` reference](https://mastra.ai/reference/streaming/agents/MastraModelOutput) for the stream shape, including tool call and tool result payloads.
+
 ```ts
 const agent = mastra.getAgentById('test-agent')
 const stream = await agent.stream('Help me organize my day')

package/.docs/reference/agents/generate.md

@@ -300,6 +300,34 @@ const response = await agent.generate('Help me organize my day', {
 
 **options.includeRawChunks** (`boolean`): Whether to include raw chunks in the stream output. Not available on all model providers.
 
+## Response structure
+
+`Agent.generate()` returns the final data collected during execution. `steps` is an array of step objects. The tool arrays in the result, including top-level `toolCalls` and `toolResults` and the nested `step.toolCalls` and `step.toolResults` arrays, use Mastra's chunk format.
+
+That means tool data is wrapped in `payload`:
+
+```ts
+const response = await agent.generate('Check the weather in Lagos')
+
+for (const toolCall of response.toolCalls) {
+  console.log(toolCall.type) // 'tool-call'
+  console.log(toolCall.runId)
+  console.log(toolCall.from)
+  console.log(toolCall.payload.toolName)
+  console.log(toolCall.payload.args)
+}
+
+for (const step of response.steps) {
+  for (const toolResult of step.toolResults) {
+    console.log(toolResult.type) // 'tool-result'
+    console.log(toolResult.payload.toolName)
+    console.log(toolResult.payload.result)
+  }
+}
+```
+
+For the streaming version of the same chunk shape, see the [ChunkType reference](https://mastra.ai/reference/streaming/ChunkType).
+
 ## Returns
 
 **result** (`Awaited<ReturnType<MastraModelOutput<Output>['getFullOutput']>>`): Returns the full output of the generation process including text, object (if structured output), tool calls, tool results, usage statistics, and step information.
@@ -308,13 +336,59 @@ const response = await agent.generate('Help me organize my day', {
 
 **object** (`Output | undefined`): The structured output object if structuredOutput was provided, validated against the schema.
 
-**toolCalls** (`ToolCall[]`): Array of tool calls made during generation.
+**toolCalls** (`ToolCallChunk[]`): Array of tool call chunks made during generation.
+
+**toolCalls.type** (`'tool-call'`): Chunk type identifier.
+
+**toolCalls.runId** (`string`): Execution run identifier.
+
+**toolCalls.from** (`ChunkFrom`): Source of the chunk, such as AGENT or WORKFLOW.
+
+**toolCalls.payload** (`ToolCallPayload`): Tool call data.
+
+**toolCalls.payload.toolCallId** (`string`): Unique identifier for the tool call.
+
+**toolCalls.payload.toolName** (`string`): Name of the tool that was called.
+
+**toolCalls.payload.args** (`Record<string, unknown>`): Arguments passed to the tool.
+
+**toolCalls.payload.providerExecuted** (`boolean`): Whether the model provider executed the tool directly.
 
-**toolResults** (`ToolResult[]`): Array of results from tool executions.
+**toolResults** (`ToolResultChunk[]`): Array of tool result chunks from tool executions.
+
+**toolResults.type** (`'tool-result'`): Chunk type identifier.
+
+**toolResults.runId** (`string`): Execution run identifier.
+
+**toolResults.from** (`ChunkFrom`): Source of the chunk, such as AGENT or WORKFLOW.
+
+**toolResults.payload** (`ToolResultPayload`): Tool result data.
+
+**toolResults.payload.toolCallId** (`string`): Unique identifier for the tool call.
+
+**toolResults.payload.toolName** (`string`): Name of the tool that produced the result.
+
+**toolResults.payload.result** (`unknown`): Value returned by the tool.
+
+**toolResults.payload.isError** (`boolean`): Whether the tool execution failed.
 
 **usage** (`TokenUsage`): Token usage statistics for the generation.
 
-**steps** (`Step[]`): Array of execution steps, useful for debugging multi-step generations.
+**steps** (`object[]`): Array of execution steps, useful for debugging multi-step generations.
+
+**steps.text** (`string`): Text generated in this step.
+
+**steps.toolCalls** (`ToolCallChunk[]`): Tool calls emitted during this step.
+
+**steps.toolResults** (`ToolResultChunk[]`): Tool results emitted during this step.
+
+**steps.finishReason** (`string`): Why this step finished.
+
+**steps.usage** (`LanguageModelUsage`): Token usage for this step.
+
+**steps.request** (`{ body?: unknown }`): Request metadata for this step.
+
+**steps.response** (`object`): Response metadata for this step.
 
 **finishReason** (`string`): The reason generation finished. Values include 'stop' (normal completion), 'tool-calls' (ended with tool calls), 'suspended' (waiting for tool approval), or 'error' (error occurred).
 

package/CHANGELOG.md

@@ -1,5 +1,20 @@
 # @mastra/mcp-docs-server
 
+## 1.1.26-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`7020c06`](https://github.com/mastra-ai/mastra/commit/7020c0690b199d9da337f0e805f16948e557922e), [`7020c06`](https://github.com/mastra-ai/mastra/commit/7020c0690b199d9da337f0e805f16948e557922e)]:
+  - @mastra/mcp@1.5.1-alpha.0
+  - @mastra/core@1.25.1-alpha.1
+
+## 1.1.26-alpha.0
+
+### Patch Changes
+
+- Updated dependencies [[`d63ffdb`](https://github.com/mastra-ai/mastra/commit/d63ffdbb2c11e76fe5ea45faab44bc15460f010c)]:
+  - @mastra/core@1.25.1-alpha.0
+
 ## 1.1.25
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.25",
+  "version": "1.1.26-alpha.2",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,8 +29,8 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.3.6",
-    "@mastra/core": "1.25.0",
-    "@mastra/mcp": "^1.5.0"
+    "@mastra/core": "1.25.1-alpha.1",
+    "@mastra/mcp": "^1.5.1-alpha.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -46,9 +46,9 @@
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
     "vitest": "4.0.18",
-    "@mastra/core": "1.25.0",
     "@internal/lint": "0.0.83",
-    "@internal/types-builder": "0.0.58"
+    "@internal/types-builder": "0.0.58",
+    "@mastra/core": "1.25.1-alpha.1"
   },
   "homepage": "https://mastra.ai",
   "repository": {