@mastra/mcp-docs-server 1.1.35 → 1.1.36-alpha.3
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/a2a.md +235 -0
- package/.docs/docs/agents/response-caching.md +11 -11
- package/.docs/docs/agents/signals.md +1 -1
- package/.docs/docs/deployment/cloud-providers.md +1 -1
- package/.docs/docs/deployment/overview.md +6 -5
- package/.docs/docs/mastra-platform/configuration.md +22 -6
- package/.docs/docs/mastra-platform/observability.md +99 -0
- package/.docs/docs/mastra-platform/overview.md +12 -55
- package/.docs/{guides/deployment/mastra-platform.md → docs/mastra-platform/server.md} +30 -37
- package/.docs/docs/mastra-platform/studio.md +81 -0
- package/.docs/docs/observability/overview.md +10 -5
- package/.docs/docs/observability/tracing/exporters/mastra-platform.md +13 -13
- package/.docs/docs/observability/tracing/exporters/mastra-storage.md +1 -1
- package/.docs/docs/observability/tracing/overview.md +4 -4
- package/.docs/docs/server/mastra-client.md +1 -0
- package/.docs/docs/server/mastra-server.md +2 -1
- package/.docs/docs/studio/deployment.md +1 -37
- package/.docs/docs/studio/observability.md +28 -23
- package/.docs/docs/studio/overview.md +3 -3
- package/.docs/guides/getting-started/quickstart.md +4 -4
- package/.docs/guides/migrations/mastra-cloud.md +8 -8
- package/.docs/guides/migrations/upgrade-to-v1/tracing.md +2 -2
- package/.docs/models/index.md +1 -1
- package/.docs/models/providers/alibaba-cn.md +1 -1
- package/.docs/models/providers/alibaba.md +1 -1
- package/.docs/models/providers/auriko.md +85 -0
- package/.docs/models/providers/claudinio.md +71 -0
- package/.docs/models/providers/deepinfra.md +3 -1
- package/.docs/models/providers/google.md +1 -1
- package/.docs/models/providers/kilo.md +1 -1
- package/.docs/models/providers/llmgateway.md +1 -1
- package/.docs/models/providers/wafer.ai.md +4 -6
- package/.docs/models/providers.md +2 -0
- package/.docs/reference/cli/create-mastra.md +6 -0
- package/.docs/reference/cli/mastra.md +30 -14
- package/.docs/reference/harness/harness-class.md +1 -1
- package/.docs/reference/observability/metrics/automatic-metrics.md +1 -1
- package/.docs/reference/observability/tracing/configuration.md +1 -1
- package/.docs/reference/observability/tracing/exporters/cloud-exporter.md +2 -2
- package/.docs/reference/observability/tracing/exporters/mastra-platform-exporter.md +3 -3
- package/.docs/reference/observability/tracing/interfaces.md +1 -1
- package/CHANGELOG.md +14 -0
- package/package.json +4 -4
|
@@ -80,7 +80,7 @@ for await (const chunk of stream) {
|
|
|
80
80
|
| `alibaba/qwen3.6-27b` | 262K | | | | | | $0.60 | $4 |
|
|
81
81
|
| `alibaba/qwen3.6-35b-a3b` | 262K | | | | | | $0.25 | $1 |
|
|
82
82
|
| `alibaba/qwen3.6-max-preview` | 262K | | | | | | $1 | $8 |
|
|
83
|
-
| `alibaba/qwen3.6-plus` | 1.0M | | | | | | $0.
|
|
83
|
+
| `alibaba/qwen3.6-plus` | 1.0M | | | | | | $0.50 | $3 |
|
|
84
84
|
| `alibaba/qwq-plus` | 131K | | | | | | $0.80 | $2 |
|
|
85
85
|
|
|
86
86
|
## Advanced configuration
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
# Auriko
|
|
2
|
+
|
|
3
|
+
Access 15 Auriko models through Mastra's model router. Authentication is handled automatically using the `AURIKO_API_KEY` environment variable.
|
|
4
|
+
|
|
5
|
+
Learn more in the [Auriko documentation](https://docs.auriko.ai).
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
AURIKO_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: "auriko/claude-opus-4-6"
|
|
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 [Auriko documentation](https://docs.auriko.ai) for details.
|
|
32
|
+
|
|
33
|
+
## Models
|
|
34
|
+
|
|
35
|
+
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
36
|
+
| ------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
37
|
+
| `auriko/claude-opus-4-6` | 1.0M | | | | | | $5 | $25 |
|
|
38
|
+
| `auriko/claude-opus-4-7` | 1.0M | | | | | | $5 | $25 |
|
|
39
|
+
| `auriko/claude-sonnet-4-6` | 1.0M | | | | | | $3 | $15 |
|
|
40
|
+
| `auriko/deepseek-v4-flash` | 1.0M | | | | | | $0.14 | $0.28 |
|
|
41
|
+
| `auriko/deepseek-v4-pro` | 1.0M | | | | | | $0.43 | $0.87 |
|
|
42
|
+
| `auriko/gemini-2.5-flash` | 1.0M | | | | | | $0.30 | $3 |
|
|
43
|
+
| `auriko/gemini-2.5-pro` | 1.0M | | | | | | $1 | $10 |
|
|
44
|
+
| `auriko/gemini-3.1-pro-preview` | 1.0M | | | | | | $2 | $12 |
|
|
45
|
+
| `auriko/glm-5.1` | 200K | | | | | | $1 | $4 |
|
|
46
|
+
| `auriko/grok-4.3` | 1.0M | | | | | | $1 | $3 |
|
|
47
|
+
| `auriko/kimi-k2.5` | 262K | | | | | | $0.50 | $3 |
|
|
48
|
+
| `auriko/kimi-k2.6` | 262K | | | | | | $0.95 | $4 |
|
|
49
|
+
| `auriko/minimax-m2-7` | 205K | | | | | | $0.30 | $1 |
|
|
50
|
+
| `auriko/minimax-m2-7-highspeed` | 205K | | | | | | $0.60 | $2 |
|
|
51
|
+
| `auriko/qwen-3.6-plus` | 1.0M | | | | | | $0.50 | $3 |
|
|
52
|
+
|
|
53
|
+
## Advanced configuration
|
|
54
|
+
|
|
55
|
+
### Custom headers
|
|
56
|
+
|
|
57
|
+
```typescript
|
|
58
|
+
const agent = new Agent({
|
|
59
|
+
id: "custom-agent",
|
|
60
|
+
name: "custom-agent",
|
|
61
|
+
model: {
|
|
62
|
+
url: "https://api.auriko.ai/v1",
|
|
63
|
+
id: "auriko/claude-opus-4-6",
|
|
64
|
+
apiKey: process.env.AURIKO_API_KEY,
|
|
65
|
+
headers: {
|
|
66
|
+
"X-Custom-Header": "value"
|
|
67
|
+
}
|
|
68
|
+
}
|
|
69
|
+
});
|
|
70
|
+
```
|
|
71
|
+
|
|
72
|
+
### Dynamic model selection
|
|
73
|
+
|
|
74
|
+
```typescript
|
|
75
|
+
const agent = new Agent({
|
|
76
|
+
id: "dynamic-agent",
|
|
77
|
+
name: "Dynamic Agent",
|
|
78
|
+
model: ({ requestContext }) => {
|
|
79
|
+
const useAdvanced = requestContext.task === "complex";
|
|
80
|
+
return useAdvanced
|
|
81
|
+
? "auriko/qwen-3.6-plus"
|
|
82
|
+
: "auriko/claude-opus-4-6";
|
|
83
|
+
}
|
|
84
|
+
});
|
|
85
|
+
```
|
|
@@ -0,0 +1,71 @@
|
|
|
1
|
+
# Claudinio
|
|
2
|
+
|
|
3
|
+
Access 1 Claudinio model through Mastra's model router. Authentication is handled automatically using the `CLAUDINIO_API_KEY` environment variable.
|
|
4
|
+
|
|
5
|
+
Learn more in the [Claudinio documentation](https://claudin.io).
|
|
6
|
+
|
|
7
|
+
```bash
|
|
8
|
+
CLAUDINIO_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: "claudinio/claudinio"
|
|
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 [Claudinio documentation](https://claudin.io) for details.
|
|
32
|
+
|
|
33
|
+
## Models
|
|
34
|
+
|
|
35
|
+
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
36
|
+
| --------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
37
|
+
| `claudinio/claudinio` | 256K | | | | | | $0.50 | $2 |
|
|
38
|
+
|
|
39
|
+
## Advanced configuration
|
|
40
|
+
|
|
41
|
+
### Custom headers
|
|
42
|
+
|
|
43
|
+
```typescript
|
|
44
|
+
const agent = new Agent({
|
|
45
|
+
id: "custom-agent",
|
|
46
|
+
name: "custom-agent",
|
|
47
|
+
model: {
|
|
48
|
+
url: "https://api.claudin.io/v1",
|
|
49
|
+
id: "claudinio/claudinio",
|
|
50
|
+
apiKey: process.env.CLAUDINIO_API_KEY,
|
|
51
|
+
headers: {
|
|
52
|
+
"X-Custom-Header": "value"
|
|
53
|
+
}
|
|
54
|
+
}
|
|
55
|
+
});
|
|
56
|
+
```
|
|
57
|
+
|
|
58
|
+
### Dynamic model selection
|
|
59
|
+
|
|
60
|
+
```typescript
|
|
61
|
+
const agent = new Agent({
|
|
62
|
+
id: "dynamic-agent",
|
|
63
|
+
name: "Dynamic Agent",
|
|
64
|
+
model: ({ requestContext }) => {
|
|
65
|
+
const useAdvanced = requestContext.task === "complex";
|
|
66
|
+
return useAdvanced
|
|
67
|
+
? "claudinio/claudinio"
|
|
68
|
+
: "claudinio/claudinio";
|
|
69
|
+
}
|
|
70
|
+
});
|
|
71
|
+
```
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Deep Infra
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 38 Deep Infra models through Mastra's model router. Authentication is handled automatically using the `DEEPINFRA_API_KEY` environment variable.
|
|
4
4
|
|
|
5
5
|
Learn more in the [Deep Infra documentation](https://deepinfra.com/models).
|
|
6
6
|
|
|
@@ -62,6 +62,8 @@ for await (const chunk of stream) {
|
|
|
62
62
|
| `deepinfra/Qwen/Qwen3.5-35B-A3B` | 262K | | | | | | $0.20 | $0.95 |
|
|
63
63
|
| `deepinfra/Qwen/Qwen3.5-397B-A17B` | 262K | | | | | | $0.54 | $3 |
|
|
64
64
|
| `deepinfra/Qwen/Qwen3.6-35B-A3B` | 262K | | | | | | $0.20 | $1 |
|
|
65
|
+
| `deepinfra/xiaomi/mimo-v2.5` | 262K | | | | | | $0.40 | $2 |
|
|
66
|
+
| `deepinfra/xiaomi/mimo-v2.5-pro` | 1.0M | | | | | | $1 | $3 |
|
|
65
67
|
| `deepinfra/zai-org/GLM-4.6` | 205K | | | | | | $0.43 | $2 |
|
|
66
68
|
| `deepinfra/zai-org/GLM-4.6V` | 205K | | | | | | $0.30 | $0.90 |
|
|
67
69
|
| `deepinfra/zai-org/GLM-4.7` | 203K | | | | | | $0.43 | $2 |
|
|
@@ -53,7 +53,7 @@ for await (const chunk of stream) {
|
|
|
53
53
|
| `google/gemini-2.5-pro-preview-tts` | 8K | | | | | | $1 | $20 |
|
|
54
54
|
| `google/gemini-3-flash-preview` | 1.0M | | | | | | $0.50 | $3 |
|
|
55
55
|
| `google/gemini-3-pro-preview` | 1.0M | | | | | | $2 | $12 |
|
|
56
|
-
| `google/gemini-3.1-flash-image-preview` | 131K | | | | | | $0.
|
|
56
|
+
| `google/gemini-3.1-flash-image-preview` | 131K | | | | | | $0.50 | $60 |
|
|
57
57
|
| `google/gemini-3.1-flash-lite` | 1.0M | | | | | | $0.25 | $2 |
|
|
58
58
|
| `google/gemini-3.1-flash-lite-preview` | 1.0M | | | | | | $0.25 | $2 |
|
|
59
59
|
| `google/gemini-3.1-pro-preview` | 1.0M | | | | | | $2 | $12 |
|
|
@@ -199,7 +199,7 @@ for await (const chunk of stream) {
|
|
|
199
199
|
| `kilo/moonshotai/kimi-k2-0905` | 131K | | | | | | $0.40 | $2 |
|
|
200
200
|
| `kilo/moonshotai/kimi-k2-thinking` | 131K | | | | | | $0.47 | $2 |
|
|
201
201
|
| `kilo/moonshotai/kimi-k2.5` | 262K | | | | | | $0.45 | $2 |
|
|
202
|
-
| `kilo/moonshotai/kimi-k2.6` | 262K | | | | | | $0.
|
|
202
|
+
| `kilo/moonshotai/kimi-k2.6` | 262K | | | | | | $0.75 | $4 |
|
|
203
203
|
| `kilo/morph/morph-v3-fast` | 82K | | | | | | $0.80 | $1 |
|
|
204
204
|
| `kilo/morph/morph-v3-large` | 262K | | | | | | $0.90 | $2 |
|
|
205
205
|
| `kilo/nex-agi/deepseek-v3.1-nex-n1` | 131K | | | | | | $0.27 | $1 |
|
|
@@ -219,7 +219,7 @@ for await (const chunk of stream) {
|
|
|
219
219
|
| `llmgateway/qwen3-vl-plus` | 262K | | | | | | $0.20 | $2 |
|
|
220
220
|
| `llmgateway/qwen3.6-35b-a3b` | 262K | | | | | | $0.25 | $1 |
|
|
221
221
|
| `llmgateway/qwen3.6-max-preview` | 262K | | | | | | $1 | $8 |
|
|
222
|
-
| `llmgateway/qwen3.6-plus` | 1.0M | | | | | | $0.
|
|
222
|
+
| `llmgateway/qwen3.6-plus` | 1.0M | | | | | | $0.50 | $3 |
|
|
223
223
|
| `llmgateway/qwen35-397b-a17b` | 262K | | | | | | $0.60 | $4 |
|
|
224
224
|
| `llmgateway/qwq-plus` | 131K | | | | | | $0.80 | $2 |
|
|
225
225
|
| `llmgateway/seed-1-6-250615` | 256K | | | | | | $0.25 | $2 |
|
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
# Wafer
|
|
2
2
|
|
|
3
|
-
Access
|
|
3
|
+
Access 2 Wafer models through Mastra's model router. Authentication is handled automatically using the `WAFER_API_KEY` environment variable.
|
|
4
4
|
|
|
5
5
|
Learn more in the [Wafer documentation](https://docs.wafer.ai/wafer-pass).
|
|
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: "wafer.ai/
|
|
18
|
+
model: "wafer.ai/GLM-5.1"
|
|
19
19
|
});
|
|
20
20
|
|
|
21
21
|
// Generate a response
|
|
@@ -34,9 +34,7 @@ for await (const chunk of stream) {
|
|
|
34
34
|
|
|
35
35
|
| Model | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
|
|
36
36
|
| ---------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
|
|
37
|
-
| `wafer.ai/DeepSeek-V4-Pro` | 1.0M | | | | | | — | — |
|
|
38
37
|
| `wafer.ai/GLM-5.1` | 203K | | | | | | — | — |
|
|
39
|
-
| `wafer.ai/MiniMax-M2.7` | 205K | | | | | | — | — |
|
|
40
38
|
| `wafer.ai/Qwen3.5-397B-A17B` | 262K | | | | | | — | — |
|
|
41
39
|
|
|
42
40
|
## Advanced configuration
|
|
@@ -49,7 +47,7 @@ const agent = new Agent({
|
|
|
49
47
|
name: "custom-agent",
|
|
50
48
|
model: {
|
|
51
49
|
url: "https://pass.wafer.ai/v1",
|
|
52
|
-
id: "wafer.ai/
|
|
50
|
+
id: "wafer.ai/GLM-5.1",
|
|
53
51
|
apiKey: process.env.WAFER_API_KEY,
|
|
54
52
|
headers: {
|
|
55
53
|
"X-Custom-Header": "value"
|
|
@@ -68,7 +66,7 @@ const agent = new Agent({
|
|
|
68
66
|
const useAdvanced = requestContext.task === "complex";
|
|
69
67
|
return useAdvanced
|
|
70
68
|
? "wafer.ai/Qwen3.5-397B-A17B"
|
|
71
|
-
: "wafer.ai/
|
|
69
|
+
: "wafer.ai/GLM-5.1";
|
|
72
70
|
}
|
|
73
71
|
});
|
|
74
72
|
```
|
|
@@ -16,12 +16,14 @@ Direct access to individual AI model providers. Each provider offers unique mode
|
|
|
16
16
|
- [Alibaba (China)](https://mastra.ai/models/providers/alibaba-cn)
|
|
17
17
|
- [Alibaba Coding Plan](https://mastra.ai/models/providers/alibaba-coding-plan)
|
|
18
18
|
- [Alibaba Coding Plan (China)](https://mastra.ai/models/providers/alibaba-coding-plan-cn)
|
|
19
|
+
- [Auriko](https://mastra.ai/models/providers/auriko)
|
|
19
20
|
- [Bailing](https://mastra.ai/models/providers/bailing)
|
|
20
21
|
- [Baseten](https://mastra.ai/models/providers/baseten)
|
|
21
22
|
- [Berget.AI](https://mastra.ai/models/providers/berget)
|
|
22
23
|
- [Cerebras](https://mastra.ai/models/providers/cerebras)
|
|
23
24
|
- [Chutes](https://mastra.ai/models/providers/chutes)
|
|
24
25
|
- [Clarifai](https://mastra.ai/models/providers/clarifai)
|
|
26
|
+
- [Claudinio](https://mastra.ai/models/providers/claudinio)
|
|
25
27
|
- [CloudFerro Sherlock](https://mastra.ai/models/providers/cloudferro-sherlock)
|
|
26
28
|
- [Cloudflare Workers AI](https://mastra.ai/models/providers/cloudflare-workers-ai)
|
|
27
29
|
- [Cortecs](https://mastra.ai/models/providers/cortecs)
|
|
@@ -118,6 +118,12 @@ Instead of an interactive prompt you can also define these CLI flags.
|
|
|
118
118
|
|
|
119
119
|
**--skills** (`string`): Comma-separated list of agents to install Mastra skills for (e.g., claude-code,cursor,windsurf)
|
|
120
120
|
|
|
121
|
+
**--observability** (`boolean`): Enable Observability on the Mastra platform during project creation. This opens browser login when needed, prompts for an organization, provisions a platform project, and configures the observability exporters.
|
|
122
|
+
|
|
123
|
+
**--no-observability** (`boolean`): Skip the Observability prompt during project creation.
|
|
124
|
+
|
|
125
|
+
**--observability-project** (`string`): Set the platform project name to use when Mastra Observability is enabled.
|
|
126
|
+
|
|
121
127
|
**--help** (`boolean`): Display help for command
|
|
122
128
|
|
|
123
129
|
## Telemetry
|
|
@@ -201,11 +201,13 @@ mastra studio deploy
|
|
|
201
201
|
|
|
202
202
|
The command runs `mastra build`, zips the output, reads an env file from the project directory, and uploads everything to the platform. After uploading, it polls the deploy status and streams build logs until the deploy reaches a terminal state.
|
|
203
203
|
|
|
204
|
+
The deploy command auto-loads the project's `.env` file. If `MASTRA_PROJECT_ID` points to a project that was provisioned for Observability, the deploy links to that project instead of creating a new one. Deploying Studio to an observability-only project converts it into a Studio project on the platform side.
|
|
205
|
+
|
|
204
206
|
The CLI requires at least one `.env` or `.env.*` file (excluding `.env.example`) in the project directory and fails with `Error: No env file found for deploy.` if none exists. When multiple env files are present, the CLI prompts you to pick one (defaulting to `.env.production`); pass `--env-file` to choose explicitly. With `--yes` and multiple env files, you must pass `--env-file` or the deploy errors.
|
|
205
207
|
|
|
206
208
|
Organization and project are resolved in order from: Environment variable flag, `.mastra-project.json` config file, current org from credentials, and lastly interactive prompt. On first deploy, the CLI saves the resolved IDs to `.mastra-project.json` so subsequent deploys skip the prompts.
|
|
207
209
|
|
|
208
|
-
If `--project <value>`
|
|
210
|
+
If `--project <value>` doesn't match an existing project (by ID or slug), the CLI treats `<value>` as a new project name and creates it after confirmation. Combined with `--yes`, this creates and deploys a new project in one non-interactive command:
|
|
209
211
|
|
|
210
212
|
```bash
|
|
211
213
|
mastra studio deploy --project "my-new-project" --yes
|
|
@@ -295,7 +297,7 @@ Shows diagnosis results and suggested fixes for a failed Studio deploy.
|
|
|
295
297
|
mastra studio deploy suggestions [deploy-id]
|
|
296
298
|
```
|
|
297
299
|
|
|
298
|
-
If you omit `deploy-id`, the command uses the latest deploy for the linked project. If a diagnosis
|
|
300
|
+
If you omit `deploy-id`, the command uses the latest deploy for the linked project. If a diagnosis doesn't exist yet, the command starts one and polls until results are ready. If the deploy is healthy, no suggestions are shown.
|
|
299
301
|
|
|
300
302
|
### `mastra studio projects`
|
|
301
303
|
|
|
@@ -303,12 +305,14 @@ Lists all projects in the current organization.
|
|
|
303
305
|
|
|
304
306
|
### `mastra studio projects create`
|
|
305
307
|
|
|
306
|
-
Creates a new project through an interactive prompt. This command
|
|
308
|
+
Creates a new project through an interactive prompt. This command doesn't accept a `--name` flag; for non-interactive project creation, use [`mastra studio deploy --project <name> --yes`](#mastra-studio-deploy) instead, which creates the project and deploys to it in one step.
|
|
307
309
|
|
|
308
310
|
## `mastra server deploy`
|
|
309
311
|
|
|
310
312
|
Builds and deploys your project to Server on Mastra platform. Works the same as [`mastra studio deploy`](#mastra-studio-deploy) with the same flags, arguments, and resolution logic.
|
|
311
313
|
|
|
314
|
+
The deploy command auto-loads the project's `.env` file. If `MASTRA_PROJECT_ID` points to a project that was provisioned for Observability, the deploy links to that project instead of creating a new one. Deploying Server to an observability-only project converts it into a Server project on the platform side.
|
|
315
|
+
|
|
312
316
|
```bash
|
|
313
317
|
mastra server deploy [dir]
|
|
314
318
|
```
|
|
@@ -321,7 +325,7 @@ Shows diagnosis results and suggested fixes for a failed Server deploy.
|
|
|
321
325
|
mastra server deploy suggestions [deploy-id]
|
|
322
326
|
```
|
|
323
327
|
|
|
324
|
-
If you omit `deploy-id`, the command uses the latest deploy for the linked project. If a diagnosis
|
|
328
|
+
If you omit `deploy-id`, the command uses the latest deploy for the linked project. If a diagnosis doesn't exist yet, the command starts one and polls until results are ready. If the deploy is healthy, no suggestions are shown.
|
|
325
329
|
|
|
326
330
|
## `mastra server pause`
|
|
327
331
|
|
|
@@ -339,13 +343,13 @@ Organization ID. Can also be set via the `MASTRA_ORG_ID` environment variable.
|
|
|
339
343
|
|
|
340
344
|
#### `--project`
|
|
341
345
|
|
|
342
|
-
Project ID or slug when `MASTRA_PROJECT_ID`
|
|
346
|
+
Project ID or slug when `MASTRA_PROJECT_ID` isn't set. Slugs are resolved against projects in the current organization.
|
|
343
347
|
|
|
344
348
|
#### `-c, --config`
|
|
345
349
|
|
|
346
350
|
Path to the project config file. Defaults to `.mastra-project.json`.
|
|
347
351
|
|
|
348
|
-
Fails if the instance
|
|
352
|
+
Fails if the instance isn't running.
|
|
349
353
|
|
|
350
354
|
## `mastra server restart`
|
|
351
355
|
|
|
@@ -359,7 +363,7 @@ Same flags as [`mastra server pause`](#mastra-server-pause): **`--org`**, **`--p
|
|
|
359
363
|
mastra server restart
|
|
360
364
|
```
|
|
361
365
|
|
|
362
|
-
Fails if a deployment is still active for this project (running, building, deploying, etc.); that
|
|
366
|
+
Fails if a deployment is still active for this project (running, building, deploying, etc.); that's a platform restriction so you can't restart while another deploy is in progress.
|
|
363
367
|
|
|
364
368
|
## `mastra server env`
|
|
365
369
|
|
|
@@ -440,7 +444,7 @@ Lists all organizations with your role in each. The current organization is mark
|
|
|
440
444
|
|
|
441
445
|
#### `mastra auth orgs switch`
|
|
442
446
|
|
|
443
|
-
Switches the active organization through an interactive prompt.
|
|
447
|
+
Switches the active organization through an interactive prompt. Can't be used when `MASTRA_API_TOKEN` or `MASTRA_ORG_ID` environment variables are set.
|
|
444
448
|
|
|
445
449
|
### `mastra auth tokens`
|
|
446
450
|
|
|
@@ -448,7 +452,7 @@ Lists all API tokens with their last-used date.
|
|
|
448
452
|
|
|
449
453
|
#### `mastra auth tokens create`
|
|
450
454
|
|
|
451
|
-
Creates a new API token. The secret is displayed once and
|
|
455
|
+
Creates a new API token. The secret is displayed once and can't be retrieved again.
|
|
452
456
|
|
|
453
457
|
```bash
|
|
454
458
|
mastra auth tokens create <name>
|
|
@@ -566,6 +570,18 @@ Don't include example code. Useful when using the `--default` flag.
|
|
|
566
570
|
|
|
567
571
|
Configure your code editor with Mastra's MCP server. Choose from: `"cursor" | "cursor-global" | "windsurf" | "vscode"`.
|
|
568
572
|
|
|
573
|
+
#### `--observability`
|
|
574
|
+
|
|
575
|
+
Enable Observability on the Mastra platform. The CLI prompts you to select an existing platform project or create a new one, writes the required environment variables, and configures the observability exporters.
|
|
576
|
+
|
|
577
|
+
#### `--no-observability`
|
|
578
|
+
|
|
579
|
+
Skip the Mastra Observability prompt.
|
|
580
|
+
|
|
581
|
+
#### `--observability-project`
|
|
582
|
+
|
|
583
|
+
Set the platform project name to use when Mastra Observability is enabled.
|
|
584
|
+
|
|
569
585
|
## `mastra migrate`
|
|
570
586
|
|
|
571
587
|
Runs database migrations to update your storage schema. This command is useful when upgrading Mastra versions that include storage schema changes.
|
|
@@ -584,7 +600,7 @@ It accepts [common flags](#common-flags).
|
|
|
584
600
|
|
|
585
601
|
## `mastra api`
|
|
586
602
|
|
|
587
|
-
Calls a Mastra runtime server with JSON input and JSON output. Use it for local development servers, deployed Mastra
|
|
603
|
+
Calls a Mastra runtime server with JSON input and JSON output. Use it for local development servers, deployed Mastra platform projects, or self-hosted Mastra servers.
|
|
588
604
|
|
|
589
605
|
```bash
|
|
590
606
|
mastra api agent list --pretty
|
|
@@ -626,9 +642,9 @@ The command resolves the target server in this order:
|
|
|
626
642
|
|
|
627
643
|
1. `--url <url>` for an explicit remote or self-hosted server.
|
|
628
644
|
2. `http://localhost:4111` for a local `mastra dev` server.
|
|
629
|
-
3. `.mastra-project.json` for a Mastra
|
|
645
|
+
3. `.mastra-project.json` for a Mastra platform project.
|
|
630
646
|
|
|
631
|
-
Automatic platform auth is only used when the CLI resolves a Mastra
|
|
647
|
+
Automatic platform auth is only used when the CLI resolves a Mastra platform target from `.mastra-project.json`. Localhost targets and explicit `--url` targets don't receive automatic credentials. Headers passed with `--header` are sent to any target, including localhost.
|
|
632
648
|
|
|
633
649
|
### Flags
|
|
634
650
|
|
|
@@ -660,7 +676,7 @@ Pretty-print JSON output. Defaults to `false`.
|
|
|
660
676
|
|
|
661
677
|
Print the CLI-oriented request schema for a command that accepts JSON input. The schema comes from the target server's route contracts and includes the command shape, positionals, examples, request schemas, and response shape.
|
|
662
678
|
|
|
663
|
-
`--schema` is available on leaf commands that accept JSON input. It
|
|
679
|
+
`--schema` is available on leaf commands that accept JSON input. It isn't available as a top-level `mastra api` flag.
|
|
664
680
|
|
|
665
681
|
```bash
|
|
666
682
|
mastra api agent run --schema
|
|
@@ -669,7 +685,7 @@ mastra api tool execute --schema
|
|
|
669
685
|
|
|
670
686
|
### Input model
|
|
671
687
|
|
|
672
|
-
Commands that accept input take one inline JSON argument.
|
|
688
|
+
Commands that accept input take one inline JSON argument. Don't pass file paths or stdin.
|
|
673
689
|
|
|
674
690
|
```bash
|
|
675
691
|
mastra api workflow run start data-pipeline '{"inputData":{"source":"s3://bucket/data.csv"}}'
|
|
@@ -711,7 +711,7 @@ By default, a subagent runs with a fresh context — it doesn't see the parent c
|
|
|
711
711
|
|
|
712
712
|
#### Enabling forked mode
|
|
713
713
|
|
|
714
|
-
Set `forked: true` either on the
|
|
714
|
+
Set `forked: true` either on the `HarnessSubagent` definition (per-type default) or on each `subagent` tool call (per-invocation override):
|
|
715
715
|
|
|
716
716
|
```typescript
|
|
717
717
|
// Per-type default — every call to this subagent forks unless overridden.
|
|
@@ -115,7 +115,7 @@ When you spot a spike in latency or token usage on the Metrics dashboard, correl
|
|
|
115
115
|
### No metrics are appearing
|
|
116
116
|
|
|
117
117
|
- **Observability is configured**: Verify that your `Mastra` instance has an `observability` config with at least one exporter.
|
|
118
|
-
- **`MastraStorageExporter` or `MastraPlatformExporter` is present**: Other exporters (Datadog, Langfuse, etc.) don't surface metrics in Mastra. `MastraStorageExporter` is required for the local Studio dashboard, and `MastraPlatformExporter` is required to view metrics in Mastra
|
|
118
|
+
- **`MastraStorageExporter` or `MastraPlatformExporter` is present**: Other exporters (Datadog, Langfuse, etc.) don't surface metrics in Mastra. `MastraStorageExporter` is required for the local Studio dashboard, and `MastraPlatformExporter` is required to view metrics in Mastra platform.
|
|
119
119
|
- **Storage supports metrics**: Metrics require an OLAP-capable store (ClickHouse or DuckDB). Row-oriented databases (PostgreSQL, LibSQL, MSSQL) and document stores (MongoDB) are not supported for metrics.
|
|
120
120
|
- **Sampling isn't 0%**: If sampling probability is `0` or strategy is `never`, all spans become no-ops and no metrics are extracted.
|
|
121
121
|
|
|
@@ -205,7 +205,7 @@ Shuts down all observability instances and clears the registry.
|
|
|
205
205
|
### Exporters
|
|
206
206
|
|
|
207
207
|
- [MastraStorageExporter](https://mastra.ai/reference/observability/tracing/exporters/mastra-storage-exporter): Persists observability events to Mastra Storage
|
|
208
|
-
- [MastraPlatformExporter](https://mastra.ai/reference/observability/tracing/exporters/mastra-platform-exporter): Sends observability events to Mastra
|
|
208
|
+
- [MastraPlatformExporter](https://mastra.ai/reference/observability/tracing/exporters/mastra-platform-exporter): Sends observability events to Mastra platform
|
|
209
209
|
- [Braintrust](https://mastra.ai/reference/observability/tracing/exporters/braintrust): Braintrust integration
|
|
210
210
|
- [Langfuse](https://mastra.ai/reference/observability/tracing/exporters/langfuse): Langfuse integration
|
|
211
211
|
- [LangSmith](https://mastra.ai/reference/observability/tracing/exporters/langsmith): LangSmith integration
|
|
@@ -60,9 +60,9 @@ Extends `BaseExporterConfig`, which includes:
|
|
|
60
60
|
|
|
61
61
|
The exporter reads these environment variables if not provided in config:
|
|
62
62
|
|
|
63
|
-
- `
|
|
63
|
+
- `MASTRA_PLATFORM_ACCESS_TOKEN` - Authentication token for `CloudExporter` requests
|
|
64
64
|
- `MASTRA_PROJECT_ID` - Project ID to use when deriving project-scoped collector routes such as `/projects/:projectId/ai/spans/publish`
|
|
65
|
-
- `
|
|
65
|
+
- `MASTRA_PLATFORM_OBSERVABILITY_ENDPOINT` - Observability endpoint override. Pass either a base origin or a full traces publish URL. Defaults to `https://observability.mastra.ai` in `@mastra/observability@1.9.2` and later
|
|
66
66
|
|
|
67
67
|
## Properties
|
|
68
68
|
|
|
@@ -60,9 +60,9 @@ Extends `BaseExporterConfig`, which includes:
|
|
|
60
60
|
|
|
61
61
|
The exporter reads these environment variables if not provided in config:
|
|
62
62
|
|
|
63
|
-
- `
|
|
63
|
+
- `MASTRA_PLATFORM_ACCESS_TOKEN` - Authentication token for `MastraPlatformExporter` requests
|
|
64
64
|
- `MASTRA_PROJECT_ID` - Project ID to use when deriving project-scoped collector routes such as `/projects/:projectId/ai/spans/publish`
|
|
65
|
-
- `
|
|
65
|
+
- `MASTRA_PLATFORM_OBSERVABILITY_ENDPOINT` - Observability endpoint override. Pass either a base origin or a full traces publish URL. Defaults to `https://observability.mastra.ai` in `@mastra/observability@1.9.2` and later
|
|
66
66
|
|
|
67
67
|
## Properties
|
|
68
68
|
|
|
@@ -190,7 +190,7 @@ Errors raised by `MastraPlatformExporter` use the `MASTRA_PLATFORM_EXPORTER_*` `
|
|
|
190
190
|
|
|
191
191
|
## Span wire format
|
|
192
192
|
|
|
193
|
-
The shape of each span sent to Mastra
|
|
193
|
+
The shape of each span sent to Mastra platform is documented here for reference only — it is not exported from `@mastra/observability` and should not be imported. The exporter spreads the original `AnyExportedSpan` (so the source field names are preserved) and layers a small set of platform-friendly aliases on top:
|
|
194
194
|
|
|
195
195
|
```typescript
|
|
196
196
|
type MastraPlatformSpanRecord = AnyExportedSpan & {
|
|
@@ -177,7 +177,7 @@ interface ObservabilityExporter {
|
|
|
177
177
|
}
|
|
178
178
|
```
|
|
179
179
|
|
|
180
|
-
Event callback payloads use observability event bus envelopes: `TracingEvent` carries span lifecycle events with `exportedSpan`, `LogEvent` wraps `ExportedLog` in `log`, `MetricEvent` wraps `ExportedMetric` in `metric`, `ScoreEvent` wraps `ExportedScore` in `score`, and `FeedbackEvent` wraps `ExportedFeedback` in `feedback`. For Mastra
|
|
180
|
+
Event callback payloads use observability event bus envelopes: `TracingEvent` carries span lifecycle events with `exportedSpan`, `LogEvent` wraps `ExportedLog` in `log`, `MetricEvent` wraps `ExportedMetric` in `metric`, `ScoreEvent` wraps `ExportedScore` in `score`, and `FeedbackEvent` wraps `ExportedFeedback` in `feedback`. For Mastra platform exporter behavior for these callbacks, see [MastraPlatformExporter](https://mastra.ai/reference/observability/tracing/exporters/mastra-platform-exporter).
|
|
181
181
|
|
|
182
182
|
### `ObservabilityDropEvent`
|
|
183
183
|
|
package/CHANGELOG.md
CHANGED
|
@@ -1,5 +1,19 @@
|
|
|
1
1
|
# @mastra/mcp-docs-server
|
|
2
2
|
|
|
3
|
+
## 1.1.36-alpha.2
|
|
4
|
+
|
|
5
|
+
### Patch Changes
|
|
6
|
+
|
|
7
|
+
- Updated dependencies [[`3e63fca`](https://github.com/mastra-ai/mastra/commit/3e63fca7aa41269b2a9518effdd09b8ab8f1ff04), [`bc386e0`](https://github.com/mastra-ai/mastra/commit/bc386e08249dd30f3e66cf59de0c151a8dc26afb)]:
|
|
8
|
+
- @mastra/core@1.33.1-alpha.1
|
|
9
|
+
|
|
10
|
+
## 1.1.36-alpha.0
|
|
11
|
+
|
|
12
|
+
### Patch Changes
|
|
13
|
+
|
|
14
|
+
- Updated dependencies [[`6ba46dc`](https://github.com/mastra-ai/mastra/commit/6ba46dc1ac04af635d0f59377d7384ca6af44cd1)]:
|
|
15
|
+
- @mastra/core@1.33.1-alpha.0
|
|
16
|
+
|
|
3
17
|
## 1.1.35
|
|
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.1.
|
|
3
|
+
"version": "1.1.36-alpha.3",
|
|
4
4
|
"description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -29,7 +29,7 @@
|
|
|
29
29
|
"jsdom": "^26.1.0",
|
|
30
30
|
"local-pkg": "^1.1.2",
|
|
31
31
|
"zod": "^4.3.6",
|
|
32
|
-
"@mastra/core": "1.33.
|
|
32
|
+
"@mastra/core": "1.33.1-alpha.1",
|
|
33
33
|
"@mastra/mcp": "^1.7.0"
|
|
34
34
|
},
|
|
35
35
|
"devDependencies": {
|
|
@@ -47,8 +47,8 @@
|
|
|
47
47
|
"typescript": "^6.0.3",
|
|
48
48
|
"vitest": "4.1.5",
|
|
49
49
|
"@internal/lint": "0.0.93",
|
|
50
|
-
"@
|
|
51
|
-
"@
|
|
50
|
+
"@mastra/core": "1.33.1-alpha.1",
|
|
51
|
+
"@internal/types-builder": "0.0.68"
|
|
52
52
|
},
|
|
53
53
|
"homepage": "https://mastra.ai",
|
|
54
54
|
"repository": {
|