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

package/.docs/models/index.md

@@ -23,65 +23,65 @@ Mastra reads the relevant environment variable (e.g. `ANTHROPIC_API_KEY`) and ro
 **OpenAI**:
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "openai/gpt-5.6-sol"
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'openai/gpt-5.6-sol',
 })
 ```
 
 **Anthropic**:
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "anthropic/claude-sonnet-4-6"
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'anthropic/claude-sonnet-4-6',
 })
 ```
 
 **Google Gemini**:
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "google/gemini-2.5-flash"
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'google/gemini-2.5-flash',
 })
 ```
 
 **xAI**:
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "xai/grok-4.3"
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'xai/grok-4.3',
 })
 ```
 
 **OpenRouter**:
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "openrouter/anthropic/claude-haiku-4.5"
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'openrouter/anthropic/claude-haiku-4.5',
 })
 ```
 
@@ -103,22 +103,22 @@ Alternatively, browse and test models in [Studio](https://mastra.ai/docs/studio/
 Some models are faster but less capable, while others offer larger context windows or stronger reasoning skills. Use different models from the same provider, or mix and match across providers to fit each task.
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 // Use a cost-effective model for document processing
 const documentProcessor = new Agent({
-  id: "document-processor",
-  name: "Document Processor",
-  instructions: "Extract and summarize key information from documents",
-  model: "openai/gpt-5.6-sol"
+  id: 'document-processor',
+  name: 'Document Processor',
+  instructions: 'Extract and summarize key information from documents',
+  model: 'openai/gpt-5.6-sol',
 })
 
 // Use a powerful reasoning model for complex analysis
 const reasoningAgent = new Agent({
-  id: "reasoning-agent",
-  name: "Reasoning Agent",
-  instructions: "Analyze data and provide strategic recommendations",
-  model: "anthropic/claude-opus-4-7"
+  id: 'reasoning-agent',
+  name: 'Reasoning Agent',
+  instructions: 'Analyze data and provide strategic recommendations',
+  model: 'anthropic/claude-opus-4-7',
 })
 ```
 
@@ -128,14 +128,14 @@ Since models are just strings, you can select them dynamically based on [request
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-assistant",
-  name: "Dynamic Assistant",
+  id: 'dynamic-assistant',
+  name: 'Dynamic Assistant',
   model: ({ requestContext }) => {
-    const provider = requestContext.get("provider-id");
-    const model = requestContext.get("model-id");
-    return `${provider}/${model}`;
+    const provider = requestContext.get('provider-id')
+    const model = requestContext.get('model-id')
+    return `${provider}/${model}`
   },
-});
+})
 ```
 
 This enables powerful patterns:
@@ -151,31 +151,30 @@ Different model providers expose their own configuration options. With OpenAI, y
 ```typescript
 // Agent level (apply to all future messages)
 const planner = new Agent({
-  id: "planner",
-  name: "Planner",
+  id: 'planner',
+  name: 'Planner',
   instructions: {
-    role: "system",
-    content: "You are a helpful assistant.",
+    role: 'system',
+    content: 'You are a helpful assistant.',
     providerOptions: {
-      openai: { reasoningEffort: "low" }
-    }
+      openai: { reasoningEffort: 'low' },
+    },
   },
-  model: "openai/gpt-5.6-sol",
-});
+  model: 'openai/gpt-5.6-sol',
+})
 
-const lowEffort =
-  await planner.generate("Plan a simple 3 item dinner menu");
+const lowEffort = await planner.generate('Plan a simple 3 item dinner menu')
 
 // Message level (apply only to this message)
 const highEffort = await planner.generate([
   {
-    role: "user",
-    content: "Plan a simple 3 item dinner menu for a celiac",
+    role: 'user',
+    content: 'Plan a simple 3 item dinner menu for a celiac',
     providerOptions: {
-      openai: { reasoningEffort: "high" }
-    }
-  }
-]);
+      openai: { reasoningEffort: 'high' },
+    },
+  },
+])
 ```
 
 ## Custom headers
@@ -184,16 +183,16 @@ If you need to specify custom headers, such as an organization ID or other provi
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "Custom Agent",
+  id: 'custom-agent',
+  name: 'Custom Agent',
   model: {
-    id: "openai/gpt-5.6-sol",
+    id: 'openai/gpt-5.6-sol',
     apiKey: process.env.OPENAI_API_KEY,
     headers: {
-      "OpenAI-Organization": "org-abc123"
-    }
-  }
-});
+      'OpenAI-Organization': 'org-abc123',
+    },
+  },
+})
 ```
 
 > **Info:** Configuration differs by provider. See the provider pages in the left navigation for details on custom headers.
@@ -203,7 +202,7 @@ const agent = new Agent({
 Relying on a single model creates a single point of failure for your application. Model fallbacks provide automatic failover between models and providers. If the primary model becomes unavailable, requests are retried against the next configured fallback until one succeeds.
 
 ```typescript
-import { Agent } from '@mastra/core/agent';
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
   id: 'resilient-assistant',
@@ -211,19 +210,19 @@ const agent = new Agent({
   instructions: 'You are a helpful assistant.',
   model: [
     {
-      model: "openai/gpt-5.6-sol",
+      model: 'openai/gpt-5.6-sol',
       maxRetries: 3,
     },
     {
-      model: "anthropic/claude-sonnet-4-6",
+      model: 'anthropic/claude-sonnet-4-6',
       maxRetries: 2,
     },
     {
-      model: "google/gemini-2.5-pro",
+      model: 'google/gemini-2.5-pro',
       maxRetries: 2,
     },
   ],
-});
+})
 ```
 
 Mastra tries your primary model first. If it encounters a 500 error, rate limit, or timeout, it automatically switches to your first fallback. If that fails too, it moves to the next. Each model gets its own retry count before moving on.
@@ -235,7 +234,7 @@ Your users never experience the disruption - the response comes back with the sa
 Each fallback entry can carry its own `modelSettings`, `providerOptions`, and `headers` — useful when models in the chain need different temperatures or provider-specific knobs to produce comparable output.
 
 ```typescript
-import { Agent } from '@mastra/core/agent';
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
   id: 'tuned-resilient',
@@ -255,7 +254,7 @@ const agent = new Agent({
       providerOptions: { openai: { reasoningEffort: 'low' } },
     },
   ],
-});
+})
 ```
 
 **Precedence:**
@@ -278,32 +277,32 @@ Use `gateway/provider/model` when the remote behaves like a model gateway and th
 For the `url` it's **important** that you use the base URL of the OpenAI-compatible endpoint with Mastra's `model` setting and not the individual chat endpoints.
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
   model: {
-    id: "custom/my-qwen3-model",
-    url: "http://your-custom-openai-compatible-endpoint.com/v1"
-  }
+    id: 'custom/my-qwen3-model',
+    url: 'http://your-custom-openai-compatible-endpoint.com/v1',
+  },
 })
 ```
 
 If the remote behaves like a model gateway, include the gateway prefix in `id`:
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
   model: {
-    id: "mastra/google/gemini-2.5-flash",
-    url: "http://your-custom-openai-compatible-endpoint.com/v1"
-  }
+    id: 'mastra/google/gemini-2.5-flash',
+    url: 'http://your-custom-openai-compatible-endpoint.com/v1',
+  },
 })
 ```
 
@@ -312,16 +311,16 @@ const agent = new Agent({
 After starting the LMStudio server, the local server is available at `http://localhost:1234` and it provides endpoints like `/v1/models`, `/v1/chat/completions`, etc. The `url` will be `http://localhost:1234/v1`. For the `id` you can use (`lmstudio/${modelId}`) which will be displayed in the LMStudio interface.
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
   model: {
-    id: "lmstudio/qwen/qwen3-30b-a3b-2507",
-    url: "http://localhost:1234/v1"
-  }
+    id: 'lmstudio/qwen/qwen3-30b-a3b-2507',
+    url: 'http://localhost:1234/v1',
+  },
 })
 ```
 
@@ -330,13 +329,13 @@ const agent = new Agent({
 Mastra supports AI SDK provider modules, should you need to use them directly.
 
 ```typescript
-import { groq } from '@ai-sdk/groq';
-import { Agent } from "@mastra/core/agent";
+import { groq } from '@ai-sdk/groq'
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  model: groq('gemma2-9b-it')
+  id: 'my-agent',
+  name: 'My Agent',
+  model: groq('gemma2-9b-it'),
 })
 ```
 

package/.docs/models/providers/alibaba-cn.md

@@ -11,22 +11,22 @@ DASHSCOPE_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "alibaba-cn/MiniMax-M2.5"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'alibaba-cn/MiniMax-M2.5',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -129,30 +129,28 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    url: "https://dashscope.aliyuncs.com/compatible-mode/v1",
-    id: "alibaba-cn/MiniMax-M2.5",
+    url: 'https://dashscope.aliyuncs.com/compatible-mode/v1',
+    id: 'alibaba-cn/MiniMax-M2.5',
     apiKey: process.env.DASHSCOPE_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
-    return useAdvanced
-      ? "alibaba-cn/tongyi-intent-detect-v3"
-      : "alibaba-cn/MiniMax-M2.5";
-  }
-});
+    const useAdvanced = requestContext.task === 'complex'
+    return useAdvanced ? 'alibaba-cn/tongyi-intent-detect-v3' : 'alibaba-cn/MiniMax-M2.5'
+  },
+})
 ```

package/.docs/models/providers/alibaba-token-plan-cn.md

@@ -11,22 +11,22 @@ ALIBABA_TOKEN_PLAN_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "alibaba-token-plan-cn/MiniMax-M2.5"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'alibaba-token-plan-cn/MiniMax-M2.5',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -67,30 +67,30 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    url: "https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1",
-    id: "alibaba-token-plan-cn/MiniMax-M2.5",
+    url: 'https://token-plan.cn-beijing.maas.aliyuncs.com/compatible-mode/v1',
+    id: 'alibaba-token-plan-cn/MiniMax-M2.5',
     apiKey: process.env.ALIBABA_TOKEN_PLAN_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
+    const useAdvanced = requestContext.task === 'complex'
     return useAdvanced
-      ? "alibaba-token-plan-cn/wan2.7-image-pro"
-      : "alibaba-token-plan-cn/MiniMax-M2.5";
-  }
-});
+      ? 'alibaba-token-plan-cn/wan2.7-image-pro'
+      : 'alibaba-token-plan-cn/MiniMax-M2.5'
+  },
+})
 ```

package/.docs/models/providers/alibaba-token-plan.md

@@ -11,22 +11,22 @@ ALIBABA_TOKEN_PLAN_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "alibaba-token-plan/MiniMax-M2.5"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'alibaba-token-plan/MiniMax-M2.5',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -67,30 +67,28 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    url: "https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1",
-    id: "alibaba-token-plan/MiniMax-M2.5",
+    url: 'https://token-plan.ap-southeast-1.maas.aliyuncs.com/compatible-mode/v1',
+    id: 'alibaba-token-plan/MiniMax-M2.5',
     apiKey: process.env.ALIBABA_TOKEN_PLAN_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
-    return useAdvanced
-      ? "alibaba-token-plan/wan2.7-image-pro"
-      : "alibaba-token-plan/MiniMax-M2.5";
-  }
-});
+    const useAdvanced = requestContext.task === 'complex'
+    return useAdvanced ? 'alibaba-token-plan/wan2.7-image-pro' : 'alibaba-token-plan/MiniMax-M2.5'
+  },
+})
 ```

package/.docs/models/providers/alibaba.md

@@ -11,22 +11,22 @@ DASHSCOPE_API_KEY=your-api-key
 ```
 
 ```typescript
-import { Agent } from "@mastra/core/agent";
+import { Agent } from '@mastra/core/agent'
 
 const agent = new Agent({
-  id: "my-agent",
-  name: "My Agent",
-  instructions: "You are a helpful assistant",
-  model: "alibaba/qvq-max"
-});
+  id: 'my-agent',
+  name: 'My Agent',
+  instructions: 'You are a helpful assistant',
+  model: 'alibaba/qvq-max',
+})
 
 // Generate a response
-const response = await agent.generate("Hello!");
+const response = await agent.generate('Hello!')
 
 // Stream a response
-const stream = await agent.stream("Tell me a story");
+const stream = await agent.stream('Tell me a story')
 for await (const chunk of stream) {
-  console.log(chunk);
+  console.log(chunk)
 }
 ```
 
@@ -95,30 +95,28 @@ for await (const chunk of stream) {
 
 ```typescript
 const agent = new Agent({
-  id: "custom-agent",
-  name: "custom-agent",
+  id: 'custom-agent',
+  name: 'custom-agent',
   model: {
-    url: "https://dashscope-intl.aliyuncs.com/compatible-mode/v1",
-    id: "alibaba/qvq-max",
+    url: 'https://dashscope-intl.aliyuncs.com/compatible-mode/v1',
+    id: 'alibaba/qvq-max',
     apiKey: process.env.DASHSCOPE_API_KEY,
     headers: {
-      "X-Custom-Header": "value"
-    }
-  }
-});
+      'X-Custom-Header': 'value',
+    },
+  },
+})
 ```
 
 ### Dynamic model selection
 
 ```typescript
 const agent = new Agent({
-  id: "dynamic-agent",
-  name: "Dynamic Agent",
+  id: 'dynamic-agent',
+  name: 'Dynamic Agent',
   model: ({ requestContext }) => {
-    const useAdvanced = requestContext.task === "complex";
-    return useAdvanced
-      ? "alibaba/qwq-plus"
-      : "alibaba/qvq-max";
-  }
-});
+    const useAdvanced = requestContext.task === 'complex'
+    return useAdvanced ? 'alibaba/qwq-plus' : 'alibaba/qvq-max'
+  },
+})
 ```