@mastra/mcp-docs-server 1.0.0-beta.3 → 1.0.0-beta.5

package/.docs/raw/{frameworks/web-frameworks → guides/getting-started}/sveltekit.mdx

@@ -27,27 +27,27 @@ Use this guide to scaffold and integrate Mastra with your SvelteKit project.
 
 Install Mastra
 
-Install the required Mastra packages:
+Install the required packages:
 
 <Tabs>
   <TabItem value="npm" label="npm">
     ```bash copy
-    npm install mastra@beta @mastra/core@beta @mastra/libsql@beta
+    npm install mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
   <TabItem value="yarn" label="yarn">
     ```bash copy
-    yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta
+    yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
     ```bash copy
-    pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta
+    pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
   <TabItem value="bun" label="bun">
     ```bash copy
-    bun add mastra@beta @mastra/core@beta @mastra/libsql@beta
+    bun add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
 </Tabs>
@@ -128,14 +128,13 @@ Add `.mastra` to your `.gitignore` file:
 
 Update the Mastra Agent
 
-```diff title="src/mastra/agents/weather-agent.ts"
-- import { openai } from "@ai-sdk/openai";
-+ import { createOpenAI } from "@ai-sdk/openai";
+```typescript title="src/mastra/agents/weather-agent.ts"
+import { createOpenAI } from "@ai-sdk/openai";
 
-+ const openai = createOpenAI({
-+   apiKey: import.meta.env?.VITE_OPENAI_API_KEY || process.env.VITE_OPENAI_API_KEY,
-+   compatibility: "strict"
-+ });
+ const openai = createOpenAI({
+   apiKey: import.meta.env?.VITE_OPENAI_API_KEY || process.env.VITE_OPENAI_API_KEY,
+   compatibility: "strict"
+ });
 ```
 
 By reading env vars from both `import.meta.env` and `process.env`, we ensure that the API key is available in both the SvelteKit dev server and the Mastra Dev Server.
@@ -258,27 +257,27 @@ If you need more details or information about a different location, feel free to
 
 <StepItem>
 
-Install the required Mastra packages:
+Install the required packages:
 
 <Tabs>
   <TabItem value="npm" label="npm">
     ```bash copy
-    npm install mastra@beta @mastra/core@beta @mastra/libsql@beta
+    npm install mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
   <TabItem value="yarn" label="yarn">
     ```bash copy
-    yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta
+    yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
     ```bash copy
-    pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta
+    pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
   <TabItem value="bun" label="bun">
     ```bash copy
-    bun add mastra@beta @mastra/core@beta @mastra/libsql@beta
+    bun add mastra@beta @mastra/core@beta @mastra/libsql@beta @ai-sdk/openai
     ```
   </TabItem>
 </Tabs>
@@ -359,14 +358,13 @@ Add `.mastra` to your `.gitignore` file:
 
 Update the Mastra Agent
 
-```diff title="src/mastra/agents/weather-agent.ts"
-- import { openai } from "@ai-sdk/openai";
-+ import { createOpenAI } from "@ai-sdk/openai";
+```typescript title="src/mastra/agents/weather-agent.ts"
+import { createOpenAI } from "@ai-sdk/openai";
 
-+ const openai = createOpenAI({
-+   apiKey: import.meta.env?.VITE_OPENAI_API_KEY || process.env.VITE_OPENAI_API_KEY,
-+   compatibility: "strict"
-+ });
+const openai = createOpenAI({
+   apiKey: import.meta.env?.VITE_OPENAI_API_KEY || process.env.VITE_OPENAI_API_KEY,
+   compatibility: "strict"
+ });
 ```
 
 By reading env vars from both `import.meta.env` and `process.env`, we ensure that the API key is available in both the SvelteKit dev server and the Mastra Dev Server.
@@ -499,4 +497,4 @@ If you need more details or information about a different location, feel free to
 
 ## Next steps
 
-- [Monorepo Deployment](../../deployment/monorepo)
+- [Monorepo Deployment](/docs/v1/deployment/monorepo)

package/.docs/raw/{frameworks/web-frameworks → guides/getting-started}/vite-react.mdx

@@ -1,12 +1,12 @@
 ---
-title: "Integrate Mastra in your Vite/React project | Frameworks"
-description: A step-by-step guide to integrating Mastra with Vite and React.
+title: "Integrate Mastra in your React + Vite project | Frameworks"
+description: A step-by-step guide to integrating Mastra with React and Vite.
 ---
 
 import Tabs from "@theme/Tabs";
 import TabItem from "@theme/TabItem";
 
-# Integrate Mastra in your Vite/React project
+# Integrate Mastra in your React + Vite project
 
 Mastra integrates with Vite, making it easy to:
 
@@ -14,11 +14,11 @@ Mastra integrates with Vite, making it easy to:
 - Simplify deployment with a unified codebase for frontend and backend
 - Take advantage of Mastra's Client SDK
 
-Use this guide to scaffold and integrate Mastra with your Vite/React project.
+Use this guide to scaffold and integrate Mastra with your React + Vite project.
 
 :::warning
 
-This guide assumes you're using Vite/React with React Router v7 at the root of your project, e.g., `app`.
+This guide assumes you're using React + Vite with React Router v7 at the root of your project, e.g., `app`.
 
 :::
 
@@ -81,7 +81,7 @@ npx mastra@latest init
 
 :::warning
 
-By default, `mastra init` suggests `src` as the install location. If you're using Vite/React at the root of your project (e.g., `app`, not `src/app`), enter `.` when prompted:
+By default, `mastra init` suggests `src` as the install location. If you're using React + Vite at the root of your project (e.g., `app`, not `src/app`), enter `.` when prompted:
 
 :::
 
@@ -252,4 +252,4 @@ The current weather in London is partly cloudy with a temperature of 19.3°C, fe
 
 ## Next steps
 
-- [Monorepo Deployment](../../deployment/monorepo)
+- [Monorepo Deployment](/docs/v1/deployment/monorepo)

package/.docs/raw/guides/guide/ai-recruiter.mdx

@@ -16,7 +16,7 @@ You'll create a workflow that gathers information from a candidate's resume, the
 
 - Node.js `v22.13.0` or later installed
 - An API key from a supported [Model Provider](/models/v1)
-- An existing Mastra project (Follow the [installation guide](/guides/v1/quickstarts/standalone-server) to set up a new project)
+- An existing Mastra project (Follow the [installation guide](/guides/v1/getting-started/quickstart) to set up a new project)
 
 ## Building the Workflow
 
@@ -58,13 +58,12 @@ To the existing `src/mastra/workflows/candidate-workflow.ts` file add the follow
 
 ```ts copy title="src/mastra/workflows/candidate-workflow.ts"
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 
 const recruiter = new Agent({
   id: "recruiter-agent",
   name: "Recruiter Agent",
   instructions: `You are a recruiter.`,
-  model: openai("gpt-4o-mini"),
+  model: "openai/gpt-5.1",
 });
 
 const gatherCandidateInfo = createStep({

package/.docs/raw/guides/guide/chef-michel.mdx

@@ -19,7 +19,7 @@ You'll learn how to create the agent and register it with Mastra. Next, you'll i
 
 - Node.js `v22.13.0` or later installed
 - An API key from a supported [Model Provider](/models/v1)
-- An existing Mastra project (Follow the [installation guide](/guides/v1/quickstarts/standalone-server) to set up a new project)
+- An existing Mastra project (Follow the [installation guide](/guides/v1/getting-started/quickstart) to set up a new project)
 
 ## Creating the Agent
 
@@ -32,7 +32,6 @@ To create an agent in Mastra use the `Agent` class to define it and then registe
 Create a new file `src/mastra/agents/chefAgent.ts` and define your agent:
 
 ```ts copy title="src/mastra/agents/chefAgent.ts"
-import { openai } from "@ai-sdk/openai";
 import { Agent } from "@mastra/core/agent";
 
 export const chefAgent = new Agent({
@@ -41,7 +40,7 @@ export const chefAgent = new Agent({
   instructions:
     "You are Michel, a practical and experienced home chef" +
     "You help people cook with whatever ingredients they have available.",
-  model: openai("gpt-4o-mini"),
+  model: "openai/gpt-5.1",
 });
 ```
 

package/.docs/raw/guides/guide/notes-mcp-server.mdx

@@ -18,7 +18,7 @@ In this guide, you'll learn how to build a complete MCP (Model Context Protocol)
 
 - Node.js `v22.13.0` or later installed
 - An API key from a supported [Model Provider](/models/v1)
-- An existing Mastra project (Follow the [installation guide](/guides/v1/quickstarts/standalone-server) to set up a new project)
+- An existing Mastra project (Follow the [installation guide](/guides/v1/getting-started/quickstart) to set up a new project)
 
 ## Adding necessary dependencies & files
 
@@ -38,7 +38,7 @@ npm install @mastra/mcp@beta
 
 <StepItem>
 
-After following the default [installation guide](/guides/v1/quickstarts/standalone-server) your project will include files that are not relevant for this guide. You can safely remove them:
+After following the default [installation guide](/guides/v1/getting-started/quickstart) your project will include files that are not relevant for this guide. You can safely remove them:
 
 ```bash copy
 rm -rf src/mastra/agents src/mastra/workflows src/mastra/tools/weather-tool.ts

package/.docs/raw/guides/guide/research-assistant.mdx

@@ -16,7 +16,7 @@ You'll use the foundational Transformer paper ["Attention Is All You Need"](http
 
 - Node.js `v22.13.0` or later installed
 - An API key from a supported [Model Provider](/models/v1)
-- An existing Mastra project (Follow the [installation guide](/guides/v1/quickstarts/standalone-server) to set up a new project)
+- An existing Mastra project (Follow the [installation guide](/guides/v1/getting-started/quickstart) to set up a new project)
 
 ## How RAG works
 
@@ -57,7 +57,7 @@ Let's define the agent's behavior, connect it to your Mastra project, and create
 
 Install additional dependencies
 
-After running the [installation guide](/guides/v1/quickstarts/standalone-server) you'll need to install additional dependencies:
+After running the [installation guide](/guides/v1/getting-started/quickstart) you'll need to install additional dependencies:
 
 ```bash copy
 npm install @mastra/rag@beta ai@^4.0.0
@@ -76,14 +76,14 @@ Create a new file `src/mastra/agents/researchAgent.ts` and define your agent:
 
 ```ts copy title="src/mastra/agents/researchAgent.ts"
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
+import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
 import { createVectorQueryTool } from "@mastra/rag";
 
 // Create a tool for semantic search over the paper embeddings
 const vectorQueryTool = createVectorQueryTool({
   vectorStoreName: "libSqlVector",
   indexName: "papers",
-  model: openai.embedding("text-embedding-3-small"),
+  model: new ModelRouterEmbeddingModel("openai/text-embedding-3-small"),
 });
 
 export const researchAgent = new Agent({
@@ -94,7 +94,7 @@ export const researchAgent = new Agent({
     and provide accurate, well-supported answers based on the retrieved content.
     Focus on the specific content available in the tool and acknowledge if you cannot find sufficient information to answer a question.
     Base your responses only on the content provided, not on general knowledge.`,
-  model: openai("gpt-4o-mini"),
+  model: "openai/gpt-5.1",
   tools: {
     vectorQueryTool,
   },
@@ -229,9 +229,8 @@ This allows the agent to efficiently search and retrieve relevant information.
 
 Open the `src/store.ts` file and add the following:
 
-```ts copy title="src/store.ts" {2-4, 20-99}
+```ts copy title="src/store.ts"
 import { MDocument } from "@mastra/rag";
-import { openai } from "@ai-sdk/openai";
 import { embedMany } from "ai";
 import { mastra } from "./mastra";
 
@@ -251,7 +250,7 @@ const chunks = await doc.chunk({
 
 // Generate embeddings
 const { embeddings } = await embedMany({
-  model: openai.embedding("text-embedding-3-small"),
+  model: new ModelRouterEmbeddingModel("openai/text-embedding-3-small"),
   values: chunks.map((chunk) => chunk.text),
 });
 

package/.docs/raw/guides/guide/stock-agent.mdx

@@ -17,7 +17,7 @@ In this guide, you're going to create a simple agent that fetches the last day's
 
 - Node.js `v22.13.0` or later installed
 - An API key from a supported [Model Provider](/models/v1)
-- An existing Mastra project (Follow the [installation guide](/guides/v1/quickstarts/standalone-server) to set up a new project)
+- An existing Mastra project (Follow the [installation guide](/guides/v1/getting-started/quickstart) to set up a new project)
 
 ## Creating the Agent
 
@@ -30,7 +30,6 @@ To create an agent in Mastra use the `Agent` class to define it and then registe
 Create a new file `src/mastra/agents/stockAgent.ts` and define your agent:
 
 ```ts copy title="src/mastra/agents/stockAgent.ts"
-import { openai } from "@ai-sdk/openai";
 import { Agent } from "@mastra/core/agent";
 
 export const stockAgent = new Agent({
@@ -38,7 +37,7 @@ export const stockAgent = new Agent({
   name: "Stock Agent",
   instructions:
     "You are a helpful assistant that provides current stock prices. When asked about a stock, use the stock price tool to fetch the stock price.",
-  model: openai("gpt-4o-mini"),
+  model: "openai/gpt-5.1",
 });
 ```
 
@@ -104,8 +103,7 @@ export const stockPrices = createTool({
 
 Inside `src/mastra/agents/stockAgent.ts` import your newly created `stockPrices` tool and add it to the agent.
 
-```ts copy title="src/mastra/agents/stockAgent.ts" {3, 10-12}
-import { openai } from "@ai-sdk/openai";
+```ts copy title="src/mastra/agents/stockAgent.ts" {9-11}
 import { Agent } from "@mastra/core/agent";
 import { stockPrices } from "../tools/stockPrices";
 
@@ -114,7 +112,7 @@ export const stockAgent = new Agent({
   name: "Stock Agent",
   instructions:
     "You are a helpful assistant that provides current stock prices. When asked about a stock, use the stock price tool to fetch the stock price.",
-  model: openai("gpt-4o-mini"),
+  model: "openai/gpt-5.1",
   tools: {
     stockPrices,
   },

package/.docs/raw/guides/guide/web-search.mdx

@@ -19,7 +19,7 @@ When building a web search agent, you have two main strategies to consider:
 
 - Node.js `v22.13.0` or later installed
 - An API key from a supported [Model Provider](/models/v1)
-- An existing Mastra project (Follow the [installation guide](/guides/v1/quickstarts/standalone-server) to set up a new project)
+- An existing Mastra project (Follow the [installation guide](/guides/v1/getting-started/quickstart) to set up a new project)
 
 ## Using native search tools
 
@@ -61,7 +61,7 @@ Create a new file `src/mastra/agents/searchAgent.ts` and define your agent:
         name: "Search Agent",
         instructions:
             "You are a search agent that can search the web for information.",
-        model: 'openai/gpt-4o-mini',
+        model: "openai/gpt-5.1",
     });
     ```
 
@@ -76,7 +76,7 @@ Create a new file `src/mastra/agents/searchAgent.ts` and define your agent:
         name: "Search Agent",
         instructions:
             "You are a search agent that can search the web for information.",
-        model: 'google/gemini-2.5-flash',
+        model: "google/gemini-2.5-flash",
     });
     ```
 
@@ -93,7 +93,7 @@ Setup the tool:
 <Tabs>
     <TabItem value="openai" label="Open AI">
 
-    ```ts copy title="src/mastra/agents/searchAgent.ts" {9-11}
+    ```ts copy title="src/mastra/agents/searchAgent.ts" {9-12}
     import { openai } from "@ai-sdk/openai";
     import { Agent } from "@mastra/core/agent";
 
@@ -102,7 +102,7 @@ Setup the tool:
         name: "Search Agent",
         instructions:
             "You are a search agent that can search the web for information.",
-        model: 'openai/gpt-4o-mini',
+        model: "openai/gpt-5.1",
         tools: {
             webSearch: openai.tools.webSearch()
         }
@@ -112,7 +112,7 @@ Setup the tool:
     </TabItem>
     <TabItem value="gemini" label="Gemini">
 
-    ```ts copy title="src/mastra/agents/searchAgent.ts" {9-11}
+    ```ts copy title="src/mastra/agents/searchAgent.ts" {9-14}
     import { google } from "@ai-sdk/google";
     import { Agent } from "@mastra/core/agent";
 
@@ -121,9 +121,11 @@ Setup the tool:
         name: "Search Agent",
         instructions:
             "You are a search agent that can search the web for information.",
-        model: 'google/gemini-2.5-flash',
+        model: "google/gemini-2.5-flash",
         tools: {
-            webSearch: google.tools.googleSearch()
+          webSearch: google.tools.googleSearch({
+            mode: "MODE_DYNAMIC"
+          })
         }
     });
     ```
@@ -191,7 +193,7 @@ export const searchAgent = new Agent({
   name: "Search Agent",
   instructions:
     "You are a search agent that can search the web for information.",
-  model: "openai/gpt-4o-mini",
+  model: "openai/gpt-5.1",
 });
 ```
 
@@ -252,7 +254,7 @@ export const searchAgent = new Agent({
   name: "Search Agent",
   instructions:
     "You are a search agent that can search the web for information.",
-  model: "openai/gpt-4o-mini",
+  model: "openai/gpt-5.1",
   tools: {
     webSearch,
   },

package/.docs/raw/guides/migrations/agentnetwork.mdx

@@ -40,7 +40,7 @@ const agent = new AgentNetwork({
   name: "agent-network",
   agents: [agent1, agent2],
   tools: { tool1, tool2 },
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   instructions:
     "You are a network agent that can help users with a variety of tasks.",
 });
@@ -61,7 +61,7 @@ const agent = new Agent({
   name: "agent-network",
   agents: { agent1, agent2 },
   tools: { tool1, tool2 },
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   instructions:
     "You are a network agent that can help users with a variety of tasks.",
   memory,
@@ -83,7 +83,7 @@ const agent = new NewAgentNetwork({
   agents: { agent1, agent2 },
   workflows: { workflow1 },
   tools: { tool1, tool2 },
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   instructions:
     "You are a network agent that can help users with a variety of tasks.",
 });
@@ -104,7 +104,7 @@ const agent = new Agent({
   agents: { agent1, agent2 },
   workflows: { workflow1 },
   tools: { tool1, tool2 },
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   instructions:
     "You are a network agent that can help users with a variety of tasks.",
   memory,

package/.docs/raw/guides/migrations/ai-sdk-v4-to-v5.mdx

@@ -5,7 +5,7 @@ description: "Mastra-specific guidance for upgrading from AI SDK v4 to v5."
 
 # Migrate from AI SDK v4 to v5
 
-Looking for integration docs? See [Using AI SDK](/docs/v1/frameworks/agentic-uis/ai-sdk).
+Looking for integration docs? See [Using AI SDK](/guides/v1/build-your-ui/ai-sdk-ui).
 
 Follow the official [AI SDK v5 Migration Guide](https://v5.ai-sdk.dev/docs/migration-guides/migration-guide-5-0) for all AI SDK core breaking changes, package updates, and API changes.
 

package/.docs/raw/guides/migrations/upgrade-to-v1/agent.mdx

@@ -202,6 +202,35 @@ To migrate, update from `output` or `experimental_output` to `structuredOutput.s
   });
 ```
 
+### Agent `id` field is now required
+
+The `id` field is now required when creating an Agent. Previously, agents could be created without an explicit ID, but this is no longer supported.
+
+To migrate, add an `id` field to all Agent configurations.
+
+```diff
+  const agent = new Agent({
++   id: 'my-agent',
+    name: 'My Agent',
+    instructions: 'You are a helpful assistant',
+    model: openai('gpt-4'),
+  });
+```
+
+The `id` can be the same as the `name`, or you can use a different identifier. The ID will be used when calling `mastra.getAgentById()` and must be unique within your Mastra instance.
+
+```typescript
+// Register agent with Mastra
+const mastra = new Mastra({
+  agents: {
+    myAgent: agent, // key can differ from id
+  },
+});
+
+// Retrieve by ID
+const agent = mastra.getAgentById('my-agent');
+```
+
 ## Removed
 
 ### `generateVNext` and `streamVNext` methods

package/.docs/raw/guides/migrations/upgrade-to-v1/tools.mdx

@@ -83,6 +83,11 @@ For tools that are executed inside a workflow, access workflow-specific properti
   });
 ```
 
+The `suspendPayload` gets validated against the `suspendSchema` when the tool is executed. If the suspendPayload doesn't match the `suspendSchema`, a warning is logged and the error is returned as tool output, but suspension continues.
+Also, when the tool is resumed, the `resumeData` gets validated against the `resumeSchema`. If the resumeData doesn't match the `resumeSchema`, the tool will return a `ValidationError`, preventing the tool resumption.
+
+To skip the `suspendSchema` or `resumeSchema` validation, do not define `suspendSchema` or `resumeSchema` in the tool creation.
+
 :::note
 For MCP-specific tool context changes, see the [MCP migration guide](/guides/v1/migrations/upgrade-to-v1/mcp).
 :::

package/.docs/raw/guides/migrations/upgrade-to-v1/workflows.mdx

@@ -136,6 +136,28 @@ createWorkflow({
 })
 ```
 
+### Step `suspendPayload` validation
+
+Step `suspendPayload` is now validated for steps that have a `suspendSchema` defined. This also uses the `validateInputs` flag to determine whether to validate the `suspendPayload` or not.
+
+```diff
+  createStep({
+    id: "suspend-resume-step",
+    // ... other step properties
+    suspendSchema: z.object({
+      reason: z.string(),
+      otherReason: z.string()
+    }),
+    execute: async ({ suspend, resumeData}) => {
+      if (!resumeData) {
+-       return suspend({ reason: "Suspension reason" }); // Missing otherReason
++       return suspend({ reason: "Suspension reason", otherReason: "Other reason" });
+      }
+      //... continue execution logic
+    },
+  });
+```
+
 ## Removed
 
 ### Legacy workflows export

package/.docs/raw/guides/migrations/vnext-to-standard-apis.mdx

@@ -160,7 +160,7 @@ The following options are available in the standard `.stream()` and `generate()`
           name: z.string(),
           age: z.number(),
         }),
-        model: "openai/gpt-4o-mini", // Optional model override for structuring
+        model: "openai/gpt-5.1", // Optional model override for structuring
         errorStrategy: "fallback",
         fallbackValue: { name: "unknown", age: 0 },
         instructions: "Extract user information", // Override default structuring instructions
@@ -300,7 +300,7 @@ The following options are available in the standard `.stream()` and `generate()`
       schema: z.object({
         summary: z.string(),
       }),
-      model: "openai/gpt-4o",
+      model: "openai/gpt-5.1",
     },
   });
   ```

package/.docs/raw/index.mdx

@@ -51,8 +51,8 @@ Explore real-world examples in our [community showcase](/showcase).
 
 ## Get started
 
-Choose a [quickstart](/docs/v1/getting-started/quickstart) to get started, or see the [manual installation guide](/guides/v1/guide/manual-install) if you need more control over your setup.
+Choose a [getting started guide](/docs/v1/getting-started/start) to get started, or see the [manual installation guide](/guides/v1/getting-started/manual-install) if you need more control over your setup.
 
-If you're new to AI agents, check out our [templates](/docs/v1/getting-started/templates), [course](https://mastra.ai/course), and [YouTube videos](https://youtube.com/@mastra-ai). You can also join our [Discord](https://discord.gg/BTYqqHKUrf) community to get help and share your projects.
+If you're new to AI agents, check out our [templates](https://mastra.ai/templates), [course](https://mastra.ai/course), and [YouTube videos](https://youtube.com/@mastra-ai). You can also join our [Discord](https://discord.gg/BTYqqHKUrf) community to get help and share your projects.
 
 We can't wait to see what you build ✌️

package/.docs/raw/mcp/overview.mdx

@@ -54,8 +54,7 @@ export const testMcpClient = new MCPClient({
 
 To use tools from an MCP server in an agent, import your `MCPClient` and call `.getTools()` in the `tools` parameter. This loads from the defined MCP servers, making them available to the agent.
 
-```typescript {4,16} title="src/mastra/agents/test-agent.ts" showLineNumbers copy
-import { openai } from "@ai-sdk/openai";
+```typescript {3,15} title="src/mastra/agents/test-agent.ts" showLineNumbers copy
 import { Agent } from "@mastra/core/agent";
 
 import { testMcpClient } from "../mcp/test-mcp-client";
@@ -69,7 +68,7 @@ export const testAgent = new Agent({
       - US National Weather Service
 
       Answer questions using the information you find using the MCP Servers.`,
-  model: openai("gpt-4o-mini"),
+  model: "openai/gpt-5.1",
   tools: await testMcpClient.getTools(),
 });
 ```
@@ -131,8 +130,7 @@ Use the `.getTools()` method to fetch tools from all configured MCP servers. Thi
 
 > See [getTools()](/reference/v1/tools/mcp-client#gettools) for more information.
 
-```typescript {8} title="src/mastra/agents/test-agent.ts" showLineNumbers copy
-import { openai } from "@ai-sdk/openai";
+```typescript {7} title="src/mastra/agents/test-agent.ts" showLineNumbers copy
 import { Agent } from "@mastra/core/agent";
 
 import { testMcpClient } from "../mcp/test-mcp-client";

package/.docs/raw/memory/memory-processors.mdx

@@ -21,12 +21,11 @@ This processor is used to prevent errors caused by exceeding the LLM's context w
 import { Memory } from "@mastra/memory";
 import { TokenLimiter } from "@mastra/memory/processors";
 import { Agent } from "@mastra/core/agent";
-import { openai } from "@ai-sdk/openai";
 
 const agent = new Agent({
   id: "test-agent",
   name: "Test Agent",
-  model: openai("gpt-4o"),
+  model: "openai/gpt-5.1",
   memory: new Memory({
     processors: [
       // Ensure the total tokens from memory don't exceed ~127k