@mastra/mcp-docs-server 1.1.25-alpha.6 → 1.1.25-alpha.7
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/models/gateways/openrouter.md +1 -1
- package/.docs/models/index.md +5 -5
- package/.docs/models/providers/huggingface.md +2 -1
- package/.docs/models/providers/synthetic.md +3 -2
- package/.docs/models/providers/togetherai.md +2 -1
- package/.docs/reference/ai-sdk/chat-route.md +2 -0
- package/.docs/reference/ai-sdk/handle-chat-stream.md +2 -0
- package/.docs/reference/ai-sdk/handle-network-stream.md +2 -0
- package/.docs/reference/ai-sdk/network-route.md +2 -0
- package/package.json +5 -5
|
@@ -159,6 +159,7 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
159
159
|
| `openai/gpt-oss-20b:free` |
|
|
160
160
|
| `openai/gpt-oss-safeguard-20b` |
|
|
161
161
|
| `openai/o4-mini` |
|
|
162
|
+
| `openrouter/elephant-alpha` |
|
|
162
163
|
| `openrouter/free` |
|
|
163
164
|
| `prime-intellect/intellect-3` |
|
|
164
165
|
| `qwen/qwen-2.5-coder-32b-instruct` |
|
|
@@ -185,7 +186,6 @@ ANTHROPIC_API_KEY=ant-...
|
|
|
185
186
|
| `sourceful/riverflow-v2-max-preview` |
|
|
186
187
|
| `sourceful/riverflow-v2-standard-preview` |
|
|
187
188
|
| `stepfun/step-3.5-flash` |
|
|
188
|
-
| `stepfun/step-3.5-flash:free` |
|
|
189
189
|
| `x-ai/grok-3` |
|
|
190
190
|
| `x-ai/grok-3-beta` |
|
|
191
191
|
| `x-ai/grok-3-mini` |
|
package/.docs/models/index.md
CHANGED
|
@@ -1,16 +1,16 @@
|
|
|
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 3610 models from 99 providers through a single API.
|
|
4
4
|
|
|
5
5
|
## Features
|
|
6
6
|
|
|
7
|
-
- **One API for any model
|
|
7
|
+
- **One API for any model**: Access any model without having to install and manage additional provider dependencies.
|
|
8
8
|
|
|
9
|
-
- **Access the newest AI
|
|
9
|
+
- **Access the newest AI**: Use new models the moment they're released, no matter which provider they come from. Avoid vendor lock-in with Mastra's provider-agnostic interface.
|
|
10
10
|
|
|
11
|
-
- [**Mix and match models**](#mix-and-match-models)
|
|
11
|
+
- [**Mix and match models**](#mix-and-match-models): Use different models for different tasks. For example, run GPT-5-mini for large-context processing, then switch to Claude Opus 4.6 for reasoning tasks.
|
|
12
12
|
|
|
13
|
-
- [**Model fallbacks**](#model-fallbacks)
|
|
13
|
+
- [**Model fallbacks**](#model-fallbacks): If a provider experiences an outage, Mastra can automatically switch to another provider at the application level, minimizing latency compared to API gateways.
|
|
14
14
|
|
|
15
15
|
## Basic usage
|
|
16
16
|
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Hugging Face
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 22 Hugging Face models through Mastra's model router. Authentication is handled automatically using the `HF_TOKEN` environment variable.
|
|
4
4
|
|
|
5
5
|
Learn more in the [Hugging Face documentation](https://huggingface.co).
|
|
6
6
|
|
|
@@ -38,6 +38,7 @@ for await (const chunk of stream) {
|
|
|
38
38
|
| `huggingface/deepseek-ai/DeepSeek-V3.2` | 164K | | | | | | $0.28 | $0.40 |
|
|
39
39
|
| `huggingface/MiniMaxAI/MiniMax-M2.1` | 205K | | | | | | $0.30 | $1 |
|
|
40
40
|
| `huggingface/MiniMaxAI/MiniMax-M2.5` | 205K | | | | | | $0.30 | $1 |
|
|
41
|
+
| `huggingface/MiniMaxAI/MiniMax-M2.7` | 205K | | | | | | $0.30 | $1 |
|
|
41
42
|
| `huggingface/moonshotai/Kimi-K2-Instruct` | 131K | | | | | | $1 | $3 |
|
|
42
43
|
| `huggingface/moonshotai/Kimi-K2-Instruct-0905` | 262K | | | | | | $1 | $3 |
|
|
43
44
|
| `huggingface/moonshotai/Kimi-K2-Thinking` | 262K | | | | | | $0.60 | $3 |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Synthetic
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 32 Synthetic models through Mastra's model router. Authentication is handled automatically using the `SYNTHETIC_API_KEY` environment variable.
|
|
4
4
|
|
|
5
5
|
Learn more in the [Synthetic documentation](https://synthetic.new/pricing).
|
|
6
6
|
|
|
@@ -65,6 +65,7 @@ for await (const chunk of stream) {
|
|
|
65
65
|
| `synthetic/hf:zai-org/GLM-4.7` | 200K | | | | | | $0.55 | $2 |
|
|
66
66
|
| `synthetic/hf:zai-org/GLM-4.7-Flash` | 197K | | | | | | $0.06 | $0.40 |
|
|
67
67
|
| `synthetic/hf:zai-org/GLM-5` | 197K | | | | | | $1 | $3 |
|
|
68
|
+
| `synthetic/hf:zai-org/GLM-5.1` | 197K | | | | | | $1 | $3 |
|
|
68
69
|
|
|
69
70
|
## Advanced configuration
|
|
70
71
|
|
|
@@ -94,7 +95,7 @@ const agent = new Agent({
|
|
|
94
95
|
model: ({ requestContext }) => {
|
|
95
96
|
const useAdvanced = requestContext.task === "complex";
|
|
96
97
|
return useAdvanced
|
|
97
|
-
? "synthetic/hf:zai-org/GLM-5"
|
|
98
|
+
? "synthetic/hf:zai-org/GLM-5.1"
|
|
98
99
|
: "synthetic/hf:MiniMaxAI/MiniMax-M2";
|
|
99
100
|
}
|
|
100
101
|
});
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Together AI
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 15 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
|
|
|
@@ -39,6 +39,7 @@ for await (const chunk of stream) {
|
|
|
39
39
|
| `togetherai/google/gemma-4-31B-it` | 262K | | | | | | $0.20 | $0.50 |
|
|
40
40
|
| `togetherai/meta-llama/Llama-3.3-70B-Instruct-Turbo` | 131K | | | | | | $0.88 | $0.88 |
|
|
41
41
|
| `togetherai/MiniMaxAI/MiniMax-M2.5` | 205K | | | | | | $0.30 | $1 |
|
|
42
|
+
| `togetherai/MiniMaxAI/MiniMax-M2.7` | 203K | | | | | | $0.30 | $1 |
|
|
42
43
|
| `togetherai/moonshotai/Kimi-K2.5` | 262K | | | | | | $0.50 | $3 |
|
|
43
44
|
| `togetherai/openai/gpt-oss-120b` | 131K | | | | | | $0.15 | $0.60 |
|
|
44
45
|
| `togetherai/Qwen/Qwen3-235B-A22B-Instruct-2507-tput` | 262K | | | | | | $0.20 | $0.60 |
|
|
@@ -55,6 +55,8 @@ export const mastra = new Mastra({
|
|
|
55
55
|
|
|
56
56
|
**agent** (`string`): The ID of the agent to use for this chat route. Required if the path doesn't include \`:agentId\`.
|
|
57
57
|
|
|
58
|
+
**agentVersion** (`{ versionId: string } | { status?: 'draft' | 'published' }`): Selects a specific agent version. Pass \`{ versionId: '\<id>' }\` to target an exact version, or \`{ status: 'draft' }\` / \`{ status: 'published' }\` to resolve by status. When the route is called, query parameters \`?versionId=\<id>\` or \`?status=draft|published\` take precedence over this static value. Requires the \[Editor]\(/docs/editor/overview) to be configured.
|
|
59
|
+
|
|
58
60
|
**defaultOptions** (`AgentExecutionOptions`): Default options passed to agent execution. These can include instructions, memory configuration, maxSteps, and other execution settings.
|
|
59
61
|
|
|
60
62
|
**sendStart** (`boolean`): Whether to send start events in the stream. (Default: `true`)
|
|
@@ -37,6 +37,8 @@ export async function POST(req: Request) {
|
|
|
37
37
|
|
|
38
38
|
**agentId** (`string`): The ID of the agent to use for chat.
|
|
39
39
|
|
|
40
|
+
**agentVersion** (`{ versionId: string } | { status?: 'draft' | 'published' }`): Selects a specific agent version. Pass \`{ versionId: '\<id>' }\` to target an exact version, or \`{ status: 'draft' }\` / \`{ status: 'published' }\` to resolve by status. Requires the \[Editor]\(/docs/editor/overview) to be configured.
|
|
41
|
+
|
|
40
42
|
**params** (`ChatStreamHandlerParams`): Parameters for the chat stream, including messages and optional resume data.
|
|
41
43
|
|
|
42
44
|
**params.messages** (`UIMessage[]`): Array of messages in the conversation.
|
|
@@ -38,6 +38,8 @@ export async function POST(req: Request) {
|
|
|
38
38
|
|
|
39
39
|
**agentId** (`string`): The ID of the routing agent to execute as a network.
|
|
40
40
|
|
|
41
|
+
**agentVersion** (`{ versionId: string } | { status?: 'draft' | 'published' }`): Selects a specific agent version. Pass \`{ versionId: '\<id>' }\` to target an exact version, or \`{ status: 'draft' }\` / \`{ status: 'published' }\` to resolve by status. Requires the \[Editor]\(/docs/editor/overview) to be configured.
|
|
42
|
+
|
|
41
43
|
**params** (`NetworkStreamHandlerParams`): The request parameters containing messages and execution options. Includes \`messages\` (required) and any AgentExecutionOptions like \`memory\`, \`maxSteps\`, \`runId\`, etc.
|
|
42
44
|
|
|
43
45
|
**defaultOptions** (`AgentExecutionOptions`): Default options passed to agent execution. These are merged with params, with params taking precedence.
|
|
@@ -53,6 +53,8 @@ export const mastra = new Mastra({
|
|
|
53
53
|
|
|
54
54
|
**agent** (`string`): The ID of the routing agent to use for this network route. Required if the path doesn't include \`:agentId\`.
|
|
55
55
|
|
|
56
|
+
**agentVersion** (`{ versionId: string } | { status?: 'draft' | 'published' }`): Selects a specific agent version. Pass \`{ versionId: '\<id>' }\` to target an exact version, or \`{ status: 'draft' }\` / \`{ status: 'published' }\` to resolve by status. When the route is called, query parameters \`?versionId=\<id>\` or \`?status=draft|published\` take precedence over this static value. Requires the \[Editor]\(/docs/editor/overview) to be configured.
|
|
57
|
+
|
|
56
58
|
**defaultOptions** (`AgentExecutionOptions`): Default options passed to agent execution. These can include instructions, memory configuration, maxSteps, and other execution settings.
|
|
57
59
|
|
|
58
60
|
## Additional configuration
|
package/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "@mastra/mcp-docs-server",
|
|
3
|
-
"version": "1.1.25-alpha.
|
|
3
|
+
"version": "1.1.25-alpha.7",
|
|
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.25.0-alpha.2",
|
|
33
|
+
"@mastra/mcp": "^1.4.2"
|
|
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
|
-
"@
|
|
49
|
+
"@internal/lint": "0.0.82",
|
|
50
50
|
"@internal/types-builder": "0.0.57",
|
|
51
|
-
"@
|
|
51
|
+
"@mastra/core": "1.25.0-alpha.2"
|
|
52
52
|
},
|
|
53
53
|
"homepage": "https://mastra.ai",
|
|
54
54
|
"repository": {
|