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

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -52,6 +52,8 @@ When referencing an agent from your Mastra instance, use `mastra.getAgentById()`
52
52
 
53
53
  Returns the full response after all tool calls and steps complete. The result includes `text`, `toolCalls`, `toolResults`, `steps`, and token `usage` statistics.
54
54
 
55
+ See the [`Agent.generate()` reference](https://mastra.ai/reference/agents/generate) for the response shape, including tool call and tool result payloads.
56
+
55
57
  ```ts
56
58
  const agent = mastra.getAgentById('test-agent')
57
59
  const response = await agent.generate('Help me organize my day')
@@ -62,6 +64,8 @@ console.log(response.text)
62
64
 
63
65
  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.
64
66
 
67
+ See the [`MastraModelOutput` reference](https://mastra.ai/reference/streaming/agents/MastraModelOutput) for the stream shape, including tool call and tool result payloads.
68
+
65
69
  ```ts
66
70
  const agent = mastra.getAgentById('test-agent')
67
71
  const stream = await agent.stream('Help me organize my day')
@@ -1,6 +1,6 @@
1
1
  # ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter
2
2
 
3
- OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 171 models through Mastra's model router.
3
+ OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 170 models through Mastra's model router.
4
4
 
5
5
  Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
6
6
 
@@ -87,9 +87,8 @@ ANTHROPIC_API_KEY=ant-...
87
87
  | `google/gemma-4-26b-a4b-it:free` |
88
88
  | `google/gemma-4-31b-it` |
89
89
  | `google/gemma-4-31b-it:free` |
90
- | `inception/mercury` |
91
90
  | `inception/mercury-2` |
92
- | `inception/mercury-coder` |
91
+ | `inception/mercury-edit-2` |
93
92
  | `liquid/lfm-2.5-1.2b-instruct:free` |
94
93
  | `liquid/lfm-2.5-1.2b-thinking:free` |
95
94
  | `meta-llama/llama-3.2-11b-vision-instruct` |
@@ -119,7 +119,7 @@ ANTHROPIC_API_KEY=ant-...
119
119
  | `google/text-embedding-005` |
120
120
  | `google/text-multilingual-embedding-002` |
121
121
  | `inception/mercury-2` |
122
- | `inception/mercury-coder-small` |
122
+ | `inception/mercury-edit-2` |
123
123
  | `kwaipilot/kat-coder-pro-v1` |
124
124
  | `kwaipilot/kat-coder-pro-v2` |
125
125
  | `meituan/longcat-flash-chat` |
@@ -1,6 +1,6 @@
1
1
  # ![Inception logo](https://models.dev/logos/inception.svg)Inception
2
2
 
3
- Access 4 Inception models through Mastra's model router. Authentication is handled automatically using the `INCEPTION_API_KEY` environment variable.
3
+ Access 2 Inception models through Mastra's model router. Authentication is handled automatically using the `INCEPTION_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [Inception documentation](https://platform.inceptionlabs.ai/docs).
6
6
 
@@ -15,7 +15,7 @@ const agent = new Agent({
15
15
  id: "my-agent",
16
16
  name: "My Agent",
17
17
  instructions: "You are a helpful assistant",
18
- model: "inception/mercury"
18
+ model: "inception/mercury-2"
19
19
  });
20
20
 
21
21
  // Generate a response
@@ -32,12 +32,10 @@ for await (const chunk of stream) {
32
32
 
33
33
  ## Models
34
34
 
35
- | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
- | ------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
- | `inception/mercury` | 128K | | | | | | $0.25 | $1 |
38
- | `inception/mercury-2` | 128K | | | | | | $0.25 | $0.75 |
39
- | `inception/mercury-coder` | 128K | | | | | | $0.25 | $1 |
40
- | `inception/mercury-edit` | 128K | | | | | | $0.25 | $0.75 |
35
+ | Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
36
+ | -------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
37
+ | `inception/mercury-2` | 128K | | | | | | $0.25 | $0.75 |
38
+ | `inception/mercury-edit-2` | 128K | | | | | | $0.25 | $0.75 |
41
39
 
42
40
  ## Advanced configuration
43
41
 
@@ -49,7 +47,7 @@ const agent = new Agent({
49
47
  name: "custom-agent",
50
48
  model: {
51
49
  url: "https://api.inceptionlabs.ai/v1/",
52
- id: "inception/mercury",
50
+ id: "inception/mercury-2",
53
51
  apiKey: process.env.INCEPTION_API_KEY,
54
52
  headers: {
55
53
  "X-Custom-Header": "value"
@@ -67,8 +65,8 @@ const agent = new Agent({
67
65
  model: ({ requestContext }) => {
68
66
  const useAdvanced = requestContext.task === "complex";
69
67
  return useAdvanced
70
- ? "inception/mercury-edit"
71
- : "inception/mercury";
68
+ ? "inception/mercury-edit-2"
69
+ : "inception/mercury-2";
72
70
  }
73
71
  });
74
72
  ```
@@ -1,6 +1,6 @@
1
1
  # ![Kilo Gateway logo](https://models.dev/logos/kilo.svg)Kilo Gateway
2
2
 
3
- Access 335 Kilo Gateway models through Mastra's model router. Authentication is handled automatically using the `KILO_API_KEY` environment variable.
3
+ Access 334 Kilo Gateway models through Mastra's model router. Authentication is handled automatically using the `KILO_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [Kilo Gateway documentation](https://kilo.ai).
6
6
 
@@ -127,9 +127,8 @@ for await (const chunk of stream) {
127
127
  | `kilo/google/lyria-3-pro-preview` | 1.0M | | | | | | — | — |
128
128
  | `kilo/gryphe/mythomax-l2-13b` | 4K | | | | | | $0.06 | $0.06 |
129
129
  | `kilo/ibm-granite/granite-4.0-h-micro` | 131K | | | | | | $0.02 | $0.11 |
130
- | `kilo/inception/mercury` | 128K | | | | | | $0.25 | $0.75 |
131
130
  | `kilo/inception/mercury-2` | 128K | | | | | | $0.25 | $0.75 |
132
- | `kilo/inception/mercury-coder` | 128K | | | | | | $0.25 | $0.75 |
131
+ | `kilo/inception/mercury-edit-2` | 128K | | | | | | $0.25 | $0.75 |
133
132
  | `kilo/inflection/inflection-3-pi` | 8K | | | | | | $3 | $10 |
134
133
  | `kilo/inflection/inflection-3-productivity` | 8K | | | | | | $3 | $10 |
135
134
  | `kilo/kilo-auto/balanced` | 205K | | | | | | $0.60 | $3 |
@@ -1,6 +1,6 @@
1
1
  # ![NanoGPT logo](https://models.dev/logos/nano-gpt.svg)NanoGPT
2
2
 
3
- Access 519 NanoGPT models through Mastra's model router. Authentication is handled automatically using the `NANO_GPT_API_KEY` environment variable.
3
+ Access 518 NanoGPT models through Mastra's model router. Authentication is handled automatically using the `NANO_GPT_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [NanoGPT documentation](https://docs.nano-gpt.com).
6
6
 
@@ -319,7 +319,6 @@ for await (const chunk of stream) {
319
319
  | `nano-gpt/meganova-ai/manta-mini-1.0` | 8K | | | | | | $0.02 | $0.16 |
320
320
  | `nano-gpt/meganova-ai/manta-pro-1.0` | 33K | | | | | | $0.06 | $0.50 |
321
321
  | `nano-gpt/meituan-longcat/LongCat-Flash-Chat-FP8` | 128K | | | | | | $0.15 | $0.70 |
322
- | `nano-gpt/mercury-coder-small` | 33K | | | | | | $0.25 | $1 |
323
322
  | `nano-gpt/Meta-Llama-3-1-8B-Instruct-FP8` | 128K | | | | | | $0.02 | $0.03 |
324
323
  | `nano-gpt/meta-llama/llama-3.1-8b-instruct` | 131K | | | | | | $0.05 | $0.05 |
325
324
  | `nano-gpt/meta-llama/llama-3.2-3b-instruct` | 131K | | | | | | $0.03 | $0.05 |
@@ -1,6 +1,6 @@
1
1
  # ![Nvidia logo](https://models.dev/logos/nvidia.svg)Nvidia
2
2
 
3
- Access 75 Nvidia models through Mastra's model router. Authentication is handled automatically using the `NVIDIA_API_KEY` environment variable.
3
+ Access 76 Nvidia models through Mastra's model router. Authentication is handled automatically using the `NVIDIA_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [Nvidia documentation](https://docs.api.nvidia.com/nim/).
6
6
 
@@ -71,6 +71,7 @@ for await (const chunk of stream) {
71
71
  | `nvidia/microsoft/phi-4-mini-instruct` | 131K | | | | | | — | — |
72
72
  | `nvidia/minimaxai/minimax-m2.1` | 205K | | | | | | — | — |
73
73
  | `nvidia/minimaxai/minimax-m2.5` | 205K | | | | | | — | — |
74
+ | `nvidia/minimaxai/minimax-m2.7` | 205K | | | | | | $0.30 | $1 |
74
75
  | `nvidia/mistralai/codestral-22b-instruct-v0.1` | 128K | | | | | | — | — |
75
76
  | `nvidia/mistralai/devstral-2-123b-instruct-2512` | 262K | | | | | | — | — |
76
77
  | `nvidia/mistralai/mamba-codestral-7b-v0.1` | 128K | | | | | | — | — |
@@ -1,6 +1,6 @@
1
1
  # ![OpenCode Go logo](https://models.dev/logos/opencode-go.svg)OpenCode Go
2
2
 
3
- Access 7 OpenCode Go models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
3
+ Access 9 OpenCode Go models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [OpenCode Go documentation](https://opencode.ai/docs/zen).
6
6
 
@@ -41,6 +41,8 @@ for await (const chunk of stream) {
41
41
  | `opencode-go/mimo-v2-pro` | 1.0M | | | | | | $1 | $3 |
42
42
  | `opencode-go/minimax-m2.5` | 205K | | | | | | $0.30 | $1 |
43
43
  | `opencode-go/minimax-m2.7` | 205K | | | | | | $0.30 | $1 |
44
+ | `opencode-go/qwen3.5-plus` | 262K | | | | | | $0.20 | $1 |
45
+ | `opencode-go/qwen3.6-plus` | 262K | | | | | | $0.50 | $3 |
44
46
 
45
47
  ## Advanced configuration
46
48
 
@@ -70,7 +72,7 @@ const agent = new Agent({
70
72
  model: ({ requestContext }) => {
71
73
  const useAdvanced = requestContext.task === "complex";
72
74
  return useAdvanced
73
- ? "opencode-go/minimax-m2.7"
75
+ ? "opencode-go/qwen3.6-plus"
74
76
  : "opencode-go/glm-5";
75
77
  }
76
78
  });
@@ -1,6 +1,6 @@
1
1
  # ![OpenCode Zen logo](https://models.dev/logos/opencode.svg)OpenCode Zen
2
2
 
3
- Access 32 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
3
+ Access 34 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
4
4
 
5
5
  Learn more in the [OpenCode Zen documentation](https://opencode.ai/docs/zen).
6
6
 
@@ -66,6 +66,8 @@ for await (const chunk of stream) {
66
66
  | `opencode/minimax-m2.5` | 205K | | | | | | $0.30 | $1 |
67
67
  | `opencode/minimax-m2.5-free` | 205K | | | | | | — | — |
68
68
  | `opencode/nemotron-3-super-free` | 205K | | | | | | — | — |
69
+ | `opencode/qwen3.5-plus` | 262K | | | | | | $0.20 | $1 |
70
+ | `opencode/qwen3.6-plus` | 262K | | | | | | $0.50 | $3 |
69
71
 
70
72
  ## Advanced configuration
71
73
 
@@ -95,7 +97,7 @@ const agent = new Agent({
95
97
  model: ({ requestContext }) => {
96
98
  const useAdvanced = requestContext.task === "complex";
97
99
  return useAdvanced
98
- ? "opencode/nemotron-3-super-free"
100
+ ? "opencode/qwen3.6-plus"
99
101
  : "opencode/big-pickle";
100
102
  }
101
103
  });
@@ -300,6 +300,34 @@ const response = await agent.generate('Help me organize my day', {
300
300
 
301
301
  **options.includeRawChunks** (`boolean`): Whether to include raw chunks in the stream output. Not available on all model providers.
302
302
 
303
+ ## Response structure
304
+
305
+ `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.
306
+
307
+ That means tool data is wrapped in `payload`:
308
+
309
+ ```ts
310
+ const response = await agent.generate('Check the weather in Lagos')
311
+
312
+ for (const toolCall of response.toolCalls) {
313
+ console.log(toolCall.type) // 'tool-call'
314
+ console.log(toolCall.runId)
315
+ console.log(toolCall.from)
316
+ console.log(toolCall.payload.toolName)
317
+ console.log(toolCall.payload.args)
318
+ }
319
+
320
+ for (const step of response.steps) {
321
+ for (const toolResult of step.toolResults) {
322
+ console.log(toolResult.type) // 'tool-result'
323
+ console.log(toolResult.payload.toolName)
324
+ console.log(toolResult.payload.result)
325
+ }
326
+ }
327
+ ```
328
+
329
+ For the streaming version of the same chunk shape, see the [ChunkType reference](https://mastra.ai/reference/streaming/ChunkType).
330
+
303
331
  ## Returns
304
332
 
305
333
  **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', {
308
336
 
309
337
  **object** (`Output | undefined`): The structured output object if structuredOutput was provided, validated against the schema.
310
338
 
311
- **toolCalls** (`ToolCall[]`): Array of tool calls made during generation.
339
+ **toolCalls** (`ToolCallChunk[]`): Array of tool call chunks made during generation.
340
+
341
+ **toolCalls.type** (`'tool-call'`): Chunk type identifier.
342
+
343
+ **toolCalls.runId** (`string`): Execution run identifier.
344
+
345
+ **toolCalls.from** (`ChunkFrom`): Source of the chunk, such as AGENT or WORKFLOW.
346
+
347
+ **toolCalls.payload** (`ToolCallPayload`): Tool call data.
348
+
349
+ **toolCalls.payload.toolCallId** (`string`): Unique identifier for the tool call.
350
+
351
+ **toolCalls.payload.toolName** (`string`): Name of the tool that was called.
352
+
353
+ **toolCalls.payload.args** (`Record<string, unknown>`): Arguments passed to the tool.
354
+
355
+ **toolCalls.payload.providerExecuted** (`boolean`): Whether the model provider executed the tool directly.
312
356
 
313
- **toolResults** (`ToolResult[]`): Array of results from tool executions.
357
+ **toolResults** (`ToolResultChunk[]`): Array of tool result chunks from tool executions.
358
+
359
+ **toolResults.type** (`'tool-result'`): Chunk type identifier.
360
+
361
+ **toolResults.runId** (`string`): Execution run identifier.
362
+
363
+ **toolResults.from** (`ChunkFrom`): Source of the chunk, such as AGENT or WORKFLOW.
364
+
365
+ **toolResults.payload** (`ToolResultPayload`): Tool result data.
366
+
367
+ **toolResults.payload.toolCallId** (`string`): Unique identifier for the tool call.
368
+
369
+ **toolResults.payload.toolName** (`string`): Name of the tool that produced the result.
370
+
371
+ **toolResults.payload.result** (`unknown`): Value returned by the tool.
372
+
373
+ **toolResults.payload.isError** (`boolean`): Whether the tool execution failed.
314
374
 
315
375
  **usage** (`TokenUsage`): Token usage statistics for the generation.
316
376
 
317
- **steps** (`Step[]`): Array of execution steps, useful for debugging multi-step generations.
377
+ **steps** (`object[]`): Array of execution steps, useful for debugging multi-step generations.
378
+
379
+ **steps.text** (`string`): Text generated in this step.
380
+
381
+ **steps.toolCalls** (`ToolCallChunk[]`): Tool calls emitted during this step.
382
+
383
+ **steps.toolResults** (`ToolResultChunk[]`): Tool results emitted during this step.
384
+
385
+ **steps.finishReason** (`string`): Why this step finished.
386
+
387
+ **steps.usage** (`LanguageModelUsage`): Token usage for this step.
388
+
389
+ **steps.request** (`{ body?: unknown }`): Request metadata for this step.
390
+
391
+ **steps.response** (`object`): Response metadata for this step.
318
392
 
319
393
  **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).
320
394
 
package/CHANGELOG.md CHANGED
@@ -1,5 +1,20 @@
1
1
  # @mastra/mcp-docs-server
2
2
 
3
+ ## 1.1.26-alpha.0
4
+
5
+ ### Patch Changes
6
+
7
+ - Updated dependencies [[`d63ffdb`](https://github.com/mastra-ai/mastra/commit/d63ffdbb2c11e76fe5ea45faab44bc15460f010c)]:
8
+ - @mastra/core@1.25.1-alpha.0
9
+
10
+ ## 1.1.25
11
+
12
+ ### Patch Changes
13
+
14
+ - Updated dependencies [[`87df955`](https://github.com/mastra-ai/mastra/commit/87df955c028660c075873fd5d74af28233ce32eb), [`8fad147`](https://github.com/mastra-ai/mastra/commit/8fad14759804179c8e080ce4d9dec6ef1a808b31), [`582644c`](https://github.com/mastra-ai/mastra/commit/582644c4a87f83b4f245a84d72b9e8590585012e), [`cbdf3e1`](https://github.com/mastra-ai/mastra/commit/cbdf3e12b3d0c30a6e5347be658e2009648c130a), [`8fe46d3`](https://github.com/mastra-ai/mastra/commit/8fe46d354027f3f0f0846e64219772348de106dd), [`18c67db`](https://github.com/mastra-ai/mastra/commit/18c67dbb9c9ebc26f26f65f7d3ff836e5691ef46), [`4ba3bb1`](https://github.com/mastra-ai/mastra/commit/4ba3bb1e465ad2ddaba3bbf2bc47e0faec32985e), [`5d84914`](https://github.com/mastra-ai/mastra/commit/5d84914e0e520c642a40329b210b413fcd139898), [`8dcc77e`](https://github.com/mastra-ai/mastra/commit/8dcc77e78a5340f5848f74b9e9f1b3da3513c1f5), [`aa67fc5`](https://github.com/mastra-ai/mastra/commit/aa67fc59ee8a5eeff1f23eb05970b8d7a536c8ff), [`fd2f314`](https://github.com/mastra-ai/mastra/commit/fd2f31473d3449b6b97e837ef8641264377f41a7), [`fa8140b`](https://github.com/mastra-ai/mastra/commit/fa8140bcd4251d2e3ac85fdc5547dfc4f372b5be), [`190f452`](https://github.com/mastra-ai/mastra/commit/190f45258b0640e2adfc8219fa3258cdc5b8f071), [`e80fead`](https://github.com/mastra-ai/mastra/commit/e80fead1412cc0d1b2f7d6a1ce5017d9e0098ff7), [`0287b64`](https://github.com/mastra-ai/mastra/commit/0287b644a5c3272755cf3112e71338106664103b), [`7e7bf60`](https://github.com/mastra-ai/mastra/commit/7e7bf606886bf374a6f9d4ca9b09dd83d0533372), [`184907d`](https://github.com/mastra-ai/mastra/commit/184907d775d8609c03c26e78ccaf37315f3aa287), [`075e91a`](https://github.com/mastra-ai/mastra/commit/075e91a4549baf46ad7a42a6a8ac8dfa78cc09e6), [`5cf84a3`](https://github.com/mastra-ai/mastra/commit/5cf84a3e2b7aa69b3f674a6f312f1bf0ed7ebead), [`5f3d4dd`](https://github.com/mastra-ai/mastra/commit/5f3d4ddf237241f4b238ac062ac61eadabed0770), [`0c4cd13`](https://github.com/mastra-ai/mastra/commit/0c4cd131931c04ac5405373c932a242dbe88edd6), [`b16a753`](https://github.com/mastra-ai/mastra/commit/b16a753d5748440248d7df82e29bb987a9c8386c)]:
15
+ - @mastra/core@1.25.0
16
+ - @mastra/mcp@1.5.0
17
+
3
18
  ## 1.1.25-alpha.8
4
19
 
5
20
  ### Patch Changes
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@mastra/mcp-docs-server",
3
- "version": "1.1.25-alpha.9",
3
+ "version": "1.1.26-alpha.1",
4
4
  "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
@@ -29,8 +29,8 @@
29
29
  "jsdom": "^26.1.0",
30
30
  "local-pkg": "^1.1.2",
31
31
  "zod": "^4.3.6",
32
- "@mastra/core": "1.25.0-alpha.3",
33
- "@mastra/mcp": "^1.5.0-alpha.0"
32
+ "@mastra/mcp": "^1.5.0",
33
+ "@mastra/core": "1.25.1-alpha.0"
34
34
  },
35
35
  "devDependencies": {
36
36
  "@hono/node-server": "^1.19.11",
@@ -46,9 +46,9 @@
46
46
  "tsx": "^4.21.0",
47
47
  "typescript": "^5.9.3",
48
48
  "vitest": "4.0.18",
49
- "@internal/lint": "0.0.82",
50
- "@internal/types-builder": "0.0.57",
51
- "@mastra/core": "1.25.0-alpha.3"
49
+ "@internal/lint": "0.0.83",
50
+ "@internal/types-builder": "0.0.58",
51
+ "@mastra/core": "1.25.1-alpha.0"
52
52
  },
53
53
  "homepage": "https://mastra.ai",
54
54
  "repository": {