@mastra/mcp-docs-server 1.1.22-alpha.0 → 1.1.22-alpha.11
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/server/mastra-client.md +2 -2
- package/.docs/docs/server/mastra-server.md +1 -1
- package/.docs/models/gateways/openrouter.md +4 -2
- package/.docs/models/gateways/vercel.md +7 -2
- package/.docs/models/index.md +1 -1
- package/.docs/models/providers/alibaba-cn.md +3 -2
- package/.docs/models/providers/alibaba-coding-plan-cn.md +3 -2
- package/.docs/models/providers/alibaba-coding-plan.md +3 -2
- package/.docs/models/providers/alibaba.md +2 -1
- package/.docs/models/providers/deepseek.md +1 -1
- package/.docs/models/providers/google.md +4 -2
- package/.docs/models/providers/nvidia.md +2 -1
- package/.docs/models/providers/togetherai.md +1 -5
- package/.docs/models/providers/vivgrid.md +5 -2
- package/.docs/models/providers/vultr.md +7 -6
- package/.docs/models/providers/xiaomi-token-plan-ams.md +73 -0
- package/.docs/models/providers/xiaomi-token-plan-cn.md +73 -0
- package/.docs/models/providers/xiaomi-token-plan-sgp.md +73 -0
- package/.docs/models/providers/zenmux.md +5 -2
- package/.docs/models/providers.md +3 -0
- package/.docs/reference/client-js/conversations.md +1 -1
- package/.docs/reference/client-js/responses.md +1 -1
- package/.docs/reference/templates/overview.md +88 -14
- package/CHANGELOG.md +49 -0
- package/package.json +4 -4
|
@@ -61,8 +61,8 @@ The Mastra Client SDK exposes all resources served by the Mastra Server.
|
|
|
61
61
|
- **[Tools](https://mastra.ai/reference/client-js/tools)**: Executed and managed tools.
|
|
62
62
|
- **[Workflows](https://mastra.ai/reference/client-js/workflows)**: Trigger workflows and track their execution.
|
|
63
63
|
- **[Vectors](https://mastra.ai/reference/client-js/vectors)**: Use vector embeddings for semantic search.
|
|
64
|
-
- **[Responses](https://mastra.ai/reference/client-js/responses)**:
|
|
65
|
-
- **[Conversations](https://mastra.ai/reference/client-js/conversations)**: Work with
|
|
64
|
+
- **[Responses](https://mastra.ai/reference/client-js/responses)**: Use Mastra Agents as a Responses API with an OpenAI-compatible, agent-backed interface. This API is currently experimental.
|
|
65
|
+
- **[Conversations](https://mastra.ai/reference/client-js/conversations)**: Work with the stored conversation threads and item history behind Mastra Agents as a Responses API. This API is currently experimental.
|
|
66
66
|
- **[Logs](https://mastra.ai/reference/client-js/logs)**: View logs and debug system behavior.
|
|
67
67
|
- **[Telemetry](https://mastra.ai/reference/client-js/telemetry)**: View app performance and trace activity.
|
|
68
68
|
|
|
@@ -53,7 +53,7 @@ To explore the API interactively, visit the Swagger UI at <http://localhost:4111
|
|
|
53
53
|
|
|
54
54
|
## OpenAI Responses API
|
|
55
55
|
|
|
56
|
-
Mastra exposes OpenAI-compatible Responses and Conversations routes. These routes are agent-backed adapters over Mastra agents, memory, and storage, so requests run through the selected Mastra agent instead of acting as a raw provider proxy.
|
|
56
|
+
Mastra exposes OpenAI-compatible Responses and Conversations routes that let you use Mastra Agents as a Responses API. These routes are agent-backed adapters over Mastra agents, memory, and storage, so requests run through the selected Mastra agent instead of acting as a raw provider proxy.
|
|
57
57
|
|
|
58
58
|
These APIs are currently experimental.
|
|
59
59
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# OpenRouter
|
|
2
2
|
|
|
3
|
-
OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access
|
|
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
|
|
|
@@ -45,6 +45,7 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
45
45
|
| `anthropic/claude-sonnet-4.5` |
|
|
46
46
|
| `anthropic/claude-sonnet-4.6` |
|
|
47
47
|
| `arcee-ai/trinity-large-preview:free` |
|
|
48
|
+
| `arcee-ai/trinity-large-thinking` |
|
|
48
49
|
| `arcee-ai/trinity-mini:free` |
|
|
49
50
|
| `black-forest-labs/flux.2-flex` |
|
|
50
51
|
| `black-forest-labs/flux.2-klein-4b` |
|
|
@@ -82,6 +83,8 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
82
83
|
| `google/gemma-3n-e2b-it:free` |
|
|
83
84
|
| `google/gemma-3n-e4b-it` |
|
|
84
85
|
| `google/gemma-3n-e4b-it:free` |
|
|
86
|
+
| `google/gemma-4-26b-a4b-it` |
|
|
87
|
+
| `google/gemma-4-31b-it` |
|
|
85
88
|
| `inception/mercury` |
|
|
86
89
|
| `inception/mercury-2` |
|
|
87
90
|
| `inception/mercury-coder` |
|
|
@@ -172,7 +175,6 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
172
175
|
| `qwen/qwen3-next-80b-a3b-thinking` |
|
|
173
176
|
| `qwen/qwen3.5-397b-a17b` |
|
|
174
177
|
| `qwen/qwen3.5-plus-02-15` |
|
|
175
|
-
| `qwen/qwen3.6-plus-preview:free` |
|
|
176
178
|
| `qwen/qwen3.6-plus:free` |
|
|
177
179
|
| `sourceful/riverflow-v2-fast-preview` |
|
|
178
180
|
| `sourceful/riverflow-v2-max-preview` |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Vercel
|
|
2
2
|
|
|
3
|
-
Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access
|
|
3
|
+
Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 231 models through Mastra's model router.
|
|
4
4
|
|
|
5
5
|
Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
|
|
6
6
|
|
|
@@ -55,6 +55,7 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
55
55
|
| `alibaba/qwen3-vl-thinking` |
|
|
56
56
|
| `alibaba/qwen3.5-flash` |
|
|
57
57
|
| `alibaba/qwen3.5-plus` |
|
|
58
|
+
| `alibaba/qwen3.6-plus` |
|
|
58
59
|
| `amazon/nova-2-lite` |
|
|
59
60
|
| `amazon/nova-lite` |
|
|
60
61
|
| `amazon/nova-micro` |
|
|
@@ -75,6 +76,7 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
75
76
|
| `anthropic/claude-sonnet-4.5` |
|
|
76
77
|
| `anthropic/claude-sonnet-4.6` |
|
|
77
78
|
| `arcee-ai/trinity-large-preview` |
|
|
79
|
+
| `arcee-ai/trinity-large-thinking` |
|
|
78
80
|
| `arcee-ai/trinity-mini` |
|
|
79
81
|
| `bfl/flux-kontext-max` |
|
|
80
82
|
| `bfl/flux-kontext-pro` |
|
|
@@ -109,6 +111,8 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
109
111
|
| `google/gemini-3.1-pro-preview` |
|
|
110
112
|
| `google/gemini-embedding-001` |
|
|
111
113
|
| `google/gemini-embedding-2` |
|
|
114
|
+
| `google/gemma-4-26b-a4b-it` |
|
|
115
|
+
| `google/gemma-4-31b-it` |
|
|
112
116
|
| `google/imagen-4.0-fast-generate-001` |
|
|
113
117
|
| `google/imagen-4.0-generate-001` |
|
|
114
118
|
| `google/imagen-4.0-ultra-generate-001` |
|
|
@@ -259,4 +263,5 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
259
263
|
| `zai/glm-4.7-flash` |
|
|
260
264
|
| `zai/glm-4.7-flashx` |
|
|
261
265
|
| `zai/glm-5` |
|
|
262
|
-
| `zai/glm-5-turbo` |
|
|
266
|
+
| `zai/glm-5-turbo` |
|
|
267
|
+
| `zai/glm-5v-turbo` |
|
package/.docs/models/index.md
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Model Providers
|
|
2
2
|
|
|
3
|
-
Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to
|
|
3
|
+
Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 3607 models from 98 providers through a single API.
|
|
4
4
|
|
|
5
5
|
## Features
|
|
6
6
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Alibaba (China)
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 75 Alibaba (China) models through Mastra's model router. Authentication is handled automatically using the `DASHSCOPE_API_KEY` environment variable.
|
|
4
4
|
|
|
5
5
|
Learn more in the [Alibaba (China) documentation](https://www.alibabacloud.com/help/en/model-studio/models).
|
|
6
6
|
|
|
@@ -50,7 +50,7 @@ for await (const chunk of stream) {
|
|
|
50
50
|
| `alibaba-cn/kimi-k2.5` | 262K | | | | | | $0.57 | $2 |
|
|
51
51
|
| `alibaba-cn/kimi/kimi-k2.5` | 262K | | | | | | $0.60 | $3 |
|
|
52
52
|
| `alibaba-cn/MiniMax-M2.5` | 205K | | | | | | $0.30 | $1 |
|
|
53
|
-
| `alibaba-cn/MiniMax/MiniMax-M2.
|
|
53
|
+
| `alibaba-cn/MiniMax/MiniMax-M2.7` | 205K | | | | | | $0.30 | $1 |
|
|
54
54
|
| `alibaba-cn/moonshot-kimi-k2-instruct` | 131K | | | | | | $0.57 | $2 |
|
|
55
55
|
| `alibaba-cn/qvq-max` | 131K | | | | | | $1 | $5 |
|
|
56
56
|
| `alibaba-cn/qwen-deep-research` | 1.0M | | | | | | $8 | $23 |
|
|
@@ -101,6 +101,7 @@ for await (const chunk of stream) {
|
|
|
101
101
|
| `alibaba-cn/qwen3.5-397b-a17b` | 262K | | | | | | $0.43 | $3 |
|
|
102
102
|
| `alibaba-cn/qwen3.5-flash` | 1.0M | | | | | | $0.17 | $2 |
|
|
103
103
|
| `alibaba-cn/qwen3.5-plus` | 1.0M | | | | | | $0.57 | $3 |
|
|
104
|
+
| `alibaba-cn/qwen3.6-plus` | 1.0M | | | | | | $0.28 | $2 |
|
|
104
105
|
| `alibaba-cn/qwq-32b` | 131K | | | | | | $0.29 | $0.86 |
|
|
105
106
|
| `alibaba-cn/qwq-plus` | 131K | | | | | | $0.23 | $0.57 |
|
|
106
107
|
| `alibaba-cn/siliconflow/deepseek-r1-0528` | 164K | | | | | | $0.50 | $2 |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Alibaba Coding Plan (China)
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 9 Alibaba Coding Plan (China) models through Mastra's model router. Authentication is handled automatically using the `ALIBABA_CODING_PLAN_API_KEY` environment variable.
|
|
4
4
|
|
|
5
5
|
Learn more in the [Alibaba Coding Plan (China) documentation](https://help.aliyun.com/zh/model-studio/coding-plan).
|
|
6
6
|
|
|
@@ -42,6 +42,7 @@ for await (const chunk of stream) {
|
|
|
42
42
|
| `alibaba-coding-plan-cn/qwen3-coder-plus` | 1.0M | | | | | | — | — |
|
|
43
43
|
| `alibaba-coding-plan-cn/qwen3-max-2026-01-23` | 262K | | | | | | — | — |
|
|
44
44
|
| `alibaba-coding-plan-cn/qwen3.5-plus` | 1.0M | | | | | | — | — |
|
|
45
|
+
| `alibaba-coding-plan-cn/qwen3.6-plus` | 1.0M | | | | | | — | — |
|
|
45
46
|
|
|
46
47
|
## Advanced configuration
|
|
47
48
|
|
|
@@ -71,7 +72,7 @@ const agent = new Agent({
|
|
|
71
72
|
model: ({ requestContext }) => {
|
|
72
73
|
const useAdvanced = requestContext.task === "complex";
|
|
73
74
|
return useAdvanced
|
|
74
|
-
? "alibaba-coding-plan-cn/qwen3.
|
|
75
|
+
? "alibaba-coding-plan-cn/qwen3.6-plus"
|
|
75
76
|
: "alibaba-coding-plan-cn/MiniMax-M2.5";
|
|
76
77
|
}
|
|
77
78
|
});
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Alibaba Coding Plan
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 9 Alibaba Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ALIBABA_CODING_PLAN_API_KEY` environment variable.
|
|
4
4
|
|
|
5
5
|
Learn more in the [Alibaba Coding Plan documentation](https://www.alibabacloud.com/help/en/model-studio/coding-plan).
|
|
6
6
|
|
|
@@ -42,6 +42,7 @@ for await (const chunk of stream) {
|
|
|
42
42
|
| `alibaba-coding-plan/qwen3-coder-plus` | 1.0M | | | | | | — | — |
|
|
43
43
|
| `alibaba-coding-plan/qwen3-max-2026-01-23` | 262K | | | | | | — | — |
|
|
44
44
|
| `alibaba-coding-plan/qwen3.5-plus` | 1.0M | | | | | | — | — |
|
|
45
|
+
| `alibaba-coding-plan/qwen3.6-plus` | 1.0M | | | | | | — | — |
|
|
45
46
|
|
|
46
47
|
## Advanced configuration
|
|
47
48
|
|
|
@@ -71,7 +72,7 @@ const agent = new Agent({
|
|
|
71
72
|
model: ({ requestContext }) => {
|
|
72
73
|
const useAdvanced = requestContext.task === "complex";
|
|
73
74
|
return useAdvanced
|
|
74
|
-
? "alibaba-coding-plan/qwen3.
|
|
75
|
+
? "alibaba-coding-plan/qwen3.6-plus"
|
|
75
76
|
: "alibaba-coding-plan/MiniMax-M2.5";
|
|
76
77
|
}
|
|
77
78
|
});
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Alibaba
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 42 Alibaba models through Mastra's model router. Authentication is handled automatically using the `DASHSCOPE_API_KEY` environment variable.
|
|
4
4
|
|
|
5
5
|
Learn more in the [Alibaba documentation](https://www.alibabacloud.com/help/en/model-studio/models).
|
|
6
6
|
|
|
@@ -74,6 +74,7 @@ for await (const chunk of stream) {
|
|
|
74
74
|
| `alibaba/qwen3-vl-plus` | 262K | | | | | | $0.20 | $2 |
|
|
75
75
|
| `alibaba/qwen3.5-397b-a17b` | 262K | | | | | | $0.60 | $4 |
|
|
76
76
|
| `alibaba/qwen3.5-plus` | 1.0M | | | | | | $0.40 | $2 |
|
|
77
|
+
| `alibaba/qwen3.6-plus` | 1.0M | | | | | | $0.28 | $2 |
|
|
77
78
|
| `alibaba/qwq-plus` | 131K | | | | | | $0.80 | $2 |
|
|
78
79
|
|
|
79
80
|
## Advanced configuration
|
|
@@ -32,7 +32,7 @@ for await (const chunk of stream) {
|
|
|
32
32
|
|
|
33
33
|
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
34
34
|
| ---------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
35
|
-
| `deepseek/deepseek-chat` |
|
|
35
|
+
| `deepseek/deepseek-chat` | 131K | | | | | | $0.28 | $0.42 |
|
|
36
36
|
| `deepseek/deepseek-reasoner` | 128K | | | | | | $0.28 | $0.42 |
|
|
37
37
|
|
|
38
38
|
## Advanced configuration
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Google
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 37 Google models through Mastra's model router. Authentication is handled automatically using the `GOOGLE_GENERATIVE_AI_API_KEY` environment variable.
|
|
4
4
|
|
|
5
5
|
Learn more in the [Google documentation](https://ai.google.dev/gemini-api/docs/pricing).
|
|
6
6
|
|
|
@@ -67,6 +67,8 @@ for await (const chunk of stream) {
|
|
|
67
67
|
| `google/gemma-3-4b-it` | 33K | | | | | | — | — |
|
|
68
68
|
| `google/gemma-3n-e2b-it` | 8K | | | | | | — | — |
|
|
69
69
|
| `google/gemma-3n-e4b-it` | 8K | | | | | | — | — |
|
|
70
|
+
| `google/gemma-4-26b-it` | 256K | | | | | | — | — |
|
|
71
|
+
| `google/gemma-4-31b-it` | 256K | | | | | | — | — |
|
|
70
72
|
|
|
71
73
|
## Advanced configuration
|
|
72
74
|
|
|
@@ -95,7 +97,7 @@ const agent = new Agent({
|
|
|
95
97
|
model: ({ requestContext }) => {
|
|
96
98
|
const useAdvanced = requestContext.task === "complex";
|
|
97
99
|
return useAdvanced
|
|
98
|
-
? "google/gemma-
|
|
100
|
+
? "google/gemma-4-31b-it"
|
|
99
101
|
: "google/gemini-1.5-flash";
|
|
100
102
|
}
|
|
101
103
|
});
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Nvidia
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 75 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
|
|
|
@@ -50,6 +50,7 @@ for await (const chunk of stream) {
|
|
|
50
50
|
| `nvidia/google/gemma-3-27b-it` | 131K | | | | | | — | — |
|
|
51
51
|
| `nvidia/google/gemma-3n-e2b-it` | 128K | | | | | | — | — |
|
|
52
52
|
| `nvidia/google/gemma-3n-e4b-it` | 128K | | | | | | — | — |
|
|
53
|
+
| `nvidia/google/gemma-4-31b-it` | 256K | | | | | | — | — |
|
|
53
54
|
| `nvidia/meta/codellama-70b` | 128K | | | | | | — | — |
|
|
54
55
|
| `nvidia/meta/llama-3.1-405b-instruct` | 128K | | | | | | — | — |
|
|
55
56
|
| `nvidia/meta/llama-3.1-70b-instruct` | 128K | | | | | | — | — |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Together AI
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 13 Together AI models through Mastra's model router. Authentication is handled automatically using the `TOGETHER_API_KEY` environment variable.
|
|
4
4
|
|
|
5
5
|
Learn more in the [Together AI documentation](https://docs.together.ai/docs/serverless-models).
|
|
6
6
|
|
|
@@ -38,16 +38,12 @@ for await (const chunk of stream) {
|
|
|
38
38
|
| `togetherai/essentialai/Rnj-1-Instruct` | 33K | | | | | | $0.15 | $0.15 |
|
|
39
39
|
| `togetherai/meta-llama/Llama-3.3-70B-Instruct-Turbo` | 131K | | | | | | $0.88 | $0.88 |
|
|
40
40
|
| `togetherai/MiniMaxAI/MiniMax-M2.5` | 205K | | | | | | $0.30 | $1 |
|
|
41
|
-
| `togetherai/moonshotai/Kimi-K2-Instruct` | 131K | | | | | | $1 | $3 |
|
|
42
41
|
| `togetherai/moonshotai/Kimi-K2.5` | 262K | | | | | | $0.50 | $3 |
|
|
43
42
|
| `togetherai/openai/gpt-oss-120b` | 131K | | | | | | $0.15 | $0.60 |
|
|
44
43
|
| `togetherai/Qwen/Qwen3-235B-A22B-Instruct-2507-tput` | 262K | | | | | | $0.20 | $0.60 |
|
|
45
44
|
| `togetherai/Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8` | 262K | | | | | | $2 | $2 |
|
|
46
45
|
| `togetherai/Qwen/Qwen3-Coder-Next-FP8` | 262K | | | | | | $0.50 | $1 |
|
|
47
|
-
| `togetherai/Qwen/Qwen3-Next-80B-A3B-Instruct` | 262K | | | | | | $0.15 | $2 |
|
|
48
46
|
| `togetherai/Qwen/Qwen3.5-397B-A17B` | 262K | | | | | | $0.60 | $4 |
|
|
49
|
-
| `togetherai/zai-org/GLM-4.6` | 200K | | | | | | $0.60 | $2 |
|
|
50
|
-
| `togetherai/zai-org/GLM-4.7` | 200K | | | | | | $0.45 | $2 |
|
|
51
47
|
| `togetherai/zai-org/GLM-5` | 203K | | | | | | $1 | $3 |
|
|
52
48
|
|
|
53
49
|
## Advanced configuration
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Vivgrid
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 12 Vivgrid models through Mastra's model router. Authentication is handled automatically using the `VIVGRID_API_KEY` environment variable.
|
|
4
4
|
|
|
5
5
|
Learn more in the [Vivgrid documentation](https://docs.vivgrid.com/models).
|
|
6
6
|
|
|
@@ -42,7 +42,10 @@ for await (const chunk of stream) {
|
|
|
42
42
|
| `vivgrid/gpt-5.1-codex` | 400K | | | | | | $1 | $10 |
|
|
43
43
|
| `vivgrid/gpt-5.1-codex-max` | 400K | | | | | | $1 | $10 |
|
|
44
44
|
| `vivgrid/gpt-5.2-codex` | 400K | | | | | | $2 | $14 |
|
|
45
|
+
| `vivgrid/gpt-5.3-codex` | 400K | | | | | | $2 | $14 |
|
|
45
46
|
| `vivgrid/gpt-5.4` | 400K | | | | | | $3 | $15 |
|
|
47
|
+
| `vivgrid/gpt-5.4-mini` | 400K | | | | | | $0.75 | $5 |
|
|
48
|
+
| `vivgrid/gpt-5.4-nano` | 400K | | | | | | $0.20 | $1 |
|
|
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
|
-
? "vivgrid/gpt-5.4"
|
|
78
|
+
? "vivgrid/gpt-5.4-nano"
|
|
76
79
|
: "vivgrid/deepseek-v3.2";
|
|
77
80
|
}
|
|
78
81
|
});
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Vultr
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 5 Vultr models through Mastra's model router. Authentication is handled automatically using the `VULTR_API_KEY` environment variable.
|
|
4
4
|
|
|
5
5
|
Learn more in the [Vultr documentation](https://api.vultrinference.com/).
|
|
6
6
|
|
|
@@ -34,10 +34,11 @@ for await (const chunk of stream) {
|
|
|
34
34
|
|
|
35
35
|
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
36
36
|
| --------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
37
|
-
| `vultr/DeepSeek-V3.2` |
|
|
38
|
-
| `vultr/GLM-5-FP8` |
|
|
39
|
-
| `vultr/
|
|
40
|
-
| `vultr/
|
|
37
|
+
| `vultr/DeepSeek-V3.2` | 127K | | | | | | $0.55 | $2 |
|
|
38
|
+
| `vultr/GLM-5-FP8` | 200K | | | | | | $0.85 | $3 |
|
|
39
|
+
| `vultr/gpt-oss-120b` | 129K | | | | | | $0.15 | $0.60 |
|
|
40
|
+
| `vultr/Kimi-K2.5` | 254K | | | | | | $0.55 | $3 |
|
|
41
|
+
| `vultr/MiniMax-M2.5` | 194K | | | | | | $0.30 | $1 |
|
|
41
42
|
|
|
42
43
|
## Advanced configuration
|
|
43
44
|
|
|
@@ -67,7 +68,7 @@ const agent = new Agent({
|
|
|
67
68
|
model: ({ requestContext }) => {
|
|
68
69
|
const useAdvanced = requestContext.task === "complex";
|
|
69
70
|
return useAdvanced
|
|
70
|
-
? "vultr/
|
|
71
|
+
? "vultr/gpt-oss-120b"
|
|
71
72
|
: "vultr/DeepSeek-V3.2";
|
|
72
73
|
}
|
|
73
74
|
});
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# Xiaomi Token Plan (Europe)
|
|
2
|
+
|
|
3
|
+
Access 3 Xiaomi Token Plan (Europe) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
|
|
4
|
+
|
|
5
|
+
Learn more in the [Xiaomi Token Plan (Europe) documentation](https://platform.xiaomimimo.com/#/docs).
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
XIAOMI_API_KEY=your-api-key
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
import { Agent } from "@mastra/core/agent";
|
|
13
|
+
|
|
14
|
+
const agent = new Agent({
|
|
15
|
+
id: "my-agent",
|
|
16
|
+
name: "My Agent",
|
|
17
|
+
instructions: "You are a helpful assistant",
|
|
18
|
+
model: "xiaomi-token-plan-ams/mimo-v2-omni"
|
|
19
|
+
});
|
|
20
|
+
|
|
21
|
+
// Generate a response
|
|
22
|
+
const response = await agent.generate("Hello!");
|
|
23
|
+
|
|
24
|
+
// Stream a response
|
|
25
|
+
const stream = await agent.stream("Tell me a story");
|
|
26
|
+
for await (const chunk of stream) {
|
|
27
|
+
console.log(chunk);
|
|
28
|
+
}
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Xiaomi Token Plan (Europe) documentation](https://platform.xiaomimimo.com/#/docs) for details.
|
|
32
|
+
|
|
33
|
+
## Models
|
|
34
|
+
|
|
35
|
+
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
36
|
+
| ------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
37
|
+
| `xiaomi-token-plan-ams/mimo-v2-omni` | 256K | | | | | | — | — |
|
|
38
|
+
| `xiaomi-token-plan-ams/mimo-v2-pro` | 1.0M | | | | | | — | — |
|
|
39
|
+
| `xiaomi-token-plan-ams/mimo-v2-tts` | 8K | | | | | | — | — |
|
|
40
|
+
|
|
41
|
+
## Advanced configuration
|
|
42
|
+
|
|
43
|
+
### Custom headers
|
|
44
|
+
|
|
45
|
+
```typescript
|
|
46
|
+
const agent = new Agent({
|
|
47
|
+
id: "custom-agent",
|
|
48
|
+
name: "custom-agent",
|
|
49
|
+
model: {
|
|
50
|
+
url: "https://token-plan-ams.xiaomimimo.com/v1",
|
|
51
|
+
id: "xiaomi-token-plan-ams/mimo-v2-omni",
|
|
52
|
+
apiKey: process.env.XIAOMI_API_KEY,
|
|
53
|
+
headers: {
|
|
54
|
+
"X-Custom-Header": "value"
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
});
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Dynamic model selection
|
|
61
|
+
|
|
62
|
+
```typescript
|
|
63
|
+
const agent = new Agent({
|
|
64
|
+
id: "dynamic-agent",
|
|
65
|
+
name: "Dynamic Agent",
|
|
66
|
+
model: ({ requestContext }) => {
|
|
67
|
+
const useAdvanced = requestContext.task === "complex";
|
|
68
|
+
return useAdvanced
|
|
69
|
+
? "xiaomi-token-plan-ams/mimo-v2-tts"
|
|
70
|
+
: "xiaomi-token-plan-ams/mimo-v2-omni";
|
|
71
|
+
}
|
|
72
|
+
});
|
|
73
|
+
```
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# Xiaomi Token Plan (China)
|
|
2
|
+
|
|
3
|
+
Access 3 Xiaomi Token Plan (China) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
|
|
4
|
+
|
|
5
|
+
Learn more in the [Xiaomi Token Plan (China) documentation](https://platform.xiaomimimo.com/#/docs).
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
XIAOMI_API_KEY=your-api-key
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
import { Agent } from "@mastra/core/agent";
|
|
13
|
+
|
|
14
|
+
const agent = new Agent({
|
|
15
|
+
id: "my-agent",
|
|
16
|
+
name: "My Agent",
|
|
17
|
+
instructions: "You are a helpful assistant",
|
|
18
|
+
model: "xiaomi-token-plan-cn/mimo-v2-omni"
|
|
19
|
+
});
|
|
20
|
+
|
|
21
|
+
// Generate a response
|
|
22
|
+
const response = await agent.generate("Hello!");
|
|
23
|
+
|
|
24
|
+
// Stream a response
|
|
25
|
+
const stream = await agent.stream("Tell me a story");
|
|
26
|
+
for await (const chunk of stream) {
|
|
27
|
+
console.log(chunk);
|
|
28
|
+
}
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Xiaomi Token Plan (China) documentation](https://platform.xiaomimimo.com/#/docs) for details.
|
|
32
|
+
|
|
33
|
+
## Models
|
|
34
|
+
|
|
35
|
+
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
36
|
+
| ----------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
37
|
+
| `xiaomi-token-plan-cn/mimo-v2-omni` | 256K | | | | | | — | — |
|
|
38
|
+
| `xiaomi-token-plan-cn/mimo-v2-pro` | 1.0M | | | | | | — | — |
|
|
39
|
+
| `xiaomi-token-plan-cn/mimo-v2-tts` | 8K | | | | | | — | — |
|
|
40
|
+
|
|
41
|
+
## Advanced configuration
|
|
42
|
+
|
|
43
|
+
### Custom headers
|
|
44
|
+
|
|
45
|
+
```typescript
|
|
46
|
+
const agent = new Agent({
|
|
47
|
+
id: "custom-agent",
|
|
48
|
+
name: "custom-agent",
|
|
49
|
+
model: {
|
|
50
|
+
url: "https://token-plan-cn.xiaomimimo.com/v1",
|
|
51
|
+
id: "xiaomi-token-plan-cn/mimo-v2-omni",
|
|
52
|
+
apiKey: process.env.XIAOMI_API_KEY,
|
|
53
|
+
headers: {
|
|
54
|
+
"X-Custom-Header": "value"
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
});
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Dynamic model selection
|
|
61
|
+
|
|
62
|
+
```typescript
|
|
63
|
+
const agent = new Agent({
|
|
64
|
+
id: "dynamic-agent",
|
|
65
|
+
name: "Dynamic Agent",
|
|
66
|
+
model: ({ requestContext }) => {
|
|
67
|
+
const useAdvanced = requestContext.task === "complex";
|
|
68
|
+
return useAdvanced
|
|
69
|
+
? "xiaomi-token-plan-cn/mimo-v2-tts"
|
|
70
|
+
: "xiaomi-token-plan-cn/mimo-v2-omni";
|
|
71
|
+
}
|
|
72
|
+
});
|
|
73
|
+
```
|
|
@@ -0,0 +1,73 @@
|
|
|
1
|
+
# Xiaomi Token Plan (Singapore)
|
|
2
|
+
|
|
3
|
+
Access 3 Xiaomi Token Plan (Singapore) models through Mastra's model router. Authentication is handled automatically using the `XIAOMI_API_KEY` environment variable.
|
|
4
|
+
|
|
5
|
+
Learn more in the [Xiaomi Token Plan (Singapore) documentation](https://platform.xiaomimimo.com/#/docs).
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
XIAOMI_API_KEY=your-api-key
|
|
9
|
+
```
|
|
10
|
+
|
|
11
|
+
```typescript
|
|
12
|
+
import { Agent } from "@mastra/core/agent";
|
|
13
|
+
|
|
14
|
+
const agent = new Agent({
|
|
15
|
+
id: "my-agent",
|
|
16
|
+
name: "My Agent",
|
|
17
|
+
instructions: "You are a helpful assistant",
|
|
18
|
+
model: "xiaomi-token-plan-sgp/mimo-v2-omni"
|
|
19
|
+
});
|
|
20
|
+
|
|
21
|
+
// Generate a response
|
|
22
|
+
const response = await agent.generate("Hello!");
|
|
23
|
+
|
|
24
|
+
// Stream a response
|
|
25
|
+
const stream = await agent.stream("Tell me a story");
|
|
26
|
+
for await (const chunk of stream) {
|
|
27
|
+
console.log(chunk);
|
|
28
|
+
}
|
|
29
|
+
```
|
|
30
|
+
|
|
31
|
+
> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Xiaomi Token Plan (Singapore) documentation](https://platform.xiaomimimo.com/#/docs) for details.
|
|
32
|
+
|
|
33
|
+
## Models
|
|
34
|
+
|
|
35
|
+
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
36
|
+
| ------------------------------------ | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
37
|
+
| `xiaomi-token-plan-sgp/mimo-v2-omni` | 256K | | | | | | — | — |
|
|
38
|
+
| `xiaomi-token-plan-sgp/mimo-v2-pro` | 1.0M | | | | | | — | — |
|
|
39
|
+
| `xiaomi-token-plan-sgp/mimo-v2-tts` | 8K | | | | | | — | — |
|
|
40
|
+
|
|
41
|
+
## Advanced configuration
|
|
42
|
+
|
|
43
|
+
### Custom headers
|
|
44
|
+
|
|
45
|
+
```typescript
|
|
46
|
+
const agent = new Agent({
|
|
47
|
+
id: "custom-agent",
|
|
48
|
+
name: "custom-agent",
|
|
49
|
+
model: {
|
|
50
|
+
url: "https://token-plan-sgp.xiaomimimo.com/v1",
|
|
51
|
+
id: "xiaomi-token-plan-sgp/mimo-v2-omni",
|
|
52
|
+
apiKey: process.env.XIAOMI_API_KEY,
|
|
53
|
+
headers: {
|
|
54
|
+
"X-Custom-Header": "value"
|
|
55
|
+
}
|
|
56
|
+
}
|
|
57
|
+
});
|
|
58
|
+
```
|
|
59
|
+
|
|
60
|
+
### Dynamic model selection
|
|
61
|
+
|
|
62
|
+
```typescript
|
|
63
|
+
const agent = new Agent({
|
|
64
|
+
id: "dynamic-agent",
|
|
65
|
+
name: "Dynamic Agent",
|
|
66
|
+
model: ({ requestContext }) => {
|
|
67
|
+
const useAdvanced = requestContext.task === "complex";
|
|
68
|
+
return useAdvanced
|
|
69
|
+
? "xiaomi-token-plan-sgp/mimo-v2-tts"
|
|
70
|
+
: "xiaomi-token-plan-sgp/mimo-v2-omni";
|
|
71
|
+
}
|
|
72
|
+
});
|
|
73
|
+
```
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# ZenMux
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 88 ZenMux models through Mastra's model router. Authentication is handled automatically using the `ZENMUX_API_KEY` environment variable.
|
|
4
4
|
|
|
5
5
|
Learn more in the [ZenMux documentation](https://docs.zenmux.ai).
|
|
6
6
|
|
|
@@ -59,6 +59,7 @@ for await (const chunk of stream) {
|
|
|
59
59
|
| `zenmux/inclusionai/ring-1t` | 128K | | | | | | $0.56 | $2 |
|
|
60
60
|
| `zenmux/kuaishou/kat-coder-pro-v1` | 256K | | | | | | $0.30 | $1 |
|
|
61
61
|
| `zenmux/kuaishou/kat-coder-pro-v1-free` | 256K | | | | | | — | — |
|
|
62
|
+
| `zenmux/kuaishou/kat-coder-pro-v2` | 256K | | | | | | $0.30 | $1 |
|
|
62
63
|
| `zenmux/minimax/minimax-m2` | 204K | | | | | | $0.30 | $1 |
|
|
63
64
|
| `zenmux/minimax/minimax-m2.1` | 204K | | | | | | $0.30 | $1 |
|
|
64
65
|
| `zenmux/minimax/minimax-m2.5` | 205K | | | | | | $0.30 | $1 |
|
|
@@ -88,6 +89,7 @@ for await (const chunk of stream) {
|
|
|
88
89
|
| `zenmux/qwen/qwen3-max` | 256K | | | | | | $1 | $6 |
|
|
89
90
|
| `zenmux/qwen/qwen3.5-flash` | 1.0M | | | | | | $0.10 | $0.40 |
|
|
90
91
|
| `zenmux/qwen/qwen3.5-plus` | 1.0M | | | | | | $0.80 | $5 |
|
|
92
|
+
| `zenmux/qwen/qwen3.6-plus` | 1.0M | | | | | | $0.50 | $3 |
|
|
91
93
|
| `zenmux/stepfun/step-3` | 66K | | | | | | $0.21 | $0.57 |
|
|
92
94
|
| `zenmux/stepfun/step-3.5-flash` | 256K | | | | | | $0.10 | $0.30 |
|
|
93
95
|
| `zenmux/stepfun/step-3.5-flash-free` | 256K | | | | | | — | — |
|
|
@@ -119,6 +121,7 @@ for await (const chunk of stream) {
|
|
|
119
121
|
| `zenmux/z-ai/glm-4.7-flashx` | 200K | | | | | | $0.07 | $0.42 |
|
|
120
122
|
| `zenmux/z-ai/glm-5` | 200K | | | | | | $0.58 | $3 |
|
|
121
123
|
| `zenmux/z-ai/glm-5-turbo` | 200K | | | | | | $0.88 | $3 |
|
|
124
|
+
| `zenmux/z-ai/glm-5v-turbo` | 200K | | | | | | $0.73 | $3 |
|
|
122
125
|
|
|
123
126
|
## Advanced configuration
|
|
124
127
|
|
|
@@ -148,7 +151,7 @@ const agent = new Agent({
|
|
|
148
151
|
model: ({ requestContext }) => {
|
|
149
152
|
const useAdvanced = requestContext.task === "complex";
|
|
150
153
|
return useAdvanced
|
|
151
|
-
? "zenmux/z-ai/glm-
|
|
154
|
+
? "zenmux/z-ai/glm-5v-turbo"
|
|
152
155
|
: "zenmux/anthropic/claude-3.5-haiku";
|
|
153
156
|
}
|
|
154
157
|
});
|
|
@@ -88,6 +88,9 @@ Direct access to individual AI model providers. Each provider offers unique mode
|
|
|
88
88
|
- [Vultr](https://mastra.ai/models/providers/vultr)
|
|
89
89
|
- [Weights & Biases](https://mastra.ai/models/providers/wandb)
|
|
90
90
|
- [Xiaomi](https://mastra.ai/models/providers/xiaomi)
|
|
91
|
+
- [Xiaomi Token Plan (China)](https://mastra.ai/models/providers/xiaomi-token-plan-cn)
|
|
92
|
+
- [Xiaomi Token Plan (Europe)](https://mastra.ai/models/providers/xiaomi-token-plan-ams)
|
|
93
|
+
- [Xiaomi Token Plan (Singapore)](https://mastra.ai/models/providers/xiaomi-token-plan-sgp)
|
|
91
94
|
- [Z.AI](https://mastra.ai/models/providers/zai)
|
|
92
95
|
- [Z.AI Coding Plan](https://mastra.ai/models/providers/zai-coding-plan)
|
|
93
96
|
- [ZenMux](https://mastra.ai/models/providers/zenmux)
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# OpenAI Responses API Conversations
|
|
2
2
|
|
|
3
|
-
The OpenAI Responses API Conversations surface provides methods to create, retrieve, delete, and inspect thread-backed conversations in Mastra.
|
|
3
|
+
The OpenAI Responses API Conversations surface gives you the conversation-management side of Mastra Agents as a Responses API. It provides methods to create, retrieve, delete, and inspect thread-backed conversations in Mastra.
|
|
4
4
|
|
|
5
5
|
This API follows up on the [OpenAI Responses API](https://mastra.ai/reference/client-js/responses). Stored Responses calls return `conversation_id`, and in Mastra that value is the raw memory `threadId`. Use `client.conversations` when you want to work with that thread directly.
|
|
6
6
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# OpenAI Responses API
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
This OpenAI-compatible, agent-backed interface lets you use Mastra Agents as a Responses API. It provides methods to create, retrieve, stream, and delete responses through Mastra agents.
|
|
4
4
|
|
|
5
5
|
These routes are agent-backed adapters over Mastra agents, memory, and storage. Use `agent_id` to select the Mastra agent that should handle the request. You can pass `model` to override the agent's configured model for a single request, or omit it to use the model already configured on the agent.
|
|
6
6
|
|
|
@@ -4,10 +4,10 @@ This reference provides comprehensive information about Mastra templates, includ
|
|
|
4
4
|
|
|
5
5
|
Mastra templates are pre-built project structures that demonstrate specific use cases and patterns. They provide:
|
|
6
6
|
|
|
7
|
-
- **Working examples
|
|
8
|
-
- **Best practices
|
|
9
|
-
- **Educational resources
|
|
10
|
-
- **Quickstarts
|
|
7
|
+
- **Working examples**: Complete, functional Mastra applications
|
|
8
|
+
- **Best practices**: Proper project structure and coding conventions
|
|
9
|
+
- **Educational resources**: Learn Mastra patterns through real implementations
|
|
10
|
+
- **Quickstarts**: Bootstrap projects faster than building from scratch
|
|
11
11
|
|
|
12
12
|
## Using templates
|
|
13
13
|
|
|
@@ -15,10 +15,30 @@ Mastra templates are pre-built project structures that demonstrate specific use
|
|
|
15
15
|
|
|
16
16
|
Install a template using the `create-mastra` command:
|
|
17
17
|
|
|
18
|
-
|
|
18
|
+
**npm**:
|
|
19
|
+
|
|
20
|
+
```sh
|
|
19
21
|
npx create-mastra@latest --template template-name
|
|
20
22
|
```
|
|
21
23
|
|
|
24
|
+
**pnpm**:
|
|
25
|
+
|
|
26
|
+
```sh
|
|
27
|
+
pnpm dlx create-mastra@latest --template template-name
|
|
28
|
+
```
|
|
29
|
+
|
|
30
|
+
**Yarn**:
|
|
31
|
+
|
|
32
|
+
```sh
|
|
33
|
+
yarn dlx create-mastra@latest --template template-name
|
|
34
|
+
```
|
|
35
|
+
|
|
36
|
+
**Bun**:
|
|
37
|
+
|
|
38
|
+
```sh
|
|
39
|
+
bun x create-mastra@latest --template template-name
|
|
40
|
+
```
|
|
41
|
+
|
|
22
42
|
This creates a complete project with all necessary code and configuration.
|
|
23
43
|
|
|
24
44
|
### Setup Process
|
|
@@ -41,20 +61,74 @@ After installation:
|
|
|
41
61
|
|
|
42
62
|
3. **Install dependencies** (if not done automatically):
|
|
43
63
|
|
|
44
|
-
|
|
64
|
+
**npm**:
|
|
65
|
+
|
|
66
|
+
```sh
|
|
45
67
|
npm install
|
|
46
68
|
```
|
|
47
69
|
|
|
70
|
+
**pnpm**:
|
|
71
|
+
|
|
72
|
+
```sh
|
|
73
|
+
pnpm install
|
|
74
|
+
```
|
|
75
|
+
|
|
76
|
+
**Yarn**:
|
|
77
|
+
|
|
78
|
+
```sh
|
|
79
|
+
yarn install
|
|
80
|
+
```
|
|
81
|
+
|
|
82
|
+
**Bun**:
|
|
83
|
+
|
|
84
|
+
```sh
|
|
85
|
+
bun install
|
|
86
|
+
```
|
|
87
|
+
|
|
48
88
|
4. **Start development server**:
|
|
49
89
|
|
|
50
|
-
|
|
90
|
+
**npm**:
|
|
91
|
+
|
|
92
|
+
```sh
|
|
51
93
|
npm run dev
|
|
52
94
|
```
|
|
53
95
|
|
|
54
|
-
|
|
96
|
+
**pnpm**:
|
|
97
|
+
|
|
98
|
+
```sh
|
|
99
|
+
pnpm run dev
|
|
100
|
+
```
|
|
101
|
+
|
|
102
|
+
**Yarn**:
|
|
103
|
+
|
|
104
|
+
```sh
|
|
105
|
+
yarn dev
|
|
106
|
+
```
|
|
107
|
+
|
|
108
|
+
**Bun**:
|
|
109
|
+
|
|
110
|
+
```sh
|
|
111
|
+
bun run dev
|
|
112
|
+
```
|
|
113
|
+
|
|
114
|
+
### Template structure
|
|
55
115
|
|
|
56
116
|
All templates follow this standardized structure:
|
|
57
117
|
|
|
118
|
+
```text
|
|
119
|
+
your-template/
|
|
120
|
+
├── src/
|
|
121
|
+
│ └── mastra/
|
|
122
|
+
│ ├── agents/ # Agent definitions
|
|
123
|
+
│ ├── tools/ # Tool definitions
|
|
124
|
+
│ ├── workflows/ # Workflow definitions
|
|
125
|
+
│ └── index.ts # Main Mastra config
|
|
126
|
+
├── .env.example # Required environment variables
|
|
127
|
+
├── package.json
|
|
128
|
+
├── tsconfig.json
|
|
129
|
+
└── README.md
|
|
130
|
+
```
|
|
131
|
+
|
|
58
132
|
## Creating templates
|
|
59
133
|
|
|
60
134
|
### Requirements
|
|
@@ -127,12 +201,12 @@ const agent = new Agent({
|
|
|
127
201
|
|
|
128
202
|
Templates must be:
|
|
129
203
|
|
|
130
|
-
- **Single projects
|
|
131
|
-
- **Framework-free
|
|
132
|
-
- **Mastra-focused
|
|
133
|
-
- **Mergeable
|
|
134
|
-
- **Node.js compatible
|
|
135
|
-
- **ESM modules
|
|
204
|
+
- **Single projects**: Not monorepos with multiple applications
|
|
205
|
+
- **Framework-free**: No Next.js, Express, or other web framework boilerplate
|
|
206
|
+
- **Mastra-focused**: Demonstrate Mastra functionality without additional layers
|
|
207
|
+
- **Mergeable**: Structure code for seamless integration into existing projects
|
|
208
|
+
- **Node.js compatible**: Support Node.js v22.13.0 and later
|
|
209
|
+
- **ESM modules**: Use ES modules (`"type": "module"` in package.json)
|
|
136
210
|
|
|
137
211
|
### Documentation Requirements
|
|
138
212
|
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,54 @@
|
|
|
1
1
|
# @mastra/mcp-docs-server
|
|
2
2
|
|
|
3
|
+
## 1.1.22-alpha.10
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies [[`665477b`](https://github.com/mastra-ai/mastra/commit/665477bc104fd52cfef8e7610d7664781a70c220), [`4cc2755`](https://github.com/mastra-ai/mastra/commit/4cc2755a7194cb08720ff2ab4dffb4b4a5103dfd)]:
|
|
8
|
+
- @mastra/core@1.23.0-alpha.7
|
|
9
|
+
|
|
10
|
+
## 1.1.22-alpha.8
|
|
11
|
+
|
|
12
|
+
### Patch Changes
|
|
13
|
+
|
|
14
|
+
- Updated dependencies [[`7d6f521`](https://github.com/mastra-ai/mastra/commit/7d6f52164d0cca099f0b07cb2bba334360f1c8ab)]:
|
|
15
|
+
- @mastra/core@1.23.0-alpha.6
|
|
16
|
+
|
|
17
|
+
## 1.1.22-alpha.7
|
|
18
|
+
|
|
19
|
+
### Patch Changes
|
|
20
|
+
|
|
21
|
+
- Updated dependencies [[`1371703`](https://github.com/mastra-ai/mastra/commit/1371703835080450ef3f9aea58059a95d0da2e5a), [`98f8a8b`](https://github.com/mastra-ai/mastra/commit/98f8a8bdf5761b9982f3ad3acbe7f1cc3efa71f3)]:
|
|
22
|
+
- @mastra/core@1.23.0-alpha.5
|
|
23
|
+
|
|
24
|
+
## 1.1.22-alpha.5
|
|
25
|
+
|
|
26
|
+
### Patch Changes
|
|
27
|
+
|
|
28
|
+
- Updated dependencies [[`fff91cf`](https://github.com/mastra-ai/mastra/commit/fff91cf914de0e731578aacebffdeebef82f0440)]:
|
|
29
|
+
- @mastra/core@1.23.0-alpha.4
|
|
30
|
+
|
|
31
|
+
## 1.1.22-alpha.3
|
|
32
|
+
|
|
33
|
+
### Patch Changes
|
|
34
|
+
|
|
35
|
+
- Updated dependencies [[`1805ddc`](https://github.com/mastra-ai/mastra/commit/1805ddc9c9b3b14b63749735a13c05a45af43a80)]:
|
|
36
|
+
- @mastra/core@1.23.0-alpha.3
|
|
37
|
+
|
|
38
|
+
## 1.1.22-alpha.2
|
|
39
|
+
|
|
40
|
+
### Patch Changes
|
|
41
|
+
|
|
42
|
+
- Updated dependencies:
|
|
43
|
+
- @mastra/core@1.23.0-alpha.2
|
|
44
|
+
|
|
45
|
+
## 1.1.22-alpha.1
|
|
46
|
+
|
|
47
|
+
### Patch Changes
|
|
48
|
+
|
|
49
|
+
- Updated dependencies [[`f32b9e1`](https://github.com/mastra-ai/mastra/commit/f32b9e115a3c754d1c8cfa3f4256fba87b09cfb7)]:
|
|
50
|
+
- @mastra/core@1.23.0-alpha.1
|
|
51
|
+
|
|
3
52
|
## 1.1.22-alpha.0
|
|
4
53
|
|
|
5
54
|
### Patch Changes
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/mcp-docs-server",
|
|
3
|
-
"version": "1.1.22-alpha.
|
|
3
|
+
"version": "1.1.22-alpha.11",
|
|
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/
|
|
33
|
-
"@mastra/
|
|
32
|
+
"@mastra/core": "1.23.0-alpha.7",
|
|
33
|
+
"@mastra/mcp": "^1.4.1"
|
|
34
34
|
},
|
|
35
35
|
"devDependencies": {
|
|
36
36
|
"@hono/node-server": "^1.19.11",
|
|
@@ -48,7 +48,7 @@
|
|
|
48
48
|
"vitest": "4.0.18",
|
|
49
49
|
"@internal/lint": "0.0.79",
|
|
50
50
|
"@internal/types-builder": "0.0.54",
|
|
51
|
-
"@mastra/core": "1.23.0-alpha.
|
|
51
|
+
"@mastra/core": "1.23.0-alpha.7"
|
|
52
52
|
},
|
|
53
53
|
"homepage": "https://mastra.ai",
|
|
54
54
|
"repository": {
|