@mastra/mcp-docs-server 1.0.0-beta.1 → 1.0.0-beta.10

package/.docs/raw/{frameworks/agentic-uis → guides/build-your-ui}/assistant-ui.mdx

@@ -1,15 +1,14 @@
 ---
-title: "Using with Assistant UI | Frameworks | Mastra Docs"
+title: "Using Assistant UI | Frameworks"
 description: "Learn how to integrate Assistant UI with Mastra"
 ---
 
 import Steps from "@site/src/components/Steps";
 import StepItem from "@site/src/components/StepItem";
 
-# Using with Assistant UI
+# Using Assistant UI
 
-[Assistant UI](https://assistant-ui.com) is the TypeScript/React library for AI Chat.
-Built on shadcn/ui and Tailwind CSS, it enables developers to create beautiful, enterprise-grade chat experiences in minutes.
+[Assistant UI](https://assistant-ui.com) is the TypeScript/React library for AI Chat. Built on shadcn/ui and Tailwind CSS, it enables developers to create beautiful, enterprise-grade chat experiences in minutes.
 
 :::info
 
@@ -17,6 +16,12 @@ For a full-stack integration approach where Mastra runs directly in your Next.js
 
 :::
 
+:::tip
+
+Visit Mastra's [**"UI Dojo"**](https://ui-dojo.mastra.ai/) to see real-world examples of Assistant UI integrated with Mastra.
+
+:::
+
 ## Integration Guide
 
 Run Mastra as a standalone server and connect your Next.js frontend (with Assistant UI) to its API endpoints.
@@ -33,7 +38,7 @@ project-root
 │   ├── src
 │   │   └── mastra
 │   └── package.json
-└── nextjs-frontend
+└── my-app
     └── package.json
 ```
 
@@ -43,8 +48,13 @@ Bootstrap your Mastra server:
 npx create-mastra@beta
 ```
 
-This command will launch an interactive wizard to help you scaffold a new Mastra project, including prompting you for a project name and setting up basic configurations.
-Follow the prompts to create your server project.
+This command will launch an interactive wizard to help you scaffold a new Mastra project, including prompting you for a project name and setting up basic configurations. Follow the prompts to create your server project.
+
+Navigate to your newly created Mastra server directory:
+
+```bash copy
+cd mastra-server # Replace with the actual directory name you provided
+```
 
 You now have a basic Mastra server project ready. You should have the following files and folders:
 
@@ -53,6 +63,8 @@ src
 └── mastra
     ├── agents
     │   └── weather-agent.ts
+    ├── scorers
+    │   └── weather-scorer.ts
     ├── tools
     │   └── weather-tool.ts
     ├── workflows
@@ -70,18 +82,55 @@ Ensure that you have set the appropriate environment variables for your LLM prov
 
 <StepItem>
 
+Create a chat route for the Assistant UI frontend by using the `chatRoute()` helper from `@mastra/ai-sdk`. Add it to your Mastra project:
+
+```bash copy
+npm install @mastra/ai-sdk@beta
+```
+
+In your `src/mastra/index.ts` file, register the chat route:
+
+```typescript copy title="src/mastra/index.ts" {2,7-13}
+import { Mastra } from '@mastra/core/mastra';
+import { chatRoute } from '@mastra/ai-sdk';
+// Rest of the imports...
+
+export const mastra = new Mastra({
+  // Rest of the configuration...
+  server: {
+    apiRoutes: [
+      chatRoute({
+        path: '/chat/:agentId'
+      })
+    ]
+  }
+});
+```
+
+This will make all agents available in AI SDK-compatible formats, including the `weatherAgent` at the endpoint `/chat/weatherAgent`.
+
+</StepItem>
+
+<StepItem>
+
 Run the Mastra server using the following command:
 
 ```bash copy
 npm run dev
 ```
 
-By default, the Mastra server will run on `http://localhost:4111`. Your `weatherAgent` should now be accessible via a POST request endpoint, typically `http://localhost:4111/api/agents/weatherAgent/stream`. Keep this server running for the next steps where we'll set up the Assistant UI frontend to connect to it.
+By default, the Mastra server will run on `http://localhost:4111`. Keep this server running for the next steps where we'll set up the Assistant UI frontend to connect to it.
 
 </StepItem>
 
 <StepItem>
 
+Go up one directory to your project root.
+
+```bash copy
+cd ..
+```
+
 Create a new `assistant-ui` project with the following command.
 
 ```bash copy
@@ -100,19 +149,22 @@ For detailed setup instructions, including adding API keys, basic configuration,
 
 The default Assistant UI setup configures the chat runtime to use a local API route (`/api/chat`) within the Next.js project. Since our Mastra agent is running on a separate server, we need to update the frontend to point to that server's endpoint.
 
-Find the `useChatRuntime` hook in the `assistant-ui` project, typically at `app/assistant.tsx` and change the `api` property to the full URL of your Mastra agent's stream endpoint:
+Open the file in your assistant-ui frontend project that contains the `useChatRuntime` hook (usually `app/assistant.tsx` or `src/app/assistant.tsx`). Find the `useChatRuntime` hook and change the `api` property to the full URL of your Mastra agent's stream endpoint:
 
-```typescript showLineNumbers copy title="app/assistant.tsx" {6}
-import {
-  useChatRuntime,
-  AssistantChatTransport,
-} from "@assistant-ui/react-ai-sdk";
+```tsx {8} title="app/assistant.tsx"
+"use client";
 
-const runtime = useChatRuntime({
-  transport: new AssistantChatTransport({
-    api: "MASTRA_ENDPOINT",
-  }),
-});
+// Rest of the imports...
+
+export const Assistant = () => {
+  const runtime = useChatRuntime({
+    transport: new AssistantChatTransport({
+      api: "http://localhost:4111/chat/weatherAgent",
+    }),
+  });
+
+  // Rest of the component...
+};
 ```
 
 Now, the Assistant UI frontend will send chat requests directly to your running Mastra server.

package/.docs/raw/guides/build-your-ui/copilotkit.mdx

@@ -0,0 +1,206 @@
+---
+title: "Using CopilotKit | Frameworks"
+description: "Learn how to integrate CopilotKit with Mastra"
+---
+
+import Tabs from "@theme/Tabs";
+import TabItem from "@theme/TabItem";
+import Steps from "@site/src/components/Steps";
+import StepItem from "@site/src/components/StepItem";
+
+# Using CopilotKit
+
+[CopilotKit](https://www.copilotkit.ai/) provides React components to quickly integrate customizable AI copilots into your application. Combined with Mastra, you can build sophisticated AI apps featuring bidirectional state synchronization and interactive UIs.
+
+Visit the [CopilotKit documentation](https://docs.copilotkit.ai/) to learn more about CopilotKit concepts, components, and advanced usage patterns.
+
+:::info
+
+For a full-stack integration approach where Mastra runs directly in your Next.js API routes, see the [CopilotKit Quickstart](https://docs.copilotkit.ai/mastra/quickstart) guide.
+
+:::
+
+:::tip
+
+Visit Mastra's [**"UI Dojo"**](https://ui-dojo.mastra.ai/) to see real-world examples of CopilotKit integrated with Mastra.
+
+:::
+
+## Integration Guide
+
+Run Mastra as a standalone server and connect your Next.js frontend (with CopilotKit) to its API endpoints.
+
+<Steps>
+
+<StepItem>
+
+Set up your directory structure. A possible directory structure could look like this:
+
+```shell
+project-root
+├── mastra-server
+│   ├── src
+│   │   └── mastra
+│   └── package.json
+└── my-copilot-app
+    └── package.json
+```
+
+Bootstrap your Mastra server:
+
+```bash copy
+npx create-mastra@latest
+```
+
+This command will launch an interactive wizard to help you scaffold a new Mastra project, including prompting you for a project name and setting up basic configurations. Follow the prompts to create your server project.
+
+Navigate to your newly created Mastra server directory:
+
+```bash copy
+cd mastra-server # Replace with the actual directory name you provided
+```
+
+You now have a basic Mastra server project ready. You should have the following files and folders:
+
+```shell
+src
+└── mastra
+    ├── agents
+    │   └── weather-agent.ts
+    ├── scorers
+    │   └── weather-scorer.ts
+    ├── tools
+    │   └── weather-tool.ts
+    ├── workflows
+    │   └── weather-workflow.ts
+    └── index.ts
+```
+
+:::note
+
+Ensure that you have set the appropriate environment variables for your LLM provider in the `.env` file.
+
+:::
+
+</StepItem>
+
+<StepItem>
+
+Create a chat route for the CopilotKit frontend by using the `registerCopilotKit()` helper from `@ag-ui/mastra`. Add it to your Mastra project (and its peer dependencies):
+
+```bash copy
+npm install --legacy-peer-deps @ag-ui/mastra @copilotkit/runtime @ag-ui/core @ag-ui/client @ag-ui/encoder @ag-ui/langgraph @ag-ui/proto
+```
+
+In your `src/mastra/index.ts` file, register the chat route:
+
+```typescript copy title="src/mastra/index.ts" {2,7-19}
+import { Mastra } from '@mastra/core/mastra';
+import { registerCopilotKit } from '@ag-ui/mastra/copilotkit';
+// Rest of the imports...
+
+export const mastra = new Mastra({
+  // Rest of the configuration...
+  server: {
+    cors: {
+      origin: "*",
+      allowMethods: ["*"],
+      allowHeaders: ["*"],
+    },
+    apiRoutes: [
+      registerCopilotKit({
+        path: '/chat',
+        resourceId: 'weatherAgent'
+      })
+    ]
+  }
+});
+```
+
+This will make the `weatherAgent` available at `/chat` in a CopilotKit-compatible format. You have to add the CORS configuration to allow the CopilotKit frontend to access the Mastra server. For production deployments, make sure to restrict the CORS origins to only your frontend domain.
+
+</StepItem>
+
+<StepItem>
+
+Run the Mastra server using the following command:
+
+```bash copy
+npm run dev
+```
+
+By default, the Mastra server will run on `http://localhost:4111`. Keep this server running for the next steps where we'll set up the CopilotKit frontend to connect to it.
+
+</StepItem>
+
+<StepItem>
+
+Go up one directory to your project root.
+
+```bash copy
+cd ..
+```
+
+Create a new Next.js project with the name `my-copilot-app`:
+
+```bash copy
+npx create-next-app@latest my-copilot-app
+```
+
+Navigate to your newly created Next.js project directory:
+
+```bash copy
+cd my-copilot-app
+```
+
+</StepItem>
+
+<StepItem>
+
+Install the CopilotKit UI packages which you'll use to display a chat interface:
+
+```bash copy
+npm install @copilotkit/react-ui @copilotkit/react-core
+```
+
+Open the home route of the Next.js app (usually `app/page.tsx` or `src/app/page.tsx`) and replace the existing contents with the following code to set up a basic CopilotKit chat interface:
+
+```typescript copy title="app/page.tsx"
+import { CopilotChat } from "@copilotkit/react-ui";
+import { CopilotKit } from "@copilotkit/react-core";
+import "@copilotkit/react-ui/styles.css";
+
+export default function Home() {
+  return (
+    <CopilotKit
+      runtimeUrl="http://localhost:4111/chat"
+      agent="weatherAgent"
+    >
+      <CopilotChat
+        labels={{
+          title: "Weather Agent",
+          initial: "Hi! 👋 Ask me about the weather, forecasts, and climate.",
+        }}
+      />
+    </CopilotKit>
+  );
+}
+```
+
+</StepItem>
+
+<StepItem>
+
+You're ready to connect the pieces! Make sure both the Mastra server and the CopilotKit frontend are running. Start the Next.js development server:
+
+```bash copy
+npm run dev
+```
+
+You should now be able to chat with your agent in the browser.
+
+</StepItem>
+
+</Steps>
+
+Congratulations! You have successfully integrated Mastra with CopilotKit using a separate server approach. Your CopilotKit frontend now communicates with a standalone Mastra agent server.

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

@@ -1,5 +1,5 @@
 ---
-title: "Integrate Mastra in your Astro project | Frameworks | Mastra Docs"
+title: "Integrate Mastra in your Astro project | Frameworks"
 description: A step-by-step guide to integrating Mastra with Astro.
 ---
 
@@ -31,34 +31,34 @@ This guide assumes you're using Astro's Actions with React and the Vercel adapte
 
 <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>
@@ -140,14 +140,13 @@ Add `.mastra` and `.vercel` to your `.gitignore` file:
 
 Astro uses Vite, which accesses environment variables via `import.meta.env` rather than `process.env`. As a result, the model constructor must explicitly receive the `apiKey` from the Vite environment like this:
 
-```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?.OPENAI_API_KEY,
-+   compatibility: "strict"
-+ });
+ const openai = createOpenAI({
+   apiKey: import.meta.env?.OPENAI_API_KEY,
+   compatibility: "strict"
+ });
 ```
 
 > More configuration details are available in the AI SDK docs. See [Provider Instance](https://ai-sdk.dev/providers/ai-sdk-providers/openai#provider-instance) for more information.
@@ -324,34 +323,34 @@ Before proceeding, ensure your Astro project is configured as follows:
 
 <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>
@@ -433,14 +432,13 @@ Add `.mastra` to your `.gitignore` file:
 
 Astro uses Vite, which accesses environment variables via `import.meta.env` rather than `process.env`. As a result, the model constructor must explicitly receive the `apiKey` from the Vite environment like this:
 
-```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?.OPENAI_API_KEY,
-+   compatibility: "strict"
-+ });
+ const openai = createOpenAI({
+   apiKey: import.meta.env?.OPENAI_API_KEY,
+   compatibility: "strict"
+ });
 ```
 
 > More configuration details are available in the AI SDK docs. See [Provider Instance](https://ai-sdk.dev/providers/ai-sdk-providers/openai#provider-instance) for more information.
@@ -599,4 +597,4 @@ Let me know if you need more information!
 ## Next Steps
 
 - [Deployment | With Astro on Vercel](/docs/v1/deployment/web-framework#with-astro-on-vercel)
-- [Monorepo Deployment](../../deployment/monorepo)
+- [Monorepo Deployment](/docs/v1/deployment/monorepo)

package/.docs/raw/{frameworks/servers → guides/getting-started}/express.mdx

@@ -1,5 +1,5 @@
 ---
-title: "Integrate Mastra in your Express project | Frameworks | Mastra Docs"
+title: "Integrate Mastra in your Express project | Frameworks"
 description: A step-by-step guide to integrating Mastra with an Express backend.
 ---
 
@@ -26,7 +26,7 @@ In this guide you'll learn how to install the necessary Mastra dependencies, cre
 First, install the necessary Mastra dependencies to run an Agent. This guide uses OpenAI as its model but you can use any supported [model provider](/models/v1).
 
 ```bash copy
-npm install mastra@beta @mastra/core@beta @mastra/libsql@beta zod@^3.0.0 @ai-sdk/openai@^1.0.0
+npm install mastra@beta @mastra/core@beta @mastra/libsql@beta zod@^3.0.0
 ```
 
 If not existent yet, create an `.env` file and add your OpenAI API key:
@@ -37,7 +37,7 @@ OPENAI_API_KEY=<your-api-key>
 
 :::note
 
-Each LLM provider uses a different env var. See [Model Capabilities](https://sdk.vercel.ai/providers) for more information.
+Each LLM provider uses a different env var. See [Model Providers](/models/v1/providers/) for more information.
 
 :::
 
@@ -75,7 +75,6 @@ export const weatherTool = createTool({
 Add a `weatherAgent` at `src/mastra/agents/weather-agent.ts`:
 
 ```ts title="src/mastra/agents/weather-agent.ts" copy
-import { openai } from "@ai-sdk/openai";
 import { Agent } from "@mastra/core/agent";
 import { weatherTool } from "../tools/weather-tool";
 
@@ -94,7 +93,7 @@ export const weatherAgent = new Agent({
 
       Use the weatherTool to fetch current weather data.
 `,
-  model: openai("gpt-4o-mini"),
+  model: "openai/gpt-5.1",
   tools: { weatherTool },
 });
 ```

package/.docs/raw/guides/{quickstarts/nextjs.mdx → getting-started/next-js.mdx}

@@ -1,15 +1,13 @@
 ---
-title: "Next.js Quickstart"
-description: "Get started with Mastra, Next.js, and AS SDK UI. Quickly."
+title: "Next.js | Frameworks"
+description: "Get started with Mastra and Next.js"
 ---
 
-# Next.js Quickstart
+# Integrate Mastra in your Next.js project
 
-In this quickstart, you'll build an AI agent with tool-calling capabilities using [Mastra](/docs/v1), then connect it to Next.js by importing and calling the agent directly within your routes. 
+In this guide, you'll build a tool-calling AI agent using Mastra, then connect it to Next.js by importing and calling the agent directly from your routes.
 
-You'll use [AI SDK UI](https://ai-sdk.dev/docs/ai-sdk-ui/overview) and [AI Elements](https://ai-sdk.dev/elements) to create a beautiful, interactive chat experience. 
-
-In ~5 minutes, you'll have a functional AI-powered app ready to extend with your own tools and logic.
+You'll use [AI SDK UI](https://ai-sdk.dev/docs/ai-sdk-ui/overview) and [AI Elements](https://ai-sdk.dev/elements) to create a beautiful, interactive chat experience.
 
 <figure>
 ![Screenshot of a chat-style web app displaying a completed "weatherTool" tool call, answering "What is the weather in London?" with a JSON result. A message suggests offering activity ideas, and a text input field is at the bottom.](/img/nextjs-quickstart.png)
@@ -18,9 +16,11 @@ In ~5 minutes, you'll have a functional AI-powered app ready to extend with your
 
 ## Before you begin
 
-* You'll need an API key from a supported [model provider](/models/v1). If you don't have a preference, use [OpenAI](https://platform.openai.com/api-keys).
+* You'll need an API key from a supported [model provider](/models/v1). If you don't have a preference, use [OpenAI](/models/v1/providers/openai).
+
+## Create a new Next.js app (optional)
 
-## Create a new Next.js app
+If you already have a Next.js app, skip to the next step.
 
 Run the following command to [create a new Next.js app](https://nextjs.org/docs/app/getting-started/installation):
 
@@ -41,7 +41,7 @@ npx create-next-app \
 This creates a project called `my-nextjs-agent`, but you can replace it with any name you want.
 
 ## Initialize Mastra
-`cd` and run [`mastra init`](/reference/v1/cli/create-mastra). 
+`cd` into your Next.js project and run [`mastra init`](/reference/v1/cli/create-mastra).
 
 When prompted, choose a provider (e.g. OpenAI) and enter your key:
 
@@ -58,14 +58,15 @@ This creates a `src/mastra` folder with an example weather agent and the followi
 You'll call `weather-agent.ts` from your Next.js routes in the next steps.
 
 
-## Install AI SDK UI and AI Elements
+## Install AI SDK and AI Elements
 
-Install AI SDK UI along with the Mastra adapter:
+Install AI SDK along with the Mastra adapter:
 
 ```bash
 npm install \
     @mastra/ai-sdk \
-    @ai-sdk/react 
+    @ai-sdk/react \
+    ai
 ```
 
 Next, initialize AI Elements. When prompted, choose the default options:
@@ -84,7 +85,7 @@ Create `src/app/api/chat/route.ts`:
 ```ts title="src/app/api/chat/route.ts"
 import { mastra } from "@/mastra";
 import { NextResponse } from "next/server";
-import { toAISdkFormat } from "@mastra/ai-sdk";
+import { toAISdkStream } from "@mastra/ai-sdk";
 import { convertMessages } from "@mastra/core/agent";
 import { createUIMessageStreamResponse } from "ai";
 
@@ -101,7 +102,7 @@ export async function POST(req: Request) {
   });
 
   return createUIMessageStreamResponse({
-    stream: toAISdkFormat(stream, { from: "agent" }),
+    stream: toAISdkStream(stream, { from: "agent" }),
   })
 }
 
@@ -112,7 +113,7 @@ export async function GET() {
     resourceId: "weather-chat",
   });
 
-  const uiMessages = 
+  const uiMessages =
     convertMessages(response?.uiMessages ?? []).to("AIV5.UI");
   return NextResponse.json(uiMessages);
 }
@@ -190,8 +191,8 @@ function Chat() {
                 {message.parts?.map((part: any, i: number) => {
                   if (part.type === 'text') {
                     return (
-                      <Message 
-                        key={`${message.id}-${i}`} 
+                      <Message
+                        key={`${message.id}-${i}`}
                         from={message.role}>
                           <MessageContent>
                             <MessageResponse>{part.text}</MessageResponse>
@@ -251,16 +252,16 @@ This component connects [`useChat()`](https://ai-sdk.dev/docs/reference/ai-sdk-u
 It renders the response text using the [`<MessageResponse>`](https://ai-sdk.dev/elements/components/message#messageresponse-) component, and shows any tool invocations with the [`<Tool>`](https://ai-sdk.dev/elements/components/tool) component.
 
 
-## Test your agent 
+## Test your agent
 1. Run your Next.js app with `npm run dev`
 
 2. Open the chat at http://localhost:3000/chat
 
-3. Try asking about the weather. If your API key is set up correctly, you'll get a response.
+3. Try asking about the weather. If your API key is set up correctly, you'll get a response
 
 ## Next steps
 
-Congratulations on building your Mastra agent with Next.js! 🎉 
+Congratulations on building your Mastra agent with Next.js! 🎉
 
 From here, you can extend the project with your own tools and logic:
 
@@ -268,8 +269,8 @@ From here, you can extend the project with your own tools and logic:
 - Give your agent its own [tools](/docs/v1/agents/using-tools)
 - Add human-like [memory](/docs/v1/agents/agent-memory) to your agent
 
-When you're ready, read more about how Mastra integrates with AI SDK and Next.js, and how to deploy to Vercel:
+When you're ready, read more about how Mastra integrates with AI SDK and Next.js, and how to deploy your agent anywhere, including Vercel:
 
-- Integrate Mastra with [AI SDK](/docs/v1/frameworks/agentic-uis/ai-sdk)
-- Use Mastra in your [Next.js app](/docs/v1/frameworks/web-frameworks/next-js)
-- Deploy your agent to [Vercel](/docs/v1/deployment/serverless-platforms/vercel-deployer)
+- Integrate Mastra with [AI SDK](/guides/v1/build-your-ui/ai-sdk-ui)
+- Deploy your agent to [Vercel](/docs/v1/deployment/cloud-providers/vercel-deployer)
+- Deploy your agent [anywhere](/docs/v1/deployment/overview)