@mastra/mcp-docs-server 1.1.26-alpha.20 → 1.1.26-alpha.22

package/.docs/guides/getting-started/next-js.md

@@ -4,10 +4,6 @@ In this guide, you'll build a tool-calling AI agent using Mastra, then connect i
 
 You'll use [AI SDK UI](https://ai-sdk.dev/docs/ai-sdk-ui/overview) and [AI Elements](https://ai-sdk.dev/elements) to create a beautiful, interactive chat experience.
 
-![Screenshot of a chat-style web app displaying a completed \"weatherTool\" tool call, answering \"What is the weather in London?\" with a JSON result. A message suggests offering activity ideas, and a text input field is at the bottom.](/assets/images/nextjs-quickstart-11fce4f78d172367bb97a14f132d701f.png)
-
-What you'll build: an agent that can call a weather tool, display the JSON result, stream a weather summary in the chat UI, and persist conversation history across reloads.
-
 ## Before you begin
 
 - You'll need an API key from a supported [model provider](https://mastra.ai/models). If you don't have a preference, use [OpenAI](https://mastra.ai/models/providers/openai).

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 171 models through Mastra's model router.
+OpenRouter aggregates models from multiple providers with enhanced features like rate limiting and failover. Access 172 models through Mastra's model router.
 
 Learn more in the [OpenRouter documentation](https://openrouter.ai/models).
 
@@ -117,6 +117,7 @@ ANTHROPIC_API_KEY=ant-...
 | `moonshotai/kimi-k2-0905:exacto`                                |
 | `moonshotai/kimi-k2-thinking`                                   |
 | `moonshotai/kimi-k2.5`                                          |
+| `moonshotai/kimi-k2.6`                                          |
 | `nousresearch/hermes-3-llama-3.1-405b:free`                     |
 | `nousresearch/hermes-4-405b`                                    |
 | `nousresearch/hermes-4-70b`                                     |

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 3670 models from 104 providers through a single API.
+Mastra provides a unified interface for working with LLMs across multiple providers, giving you access to 3675 models from 104 providers through a single API.
 
 ## Features
 

package/.docs/models/providers/moonshotai.md

@@ -1,6 +1,6 @@
 # ![Moonshot AI logo](https://models.dev/logos/moonshotai.svg)Moonshot AI
 
-Access 6 Moonshot AI models through Mastra's model router. Authentication is handled automatically using the `MOONSHOT_API_KEY` environment variable.
+Access 7 Moonshot AI models through Mastra's model router. Authentication is handled automatically using the `MOONSHOT_API_KEY` environment variable.
 
 Learn more in the [Moonshot AI documentation](https://platform.moonshot.ai).
 
@@ -40,6 +40,7 @@ for await (const chunk of stream) {
 | `moonshotai/kimi-k2-thinking-turbo` | 262K    |       |           |       |       |       | $1         | $8          |
 | `moonshotai/kimi-k2-turbo-preview`  | 262K    |       |           |       |       |       | $2         | $10         |
 | `moonshotai/kimi-k2.5`              | 262K    |       |           |       |       |       | $0.60      | $3          |
+| `moonshotai/kimi-k2.6`              | 262K    |       |           |       |       |       | $0.95      | $4          |
 
 ## Advanced configuration
 
@@ -69,7 +70,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "moonshotai/kimi-k2.5"
+      ? "moonshotai/kimi-k2.6"
       : "moonshotai/kimi-k2-0711-preview";
   }
 });

package/.docs/models/providers/ollama-cloud.md

@@ -1,6 +1,6 @@
 # ![Ollama Cloud logo](https://models.dev/logos/ollama-cloud.svg)Ollama Cloud
 
-Access 36 Ollama Cloud models through Mastra's model router. Authentication is handled automatically using the `OLLAMA_API_KEY` environment variable.
+Access 37 Ollama Cloud models through Mastra's model router. Authentication is handled automatically using the `OLLAMA_API_KEY` environment variable.
 
 Learn more in the [Ollama Cloud documentation](https://docs.ollama.com/cloud).
 
@@ -53,6 +53,7 @@ for await (const chunk of stream) {
 | `ollama-cloud/kimi-k2-thinking`       | 262K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/kimi-k2:1t`             | 262K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/kimi-k2.5`              | 262K    |       |           |       |       |       | —          | —           |
+| `ollama-cloud/kimi-k2.6:cloud`        | 262K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/minimax-m2`             | 205K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/minimax-m2.1`           | 205K    |       |           |       |       |       | —          | —           |
 | `ollama-cloud/minimax-m2.5`           | 205K    |       |           |       |       |       | —          | —           |

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

@@ -37,7 +37,7 @@ for await (const chunk of stream) {
 | `opencode-go/glm-5`        | 205K    |       |           |       |       |       | $1         | $3          |
 | `opencode-go/glm-5.1`      | 205K    |       |           |       |       |       | $1         | $4          |
 | `opencode-go/kimi-k2.5`    | 262K    |       |           |       |       |       | $0.60      | $3          |
-| `opencode-go/kimi-k2.6`    | 262K    |       |           |       |       |       | $0.95      | $4          |
+| `opencode-go/kimi-k2.6`    | 262K    |       |           |       |       |       | $0.32      | $1          |
 | `opencode-go/mimo-v2-omni` | 262K    |       |           |       |       |       | $0.40      | $2          |
 | `opencode-go/mimo-v2-pro`  | 1.0M    |       |           |       |       |       | $1         | $3          |
 | `opencode-go/minimax-m2.5` | 205K    |       |           |       |       |       | $0.30      | $1          |

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

@@ -1,6 +1,6 @@
 # ![OpenCode Zen logo](https://models.dev/logos/opencode.svg)OpenCode Zen
 
-Access 35 OpenCode Zen models through Mastra's model router. Authentication is handled automatically using the `OPENCODE_API_KEY` environment variable.
+Access 37 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).
 
@@ -64,8 +64,10 @@ for await (const chunk of stream) {
 | `opencode/gpt-5.4-nano`          | 400K    |       |           |       |       |       | $0.20      | $1          |
 | `opencode/gpt-5.4-pro`           | 1.1M    |       |           |       |       |       | $30        | $180        |
 | `opencode/kimi-k2.5`             | 262K    |       |           |       |       |       | $0.60      | $3          |
+| `opencode/kimi-k2.6`             | 262K    |       |           |       |       |       | $0.95      | $4          |
 | `opencode/minimax-m2.5`          | 205K    |       |           |       |       |       | $0.30      | $1          |
 | `opencode/minimax-m2.5-free`     | 205K    |       |           |       |       |       | —          | —           |
+| `opencode/minimax-m2.7`          | 205K    |       |           |       |       |       | $0.30      | $1          |
 | `opencode/nemotron-3-super-free` | 205K    |       |           |       |       |       | —          | —           |
 | `opencode/qwen3.5-plus`          | 262K    |       |           |       |       |       | $0.20      | $1          |
 | `opencode/qwen3.6-plus`          | 262K    |       |           |       |       |       | $0.50      | $3          |

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

@@ -117,4 +117,17 @@ export const mastra = new Mastra({
     ],
   },
 })
-```
+```
+
+> **Keep bindings inline inside new Mastra({...}):** Mastra's Babel plugin defers `new Mastra(...)` so that `env` is available when it runs. Code outside that call evaluates at module load before `env` is populated.
+>
+> ```typescript
+> // ✅ Works — binding is inside new Mastra(), so it's deferred
+> export const mastra = new Mastra({
+>   storage: new D1Store({ binding: env.DB }),
+> })
+>
+> // ❌ Breaks — env.DB is undefined at module load
+> const storage = new D1Store({ binding: env.DB })
+> export const mastra = new Mastra({ storage })
+> ```

package/.docs/reference/storage/cloudflare-d1.md

@@ -34,59 +34,59 @@ bun add @mastra/cloudflare-d1@latest
 
 ## Usage
 
-### Using with Cloudflare Workers
+### Using with Mastra CloudflareDeployer
 
-When using D1Store in a Cloudflare Worker, you need to access the D1 binding from the worker's `env` parameter at runtime. The `D1Database` in your type definition is only for TypeScript type checking—the actual binding is provided by the Workers runtime.
+The standard way to use D1Store with Mastra on Cloudflare is with `CloudflareDeployer`. Import `env` from `cloudflare:workers` and initialize `D1Store` inline inside `new Mastra({...})`.
 
 ```typescript
+import { env } from 'cloudflare:workers'
 import { D1Store } from '@mastra/cloudflare-d1'
 import { Mastra } from '@mastra/core'
 import { CloudflareDeployer } from '@mastra/deployer-cloudflare'
 
-type Env = {
-  D1Database: D1Database // TypeScript type definition
-}
+export const mastra = new Mastra({
+  storage: new D1Store({ binding: env.DB }),
+  deployer: new CloudflareDeployer({
+    name: 'my-worker',
+    d1_databases: [
+      {
+        binding: 'DB',
+        database_name: 'your-database-name',
+        database_id: 'your-database-id',
+      },
+    ],
+  }),
+})
+```
+
+> **Note:** When using `import { env } from 'cloudflare:workers'`, `D1Store` must be initialized inline inside `new Mastra({...})` — not extracted to a module-level variable. Alternatively, initialize `D1Store` inside the `fetch` handler after `env` is available. See [CloudflareDeployer reference](https://mastra.ai/reference/deployer/cloudflare) for details.
 
-// Factory function to create Mastra with D1 binding
-function createMastra(env: Env) {
-  const storage = new D1Store({
-    binding: env.D1Database, // ✅ Access the actual binding from env
-    tablePrefix: 'dev_', // Optional: isolate tables per environment
-  })
-
-  return new Mastra({
-    storage,
-    deployer: new CloudflareDeployer({
-      name: 'my-worker',
-      d1_databases: [
-        {
-          binding: 'D1Database', // Must match the property name in Env type
-          database_name: 'your-database-name',
-          database_id: 'your-database-id',
-        },
-      ],
-    }),
-  })
+### Using in a Cloudflare Worker without HTTP routes
+
+If you want to call Mastra directly in a Worker — for example, to run an agent or trigger a workflow — without serving HTTP routes, you don't need `CloudflareDeployer`. Access the D1 binding from the worker's `env` parameter and call Mastra programmatically.
+
+```typescript
+import { D1Store } from '@mastra/cloudflare-d1'
+import { Mastra } from '@mastra/core'
+
+type Env = {
+  DB: D1Database
 }
 
-// Cloudflare Worker export
 export default {
   async fetch(request: Request, env: Env, ctx: ExecutionContext) {
-    const mastra = createMastra(env)
+    const mastra = new Mastra({
+      storage: new D1Store({ binding: env.DB }),
+    })
 
-    // Your handler logic here
-    return new Response('Hello from Mastra with D1!')
+    const agent = mastra.getAgent('my-agent')
+    const result = await agent.generate('Hello')
+
+    return Response.json({ text: result.text })
   },
 }
 ```
 
-> **Important: Understanding D1 Bindings:** In the `Env` type definition, `D1Database: D1Database` serves two purposes:
->
-> - The **property name** (`D1Database`) must match the `binding` name in your `wrangler.toml`
-> - The **type** (`: D1Database`) is from `@cloudflare/workers-types` for TypeScript type checking
->
-> At runtime, Cloudflare Workers provides the actual D1 database instance via `env.D1Database`. You can't use `D1Database` directly outside of the worker's context.
-
 ### Using with REST API
 
 For non-Workers environments (Node.js, serverless functions, etc.), use the REST API approach:
@@ -108,7 +108,7 @@ Add the D1 database binding to your `wrangler.toml`:
 
 ```toml
 [[d1_databases]]
-binding = "D1Database"  # Must match the property name in your Env type
+binding = "DB"
 database_name = "your-database-name"
 database_id = "your-database-id"
 ```
@@ -119,7 +119,7 @@ Or in `wrangler.jsonc`:
 {
   "d1_databases": [
     {
-      "binding": "D1Database",
+      "binding": "DB",
       "database_name": "your-database-name",
       "database_id": "your-database-id",
     },
@@ -158,14 +158,14 @@ import { Mastra } from '@mastra/core'
 import { D1Store } from '@mastra/cloudflare-d1'
 
 type Env = {
-  D1Database: D1Database
+  DB: D1Database
 }
 
 // In a Cloudflare Worker
 export default {
   async fetch(request: Request, env: Env, ctx: ExecutionContext) {
     const storage = new D1Store({
-      binding: env.D1Database, // ✅ Use env.D1Database
+      binding: env.DB,
     })
 
     const mastra = new Mastra({
@@ -184,7 +184,7 @@ If you're using storage directly without Mastra, you must call `init()` explicit
 import { D1Store } from '@mastra/cloudflare-d1'
 
 type Env = {
-  D1Database: D1Database
+  DB: D1Database
 }
 
 // In a Cloudflare Worker
@@ -192,7 +192,7 @@ export default {
   async fetch(request: Request, env: Env, ctx: ExecutionContext) {
     const storage = new D1Store({
       id: 'd1-storage',
-      binding: env.D1Database, // ✅ Use env.D1Database
+      binding: env.DB,
     })
 
     // Required when using storage directly

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @mastra/mcp-docs-server
 
+## 1.1.26-alpha.21
+
+### Patch Changes
+
+- Updated dependencies [[`20f59b8`](https://github.com/mastra-ai/mastra/commit/20f59b876cf91199efbc49a0e36b391240708f08), [`e2687a7`](https://github.com/mastra-ai/mastra/commit/e2687a7408790c384563816a9a28ed06735684c9), [`8f1b280`](https://github.com/mastra-ai/mastra/commit/8f1b280b7fe6999ec654f160cb69c1a8719e7a57), [`12df98c`](https://github.com/mastra-ai/mastra/commit/12df98c4904643d9481f5c78f3bed443725b4c96)]:
+  - @mastra/core@1.26.0-alpha.11
+
 ## 1.1.26-alpha.19
 
 ### Patch Changes

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.1.26-alpha.20",
+  "version": "1.1.26-alpha.22",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -29,26 +29,26 @@
     "jsdom": "^26.1.0",
     "local-pkg": "^1.1.2",
     "zod": "^4.3.6",
-    "@mastra/core": "1.26.0-alpha.10",
+    "@mastra/core": "1.26.0-alpha.11",
     "@mastra/mcp": "^1.5.1-alpha.1"
   },
   "devDependencies": {
     "@hono/node-server": "^1.19.11",
     "@types/jsdom": "^21.1.7",
     "@types/node": "22.19.15",
-    "@vitest/coverage-v8": "4.0.18",
-    "@vitest/ui": "4.0.18",
+    "@vitest/coverage-v8": "4.1.4",
+    "@vitest/ui": "4.1.4",
     "@wong2/mcp-cli": "^1.13.0",
     "cross-env": "^10.1.0",
-    "eslint": "^9.39.4",
+    "eslint": "^10.2.1",
     "hono": "^4.12.8",
     "tsup": "^8.5.1",
     "tsx": "^4.21.0",
     "typescript": "^5.9.3",
-    "vitest": "4.0.18",
-    "@internal/lint": "0.0.83",
+    "vitest": "4.1.4",
     "@internal/types-builder": "0.0.58",
-    "@mastra/core": "1.26.0-alpha.10"
+    "@internal/lint": "0.0.83",
+    "@mastra/core": "1.26.0-alpha.11"
   },
   "homepage": "https://mastra.ai",
   "repository": {