@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.
Files changed (43) hide show
  1. package/.docs/docs/agents/a2a.md +235 -0
  2. package/.docs/docs/agents/response-caching.md +11 -11
  3. package/.docs/docs/agents/signals.md +1 -1
  4. package/.docs/docs/deployment/cloud-providers.md +1 -1
  5. package/.docs/docs/deployment/overview.md +6 -5
  6. package/.docs/docs/mastra-platform/configuration.md +22 -6
  7. package/.docs/docs/mastra-platform/observability.md +99 -0
  8. package/.docs/docs/mastra-platform/overview.md +12 -55
  9. package/.docs/{guides/deployment/mastra-platform.md → docs/mastra-platform/server.md} +30 -37
  10. package/.docs/docs/mastra-platform/studio.md +81 -0
  11. package/.docs/docs/observability/overview.md +10 -5
  12. package/.docs/docs/observability/tracing/exporters/mastra-platform.md +13 -13
  13. package/.docs/docs/observability/tracing/exporters/mastra-storage.md +1 -1
  14. package/.docs/docs/observability/tracing/overview.md +4 -4
  15. package/.docs/docs/server/mastra-client.md +1 -0
  16. package/.docs/docs/server/mastra-server.md +2 -1
  17. package/.docs/docs/studio/deployment.md +1 -37
  18. package/.docs/docs/studio/observability.md +28 -23
  19. package/.docs/docs/studio/overview.md +3 -3
  20. package/.docs/guides/getting-started/quickstart.md +4 -4
  21. package/.docs/guides/migrations/mastra-cloud.md +8 -8
  22. package/.docs/guides/migrations/upgrade-to-v1/tracing.md +2 -2
  23. package/.docs/models/index.md +1 -1
  24. package/.docs/models/providers/alibaba-cn.md +1 -1
  25. package/.docs/models/providers/alibaba.md +1 -1
  26. package/.docs/models/providers/auriko.md +85 -0
  27. package/.docs/models/providers/claudinio.md +71 -0
  28. package/.docs/models/providers/deepinfra.md +3 -1
  29. package/.docs/models/providers/google.md +1 -1
  30. package/.docs/models/providers/kilo.md +1 -1
  31. package/.docs/models/providers/llmgateway.md +1 -1
  32. package/.docs/models/providers/wafer.ai.md +4 -6
  33. package/.docs/models/providers.md +2 -0
  34. package/.docs/reference/cli/create-mastra.md +6 -0
  35. package/.docs/reference/cli/mastra.md +30 -14
  36. package/.docs/reference/harness/harness-class.md +1 -1
  37. package/.docs/reference/observability/metrics/automatic-metrics.md +1 -1
  38. package/.docs/reference/observability/tracing/configuration.md +1 -1
  39. package/.docs/reference/observability/tracing/exporters/cloud-exporter.md +2 -2
  40. package/.docs/reference/observability/tracing/exporters/mastra-platform-exporter.md +3 -3
  41. package/.docs/reference/observability/tracing/interfaces.md +1 -1
  42. package/CHANGELOG.md +14 -0
  43. 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.28 | $2 |
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 logo](https://models.dev/logos/auriko.svg)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 logo](https://models.dev/logos/claudinio.svg)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 logo](https://models.dev/logos/deepinfra.svg)Deep Infra
2
2
 
3
- Access 36 Deep Infra models through Mastra's model router. Authentication is handled automatically using the `DEEPINFRA_API_KEY` environment variable.
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.25 | $60 |
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.95 | $4 |
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.28 | $2 |
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 logo](https://models.dev/logos/wafer.ai.svg)Wafer
2
2
 
3
- Access 4 Wafer models through Mastra's model router. Authentication is handled automatically using the `WAFER_API_KEY` environment variable.
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/DeepSeek-V4-Pro"
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/DeepSeek-V4-Pro",
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/DeepSeek-V4-Pro";
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>` does not 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:
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 does not exist yet, the command starts one and polls until results are ready. If the deploy is healthy, no suggestions are shown.
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 does not 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.
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 does not exist yet, the command starts one and polls until results are ready. If the deploy is healthy, no suggestions are shown.
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` is not set. Slugs are resolved against projects in the current organization.
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 is not running.
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 is a platform restriction so you cannot restart while another deploy is in progress.
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. Cannot be used when `MASTRA_API_TOKEN` or `MASTRA_ORG_ID` environment variables are set.
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 cannot be retrieved again.
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 Platform projects, or self-hosted Mastra servers.
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 Platform project.
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 Platform target from `.mastra-project.json`. Localhost targets and explicit `--url` targets do not receive automatic credentials. Headers passed with `--header` are sent to any target, including localhost.
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 is not available as a top-level `mastra api` flag.
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. Do not pass file paths or stdin.
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 [`HarnessSubagent` definition](#configuration) (per-type default) or on each `subagent` tool call (per-invocation override):
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 Platform.
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 Platform
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
- - `MASTRA_CLOUD_ACCESS_TOKEN` - Authentication token for `CloudExporter` requests
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
- - `MASTRA_CLOUD_TRACES_ENDPOINT` - Traces 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
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
- - `MASTRA_CLOUD_ACCESS_TOKEN` - Authentication token for `MastraPlatformExporter` requests
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
- - `MASTRA_CLOUD_TRACES_ENDPOINT` - Traces 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
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 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:
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 Platform exporter behavior for these callbacks, see [MastraPlatformExporter](https://mastra.ai/reference/observability/tracing/exporters/mastra-platform-exporter).
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.35",
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.0",
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
- "@internal/types-builder": "0.0.68",
51
- "@mastra/core": "1.33.0"
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": {