@mastra/mcp-docs-server 1.1.1 → 1.1.2

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

@@ -1,6 +1,6 @@
 # ![OpenCode Zen logo](https://models.dev/logos/opencode.svg)OpenCode Zen
 
-Access 28 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
+Access 27 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).
 
@@ -32,36 +32,35 @@ for await (const chunk of stream) {
 
 ## Models
 
-| Model                                 | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
-| ------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `opencode/big-pickle`                 | 200K    |       |           |       |       |       | —          | —           |
-| `opencode/claude-3-5-haiku`           | 200K    |       |           |       |       |       | $0.80      | $4          |
-| `opencode/claude-haiku-4-5`           | 200K    |       |           |       |       |       | $1         | $5          |
-| `opencode/claude-opus-4-1`            | 200K    |       |           |       |       |       | $15        | $75         |
-| `opencode/claude-opus-4-5`            | 200K    |       |           |       |       |       | $5         | $25         |
-| `opencode/claude-opus-4-6`            | 1.0M    |       |           |       |       |       | $5         | $25         |
-| `opencode/claude-sonnet-4`            | 1.0M    |       |           |       |       |       | $3         | $15         |
-| `opencode/claude-sonnet-4-5`          | 1.0M    |       |           |       |       |       | $3         | $15         |
-| `opencode/gemini-3-flash`             | 1.0M    |       |           |       |       |       | $0.50      | $3          |
-| `opencode/gemini-3-pro`               | 1.0M    |       |           |       |       |       | $2         | $12         |
-| `opencode/glm-4.6`                    | 205K    |       |           |       |       |       | $0.60      | $2          |
-| `opencode/glm-4.7`                    | 205K    |       |           |       |       |       | $0.60      | $2          |
-| `opencode/gpt-5`                      | 272K    |       |           |       |       |       | $1         | $9          |
-| `opencode/gpt-5-codex`                | 272K    |       |           |       |       |       | $1         | $9          |
-| `opencode/gpt-5-nano`                 | 272K    |       |           |       |       |       | —          | —           |
-| `opencode/gpt-5.1`                    | 272K    |       |           |       |       |       | $1         | $9          |
-| `opencode/gpt-5.1-codex`              | 272K    |       |           |       |       |       | $1         | $9          |
-| `opencode/gpt-5.1-codex-max`          | 272K    |       |           |       |       |       | $1         | $10         |
-| `opencode/gpt-5.1-codex-mini`         | 272K    |       |           |       |       |       | $0.25      | $2          |
-| `opencode/gpt-5.2`                    | 272K    |       |           |       |       |       | $2         | $14         |
-| `opencode/gpt-5.2-codex`              | 272K    |       |           |       |       |       | $2         | $14         |
-| `opencode/kimi-k2`                    | 262K    |       |           |       |       |       | $0.40      | $3          |
-| `opencode/kimi-k2-thinking`           | 262K    |       |           |       |       |       | $0.40      | $3          |
-| `opencode/kimi-k2.5`                  | 262K    |       |           |       |       |       | $0.60      | $3          |
-| `opencode/kimi-k2.5-free`             | 262K    |       |           |       |       |       | —          | —           |
-| `opencode/minimax-m2.1`               | 205K    |       |           |       |       |       | $0.30      | $1          |
-| `opencode/minimax-m2.1-free`          | 205K    |       |           |       |       |       | —          | —           |
-| `opencode/trinity-large-preview-free` | 131K    |       |           |       |       |       | —          | —           |
+| Model                         | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ----------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `opencode/big-pickle`         | 200K    |       |           |       |       |       | —          | —           |
+| `opencode/claude-3-5-haiku`   | 200K    |       |           |       |       |       | $0.80      | $4          |
+| `opencode/claude-haiku-4-5`   | 200K    |       |           |       |       |       | $1         | $5          |
+| `opencode/claude-opus-4-1`    | 200K    |       |           |       |       |       | $15        | $75         |
+| `opencode/claude-opus-4-5`    | 200K    |       |           |       |       |       | $5         | $25         |
+| `opencode/claude-opus-4-6`    | 1.0M    |       |           |       |       |       | $5         | $25         |
+| `opencode/claude-sonnet-4`    | 1.0M    |       |           |       |       |       | $3         | $15         |
+| `opencode/claude-sonnet-4-5`  | 1.0M    |       |           |       |       |       | $3         | $15         |
+| `opencode/gemini-3-flash`     | 1.0M    |       |           |       |       |       | $0.50      | $3          |
+| `opencode/gemini-3-pro`       | 1.0M    |       |           |       |       |       | $2         | $12         |
+| `opencode/glm-4.6`            | 205K    |       |           |       |       |       | $0.60      | $2          |
+| `opencode/glm-4.7`            | 205K    |       |           |       |       |       | $0.60      | $2          |
+| `opencode/gpt-5`              | 400K    |       |           |       |       |       | $1         | $9          |
+| `opencode/gpt-5-codex`        | 400K    |       |           |       |       |       | $1         | $9          |
+| `opencode/gpt-5-nano`         | 400K    |       |           |       |       |       | —          | —           |
+| `opencode/gpt-5.1`            | 400K    |       |           |       |       |       | $1         | $9          |
+| `opencode/gpt-5.1-codex`      | 400K    |       |           |       |       |       | $1         | $9          |
+| `opencode/gpt-5.1-codex-max`  | 400K    |       |           |       |       |       | $1         | $10         |
+| `opencode/gpt-5.1-codex-mini` | 400K    |       |           |       |       |       | $0.25      | $2          |
+| `opencode/gpt-5.2`            | 400K    |       |           |       |       |       | $2         | $14         |
+| `opencode/gpt-5.2-codex`      | 400K    |       |           |       |       |       | $2         | $14         |
+| `opencode/kimi-k2`            | 262K    |       |           |       |       |       | $0.40      | $3          |
+| `opencode/kimi-k2-thinking`   | 262K    |       |           |       |       |       | $0.40      | $3          |
+| `opencode/kimi-k2.5`          | 262K    |       |           |       |       |       | $0.60      | $3          |
+| `opencode/kimi-k2.5-free`     | 262K    |       |           |       |       |       | —          | —           |
+| `opencode/minimax-m2.1`       | 205K    |       |           |       |       |       | $0.30      | $1          |
+| `opencode/minimax-m2.5-free`  | 205K    |       |           |       |       |       | —          | —           |
 
 ## Advanced Configuration
 
@@ -91,7 +90,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "opencode/trinity-large-preview-free"
+      ? "opencode/minimax-m2.5-free"
       : "opencode/big-pickle";
   }
 });

package/.docs/models/providers/stackit.md

@@ -0,0 +1,78 @@
+# ![STACKIT logo](https://models.dev/logos/stackit.svg)STACKIT
+
+Access 8 STACKIT models through Mastra's model router. Authentication is handled automatically using the `STACKIT_API_KEY` environment variable.
+
+Learn more in the [STACKIT documentation](https://docs.stackit.cloud/products/data-and-ai/ai-model-serving/basics/available-shared-models).
+
+```bash
+STACKIT_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: "stackit/Qwen/Qwen3-VL-235B-A22B-Instruct-FP8"
+});
+
+// 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 [STACKIT documentation](https://docs.stackit.cloud/products/data-and-ai/ai-model-serving/basics/available-shared-models) for details.
+
+## Models
+
+| Model                                                | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
+| ---------------------------------------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
+| `stackit/cortecs/Llama-3.3-70B-Instruct-FP8-Dynamic` | 128K    |       |           |       |       |       | $0.49      | $0.71       |
+| `stackit/google/gemma-3-27b-it`                      | 37K     |       |           |       |       |       | $0.49      | $0.71       |
+| `stackit/intfloat/e5-mistral-7b-instruct`            | 4K      |       |           |       |       |       | $0.02      | $0.02       |
+| `stackit/neuralmagic/Meta-Llama-3.1-8B-Instruct-FP8` | 128K    |       |           |       |       |       | $0.16      | $0.27       |
+| `stackit/neuralmagic/Mistral-Nemo-Instruct-2407-FP8` | 128K    |       |           |       |       |       | $0.49      | $0.71       |
+| `stackit/openai/gpt-oss-120b`                        | 131K    |       |           |       |       |       | $0.49      | $0.71       |
+| `stackit/Qwen/Qwen3-VL-235B-A22B-Instruct-FP8`       | 218K    |       |           |       |       |       | $2         | $2          |
+| `stackit/Qwen/Qwen3-VL-Embedding-8B`                 | 32K     |       |           |       |       |       | $0.09      | $0.09       |
+
+## Advanced Configuration
+
+### Custom Headers
+
+```typescript
+const agent = new Agent({
+  id: "custom-agent",
+  name: "custom-agent",
+  model: {
+    url: "https://api.openai-compat.model-serving.eu01.onstackit.cloud/v1",
+    id: "stackit/Qwen/Qwen3-VL-235B-A22B-Instruct-FP8",
+    apiKey: process.env.STACKIT_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
+      ? "stackit/openai/gpt-oss-120b"
+      : "stackit/Qwen/Qwen3-VL-235B-A22B-Instruct-FP8";
+  }
+});
+```

package/.docs/models/providers/synthetic.md

@@ -52,12 +52,12 @@ for await (const chunk of stream) {
 | `synthetic/hf:moonshotai/Kimi-K2-Instruct-0905`                  | 262K    |       |           |       |       |       | $1         | $1          |
 | `synthetic/hf:moonshotai/Kimi-K2-Thinking`                       | 262K    |       |           |       |       |       | $0.55      | $2          |
 | `synthetic/hf:moonshotai/Kimi-K2.5`                              | 262K    |       |           |       |       |       | $0.55      | $2          |
+| `synthetic/hf:nvidia/Kimi-K2.5-NVFP4`                            | 262K    |       |           |       |       |       | $0.55      | $2          |
 | `synthetic/hf:openai/gpt-oss-120b`                               | 128K    |       |           |       |       |       | $0.10      | $0.10       |
 | `synthetic/hf:Qwen/Qwen2.5-Coder-32B-Instruct`                   | 33K     |       |           |       |       |       | $0.80      | $0.80       |
 | `synthetic/hf:Qwen/Qwen3-235B-A22B-Instruct-2507`                | 256K    |       |           |       |       |       | $0.20      | $0.60       |
 | `synthetic/hf:Qwen/Qwen3-235B-A22B-Thinking-2507`                | 256K    |       |           |       |       |       | $0.65      | $3          |
 | `synthetic/hf:Qwen/Qwen3-Coder-480B-A35B-Instruct`               | 256K    |       |           |       |       |       | $2         | $2          |
-| `synthetic/hf:zai-org/GLM-4.5`                                   | 128K    |       |           |       |       |       | $0.55      | $2          |
 | `synthetic/hf:zai-org/GLM-4.6`                                   | 200K    |       |           |       |       |       | $0.55      | $2          |
 | `synthetic/hf:zai-org/GLM-4.7`                                   | 200K    |       |           |       |       |       | $0.55      | $2          |
 

package/.docs/models/providers/zai-coding-plan.md

@@ -1,6 +1,6 @@
 # ![Z.AI Coding Plan logo](https://models.dev/logos/zai-coding-plan.svg)Z.AI Coding Plan
 
-Access 8 Z.AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
+Access 9 Z.AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
 
 Learn more in the [Z.AI Coding Plan documentation](https://docs.z.ai/devpack/overview).
 
@@ -42,6 +42,7 @@ for await (const chunk of stream) {
 | `zai-coding-plan/glm-4.6v`      | 128K    |       |           |       |       |       | —          | —           |
 | `zai-coding-plan/glm-4.7`       | 205K    |       |           |       |       |       | —          | —           |
 | `zai-coding-plan/glm-4.7-flash` | 200K    |       |           |       |       |       | —          | —           |
+| `zai-coding-plan/glm-5`         | 205K    |       |           |       |       |       | —          | —           |
 
 ## Advanced Configuration
 
@@ -71,7 +72,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "zai-coding-plan/glm-4.7-flash"
+      ? "zai-coding-plan/glm-5"
       : "zai-coding-plan/glm-4.5";
   }
 });

package/.docs/models/providers/zai.md

@@ -1,6 +1,6 @@
 # ![Z.AI logo](https://models.dev/logos/zai.svg)Z.AI
 
-Access 8 Z.AI models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
+Access 9 Z.AI models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
 
 Learn more in the [Z.AI documentation](https://docs.z.ai/guides/overview/pricing).
 
@@ -42,6 +42,7 @@ for await (const chunk of stream) {
 | `zai/glm-4.6v`      | 128K    |       |           |       |       |       | $0.30      | $0.90       |
 | `zai/glm-4.7`       | 205K    |       |           |       |       |       | $0.60      | $2          |
 | `zai/glm-4.7-flash` | 200K    |       |           |       |       |       | —          | —           |
+| `zai/glm-5`         | 205K    |       |           |       |       |       | $1         | $3          |
 
 ## Advanced Configuration
 
@@ -71,7 +72,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "zai/glm-4.7-flash"
+      ? "zai/glm-5"
       : "zai/glm-4.5";
   }
 });

package/.docs/models/providers/zhipuai-coding-plan.md

@@ -1,6 +1,6 @@
 # ![Zhipu AI Coding Plan logo](https://models.dev/logos/zhipuai-coding-plan.svg)Zhipu AI Coding Plan
 
-Access 8 Zhipu AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
+Access 9 Zhipu AI Coding Plan models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
 
 Learn more in the [Zhipu AI Coding Plan documentation](https://docs.bigmodel.cn/cn/coding-plan/overview).
 
@@ -42,6 +42,7 @@ for await (const chunk of stream) {
 | `zhipuai-coding-plan/glm-4.6v`       | 128K    |       |           |       |       |       | —          | —           |
 | `zhipuai-coding-plan/glm-4.6v-flash` | 128K    |       |           |       |       |       | —          | —           |
 | `zhipuai-coding-plan/glm-4.7`        | 205K    |       |           |       |       |       | —          | —           |
+| `zhipuai-coding-plan/glm-5`          | 205K    |       |           |       |       |       | —          | —           |
 
 ## Advanced Configuration
 
@@ -71,7 +72,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "zhipuai-coding-plan/glm-4.7"
+      ? "zhipuai-coding-plan/glm-5"
       : "zhipuai-coding-plan/glm-4.5";
   }
 });

package/.docs/models/providers/zhipuai.md

@@ -1,6 +1,6 @@
 # ![Zhipu AI logo](https://models.dev/logos/zhipuai.svg)Zhipu AI
 
-Access 8 Zhipu AI models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
+Access 9 Zhipu AI models through Mastra's model router. Authentication is handled automatically using the `ZHIPU_API_KEY` environment variable.
 
 Learn more in the [Zhipu AI documentation](https://docs.z.ai/guides/overview/pricing).
 
@@ -42,6 +42,7 @@ for await (const chunk of stream) {
 | `zhipuai/glm-4.6v`      | 128K    |       |           |       |       |       | $0.30      | $0.90       |
 | `zhipuai/glm-4.7`       | 205K    |       |           |       |       |       | $0.60      | $2          |
 | `zhipuai/glm-4.7-flash` | 200K    |       |           |       |       |       | —          | —           |
+| `zhipuai/glm-5`         | 205K    |       |           |       |       |       | $1         | $3          |
 
 ## Advanced Configuration
 
@@ -71,7 +72,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "zhipuai/glm-4.7-flash"
+      ? "zhipuai/glm-5"
       : "zhipuai/glm-4.5";
   }
 });

package/.docs/models/providers.md

@@ -63,6 +63,7 @@ Direct access to individual AI model providers. Each provider offers unique mode
 - [Scaleway](https://mastra.ai/models/providers/scaleway)
 - [SiliconFlow](https://mastra.ai/models/providers/siliconflow)
 - [SiliconFlow (China)](https://mastra.ai/models/providers/siliconflow-cn)
+- [STACKIT](https://mastra.ai/models/providers/stackit)
 - [submodel](https://mastra.ai/models/providers/submodel)
 - [Synthetic](https://mastra.ai/models/providers/synthetic)
 - [Together AI](https://mastra.ai/models/providers/togetherai)

package/.docs/reference/ai-sdk/with-mastra.md

@@ -40,7 +40,7 @@ const { text } = await generateText({
 
 **options.memory?:** (`WithMastraMemoryOptions`): Memory configuration - enables automatic message history persistence.
 
-**options.memory.storage:** (`MemoryStorage`): Storage adapter for message persistence (e.g., LibSQLStore, PostgresStore).
+**options.memory.storage:** (`MemoryStorage`): Memory storage domain for message persistence. Get it from a composite store using \`await storage.getStore('memory')\`.
 
 **options.memory.threadId:** (`string`): Thread ID for conversation persistence.
 

package/.docs/reference/cli/mastra.md

@@ -157,7 +157,7 @@ Comma-separated list of custom arguments to pass to the Node.js process, e.g. `-
 
 ## `mastra studio`
 
-Starts [Mastra Studio](https://mastra.ai/docs/getting-started/studio) as a static server. After starting, you can enter your Mastra instance URL (e.g. `http://localhost:4111`) to connect Studio to your Mastra backend.
+Starts [Mastra Studio](https://mastra.ai/docs/getting-started/studio) as a static server. After starting, you can enter your Mastra instance URL (e.g. `http://localhost:4111`) to connect Studio to your Mastra backend. Looks for `.env` and `.env.production` files in the current working directory for configuration.
 
 ### Flags
 

package/.docs/reference/deployer/cloudflare.md

@@ -1,16 +1,46 @@
 # CloudflareDeployer
 
-The `CloudflareDeployer` class handles deployment of standalone Mastra applications to Cloudflare Workers. It manages configuration, deployment, and extends the base [Deployer](https://mastra.ai/reference/deployer) class with Cloudflare specific functionality.
+The `CloudflareDeployer` bundles your Mastra server and generates a `wrangler.jsonc` file conforming to Cloudflare's [wrangler configuration](https://developers.cloudflare.com/workers/wrangler/configuration/). Cloudflare deploys this as a Cloudflare Worker.
+
+## Installation
+
+To use `CloudflareDeployer`, install the `@mastra/deployer-cloudflare` package:
+
+**npm**:
+
+```bash
+npm install @mastra/deployer-cloudflare@latest
+```
+
+**pnpm**:
+
+```bash
+pnpm add @mastra/deployer-cloudflare@latest
+```
+
+**Yarn**:
+
+```bash
+yarn add @mastra/deployer-cloudflare@latest
+```
+
+**Bun**:
+
+```bash
+bun add @mastra/deployer-cloudflare@latest
+```
 
 ## Usage example
 
+Import `CloudflareDeployer` and set it as the deployer in your Mastra configuration:
+
 ```typescript
 import { Mastra } from "@mastra/core";
 import { CloudflareDeployer } from "@mastra/deployer-cloudflare";
 
 export const mastra = new Mastra({
   deployer: new CloudflareDeployer({
-    name: "hello-mastra",
+    name: "your-project-name",
     routes: [
       {
         pattern: "example.com/*",
@@ -42,15 +72,8 @@ export const mastra = new Mastra({
 
 ## Constructor options
 
-The `CloudflareDeployer` constructor accepts the same configuration options as `wrangler.json`. See the [Wrangler configuration documentation](https://developers.cloudflare.com/workers/wrangler/configuration/) for all available options.
-
-### Migrating from earlier versions
+The `CloudflareDeployer` constructor accepts the same configuration options as `wrangler.jsonc`. See the [Wrangler configuration documentation](https://developers.cloudflare.com/workers/wrangler/configuration/) for all available options.
 
-The following fields are deprecated and should be replaced with their standard `wrangler.json` equivalents:
+## Build output
 
-| Deprecated        | Use instead                 |
-| ----------------- | --------------------------- |
-| `projectName`     | `name`                      |
-| `d1Databases`     | `d1_databases`              |
-| `kvNamespaces`    | `kv_namespaces`             |
-| `workerNamespace` | _(removed, no longer used)_ |
+After running `mastra build`, the deployer generates a `wrangler.jsonc` file conforming to Cloudflare's [wrangler configuration](https://developers.cloudflare.com/workers/wrangler/configuration/). It points to files inside `.mastra/output` so you need to run `mastra build` before deploying with Wrangler.

package/.docs/reference/index.md

@@ -164,7 +164,10 @@ The Reference section provides documentation of Mastra's API, including paramete
 - [Upstash Storage](https://mastra.ai/reference/storage/upstash)
 - [Workspace Class](https://mastra.ai/reference/workspace/workspace-class)
 - [LocalFilesystem](https://mastra.ai/reference/workspace/local-filesystem)
+- [S3Filesystem](https://mastra.ai/reference/workspace/s3-filesystem)
+- [GCSFilesystem](https://mastra.ai/reference/workspace/gcs-filesystem)
 - [LocalSandbox](https://mastra.ai/reference/workspace/local-sandbox)
+- [E2BSandbox](https://mastra.ai/reference/workspace/e2b-sandbox)
 - [WorkspaceFilesystem](https://mastra.ai/reference/workspace/filesystem)
 - [WorkspaceSandbox](https://mastra.ai/reference/workspace/sandbox)
 - [.stream()](https://mastra.ai/reference/streaming/agents/stream)