@mastra/mcp-docs-server 1.3.9-alpha.3 → 1.3.9-alpha.4

package/.docs/reference/connect/providers.md

@@ -4,7 +4,7 @@
 
 # Provider toolsets
 
-This page documents generated toolsets for 22 providers (908 tools in this version of `@mastra/connect`). It isn't an exhaustive list of providers registered in the SDK or available in the platform catalog. [`tools()`](https://mastra.ai/reference/connect/tools) exposes a provider's toolset when the project has an active connection for its provider ID.
+This page documents generated toolsets for 22 providers (910 tools in this version of `@mastra/connect`). It isn't an exhaustive list of providers registered in the SDK or available in the platform catalog. [`tools()`](https://mastra.ai/reference/connect/tools) exposes a provider's toolset when the project has an active connection for its provider ID.
 
 Tool keys are stable identifiers of the form `<provider>_<action>` and are the values accepted by `allowTools` and `disallowTools`. Toolsets are versioned with the package: the exact list depends on the installed `@mastra/connect` version, and this page reflects the version it was generated from.
 
@@ -18,7 +18,7 @@ MCP providers (Attio, Canva, Clay, Neon, Render, Robinhood, and Sanity) serve th
 | ![](https://cdn.simpleicons.org/github?viewbox=auto\&size=28) [GitHub](#github)                           | `github`          | 49    |
 | ![](https://cdn.simpleicons.org/googlecalendar?viewbox=auto\&size=28) [Google Calendar](#google-calendar) | `google-calendar` | 43    |
 | ![](https://cdn.simpleicons.org/googledocs?viewbox=auto\&size=28) [Google Docs](#google-docs)             | `google-docs`     | 37    |
-| ![](https://cdn.simpleicons.org/googledrive?viewbox=auto\&size=28) [Google Drive](#google-drive)          | `google-drive`    | 30    |
+| ![](https://cdn.simpleicons.org/googledrive?viewbox=auto\&size=28) [Google Drive](#google-drive)          | `google-drive`    | 32    |
 | ![](https://cdn.simpleicons.org/gmail?viewbox=auto\&size=28) [Gmail](#gmail)                              | `google-mail`     | 52    |
 | ![](https://cdn.simpleicons.org/googlesheets?viewbox=auto\&size=28) [Google Sheets](#google-sheets)       | `google-sheet`    | 18    |
 | ![](https://cdn.simpleicons.org/hubspot?viewbox=auto\&size=28) [HubSpot](#hubspot)                        | `hubspot`         | 50    |
@@ -311,7 +311,7 @@ Provider ID: `google-docs` · 37 tools
 
 ## Google Drive
 
-Provider ID: `google-drive` · 30 tools
+Provider ID: `google-drive` · 32 tools
 
 | Tool                                        | Description                                                                                                                    |
 | ------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------ |
@@ -324,6 +324,7 @@ Provider ID: `google-drive` · 30 tools
 | `google_drive_delete_permission`            | Remove a permission from a file                                                                                                |
 | `google_drive_delete_shared_drive`          | Delete a shared drive                                                                                                          |
 | `google_drive_empty_trash`                  | Permanently delete all trashed files                                                                                           |
+| `google_drive_export_file`                  | Export a Google Workspace file (Doc, Sheet, Slide, etc.) to the specified MIME type.                                           |
 | `google_drive_find_file`                    | Search for files by name or query in Google Drive                                                                              |
 | `google_drive_find_folder`                  | Search for a folder by name or query                                                                                           |
 | `google_drive_get_about`                    | Get the user's drive info and storage quota                                                                                    |
@@ -338,6 +339,7 @@ Provider ID: `google-drive` · 30 tools
 | `google_drive_list_drives`                  | List shared drives the user can access, with cursor pagination and drive metadata like hidden, capabilities, and restrictions. |
 | `google_drive_list_files_non_unified`       | List immediate files and folders for a folder ID, or root when omitted, with cursor pagination and shared-drive support.       |
 | `google_drive_list_permissions`             | List permissions on a file                                                                                                     |
+| `google_drive_list_revisions`               | List the revision history for a Drive file.                                                                                    |
 | `google_drive_move_file`                    | Move a file to a different folder                                                                                              |
 | `google_drive_unhide_shared_drive`          | Restore a hidden shared drive to default view                                                                                  |
 | `google_drive_update_comment`               | Update a comment on a file                                                                                                     |

package/.docs/reference/connect/tools.md

@@ -25,7 +25,7 @@ See [Connect](https://mastra.ai/docs/mastra-platform/connect/overview) to get st
 
 ## Parameters
 
-**options** (`ToolsOptions`): Optional discovery and client configuration.
+**options** (`ToolsOptions | ((ctx?: ToolsResolverContext) => ToolsOptions | Promise<ToolsOptions>)`): Optional discovery and client configuration, or a callback returning it per request. See Per-request options below.
 
 **options.projectId** (`string`): Platform project whose connections to discover. Falls back to MASTRA\_PROJECT\_ID.
 
@@ -41,6 +41,25 @@ See [Connect](https://mastra.ai/docs/mastra-platform/connect/overview) to get st
 
 **options.ttlMs** (`number`): How long a resolved snapshot stays fresh, in milliseconds. Default 30000. 0 revalidates on every resolution.
 
+### Per-request options
+
+Pass a callback instead of an options object to vary options per request, for example role-based filters or approval policies. The callback runs on every resolution (sync or async) and receives the same context Mastra passes the resolver (`requestContext` is populated when the resolver is an agent's `tools` option):
+
+```typescript
+const connected = tools(ctx => ({
+  providers: {
+    linear:
+      ctx?.requestContext?.get('role') === 'viewer'
+        ? { allowTools: ['linear_list_*'] }
+        : { requireApproval: ['linear_delete_*'] },
+  },
+}))
+```
+
+The resolver memoizes snapshots per distinct options value, so requests producing the same options share one cached snapshot with the usual `ttlMs` and stale-while-revalidate semantics. Structurally equal options returned from different calls count as the same value; non-serializable values such as a custom `client.fetch` compare by identity. The resolver keeps caches for at most 32 distinct options values and evicts the least recently used one (closing its MCP transports) past that, so derive options from a small, closed set of inputs such as roles, not from unbounded per-request data.
+
+With the callback form, option validation runs at the first resolution that produces a given options value rather than at `tools()` time, and a validation error fails that resolution. `refresh()` fetches for the options the callback returns without a context (the same variant a direct `await connected()` call uses), and `disconnect()` closes every memoized variant.
+
 ### Per-provider options
 
 Each value in the `providers` record form is `true`, `false`, or a `ToolsProviderOptions`:
@@ -89,7 +108,7 @@ The resolver also exposes methods for manual control:
 
 Errors fall into four groups:
 
-- Configuration errors (missing project ID or token, a malformed provider ID, both `allowTools` and `disallowTools` at one level, invalid `ttlMs`) throw when you call `tools()`.
+- Configuration errors (missing project ID or token, a malformed provider ID, both `allowTools` and `disallowTools` at one level, invalid `ttlMs`) throw when you call `tools()`. With [the callback form](#per-request-options), they fail the first resolution that produces the invalid options instead.
 - An enabled provider ID that the platform catalog confirms is unknown fails the resolution with `invalid_options`. An unknown tool key or zero-match glob in a per-provider filter does the same. If the catalog can't be reached, an unknown ID downgrades to a warning and is skipped.
 - If a background refresh fails while a snapshot is cached, the resolver keeps serving the cached toolsets and warns. It rejects only when nothing was ever cached.
 - A problem with one provider, such as a connection that needs reauthorization, logs a warning and skips that provider. The other providers' tools still load.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mastra/mcp-docs-server",
-  "version": "1.3.9-alpha.3",
+  "version": "1.3.9-alpha.4",
   "description": "MCP server for accessing Mastra.ai documentation, changelogs, and news.",
   "type": "module",
   "main": "dist/index.js",
@@ -27,7 +27,7 @@
     "local-pkg": "^1.1.2",
     "zod": "^4.6.4",
     "@mastra/mcp": "^2.4.2-alpha.0",
-    "@mastra/core": "1.79.0-alpha.1"
+    "@mastra/core": "1.79.0-alpha.2"
   },
   "devDependencies": {
     "@hono/node-server": "^2.0.0",
@@ -43,9 +43,9 @@
     "tsx": "^4.23.1",
     "typescript": "^7.0.2",
     "vitest": "4.1.11",
-    "@internal/lint": "0.0.144",
     "@internal/types-builder": "0.0.119",
-    "@mastra/core": "1.79.0-alpha.1"
+    "@internal/lint": "0.0.144",
+    "@mastra/core": "1.79.0-alpha.2"
   },
   "homepage": "https://mastra.ai",
   "repository": {