@mastra/mcp-docs-server 1.2.6-alpha.2 → 1.2.6
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.
- package/.docs/docs/agents/agent-approval.md +23 -0
- package/.docs/docs/agents/skills.md +3 -1
- package/.docs/models/gateways/openrouter.md +1 -3
- package/.docs/models/index.md +1 -1
- package/.docs/models/providers/deepinfra.md +1 -1
- package/.docs/models/providers/kilo.md +2 -1
- package/.docs/models/providers/llmgateway.md +1 -3
- package/.docs/models/providers/opencode.md +2 -1
- package/.docs/models/providers/vivgrid.md +2 -1
- package/.docs/models/providers/vultr.md +8 -5
- package/.docs/models/providers/xpersona.md +5 -4
- package/.docs/reference/core/mastra-class.md +1 -1
- package/CHANGELOG.md +14 -0
- package/package.json +9 -9
|
@@ -110,6 +110,29 @@ A tool can also pause _during_ its `execute` function by calling `suspend()`. Th
|
|
|
110
110
|
|
|
111
111
|
The stream emits a `tool-call-suspended` chunk with a custom payload defined by the tool's `suspendSchema`. You resume by calling `resumeStream()` with data matching the tool's `resumeSchema`.
|
|
112
112
|
|
|
113
|
+
```typescript
|
|
114
|
+
const weatherTool = createTool({
|
|
115
|
+
id: 'get-weather',
|
|
116
|
+
inputSchema: z.object({
|
|
117
|
+
location: z.string().optional(),
|
|
118
|
+
}),
|
|
119
|
+
suspendSchema: z.object({
|
|
120
|
+
question: z.string(),
|
|
121
|
+
}),
|
|
122
|
+
resumeSchema: z.object({
|
|
123
|
+
location: z.string(),
|
|
124
|
+
}),
|
|
125
|
+
execute: async ({ location }, context) => {
|
|
126
|
+
if (!location) {
|
|
127
|
+
return await context?.agent?.suspend({
|
|
128
|
+
question: 'Which city would you like the weather for?',
|
|
129
|
+
})
|
|
130
|
+
}
|
|
131
|
+
return await fetchWeather(location)
|
|
132
|
+
},
|
|
133
|
+
})
|
|
134
|
+
```
|
|
135
|
+
|
|
113
136
|
> **Note:** `suspend()` doesn't throw — return immediately after calling it (e.g. `return await suspend({ ... })`). Code after `await suspend(...)` still runs before the tool pauses.
|
|
114
137
|
|
|
115
138
|
## Tool approval with `generate()`
|
|
@@ -129,6 +129,8 @@ export const agent = new Agent({
|
|
|
129
129
|
|
|
130
130
|
The resolver function receives `{ requestContext }` and returns a `SkillInput[]` array or a `Promise<SkillInput[]>`.
|
|
131
131
|
|
|
132
|
+
See [Request Context](https://mastra.ai/docs/server/request-context) for more on using request context with agents and workflows.
|
|
133
|
+
|
|
132
134
|
## Merging with workspace skills
|
|
133
135
|
|
|
134
136
|
When an agent has both `skills` and a workspace with skills configured, they merge. Agent-level skills take precedence on name conflicts:
|
|
@@ -149,7 +151,7 @@ const customReview = createSkill({
|
|
|
149
151
|
instructions: '...',
|
|
150
152
|
})
|
|
151
153
|
|
|
152
|
-
export const
|
|
154
|
+
export const reviewer = new Agent({
|
|
153
155
|
id: 'reviewer',
|
|
154
156
|
model: 'openai/gpt-5.5',
|
|
155
157
|
workspace,
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# OpenRouter
|
|
4
4
|
|
|
5
|
-
OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access
|
|
5
|
+
OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 340 models through Mastra's model router.
|
|
6
6
|
|
|
7
7
|
Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
|
|
8
8
|
|
|
@@ -46,8 +46,6 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
46
46
|
| `~openai/gpt-latest` |
|
|
47
47
|
| `~openai/gpt-mini-latest` |
|
|
48
48
|
| `ai21/jamba-large-1.7` |
|
|
49
|
-
| `aion-labs/aion-1.0` |
|
|
50
|
-
| `aion-labs/aion-1.0-mini` |
|
|
51
49
|
| `aion-labs/aion-2.0` |
|
|
52
50
|
| `aion-labs/aion-rp-llama-3.1-8b` |
|
|
53
51
|
| `allenai/olmo-3-32b-think` |
|
package/.docs/models/index.md
CHANGED
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Model Providers
|
|
4
4
|
|
|
5
|
-
Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to
|
|
5
|
+
Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 4565 models from 140 providers through a single API.
|
|
6
6
|
|
|
7
7
|
## Features
|
|
8
8
|
|
|
@@ -58,7 +58,7 @@ for await (const chunk of stream) {
|
|
|
58
58
|
| `deepinfra/Qwen/Qwen3-Coder-480B-A35B-Instruct-Turbo` | 262K | | | | | | $0.30 | $1 |
|
|
59
59
|
| `deepinfra/Qwen/Qwen3-Max` | 256K | | | | | | $1 | $6 |
|
|
60
60
|
| `deepinfra/Qwen/Qwen3-Next-80B-A3B-Instruct` | 262K | | | | | | $0.09 | $1 |
|
|
61
|
-
| `deepinfra/Qwen/Qwen3.5-122B-A10B` |
|
|
61
|
+
| `deepinfra/Qwen/Qwen3.5-122B-A10B` | 262K | | | | | | $0.29 | $2 |
|
|
62
62
|
| `deepinfra/Qwen/Qwen3.5-27B` | 262K | | | | | | $0.26 | $3 |
|
|
63
63
|
| `deepinfra/Qwen/Qwen3.5-35B-A3B` | 262K | | | | | | $0.14 | $1 |
|
|
64
64
|
| `deepinfra/Qwen/Qwen3.5-397B-A17B` | 262K | | | | | | $0.45 | $3 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Kilo Gateway
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 346 Kilo Gateway models through Mastra's model router. Authentication is handled automatically using the `KILO_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [Kilo Gateway documentation](https://kilo.ai).
|
|
8
8
|
|
|
@@ -171,6 +171,7 @@ for await (const chunk of stream) {
|
|
|
171
171
|
| `kilo/minimax/minimax-m2.1` | 197K | | | | | | $0.27 | $0.95 |
|
|
172
172
|
| `kilo/minimax/minimax-m2.5` | 197K | | | | | | $0.25 | $1 |
|
|
173
173
|
| `kilo/minimax/minimax-m2.7` | 205K | | | | | | $0.30 | $1 |
|
|
174
|
+
| `kilo/minimax/minimax-m3` | 1.0M | | | | | | $0.30 | $1 |
|
|
174
175
|
| `kilo/mistralai/codestral-2508` | 256K | | | | | | $0.30 | $0.90 |
|
|
175
176
|
| `kilo/mistralai/devstral-2512` | 262K | | | | | | $0.40 | $2 |
|
|
176
177
|
| `kilo/mistralai/devstral-medium` | 131K | | | | | | $0.40 | $2 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# LLM Gateway
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 178 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [LLM Gateway documentation](https://llmgateway.io/docs).
|
|
8
8
|
|
|
@@ -37,8 +37,6 @@ for await (const chunk of stream) {
|
|
|
37
37
|
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
38
|
| -------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
39
|
| `llmgateway/auto` | 128K | | | | | | — | — |
|
|
40
|
-
| `llmgateway/claude-3-7-sonnet` | 200K | | | | | | $3 | $15 |
|
|
41
|
-
| `llmgateway/claude-3-7-sonnet-20250219` | 200K | | | | | | $3 | $15 |
|
|
42
40
|
| `llmgateway/claude-3-opus` | 200K | | | | | | $15 | $75 |
|
|
43
41
|
| `llmgateway/claude-fable-5` | 1.0M | | | | | | $10 | $50 |
|
|
44
42
|
| `llmgateway/claude-haiku-4-5` | 200K | | | | | | $1 | $5 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# OpenCode Zen
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 51 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [OpenCode Zen documentation](https://opencode.ai/docs/zen).
|
|
8
8
|
|
|
@@ -75,6 +75,7 @@ for await (const chunk of stream) {
|
|
|
75
75
|
| `opencode/gpt-5.5` | 1.1M | | | | | | $5 | $30 |
|
|
76
76
|
| `opencode/gpt-5.5-pro` | 1.1M | | | | | | $30 | $180 |
|
|
77
77
|
| `opencode/grok-build-0.1` | 256K | | | | | | $1 | $2 |
|
|
78
|
+
| `opencode/hy3-free` | 256K | | | | | | — | — |
|
|
78
79
|
| `opencode/kimi-k2.5` | 262K | | | | | | $0.60 | $3 |
|
|
79
80
|
| `opencode/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
|
|
80
81
|
| `opencode/kimi-k2.7-code` | 262K | | | | | | $0.95 | $4 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Vivgrid
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 14 Vivgrid models through Mastra's model router. Authentication is handled automatically using the `VIVGRID_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [Vivgrid documentation](https://docs.vivgrid.com/models).
|
|
8
8
|
|
|
@@ -40,6 +40,7 @@ for await (const chunk of stream) {
|
|
|
40
40
|
| `vivgrid/deepseek-v4-pro` | 1.0M | | | | | | $0.43 | $0.87 |
|
|
41
41
|
| `vivgrid/gemini-3.1-flash-lite-preview` | 1.0M | | | | | | $0.25 | $2 |
|
|
42
42
|
| `vivgrid/gemini-3.1-pro-preview` | 1.0M | | | | | | $2 | $12 |
|
|
43
|
+
| `vivgrid/glm-5.2` | 1.0M | | | | | | $1 | $4 |
|
|
43
44
|
| `vivgrid/gpt-5-mini` | 272K | | | | | | $0.25 | $2 |
|
|
44
45
|
| `vivgrid/gpt-5.1-codex` | 400K | | | | | | $1 | $10 |
|
|
45
46
|
| `vivgrid/gpt-5.1-codex-max` | 400K | | | | | | $1 | $10 |
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Vultr
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 10 Vultr models through Mastra's model router. Authentication is handled automatically using the `VULTR_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [Vultr documentation](https://api.vultrinference.com/).
|
|
8
8
|
|
|
@@ -36,13 +36,16 @@ for await (const chunk of stream) {
|
|
|
36
36
|
|
|
37
37
|
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
38
|
| ---------------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
|
+
| `vultr/deepseek-ai/DeepSeek-V4-Flash` | 1.0M | | | | | | $0.30 | $1 |
|
|
39
40
|
| `vultr/MiniMaxAI/MiniMax-M2.7` | 205K | | | | | | $0.30 | $1 |
|
|
40
|
-
| `vultr/moonshotai/Kimi-K2.6` | 262K | | | | | | $0.
|
|
41
|
+
| `vultr/moonshotai/Kimi-K2.6` | 262K | | | | | | $0.30 | $1 |
|
|
41
42
|
| `vultr/nvidia/DeepSeek-V3.2-NVFP4` | 131K | | | | | | $0.55 | $2 |
|
|
42
|
-
| `vultr/nvidia/Llama-3.1-Nemotron-Safety-Guard-8B-v3` | 8K | | | | | | $0.01 | $0.01 |
|
|
43
43
|
| `vultr/nvidia/Nemotron-3-Nano-Omni-30B-A3B-Reasoning-BF16` | 262K | | | | | | $0.13 | $0.38 |
|
|
44
44
|
| `vultr/nvidia/Nemotron-Cascade-2-30B-A3B` | 262K | | | | | | $0.15 | $0.60 |
|
|
45
|
-
| `vultr/
|
|
45
|
+
| `vultr/Qwen/Qwen3.5-397B-A17B` | 262K | | | | | | $0.30 | $2 |
|
|
46
|
+
| `vultr/Qwen/Qwen3.6-27B` | 262K | | | | | | $0.30 | $2 |
|
|
47
|
+
| `vultr/XiaomiMiMo/MiMo-V2.5-Pro` | 1.0M | | | | | | $0.55 | $2 |
|
|
48
|
+
| `vultr/zai-org/GLM-5.2-FP8` | 393K | | | | | | $0.85 | $3 |
|
|
46
49
|
|
|
47
50
|
## Advanced configuration
|
|
48
51
|
|
|
@@ -72,7 +75,7 @@ const agent = new Agent({
|
|
|
72
75
|
model: ({ requestContext }) => {
|
|
73
76
|
const useAdvanced = requestContext.task === "complex";
|
|
74
77
|
return useAdvanced
|
|
75
|
-
? "vultr/zai-org/GLM-5.
|
|
78
|
+
? "vultr/zai-org/GLM-5.2-FP8"
|
|
76
79
|
: "vultr/MiniMaxAI/MiniMax-M2.7";
|
|
77
80
|
}
|
|
78
81
|
});
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
# Xpersona
|
|
4
4
|
|
|
5
|
-
Access
|
|
5
|
+
Access 3 Xpersona models through Mastra's model router. Authentication is handled automatically using the `XPERSONA_API_KEY` environment variable.
|
|
6
6
|
|
|
7
7
|
Learn more in the [Xpersona documentation](https://www.xpersona.co/docs).
|
|
8
8
|
|
|
@@ -17,7 +17,7 @@ const agent = new Agent({
|
|
|
17
17
|
id: "my-agent",
|
|
18
18
|
name: "My Agent",
|
|
19
19
|
instructions: "You are a helpful assistant",
|
|
20
|
-
model: "xpersona/
|
|
20
|
+
model: "xpersona/claude-fable-5"
|
|
21
21
|
});
|
|
22
22
|
|
|
23
23
|
// Generate a response
|
|
@@ -36,6 +36,7 @@ for await (const chunk of stream) {
|
|
|
36
36
|
|
|
37
37
|
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
38
38
|
| --------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
39
|
+
| `xpersona/claude-fable-5` | 1.0M | | | | | | $3 | $18 |
|
|
39
40
|
| `xpersona/xpersona-frieren-coder` | 1.0M | | | | | | $2 | $6 |
|
|
40
41
|
| `xpersona/xpersona-gpt-5.5` | 1.0M | | | | | | $3 | $18 |
|
|
41
42
|
|
|
@@ -49,7 +50,7 @@ const agent = new Agent({
|
|
|
49
50
|
name: "custom-agent",
|
|
50
51
|
model: {
|
|
51
52
|
url: "https://www.xpersona.co/v1",
|
|
52
|
-
id: "xpersona/
|
|
53
|
+
id: "xpersona/claude-fable-5",
|
|
53
54
|
apiKey: process.env.XPERSONA_API_KEY,
|
|
54
55
|
headers: {
|
|
55
56
|
"X-Custom-Header": "value"
|
|
@@ -68,7 +69,7 @@ const agent = new Agent({
|
|
|
68
69
|
const useAdvanced = requestContext.task === "complex";
|
|
69
70
|
return useAdvanced
|
|
70
71
|
? "xpersona/xpersona-gpt-5.5"
|
|
71
|
-
: "xpersona/
|
|
72
|
+
: "xpersona/claude-fable-5";
|
|
72
73
|
}
|
|
73
74
|
});
|
|
74
75
|
```
|
|
@@ -45,7 +45,7 @@ export const mastra = new Mastra({
|
|
|
45
45
|
})
|
|
46
46
|
```
|
|
47
47
|
|
|
48
|
-
`notifications.dispatch.enabled`
|
|
48
|
+
`notifications.dispatch.enabled` allows an internal dispatcher workflow to run with the default cron `*/1 * * * *`. The dispatcher reads due notification records from storage, groups summaries by `agentId`, `resourceId`, and `threadId`, and emits signals through the agent thread runtime. It isn't a user-facing entrypoint. The dispatch schedule (and the workflow scheduler backing it) activates lazily on the first deferred or summarized notification, so apps that never defer notifications don't run a scheduler at all.
|
|
49
49
|
|
|
50
50
|
## Constructor parameters
|
|
51
51
|
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
# @mastra/mcp-docs-server
|
|
2
2
|
|
|
3
|
+
## 1.2.6
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies [[`e900f25`](https://github.com/mastra-ai/mastra/commit/e900f25dfe2c9237f15b26cb109ac55aa9de3000), [`e8eaf3a`](https://github.com/mastra-ai/mastra/commit/e8eaf3aea09d51c131b5d369aee459442f416efc), [`d1c930f`](https://github.com/mastra-ai/mastra/commit/d1c930f713d1de09d5f3cd665cb79a8b7ebd7ec7), [`02634f7`](https://github.com/mastra-ai/mastra/commit/02634f700051e014a125d0d10165e3c9b8414e95), [`a940148`](https://github.com/mastra-ai/mastra/commit/a9401483e1bfe85c18a6e73d33c5949239d65a92)]:
|
|
8
|
+
- @mastra/core@1.50.1
|
|
9
|
+
|
|
10
|
+
## 1.2.6-alpha.3
|
|
11
|
+
|
|
12
|
+
### Patch Changes
|
|
13
|
+
|
|
14
|
+
- Updated dependencies [[`a940148`](https://github.com/mastra-ai/mastra/commit/a9401483e1bfe85c18a6e73d33c5949239d65a92)]:
|
|
15
|
+
- @mastra/core@1.50.1-alpha.2
|
|
16
|
+
|
|
3
17
|
## 1.2.6-alpha.2
|
|
4
18
|
|
|
5
19
|
### Patch Changes
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/mcp-docs-server",
|
|
3
|
-
"version": "1.2.6
|
|
3
|
+
"version": "1.2.6",
|
|
4
4
|
"description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -28,15 +28,15 @@
|
|
|
28
28
|
"jsdom": "^26.1.0",
|
|
29
29
|
"local-pkg": "^1.1.2",
|
|
30
30
|
"zod": "^4.4.3",
|
|
31
|
-
"@mastra/
|
|
32
|
-
"@mastra/
|
|
31
|
+
"@mastra/mcp": "^1.13.1",
|
|
32
|
+
"@mastra/core": "1.50.1"
|
|
33
33
|
},
|
|
34
34
|
"devDependencies": {
|
|
35
35
|
"@hono/node-server": "^1.19.11",
|
|
36
36
|
"@types/jsdom": "^21.1.7",
|
|
37
37
|
"@types/node": "22.19.21",
|
|
38
|
-
"@vitest/coverage-v8": "4.1.
|
|
39
|
-
"@vitest/ui": "4.1.
|
|
38
|
+
"@vitest/coverage-v8": "4.1.9",
|
|
39
|
+
"@vitest/ui": "4.1.9",
|
|
40
40
|
"@wong2/mcp-cli": "^2.0.0",
|
|
41
41
|
"cross-env": "^10.1.0",
|
|
42
42
|
"eslint": "^10.4.1",
|
|
@@ -44,10 +44,10 @@
|
|
|
44
44
|
"tsup": "^8.5.1",
|
|
45
45
|
"tsx": "^4.22.4",
|
|
46
46
|
"typescript": "^6.0.3",
|
|
47
|
-
"vitest": "4.1.
|
|
48
|
-
"@internal/
|
|
49
|
-
"@
|
|
50
|
-
"@
|
|
47
|
+
"vitest": "4.1.9",
|
|
48
|
+
"@internal/types-builder": "0.0.88",
|
|
49
|
+
"@internal/lint": "0.0.113",
|
|
50
|
+
"@mastra/core": "1.50.1"
|
|
51
51
|
},
|
|
52
52
|
"homepage": "https://mastra.ai",
|
|
53
53
|
"repository": {
|