@mastra/mcp-docs-server 1.1.22-alpha.9 → 1.1.22

package/.docs/models/providers/vultr.md

@@ -1,6 +1,6 @@
 # ![Vultr logo](https://models.dev/logos/vultr.svg)Vultr
 
-Access 4 Vultr models through Mastra's model router. Authentication is handled automatically using the `VULTR_API_KEY` environment variable.
+Access 5 Vultr models through Mastra's model router. Authentication is handled automatically using the `VULTR_API_KEY` environment variable.
 
 Learn more in the [Vultr documentation](https://api.vultrinference.com/).
 
@@ -34,10 +34,11 @@ for await (const chunk of stream) {
 
 | Model                 | Context | Tools | Reasoning | Image | Audio | Video | Input $/1M | Output $/1M |
 | --------------------- | ------- | ----- | --------- | ----- | ----- | ----- | ---------- | ----------- |
-| `vultr/DeepSeek-V3.2` | 163K    |       |           |       |       |       | $0.55      | $2          |
-| `vultr/GLM-5-FP8`     | 202K    |       |           |       |       |       | $0.85      | $3          |
-| `vultr/Kimi-K2.5`     | 261K    |       |           |       |       |       | $0.55      | $3          |
-| `vultr/MiniMax-M2.5`  | 196K    |       |           |       |       |       | $0.30      | $1          |
+| `vultr/DeepSeek-V3.2` | 127K    |       |           |       |       |       | $0.55      | $2          |
+| `vultr/GLM-5-FP8`     | 200K    |       |           |       |       |       | $0.85      | $3          |
+| `vultr/gpt-oss-120b`  | 129K    |       |           |       |       |       | $0.15      | $0.60       |
+| `vultr/Kimi-K2.5`     | 254K    |       |           |       |       |       | $0.55      | $3          |
+| `vultr/MiniMax-M2.5`  | 194K    |       |           |       |       |       | $0.30      | $1          |
 
 ## Advanced configuration
 
@@ -67,7 +68,7 @@ const agent = new Agent({
   model: ({ requestContext }) => {
     const useAdvanced = requestContext.task === "complex";
     return useAdvanced
-      ? "vultr/MiniMax-M2.5"
+      ? "vultr/gpt-oss-120b"
       : "vultr/DeepSeek-V3.2";
   }
 });

package/.docs/models/providers/zenmux.md

@@ -1,6 +1,6 @@
 # ![ZenMux logo](https://models.dev/logos/zenmux.svg)ZenMux
 
-Access 88 ZenMux models through Mastra's model router. Authentication is handled automatically using the `ZENMUX_API_KEY` environment variable.
+Access 86 ZenMux models through Mastra's model router. Authentication is handled automatically using the `ZENMUX_API_KEY` environment variable.
 
 Learn more in the [ZenMux documentation](https://docs.zenmux.ai).
 
@@ -52,13 +52,10 @@ for await (const chunk of stream) {
 | `zenmux/google/gemini-2.5-flash-lite`         | 1.0M    |       |           |       |       |       | $0.10      | $0.40       |
 | `zenmux/google/gemini-2.5-pro`                | 1.0M    |       |           |       |       |       | $1         | $10         |
 | `zenmux/google/gemini-3-flash-preview`        | 1.0M    |       |           |       |       |       | $0.50      | $3          |
-| `zenmux/google/gemini-3-pro-preview`          | 1.0M    |       |           |       |       |       | $2         | $12         |
 | `zenmux/google/gemini-3.1-flash-lite-preview` | 1.1M    |       |           |       |       |       | $0.25      | $2          |
 | `zenmux/google/gemini-3.1-pro-preview`        | 1.0M    |       |           |       |       |       | $2         | $12         |
 | `zenmux/inclusionai/ling-1t`                  | 128K    |       |           |       |       |       | $0.56      | $2          |
 | `zenmux/inclusionai/ring-1t`                  | 128K    |       |           |       |       |       | $0.56      | $2          |
-| `zenmux/kuaishou/kat-coder-pro-v1`            | 256K    |       |           |       |       |       | $0.30      | $1          |
-| `zenmux/kuaishou/kat-coder-pro-v1-free`       | 256K    |       |           |       |       |       | —          | —           |
 | `zenmux/kuaishou/kat-coder-pro-v2`            | 256K    |       |           |       |       |       | $0.30      | $1          |
 | `zenmux/minimax/minimax-m2`                   | 204K    |       |           |       |       |       | $0.30      | $1          |
 | `zenmux/minimax/minimax-m2.1`                 | 204K    |       |           |       |       |       | $0.30      | $1          |
@@ -90,6 +87,8 @@ for await (const chunk of stream) {
 | `zenmux/qwen/qwen3.5-flash`                   | 1.0M    |       |           |       |       |       | $0.10      | $0.40       |
 | `zenmux/qwen/qwen3.5-plus`                    | 1.0M    |       |           |       |       |       | $0.80      | $5          |
 | `zenmux/qwen/qwen3.6-plus`                    | 1.0M    |       |           |       |       |       | $0.50      | $3          |
+| `zenmux/sapiens-ai/agnes-1.5-lite`            | 256K    |       |           |       |       |       | $0.12      | $0.60       |
+| `zenmux/sapiens-ai/agnes-1.5-pro`             | 256K    |       |           |       |       |       | $0.16      | $0.80       |
 | `zenmux/stepfun/step-3`                       | 66K     |       |           |       |       |       | $0.21      | $0.57       |
 | `zenmux/stepfun/step-3.5-flash`               | 256K    |       |           |       |       |       | $0.10      | $0.30       |
 | `zenmux/stepfun/step-3.5-flash-free`          | 256K    |       |           |       |       |       | —          | —           |
@@ -107,7 +106,6 @@ for await (const chunk of stream) {
 | `zenmux/x-ai/grok-4.2-fast-non-reasoning`     | 2.0M    |       |           |       |       |       | $3         | $9          |
 | `zenmux/x-ai/grok-code-fast-1`                | 256K    |       |           |       |       |       | $0.20      | $2          |
 | `zenmux/xiaomi/mimo-v2-flash`                 | 262K    |       |           |       |       |       | $0.10      | $0.30       |
-| `zenmux/xiaomi/mimo-v2-flash-free`            | 262K    |       |           |       |       |       | —          | —           |
 | `zenmux/xiaomi/mimo-v2-omni`                  | 265K    |       |           |       |       |       | $0.40      | $2          |
 | `zenmux/xiaomi/mimo-v2-pro`                   | 1.0M    |       |           |       |       |       | $2         | $5          |
 | `zenmux/z-ai/glm-4.5`                         | 128K    |       |           |       |       |       | $0.35      | $2          |

package/.docs/reference/browser/agent-browser.md

@@ -0,0 +1,374 @@
+# AgentBrowser class
+
+The `AgentBrowser` class provides deterministic browser automation using the [agent-browser](https://github.com/vercel-labs/agent-browser) library. It uses accessibility tree snapshots and element refs (e.g., `@e5`) for precise, reproducible interactions.
+
+Use `AgentBrowser` when you need reliable, deterministic browser automation. For AI-powered interactions using natural language, see [`StagehandBrowser`](https://mastra.ai/reference/browser/stagehand-browser).
+
+## Usage example
+
+```typescript
+import { Agent } from '@mastra/core/agent'
+import { AgentBrowser } from '@mastra/agent-browser'
+
+const browser = new AgentBrowser({
+  headless: true,
+  viewport: { width: 1280, height: 720 },
+  scope: 'thread',
+})
+
+export const browserAgent = new Agent({
+  name: 'browser-agent',
+  instructions: `You can browse the web. Use browser_snapshot to see the page structure,
+then interact with elements using their refs (e.g., @e5).`,
+  model: 'openai/gpt-5.4',
+  browser,
+})
+```
+
+## Constructor parameters
+
+**headless** (`boolean`): Whether to run the browser in headless mode (no visible UI). (Default: `true`)
+
+**viewport** (`{ width: number; height: number }`): Browser viewport dimensions. (Default: `{ width: 1280, height: 720 }`)
+
+**timeout** (`number`): Default timeout in milliseconds for browser operations. (Default: `30000`)
+
+**cdpUrl** (`string | (() => string | Promise<string>)`): CDP WebSocket URL for connecting to an existing browser. Useful for cloud browser providers.
+
+**scope** (`'shared' | 'thread'`): Browser instance scope. 'shared' shares one browser across all threads. 'thread' gives each thread its own browser. (Default: `'thread' (or 'shared' when cdpUrl is provided)`)
+
+**onLaunch** (`(args: { browser: MastraBrowser }) => void | Promise<void>`): Callback invoked after the browser is ready.
+
+**onClose** (`(args: { browser: MastraBrowser }) => void | Promise<void>`): Callback invoked before the browser closes.
+
+**screencast** (`ScreencastOptions`): Configuration for streaming browser frames to Studio.
+
+## Tools
+
+`AgentBrowser` provides 15 deterministic tools for browser automation. All tools that interact with elements use refs from the accessibility tree snapshot.
+
+### Core tools
+
+| Tool               | Description                                       |
+| ------------------ | ------------------------------------------------- |
+| `browser_goto`     | Navigate to a URL                                 |
+| `browser_snapshot` | Get accessibility tree snapshot with element refs |
+| `browser_click`    | Click an element by ref                           |
+| `browser_type`     | Type text into an element                         |
+| `browser_press`    | Press keyboard keys                               |
+| `browser_select`   | Select option from dropdown                       |
+| `browser_scroll`   | Scroll the page or element                        |
+| `browser_close`    | Close the browser                                 |
+
+### Extended tools
+
+| Tool               | Description                                     |
+| ------------------ | ----------------------------------------------- |
+| `browser_hover`    | Hover over an element                           |
+| `browser_back`     | Go back in browser history                      |
+| `browser_dialog`   | Handle browser dialogs (alert, confirm, prompt) |
+| `browser_wait`     | Wait for element state changes                  |
+| `browser_tabs`     | Manage browser tabs (list, new, switch, close)  |
+| `browser_drag`     | Drag and drop elements                          |
+| `browser_evaluate` | Execute JavaScript in the page (escape hatch)   |
+
+## Tool reference
+
+### `browser_goto`
+
+Navigate to a URL.
+
+```text
+// Tool input
+{
+  "url": "https://example.com",
+  "waitUntil": "domcontentloaded",
+  "timeout": 30000
+}
+```
+
+| Parameter   | Type                                            | Description                                     |
+| ----------- | ----------------------------------------------- | ----------------------------------------------- |
+| `url`       | `string`                                        | URL to navigate to                              |
+| `waitUntil` | `"load" \| "domcontentloaded" \| "networkidle"` | When to consider navigation complete (optional) |
+| `timeout`   | `number`                                        | Navigation timeout in ms (optional)             |
+
+### `browser_snapshot`
+
+Get an accessibility tree snapshot of the page. Returns element refs like `@e5` that you use with other tools.
+
+```text
+// Tool input
+{
+  "interactiveOnly": true,
+  "maxDepth": 10
+}
+```
+
+| Parameter         | Type      | Description                                  |
+| ----------------- | --------- | -------------------------------------------- |
+| `interactiveOnly` | `boolean` | Only include interactive elements (optional) |
+| `maxDepth`        | `number`  | Maximum tree depth (optional)                |
+
+**Example output:**
+
+```text
+[document] Example Page
+  [banner]
+    [link @e1] Home
+    [link @e2] About
+  [main]
+    [heading @e3] Welcome
+    [textbox @e4] Search...
+    [button @e5] Submit
+```
+
+### `browser_click`
+
+Click an element using its ref from the snapshot.
+
+```text
+{
+  "ref": "@e5",
+  "button": "left",
+  "clickCount": 1,
+  "modifiers": ["Control", "Shift"]
+}
+```
+
+| Parameter    | Type                            | Description                                    |
+| ------------ | ------------------------------- | ---------------------------------------------- |
+| `ref`        | `string`                        | Element ref from snapshot (required)           |
+| `button`     | `"left" \| "right" \| "middle"` | Mouse button (optional)                        |
+| `clickCount` | `number`                        | Number of activations, 2 for double (optional) |
+| `modifiers`  | `string[]`                      | Modifier keys (optional)                       |
+
+### `browser_type`
+
+Type text into an input element.
+
+```text
+// Tool input
+{
+  "ref": "@e4",
+  "text": "search query",
+  "clear": true,
+  "delay": 50
+}
+```
+
+| Parameter | Type      | Description                               |
+| --------- | --------- | ----------------------------------------- |
+| `ref`     | `string`  | Element ref from snapshot (required)      |
+| `text`    | `string`  | Text to type (required)                   |
+| `clear`   | `boolean` | Clear existing content first (optional)   |
+| `delay`   | `number`  | Delay between keystrokes in ms (optional) |
+
+### `browser_press`
+
+Press keyboard keys.
+
+```text
+// Tool input
+{
+  "key": "Enter",
+  "modifiers": ["Control"]
+}
+
+// Key combinations
+{ "key": "Control+a" }
+{ "key": "Control+c" }
+```
+
+| Parameter   | Type       | Description                                                       |
+| ----------- | ---------- | ----------------------------------------------------------------- |
+| `key`       | `string`   | Key name (e.g., "Enter", "Tab", "Escape", "Control+a") (required) |
+| `modifiers` | `string[]` | Modifier keys (optional)                                          |
+
+### `browser_select`
+
+Select an option from a dropdown. Provide one of `value`, `label`, or `index`.
+
+```text
+// Tool input - by value
+{
+  "ref": "@e10",
+  "value": "option-value"
+}
+
+// Tool input - by label
+{
+  "ref": "@e10",
+  "label": "Option Text"
+}
+
+// Tool input - by index
+{
+  "ref": "@e10",
+  "index": 0
+}
+```
+
+### `browser_scroll`
+
+Scroll the page or a specific element.
+
+```text
+// Tool input
+{
+  "direction": "down",
+  "amount": 300,
+  "ref": "@e15"
+}
+```
+
+| Parameter   | Type                                  | Description                                           |
+| ----------- | ------------------------------------- | ----------------------------------------------------- |
+| `direction` | `"up" \| "down" \| "left" \| "right"` | Scroll direction (required)                           |
+| `amount`    | `number`                              | Pixels to scroll, default 300 (optional)              |
+| `ref`       | `string`                              | Element to scroll, scrolls page if omitted (optional) |
+
+### `browser_hover`
+
+Hover over an element to trigger hover effects.
+
+```text
+// Tool input
+{
+  "ref": "@e7"
+}
+```
+
+### `browser_back`
+
+Go back in browser history.
+
+```text
+// Tool input (no parameters required)
+
+```
+
+### `browser_dialog`
+
+Handle browser dialogs (alert, confirm, prompt). Click an element that triggers a dialog and handle it.
+
+```text
+// Tool input
+{
+  "triggerRef": "@e5",
+  "action": "accept",
+  "text": "response"
+}
+```
+
+| Parameter    | Type                    | Description                                 |
+| ------------ | ----------------------- | ------------------------------------------- |
+| `triggerRef` | `string`                | Element that triggers the dialog (required) |
+| `action`     | `"accept" \| "dismiss"` | How to handle the dialog (required)         |
+| `text`       | `string`                | Text for prompt dialogs (optional)          |
+
+### `browser_wait`
+
+Wait for an element to reach a specific state.
+
+```text
+// Tool input
+{
+  "ref": "@e20",
+  "state": "visible",
+  "timeout": 30000
+}
+```
+
+| Parameter | Type                                                | Description                        |
+| --------- | --------------------------------------------------- | ---------------------------------- |
+| `ref`     | `string`                                            | Element ref to wait for (optional) |
+| `state`   | `"visible" \| "hidden" \| "attached" \| "detached"` | State to wait for (optional)       |
+| `timeout` | `number`                                            | Max wait time in ms (optional)     |
+
+### `browser_tabs`
+
+Manage browser tabs.
+
+```text
+// List all tabs
+{ "action": "list" }
+
+// Open new tab
+{ "action": "new", "url": "https://example.com" }
+
+// Switch to tab by index
+{ "action": "switch", "index": 0 }
+
+// Close tab by index
+{ "action": "close", "index": 1 }
+```
+
+### `browser_drag`
+
+Drag an element to a target location.
+
+```text
+// Tool input
+{
+  "sourceRef": "@e10",
+  "targetRef": "@e20"
+}
+```
+
+| Parameter   | Type     | Description                    |
+| ----------- | -------- | ------------------------------ |
+| `sourceRef` | `string` | Element to drag (required)     |
+| `targetRef` | `string` | Drop target element (required) |
+
+### `browser_evaluate`
+
+Execute JavaScript in the page context. Use as an escape hatch when other tools don't cover your use case.
+
+```text
+// Tool input
+{
+  "script": "document.title",
+  "returnValue": true
+}
+```
+
+| Parameter     | Type      | Description                             |
+| ------------- | --------- | --------------------------------------- |
+| `script`      | `string`  | JavaScript to execute (required)        |
+| `returnValue` | `boolean` | Whether to return the result (optional) |
+
+### `browser_close`
+
+Close the browser and clean up resources.
+
+```text
+// Tool input (no parameters required)
+
+```
+
+## How refs work
+
+The `browser_snapshot` tool returns an accessibility tree with element refs like `@e1`, `@e2`, etc. These refs are stable identifiers you use with other tools:
+
+1. Call `browser_snapshot` to see the page structure
+2. Find the element you want to interact with
+3. Use its ref with interaction tools like `browser_type` or `browser_scroll`.
+
+```text
+// 1. Get snapshot
+// Returns: [textbox @e4] Search... [link @e5] Home
+
+// 2. Type in the search box
+{ "tool": "browser_type", "input": { "ref": "@e4", "text": "mastra" } }
+
+// 3. Navigate to home
+{ "tool": "browser_goto", "input": { "url": "https://example.com" } }
+```
+
+## Related
+
+- [MastraBrowser](https://mastra.ai/reference/browser/mastra-browser): Base class reference
+- [StagehandBrowser](https://mastra.ai/reference/browser/stagehand-browser): AI-powered alternative
+- [Browser overview](https://mastra.ai/docs/browser/overview): Conceptual guide
+- [agent-browser guide](https://mastra.ai/docs/browser/agent-browser): Usage guide