@mastra/mcp-docs-server 1.1.40-alpha.1 → 1.1.40-alpha.5

package/.docs/docs/agents/signals.md

@@ -141,6 +141,44 @@ The model receives the custom signal as context like this:
 
 Use XML-safe signal type names and attribute names. Signal type names and attribute names can contain letters, numbers, underscores, periods, and hyphens. They must start with a letter or underscore.
 
+## Delivery attributes
+
+Use `ifActive.attributes` and `ifIdle.attributes` to tag a signal with context that depends on whether the agent is active or idle at delivery time. Mastra resolves the correct branch when the signal is accepted.
+
+```typescript
+agent.sendSignal(
+  {
+    type: 'user-message',
+    contents: 'Also cover the edge cases.',
+    attributes: { source: 'chat' },
+  },
+  {
+    resourceId: 'user_123',
+    threadId: 'thread_456',
+    ifActive: { attributes: { delivery: 'while-active' } },
+    ifIdle: { attributes: { delivery: 'message' } },
+  },
+)
+```
+
+When the agent is working, the model sees:
+
+```xml
+<user-message source="chat" delivery="while-active">Also cover the edge cases.</user-message>
+```
+
+When the agent is idle:
+
+```xml
+<user-message source="chat" delivery="message">Also cover the edge cases.</user-message>
+```
+
+Top-level `attributes` always apply. The selected branch's `attributes` are merged into them at delivery time. The `ifActive.attributes` branch merges when the signal is delivered to a running agent loop. The `ifIdle.attributes` branch merges when the signal wakes an idle thread. If the selected branch or its `attributes` field is `undefined`, no extra attributes are added.
+
+Delivery attributes work with any signal type and can carry any key-value pairs. The `delivery` name shown above is not a special Mastra API field. It is a custom attribute name used for this example; you can use any attribute names that fit your application.
+
+> **Note:** Visit [Agent.sendSignal() reference](https://mastra.ai/reference/agents/agent) for the full signal input and options types.
+
 ## Use the client SDK
 
 The JavaScript client exposes the same thread signal APIs. Use `subscribeToThread()` before `sendSignal()` so the client can render the stream that wakes from, or receives, the signal.

package/.docs/models/gateways/openrouter.md

@@ -1,6 +1,6 @@
 # ![OpenRouter logo](https://models.dev/logos/openrouter.svg)OpenRouter
 
-OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 357 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 358 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -72,7 +72,6 @@ ANTHROPIC_API_KEY=ant-...
 | `arcee-ai/coder-large`                                          |
 | `arcee-ai/maestro-reasoning`                                    |
 | `arcee-ai/spotlight`                                            |
-| `arcee-ai/trinity-large-preview`                                |
 | `arcee-ai/trinity-large-thinking`                               |
 | `arcee-ai/trinity-large-thinking:free`                          |
 | `arcee-ai/trinity-mini`                                         |
@@ -350,6 +349,7 @@ ANTHROPIC_API_KEY=ant-...
 | `qwen/qwen3.6-flash`                                            |
 | `qwen/qwen3.6-max-preview`                                      |
 | `qwen/qwen3.6-plus`                                             |
+| `qwen/qwen3.7-max`                                              |
 | `rekaai/reka-edge`                                              |
 | `rekaai/reka-flash-3`                                           |
 | `relace/relace-apply-3`                                         |
@@ -373,6 +373,7 @@ ANTHROPIC_API_KEY=ant-...
 | `x-ai/grok-4.20`                                                |
 | `x-ai/grok-4.20-multi-agent`                                    |
 | `x-ai/grok-4.3`                                                 |
+| `x-ai/grok-build-0.1`                                           |
 | `xiaomi/mimo-v2-flash`                                          |
 | `xiaomi/mimo-v2-omni`                                           |
 | `xiaomi/mimo-v2-pro`                                            |

package/.docs/models/gateways/vercel.md

@@ -1,6 +1,6 @@
 # ![Vercel logo](https://models.dev/logos/vercel.svg)Vercel
 
-Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 239 models through Mastra's model router.
+Vercel aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 243 models through Mastra's model router.
 
 Learn more in the [Vercel documentation](https://ai-sdk.dev/providers/ai-sdk-providers).
 
@@ -59,6 +59,7 @@ ANTHROPIC_API_KEY=ant-...
 | `alibaba/qwen3.5-plus`                         |
 | `alibaba/qwen3.6-27b`                          |
 | `alibaba/qwen3.6-plus`                         |
+| `alibaba/qwen3.7-max`                          |
 | `amazon/nova-2-lite`                           |
 | `amazon/nova-lite`                             |
 | `amazon/nova-micro`                            |
@@ -116,6 +117,7 @@ ANTHROPIC_API_KEY=ant-...
 | `google/gemini-3.1-flash-lite`                 |
 | `google/gemini-3.1-flash-lite-preview`         |
 | `google/gemini-3.1-pro-preview`                |
+| `google/gemini-3.5-flash`                      |
 | `google/gemini-embedding-001`                  |
 | `google/gemini-embedding-2`                    |
 | `google/gemma-4-26b-a4b-it`                    |
@@ -163,6 +165,7 @@ ANTHROPIC_API_KEY=ant-...
 | `mistral/mistral-embed`                        |
 | `mistral/mistral-large-3`                      |
 | `mistral/mistral-medium`                       |
+| `mistral/mistral-medium-3.5`                   |
 | `mistral/mistral-nemo`                         |
 | `mistral/mistral-small`                        |
 | `mistral/mixtral-8x22b-instruct`               |
@@ -254,6 +257,7 @@ ANTHROPIC_API_KEY=ant-...
 | `xai/grok-4.20-reasoning`                      |
 | `xai/grok-4.20-reasoning-beta`                 |
 | `xai/grok-4.3`                                 |
+| `xai/grok-build-0.1`                           |
 | `xai/grok-imagine-image`                       |
 | `xai/grok-imagine-image-pro`                   |
 | `xiaomi/mimo-v2-flash`                         |

package/.docs/models/index.md

@@ -1,6 +1,6 @@
 # Model Providers
 
-Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 4207 models from 121 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 4243 models from 124 providers through a single API.
 
 ## Features
 

package/.docs/models/providers/alibaba.md

@@ -1,6 +1,6 @@
 # ![Alibaba logo](https://models.dev/logos/alibaba.svg)Alibaba
 
-Access 48 Alibaba models through Mastra's model router. Authentication is handled automatically using the `DASHSCOPE_API_KEY` environment variable.
+Access 49 Alibaba models through Mastra's model router. Authentication is handled automatically using the `DASHSCOPE_API_KEY` environment variable.
 
 Learn more in the [Alibaba documentation](https://www.alibabacloud.com/help/en/model-studio/models).
 
@@ -81,6 +81,7 @@ for await (const chunk of stream) {
 | `alibaba/qwen3.6-35b-a3b`                    | 262K    |       |           |       |       |       | $0.25      | $1          |
 | `alibaba/qwen3.6-max-preview`                | 262K    |       |           |       |       |       | $1         | $8          |
 | `alibaba/qwen3.6-plus`                       | 1.0M    |       |           |       |       |       | $0.50      | $3          |
+| `alibaba/qwen3.7-max`                        | 1.0M    |       |           |       |       |       | $3         | $8          |
 | `alibaba/qwq-plus`                           | 131K    |       |           |       |       |       | $0.80      | $2          |
 
 ## Advanced configuration

package/.docs/models/providers/crof.md

@@ -0,0 +1,91 @@
+# ![CrofAI logo](https://models.dev/logos/crof.svg)CrofAI
+
+Access 21 CrofAI models through Mastra's model router. Authentication is handled automatically using the `CROF_API_KEY` environment variable.
+
+Learn more in the [CrofAI documentation](https://crof.ai/docs).
+
+```bash
+CROF_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "crof/deepseek-v3.2"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [CrofAI documentation](https://crof.ai/docs) for details.
+
+## Models
+
+| Model                            | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| -------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `crof/deepseek-v3.2`             | 164K    |       |           |       |       |       | $0.28      | $0.38       |
+| `crof/deepseek-v4-flash`         | 1.0M    |       |           |       |       |       | $0.12      | $0.21       |
+| `crof/deepseek-v4-pro`           | 1.0M    |       |           |       |       |       | $0.40      | $0.85       |
+| `crof/deepseek-v4-pro-precision` | 1.0M    |       |           |       |       |       | $1         | $3          |
+| `crof/gemma-4-31b-it`            | 262K    |       |           |       |       |       | $0.10      | $0.30       |
+| `crof/glm-4.7`                   | 203K    |       |           |       |       |       | $0.25      | $1          |
+| `crof/glm-4.7-flash`             | 200K    |       |           |       |       |       | $0.04      | $0.30       |
+| `crof/glm-5`                     | 203K    |       |           |       |       |       | $0.48      | $2          |
+| `crof/glm-5.1`                   | 203K    |       |           |       |       |       | $0.45      | $2          |
+| `crof/glm-5.1-precision`         | 203K    |       |           |       |       |       | $0.75      | $3          |
+| `crof/greg`                      | 229K    |       |           |       |       |       | $0.10      | $0.20       |
+| `crof/kimi-k2.5`                 | 262K    |       |           |       |       |       | $0.35      | $2          |
+| `crof/kimi-k2.5-lightning`       | 131K    |       |           |       |       |       | $1         | $3          |
+| `crof/kimi-k2.6`                 | 262K    |       |           |       |       |       | $0.50      | $2          |
+| `crof/kimi-k2.6-precision`       | 262K    |       |           |       |       |       | $0.55      | $3          |
+| `crof/mimo-v2.5-pro`             | 1.0M    |       |           |       |       |       | $0.50      | $2          |
+| `crof/mimo-v2.5-pro-precision`   | 1.0M    |       |           |       |       |       | $0.80      | $3          |
+| `crof/minimax-m2.5`              | 205K    |       |           |       |       |       | $0.11      | $0.95       |
+| `crof/qwen3.5-397b-a17b`         | 262K    |       |           |       |       |       | $0.35      | $2          |
+| `crof/qwen3.5-9b`                | 262K    |       |           |       |       |       | $0.04      | $0.15       |
+| `crof/qwen3.6-27b`               | 262K    |       |           |       |       |       | $0.20      | $2          |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://crof.ai/v1",
+    id: "crof/deepseek-v3.2",
+    apiKey: process.env.CROF_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "crof/qwen3.6-27b"
+      : "crof/deepseek-v3.2";
+  }
+});
+```

package/.docs/models/providers/inceptron.md

@@ -0,0 +1,74 @@
+# ![Inceptron logo](https://models.dev/logos/inceptron.svg)Inceptron
+
+Access 4 Inceptron models through Mastra's model router. Authentication is handled automatically using the `INCEPTRON_API_KEY` environment variable.
+
+Learn more in the [Inceptron documentation](https://docs.inceptron.io).
+
+```bash
+INCEPTRON_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "inceptron/MiniMaxAI/MiniMax-M2.5"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [Inceptron documentation](https://docs.inceptron.io) for details.
+
+## Models
+
+| Model                                         | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| --------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `inceptron/MiniMaxAI/MiniMax-M2.5`            | 197K    |       |           |       |       |       | $0.24      | $0.90       |
+| `inceptron/moonshotai/Kimi-K2.6`              | 262K    |       |           |       |       |       | $0.78      | $4          |
+| `inceptron/nvidia/llama-3.3-70b-instruct-fp8` | 131K    |       |           |       |       |       | $0.12      | $0.38       |
+| `inceptron/zai-org/GLM-5.1-FP8`               | 203K    |       |           |       |       |       | $1         | $4          |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.inceptron.io/v1",
+    id: "inceptron/MiniMaxAI/MiniMax-M2.5",
+    apiKey: process.env.INCEPTRON_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "inceptron/zai-org/GLM-5.1-FP8"
+      : "inceptron/MiniMaxAI/MiniMax-M2.5";
+  }
+});
+```

package/.docs/models/providers/llmgateway.md

@@ -1,6 +1,6 @@
 # ![LLM Gateway logo](https://models.dev/logos/llmgateway.svg)LLM Gateway
 
-Access 183 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
+Access 187 LLM Gateway models through Mastra's model router. Authentication is handled automatically using the `LLMGATEWAY_API_KEY` environment variable.
 
 Learn more in the [LLM Gateway documentation](https://llmgateway.io/docs).
 
@@ -68,6 +68,7 @@ for await (const chunk of stream) {
 | `llmgateway/gemini-3.1-flash-lite`             | 1.0M    |       |           |       |       |       | $0.25      | $2          |
 | `llmgateway/gemini-3.1-flash-lite-preview`     | 1.0M    |       |           |       |       |       | $0.25      | $2          |
 | `llmgateway/gemini-3.1-pro-preview`            | 1.0M    |       |           |       |       |       | $2         | $12         |
+| `llmgateway/gemini-3.5-flash`                  | 1.0M    |       |           |       |       |       | $2         | $9          |
 | `llmgateway/gemini-pro-latest`                 | 1.0M    |       |           |       |       |       | $2         | $12         |
 | `llmgateway/gemma-2-27b-it-together`           | 8K      |       |           |       |       |       | $0.08      | $0.08       |
 | `llmgateway/gemma-3-1b-it`                     | 1.0M    |       |           |       |       |       | $0.08      | $0.30       |
@@ -124,6 +125,8 @@ for await (const chunk of stream) {
 | `llmgateway/grok-4-1-fast-reasoning`           | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
 | `llmgateway/grok-4-20-beta-0309-non-reasoning` | 2.0M    |       |           |       |       |       | $1         | $3          |
 | `llmgateway/grok-4-20-beta-0309-reasoning`     | 2.0M    |       |           |       |       |       | $1         | $3          |
+| `llmgateway/grok-4-20-non-reasoning`           | 2.0M    |       |           |       |       |       | $1         | $3          |
+| `llmgateway/grok-4-20-reasoning`               | 2.0M    |       |           |       |       |       | $1         | $3          |
 | `llmgateway/grok-4-3`                          | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `llmgateway/grok-4-fast-reasoning`             | 2.0M    |       |           |       |       |       | $0.20      | $0.50       |
 | `llmgateway/hermes-2-pro-llama-3-8b`           | 8K      |       |           |       |       |       | $0.14      | $0.14       |
@@ -209,6 +212,7 @@ for await (const chunk of stream) {
 | `llmgateway/qwen3.6-max-preview`               | 262K    |       |           |       |       |       | $1         | $8          |
 | `llmgateway/qwen3.6-plus`                      | 1.0M    |       |           |       |       |       | $0.50      | $3          |
 | `llmgateway/qwen35-397b-a17b`                  | 262K    |       |           |       |       |       | $0.60      | $4          |
+| `llmgateway/qwen37-max`                        | 1.0M    |       |           |       |       |       | $3         | $8          |
 | `llmgateway/qwq-plus`                          | 131K    |       |           |       |       |       | $0.80      | $2          |
 | `llmgateway/seed-1-6-250615`                   | 256K    |       |           |       |       |       | $0.25      | $2          |
 | `llmgateway/seed-1-6-250915`                   | 256K    |       |           |       |       |       | $0.25      | $2          |

package/.docs/models/providers/opencode.md

@@ -1,6 +1,6 @@
 # ![OpenCode Zen logo](https://models.dev/logos/opencode.svg)OpenCode Zen
 
-Access 41 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
+Access 40 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
 
 Learn more in the [OpenCode Zen documentation](https://opencode.ai/docs/zen).
 
@@ -74,7 +74,6 @@ for await (const chunk of stream) {
 | `opencode/nemotron-3-super-free`  | 205K    |       |           |       |       |       | —          | —           |
 | `opencode/qwen3.5-plus`           | 262K    |       |           |       |       |       | $0.20      | $1          |
 | `opencode/qwen3.6-plus`           | 262K    |       |           |       |       |       | $0.50      | $3          |
-| `opencode/qwen3.6-plus-free`      | 262K    |       |           |       |       |       | —          | —           |
 
 ## Advanced configuration
 
@@ -104,7 +103,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "opencode/qwen3.6-plus-free"
+      ? "opencode/qwen3.6-plus"
       : "opencode/big-pickle";
   }
 });

package/.docs/models/providers/stepfun-ai.md

@@ -0,0 +1,72 @@
+# ![StepFun logo](https://models.dev/logos/stepfun-ai.svg)StepFun
+
+Access 2 StepFun models through Mastra's model router. Authentication is handled automatically using the `STEPFUN_API_KEY` environment variable.
+
+Learn more in the [StepFun documentation](https://platform.stepfun.ai/docs/en/step-plan/integrations/open-code).
+
+```bash
+STEPFUN_API_KEY=your-api-key
+```
+
+```typescript
+import { Agent } from "@mastra/core/agent";
+
+const agent = new Agent({
+  id: "my-agent",
+  name: "My Agent",
+  instructions: "You are a helpful assistant",
+  model: "stepfun-ai/step-3.5-flash"
+});
+
+// Generate a response
+const response = await agent.generate("Hello!");
+
+// Stream a response
+const stream = await agent.stream("Tell me a story");
+for await (const chunk of stream) {
+  console.log(chunk);
+}
+```
+
+> **Info:** Mastra uses the OpenAI-compatible `/chat/completions` endpoint. Some provider-specific features may not be available. Check the [StepFun documentation](https://platform.stepfun.ai/docs/en/step-plan/integrations/open-code) for details.
+
+## Models
+
+| Model                            | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| -------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `stepfun-ai/step-3.5-flash`      | 256K    |       |           |       |       |       | $0.10      | $0.29       |
+| `stepfun-ai/step-3.5-flash-2603` | 256K    |       |           |       |       |       | $0.10      | $0.30       |
+
+## Advanced configuration
+
+### Custom headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.stepfun.ai/step_plan/v1",
+    id: "stepfun-ai/step-3.5-flash",
+    apiKey: process.env.STEPFUN_API_KEY,
+    headers: {
+      "X-Custom-Header": "value"
+    }
+  }
+});
+```
+
+### Dynamic model selection
+
+```typescript
+const agent = new Agent({
+  id: "dynamic-agent",
+  name: "Dynamic Agent",
+  model: ({ requestContext }) => {
+    const useAdvanced = requestContext.task === "complex";
+    return useAdvanced
+      ? "stepfun-ai/step-3.5-flash-2603"
+      : "stepfun-ai/step-3.5-flash";
+  }
+});
+```

package/.docs/models/providers.md

@@ -29,6 +29,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [CloudFerro Sherlock](https://mastra.ai/models/providers/cloudferro-sherlock)
 - [Cloudflare Workers AI](https://mastra.ai/models/providers/cloudflare-workers-ai)
 - [Cortecs](https://mastra.ai/models/providers/cortecs)
+- [CrofAI](https://mastra.ai/models/providers/crof)
 - [D.Run (China)](https://mastra.ai/models/providers/drun)
 - [Databricks](https://mastra.ai/models/providers/databricks)
 - [Deep Infra](https://mastra.ai/models/providers/deepinfra)
@@ -47,6 +48,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Hugging Face](https://mastra.ai/models/providers/huggingface)
 - [iFlow](https://mastra.ai/models/providers/iflowcn)
 - [Inception](https://mastra.ai/models/providers/inception)
+- [Inceptron](https://mastra.ai/models/providers/inceptron)
 - [Inference](https://mastra.ai/models/providers/inference)
 - [IO.NET](https://mastra.ai/models/providers/io-net)
 - [Jiekou.AI](https://mastra.ai/models/providers/jiekou)
@@ -96,6 +98,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [SiliconFlow (China)](https://mastra.ai/models/providers/siliconflow-cn)
 - [STACKIT](https://mastra.ai/models/providers/stackit)
 - [StepFun](https://mastra.ai/models/providers/stepfun)
+- [StepFun](https://mastra.ai/models/providers/stepfun-ai)
 - [submodel](https://mastra.ai/models/providers/submodel)
 - [Synthetic](https://mastra.ai/models/providers/synthetic)
 - [Tencent Coding Plan (China)](https://mastra.ai/models/providers/tencent-coding-plan)

package/.docs/reference/client-js/agents.md

@@ -464,6 +464,37 @@ response.processDataStream({
 })
 ```
 
+### Tracing client tools
+
+When `@mastra/observability` is installed and configured on the server, a client-side tool records a `CLIENT_TOOL_CALL` span as a child of the current `AGENT_RUN` span. The server creates that span when the model emits the client tool call, injects a W3C trace carrier into the outgoing tool-call chunk, and ends the span once the tool arguments are available. Without server-side observability configured, client tool tracing is a no-op.
+
+The client SDK also measures the wall-clock duration of each client tool's `execute` function and ships it back to the server, where it's emitted as a `mastra_tool_duration_ms` metric with `toolType: "client"`.
+
+For richer telemetry from inside your tool's `execute` function, use the `observe` helper on the execution context to add child spans and structured logs:
+
+```typescript
+import { createTool } from '@mastra/client-js'
+import { z } from 'zod'
+
+const fetchUserTool = createTool({
+  id: 'fetchUser',
+  description: 'Fetches the current user profile',
+  inputSchema: z.object({ userId: z.string() }),
+  execute: async ({ userId }, { observe }) => {
+    observe.log('info', 'fetching user', { userId })
+    const user = await observe.span('http GET /users', async () => {
+      const res = await fetch(`/api/users/${userId}`)
+      return res.json()
+    })
+    return user
+  },
+})
+```
+
+`observe` is always available — when no tracing context is active (e.g. running outside a traced agent), `span` runs the function directly and `log` is a no-op. No null-checking needed.
+
+The SDK serializes everything the collector buffered as OTLP/JSON and ships it back in the next request body. The server's `@mastra/observability` package validates that the spans belong to the correct trace (preventing cross-trace injection) and forwards each span/log into the same observability bus that server-side telemetry uses. Your existing exporters pick them up automatically after observability is configured.
+
 ## Stored agents
 
 Stored agents are agent configurations stored in a database that can be created, updated, and deleted at runtime. They reference primitives (tools, workflows, other agents, scorers) by key, which are resolved from the Mastra registry when the agent is instantiated. Memory is configured inline as a `SerializedMemoryConfig` object with options such as `lastMessages` and `semanticRecall`.

package/.docs/reference/observability/tracing/exporters/sentry.md

@@ -146,6 +146,7 @@ The exporter sets these standard OpenTelemetry attributes:
 
 - `sentry.origin`: `auto.ai.mastra` (identifies spans from Mastra)
 - `ai.span.type`: Mastra span type
+- `gen_ai.conversation.id`: Chat thread identifier, set from `metadata.threadId` to group spans in Sentry's Conversations view
 
 **MODEL\_GENERATION spans:**
 

package/.docs/reference/observability/tracing/interfaces.md

@@ -43,6 +43,7 @@ interface SpanTypeMap {
   MODEL_STEP: ModelStepAttributes
   MODEL_CHUNK: ModelChunkAttributes
   TOOL_CALL: ToolCallAttributes
+  CLIENT_TOOL_CALL: ClientToolCallAttributes
   MCP_TOOL_CALL: MCPToolCallAttributes
   PROCESSOR_RUN: ProcessorRunAttributes
   WORKFLOW_STEP: WorkflowStepAttributes
@@ -255,6 +256,18 @@ enum SpanType {
   /** Function/tool execution with inputs, outputs, errors */
   TOOL_CALL = 'tool_call',
 
+  /**
+   * Client-side tool execution marker. The server creates this span
+   * when the model emits a client tool call, injects its W3C carrier
+   * into the outgoing tool-call chunk, then ends the span once tool
+   * args are available. Child spans/logs from the client SDK flow back
+   * as OTLP/JSON via the ClientObservabilityProxy interface in
+   * @mastra/observability and parent themselves under this span.
+   * See the "Client tools" section in the @mastra/client-js reference
+   * for the full flow.
+   */
+  CLIENT_TOOL_CALL = 'client_tool_call',
+
   /** Workflow run - root span for workflow processes */
   WORKFLOW_RUN = 'workflow_run',
 

package/CHANGELOG.md

@@ -1,5 +1,19 @@
 # @mastra/mcp-docs-server
 
+## 1.1.40-alpha.4
+
+### Patch Changes
+
+- Updated dependencies [[`df1947a`](https://github.com/mastra-ai/mastra/commit/df1947affa40f742067542251fac7ca759492ef4), [`ee59b74`](https://github.com/mastra-ai/mastra/commit/ee59b743ce73ad11784b4d9c6fbba8568edee1c8), [`a97b1a0`](https://github.com/mastra-ai/mastra/commit/a97b1a0abaed83946c3519d1e0f680d0815b8a67)]:
+  - @mastra/core@1.37.0-alpha.2
+
+## 1.1.40-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [[`2f5f58a`](https://github.com/mastra-ai/mastra/commit/2f5f58a9a8bb13bcdc6789db221eef7c9bf1ff02)]:
+  - @mastra/core@1.37.0-alpha.1
+
 ## 1.1.40-alpha.0
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.40-alpha.1",
+  "version": "1.1.40-alpha.5",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,8 +29,8 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.3.6",
-    "@mastra/mcp": "^1.8.0",
-    "@mastra/core": "1.36.1-alpha.0"
+    "@mastra/core": "1.37.0-alpha.2",
+    "@mastra/mcp": "^1.8.0"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
@@ -47,8 +47,8 @@
     "typescript": "^6.0.3",
     "vitest": "4.1.5",
     "@internal/lint": "0.0.97",
-    "@internal/types-builder": "0.0.72",
-    "@mastra/core": "1.36.1-alpha.0"
+    "@mastra/core": "1.37.0-alpha.2",
+    "@internal/types-builder": "0.0.72"
   },
   "homepage": "https://mastra.ai",
   "repository": {