@mastra/mcp-docs-server 1.1.42-alpha.7 → 1.1.42

package/.docs/reference/memory/memory-class.md

@@ -11,7 +11,7 @@ import { Agent } from '@mastra/core/agent'
 export const agent = new Agent({
   name: 'test-agent',
   instructions: 'You are an agent with memory.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     options: {
       workingMemory: {
@@ -60,7 +60,7 @@ import { LibSQLStore, LibSQLVector } from '@mastra/libsql'
 export const agent = new Agent({
   name: 'test-agent',
   instructions: 'You are an agent with memory.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'test-agent-storage',
@@ -97,7 +97,7 @@ import { PgStore, PgVector } from '@mastra/pg'
 export const agent = new Agent({
   name: 'pg-agent',
   instructions: 'You are an agent with optimized PostgreSQL memory.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new PgStore({
       id: 'pg-agent-storage',

package/.docs/reference/memory/observational-memory.md

@@ -181,7 +181,7 @@ import { Agent } from '@mastra/core/agent'
 export const agent = new Agent({
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     options: {
       observationalMemory: {
@@ -201,7 +201,7 @@ import { Agent } from '@mastra/core/agent'
 export const agent = new Agent({
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     options: {
       observationalMemory: {
@@ -228,7 +228,7 @@ import { Agent } from '@mastra/core/agent'
 export const agent = new Agent({
   name: 'health-assistant',
   instructions: 'You are a health and wellness assistant.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     options: {
       observationalMemory: {
@@ -677,7 +677,7 @@ const selector = new ModelByInputTokens({
   upTo: {
     10_000: 'google/gemini-2.5-flash', // Fast for small inputs
     40_000: 'openai/gpt-5-mini', // Stronger for medium inputs
-    1_000_000: 'openai/gpt-5.4', // Most capable for large inputs
+    1_000_000: 'openai/gpt-5.5', // Most capable for large inputs
   },
 })
 ```

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

@@ -104,7 +104,7 @@ const prompt = await exporter.client.prompt.get('customer-support', { type: 'tex
 const agent = new Agent({
   name: 'support-agent',
   instructions: prompt.compile(),
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   defaultGenerateOptions: {
     tracingOptions: buildTracingOptions(
       withLangfusePrompt({ name: prompt.name, version: prompt.version }),

package/.docs/reference/processors/batch-parts-processor.md

@@ -43,7 +43,7 @@ import { BatchPartsProcessor } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'batched-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   outputProcessors: [
     new BatchPartsProcessor({
       batchSize: 5,

package/.docs/reference/processors/cost-guard-processor.md

@@ -56,7 +56,7 @@ costGuard.onViolation = ({ detail }) => {
 
 const agent = new Agent({
   name: 'my-agent',
-  model: '__OPENAI_MODEL_NANO__',
+  model: 'openai/gpt-5-nano',
   processors: {
     input: [costGuard],
   },

package/.docs/reference/processors/language-detector.md

@@ -60,7 +60,7 @@ export const agent = new Agent({
   id: 'multilingual-agent',
   name: 'multilingual-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [
     new LanguageDetector({
       model: 'openrouter/openai/gpt-oss-safeguard-20b',

package/.docs/reference/processors/message-history-processor.md

@@ -45,7 +45,7 @@ const storage = new PostgresStorage({
 export const agent = new Agent({
   name: 'memory-agent',
   instructions: 'You are a helpful assistant with conversation memory',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [
     new MessageHistory({
       storage,

package/.docs/reference/processors/moderation-processor.md

@@ -59,7 +59,7 @@ import { ModerationProcessor } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'moderated-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [
     new ModerationProcessor({
       model: 'openrouter/openai/gpt-oss-safeguard-20b',
@@ -84,7 +84,7 @@ import { BatchPartsProcessor, ModerationProcessor } from '@mastra/core/processor
 export const agent = new Agent({
   name: 'output-moderated-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   outputProcessors: [
     // Batch stream parts first to reduce LLM calls
     new BatchPartsProcessor({

package/.docs/reference/processors/pii-detector.md

@@ -61,7 +61,7 @@ import { PIIDetector } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'private-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [
     new PIIDetector({
       model: 'openrouter/openai/gpt-oss-safeguard-20b',
@@ -89,7 +89,7 @@ import { BatchPartsProcessor, PIIDetector } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'output-pii-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   outputProcessors: [
     // Batch stream parts first to reduce LLM calls
     new BatchPartsProcessor({

package/.docs/reference/processors/prefill-error-handler.md

@@ -26,7 +26,7 @@ import { PrefillErrorHandler } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
-  model: 'anthropic/claude-opus-4-6',
+  model: 'anthropic/claude-opus-4-7',
   errorProcessors: [new PrefillErrorHandler()],
 })
 ```
@@ -47,7 +47,7 @@ const customErrorHandler: Processor = {
 export const agent = new Agent({
   name: 'my-agent',
   instructions: 'You are a helpful assistant.',
-  model: 'anthropic/claude-opus-4-6',
+  model: 'anthropic/claude-opus-4-7',
   errorProcessors: [customErrorHandler],
 })
 ```

package/.docs/reference/processors/processor-interface.md

@@ -318,7 +318,7 @@ processInputStep?<TTripwireMetadata = unknown>(
 
 The object form can return any combination of these properties:
 
-**model** (`LanguageModelV2 | string`): Change the model for this step. Can be a model instance or router ID like '\_\_GATEWAY\_OPENAI\_MODEL\_\_'.
+**model** (`LanguageModelV2 | string`): Change the model for this step. Can be a model instance or router ID like 'openai/gpt-5.5'.
 
 **toolChoice** (`ToolChoice`): Change tool selection behavior for this step.
 
@@ -778,7 +778,7 @@ export class DynamicModelProcessor implements Processor {
 
     // Switch to powerful model after tool calls
     if (steps.length > 0 && steps[steps.length - 1].toolCalls?.length) {
-      return { model: 'openai/gpt-5.4' }
+      return { model: 'openai/gpt-5.5' }
     }
 
     // Disable tools after 5 steps to force completion

package/.docs/reference/processors/prompt-injection-detector.md

@@ -53,7 +53,7 @@ import { PromptInjectionDetector } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'secure-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [
     new PromptInjectionDetector({
       model: 'openrouter/openai/gpt-oss-safeguard-20b',

package/.docs/reference/processors/regex-filter-processor.md

@@ -49,7 +49,7 @@ import { RegexFilterProcessor } from '@mastra/core/processors'
 
 const agent = new Agent({
   name: 'my-agent',
-  model: '__OPENAI_MODEL_NANO__',
+  model: 'openai/gpt-5-nano',
   processors: {
     input: [
       new RegexFilterProcessor({

package/.docs/reference/processors/semantic-recall-processor.md

@@ -82,7 +82,7 @@ const semanticRecall = new SemanticRecall({
 export const agent = new Agent({
   name: 'semantic-memory-agent',
   instructions: 'You are a helpful assistant with semantic memory recall',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [semanticRecall, new MessageHistory({ storage, lastMessages: 50 })],
   outputProcessors: [semanticRecall, new MessageHistory({ storage })],
 })

package/.docs/reference/processors/skill-search-processor.md

@@ -74,7 +74,7 @@ const agent = new Agent({
   name: 'skill-agent',
   instructions:
     'You are a helpful assistant. Use search_skills to find relevant skills, then load_skill to load their instructions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   workspace,
   inputProcessors: [skillSearch],
 })

package/.docs/reference/processors/system-prompt-scrubber.md

@@ -57,7 +57,7 @@ import { BatchPartsProcessor, SystemPromptScrubber } from '@mastra/core/processo
 export const agent = new Agent({
   name: 'scrubbed-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   outputProcessors: [
     // Batch stream parts first to reduce LLM calls
     new BatchPartsProcessor({

package/.docs/reference/processors/token-limiter-processor.md

@@ -81,7 +81,7 @@ import { TokenLimiterProcessor } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'context-limited-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     /* ... */
   }),
@@ -102,7 +102,7 @@ import { TokenLimiterProcessor } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'multi-step-agent',
   instructions: 'You are a helpful research assistant with access to tools',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [
     new TokenLimiterProcessor({ limit: 8000 }), // Applied at every step
   ],
@@ -125,7 +125,7 @@ import { TokenLimiterProcessor } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'response-limited-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   outputProcessors: [
     new TokenLimiterProcessor({
       limit: 1000,

package/.docs/reference/processors/tool-call-filter.md

@@ -90,7 +90,7 @@ import { ToolCallFilter } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'filtered-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   tools: {
     searchDatabase,
     sendEmail,
@@ -115,7 +115,7 @@ import { ToolCallFilter } from '@mastra/core/processors'
 export const agent = new Agent({
   name: 'no-tools-context-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   tools: {
     searchDatabase,
     sendEmail,

package/.docs/reference/processors/tool-search-processor.md

@@ -101,7 +101,7 @@ const agent = new Agent({
   name: 'dynamic-tools-agent',
   instructions:
     'You are a helpful assistant with access to many tools. Use search_tools to find relevant tools, then load_tool to make them available.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [toolSearch],
 })
 ```
@@ -122,7 +122,7 @@ import { ToolSearchProcessor, TokenLimiter } from '@mastra/core/processors'
 
 const agent = new Agent({
   name: 'my-agent',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [
     new ToolSearchProcessor({
       tools: allTools,

package/.docs/reference/processors/unicode-normalizer.md

@@ -43,7 +43,7 @@ export const agent = new Agent({
   id: 'normalized-agent',
   name: 'normalized-agent',
   instructions: 'You are a helpful assistant',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [
     new UnicodeNormalizer({
       stripControlChars: true,

package/.docs/reference/processors/working-memory-processor.md

@@ -67,7 +67,7 @@ const storage = new PostgresStorage({
 export const agent = new Agent({
   name: 'personalized-agent',
   instructions: 'You are a helpful assistant that remembers user preferences',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   inputProcessors: [
     new WorkingMemory({
       storage,

package/.docs/reference/rag/rerank.md

@@ -16,7 +16,7 @@ function rerank(
 ```typescript
 import { rerank } from '@mastra/rag'
 
-const model = 'openai/gpt-5.4'
+const model = 'openai/gpt-5.5'
 
 const rerankedResults = await rerank(vectorSearchResults, 'How do I deploy to production?', model, {
   weights: {

package/.docs/reference/server/nestjs-adapter.md

@@ -114,7 +114,7 @@ import { Mastra } from '@mastra/core/mastra'
             greeter: {
               name: 'greeter',
               description: 'Greets the user',
-              model: config.get('MASTRA_MODEL', '__OPENAI_MODEL_MINI__'),
+              model: config.get('MASTRA_MODEL', 'openai/gpt-5-mini'),
             },
           },
         }),

package/.docs/reference/server/routes.md

@@ -4,19 +4,20 @@ Server adapters register these routes when you call `server.init()`. All routes
 
 ## Agents
 
-| Method | Path                                         | Description                                           |
-| ------ | -------------------------------------------- | ----------------------------------------------------- |
-| `GET`  | `/api/agents`                                | List all agents                                       |
-| `GET`  | `/api/agents/:agentId`                       | Get agent by ID (supports version query params)       |
-| `POST` | `/api/agents/:agentId/generate`              | Generate agent response                               |
-| `POST` | `/api/agents/:agentId/stream`                | Stream agent response                                 |
-| `POST` | `/api/agents/:agentId/send-message`          | Send a user message to an active or idle thread       |
-| `POST` | `/api/agents/:agentId/queue-message`         | Queue a user message for the next thread turn         |
-| `POST` | `/api/agents/:agentId/signals`               | Send a lower-level signal to an active or idle thread |
-| `POST` | `/api/agents/:agentId/subscribe-thread`      | Subscribe to a thread stream                          |
-| `POST` | `/api/agents/:agentId/resume-stream`         | Resume a suspended agent stream with custom data      |
-| `GET`  | `/api/agents/:agentId/tools`                 | List agent tools                                      |
-| `POST` | `/api/agents/:agentId/tools/:toolId/execute` | Execute agent tool                                    |
+| Method | Path                                         | Description                                                             |
+| ------ | -------------------------------------------- | ----------------------------------------------------------------------- |
+| `GET`  | `/api/agents`                                | List all agents                                                         |
+| `GET`  | `/api/agents/:agentId`                       | Get agent by ID (supports version query params)                         |
+| `POST` | `/api/agents/:agentId/generate`              | Generate agent response                                                 |
+| `POST` | `/api/agents/:agentId/stream`                | Stream agent response                                                   |
+| `POST` | `/api/agents/:agentId/send-message`          | Send a user message to an active or idle thread                         |
+| `POST` | `/api/agents/:agentId/queue-message`         | Queue a user message for the next thread turn                           |
+| `POST` | `/api/agents/:agentId/signals`               | Send a lower-level signal to an active or idle thread                   |
+| `POST` | `/api/agents/:agentId/threads/subscribe`     | Subscribe to a thread stream                                            |
+| `POST` | `/api/agents/:agentId/send-tool-approval`    | Approve or decline a tool call and resume through a thread subscription |
+| `POST` | `/api/agents/:agentId/resume-stream`         | Resume a suspended agent stream with custom data                        |
+| `GET`  | `/api/agents/:agentId/tools`                 | List agent tools                                                        |
+| `POST` | `/api/agents/:agentId/tools/:toolId/execute` | Execute agent tool                                                      |
 
 ### Get agent query parameters
 
@@ -140,6 +141,32 @@ Both routes return:
 }
 ```
 
+### Subscription tool approval routes
+
+Use `POST /api/agents/:agentId/send-tool-approval` when the client already has an active thread subscription. The route resumes the run and returns a JSON acknowledgement. Resumed stream chunks are delivered through `POST /api/agents/:agentId/threads/subscribe`.
+
+The route accepts this request body:
+
+```typescript
+{
+  resourceId: string;
+  threadId: string;
+  toolCallId: string;
+  approved: boolean;
+  requestContext?: Record<string, unknown>;
+}
+```
+
+The route returns:
+
+```typescript
+{
+  accepted: true;
+  runId: string;
+  toolCallId?: string;
+}
+```
+
 ## Workflows
 
 | Method | Path                                      | Description                     |

package/.docs/reference/storage/dsql.md

@@ -241,7 +241,7 @@ export const dsqlAgent = new Agent({
   name: 'DSQL Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new DSQLStore({
       id: 'dsql-agent-storage',

package/.docs/reference/storage/mongodb.md

@@ -206,7 +206,7 @@ export const mongodbAgent = new Agent({
   name: 'mongodb-agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new MongoDBStore({
       uri: process.env.MONGODB_URI!,

package/.docs/reference/storage/postgresql.md

@@ -332,7 +332,7 @@ export const pgAgent = new Agent({
   name: 'PG Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new PostgresStore({
       id: 'pg-agent-storage',

package/.docs/reference/storage/redis.md

@@ -181,7 +181,7 @@ export const redisAgent = new Agent({
   name: 'Redis Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new RedisStore({
       id: 'redis-agent-storage',

package/.docs/reference/storage/spanner.md

@@ -122,6 +122,11 @@ The storage adapter creates the following tables, all using the GoogleSQL dialec
 - `mastra_prompt_blocks` / `mastra_prompt_block_versions`: prompt block records and versioned content snapshots (template content, rules, request-context schema)
 - `mastra_scorer_definitions` / `mastra_scorer_definition_versions`: scorer definition records and versioned config snapshots (judge instructions, model, score range, preset config, default sampling)
 - `mastra_schedules` / `mastra_schedule_triggers`: cron-driven workflow schedules and trigger history, consumed by Mastra's built-in `WorkflowScheduler`
+- `mastra_workspaces` / `mastra_workspace_versions`: workspace records and versioned configuration snapshots (filesystem, sandbox, mounts, search, skills, tools)
+- `mastra_datasets` / `mastra_dataset_items` / `mastra_dataset_versions`: evaluation datasets, SCD-2 versioned items, and version snapshots
+- `mastra_experiments` / `mastra_experiment_results`: experiment runs and their per-item results
+- `mastra_favorites`: per-user favorites for agents and skills, with denormalized `favoriteCount` maintained on the parent record
+- `mastra_channel_installations` / `mastra_channel_config`: multi-platform channel installations and per-platform configuration
 - `mastra_ai_spans`: AI tracing spans for observability (per-trace and per-span records, used to power the Studio traces UI)
 
 Tables are created with `STRING(MAX)` for text and JSON payloads, `INT64`, `FLOAT64`, `BOOL`, and `TIMESTAMP`.

package/.docs/reference/storage/upstash.md

@@ -103,7 +103,7 @@ export const upstashAgent = new Agent({
   name: 'Upstash Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new UpstashStore({
       id: 'upstash-agent-storage',

package/.docs/reference/streaming/agents/stream.md

@@ -322,7 +322,7 @@ await agent.stream('message for agent', {
       sentiment: z.enum(['positive', 'negative', 'neutral']),
       confidence: z.number(),
     }),
-    model: 'openai/gpt-5.4',
+    model: 'openai/gpt-5.5',
     errorStrategy: 'warn',
   },
   // Output processors for streaming response validation

package/.docs/reference/templates/overview.md

@@ -192,7 +192,7 @@ import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
   name: 'example-agent',
-  model: 'openai/gpt-5.4', // or other provider strings
+  model: 'openai/gpt-5.5', // or other provider strings
   instructions: 'Your agent instructions here',
 })
 ```

package/.docs/reference/tools/mcp-client.md

@@ -890,7 +890,7 @@ const agent = new Agent({
   id: 'multi-tool-agent',
   name: 'Multi-tool Agent',
   instructions: 'You have access to multiple tool servers.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   tools: await mcp.listTools(),
 })
 
@@ -941,7 +941,7 @@ const agent = new Agent({
   id: 'multi-tool-agent',
   name: 'Multi-tool Agent',
   instructions: 'You help users check stocks and weather.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
 })
 
 // Later, configure MCP with user-specific settings

package/.docs/reference/tools/mcp-server.md

@@ -22,7 +22,7 @@ const myAgent = new Agent({
   name: 'MyExampleAgent',
   description: 'A generalist to help with basic questions.',
   instructions: 'You are a helpful assistant.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
 })
 
 const weatherTool = createTool({
@@ -67,6 +67,8 @@ The constructor accepts an `MCPServerConfig` object with the following propertie
 
 **instructions** (`string`): Optional instructions describing how to use the server and its features.
 
+**mapAuthInfoToUser** (`({ authInfo, extra, requestContext }) => unknown | null | undefined | Promise<unknown | null | undefined>`): Maps MCP transport auth data from \`extra.authInfo\` into the \`user\` value used by Mastra FGA checks. Use this when an OAuth-protected MCP server is registered on a Mastra instance with an FGA provider.
+
 **repository** (`Repository`): Optional repository information for the server's source code.
 
 **releaseDate** (`string`): Optional release date of this server version (ISO 8601 string). Defaults to the time of instantiation if not provided.
@@ -1097,6 +1099,36 @@ Whatever you set on `req.auth` in your HTTP middleware becomes available as `con
 req.auth = { ... }  →  context?.mcp?.extra?.authInfo.extra = { ... }
 ```
 
+### Map auth data for FGA
+
+When an `MCPServer` is registered on a Mastra instance with a fine-grained authorization (FGA) provider, Mastra checks `requestContext.get('user')` before listing or calling tools. HTTP MCP transports pass authenticated data as `extra.authInfo`, so use `mapAuthInfoToUser` to set the user shape expected by your FGA provider.
+
+```typescript
+const server = new MCPServer({
+  id: 'my-server',
+  name: 'My Server',
+  version: '1.0.0',
+  tools: { getUserData },
+  mapAuthInfoToUser: ({ authInfo }) => {
+    const user = authInfo as {
+      extra?: {
+        userId?: string
+        organizationMembershipId?: string
+      }
+    }
+
+    if (!user.extra?.userId) {
+      return null
+    }
+
+    return {
+      id: user.extra.userId,
+      organizationMembershipId: user.extra.organizationMembershipId,
+    }
+  },
+})
+```
+
 ### Setting Up Authentication Middleware
 
 To pass data to your tools, populate `req.auth` on the Node.js request object in your HTTP server middleware before calling `server.startHTTP()`.

package/.docs/reference/tools/vector-query-tool.md

@@ -142,7 +142,7 @@ const queryTool = createVectorQueryTool({
   indexName: 'documentation',
   model: new ModelRouterEmbeddingModel('openai/text-embedding-3-small'),
   reranker: {
-    model: 'openai/gpt-5.4',
+    model: 'openai/gpt-5.5',
     options: {
       weights: {
         semantic: 0.5, // Semantic relevance weight

package/.docs/reference/vectors/libsql.md

@@ -277,7 +277,7 @@ export const libsqlAgent = new Agent({
   name: 'libSQL Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new LibSQLStore({
       id: 'libsql-agent-storage',

package/.docs/reference/vectors/mongodb.md

@@ -263,7 +263,7 @@ export const mongodbAgent = new Agent({
   name: 'mongodb-agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new MongoDBStore({
       id: 'mongodb-storage',

package/.docs/reference/vectors/pg.md

@@ -401,7 +401,7 @@ export const pgAgent = new Agent({
   name: 'PG Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new PostgresStore({
       id: 'pg-agent-storage',

package/.docs/reference/vectors/upstash.md

@@ -265,7 +265,7 @@ export const upstashAgent = new Agent({
   name: 'Upstash Agent',
   instructions:
     'You are an AI agent with the ability to automatically recall memories from previous interactions.',
-  model: 'openai/gpt-5.4',
+  model: 'openai/gpt-5.5',
   memory: new Memory({
     storage: new UpstashStore({
       id: 'upstash-agent-storage',