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

package/.docs/raw/frameworks/agentic-uis/copilotkit.mdx

@@ -81,7 +81,7 @@ export function CopilotKitComponent({ runtimeUrl }: { runtimeUrl: string }) {
 
 <StepItem>
 
-If you have not yet set up your Mastra server, follow the [getting started guide](/docs/getting-started/installation) to set up a new Mastra project.
+If you have not yet set up your Mastra server, follow the [getting started guide](/docs/v1/getting-started/installation) to set up a new Mastra project.
 
 In your Mastra server, install additional packages for CopilotKit integration:
 
@@ -89,21 +89,21 @@ In your Mastra server, install additional packages for CopilotKit integration:
 <TabItem value="npm" label="npm">
 
 ```bash copy
-npm install @copilotkit/runtime @ag-ui/mastra
+npm install @copilotkit/runtime @ag-ui/mastra@beta
 ```
 
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
 ```bash copy
-yarn add @copilotkit/runtime @ag-ui/mastra
+yarn add @copilotkit/runtime @ag-ui/mastra@beta
 ```
 
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
 ```bash copy
-pnpm add @copilotkit/runtime @ag-ui/mastra
+pnpm add @copilotkit/runtime @ag-ui/mastra@beta
 ```
 
 </TabItem>
@@ -116,11 +116,11 @@ pnpm add @copilotkit/runtime @ag-ui/mastra
 Configure your Mastra instance to include CopilotKit's runtime endpoint:
 
 ```typescript title="src/mastra/index.ts" copy {2,5-8,12-28}
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { registerCopilotKit } from "@ag-ui/mastra/copilotkit";
 import { weatherAgent } from "./agents/weather-agent";
 
-type WeatherRuntimeContext = {
+type WeatherRequestContext = {
   "user-id": string;
   "temperature-scale": "celsius" | "fahrenheit";
 };
@@ -134,15 +134,15 @@ export const mastra = new Mastra({
       allowHeaders: ["*"],
     },
     apiRoutes: [
-      registerCopilotKit<WeatherRuntimeContext>({
+      registerCopilotKit<WeatherRequestContext>({
         path: "/copilotkit",
         resourceId: "weatherAgent",
-        setContext: (c, runtimeContext) => {
-          runtimeContext.set(
+        setContext: (c, requestContext) => {
+          requestContext.set(
             "user-id",
             c.req.header("X-User-ID") || "anonymous",
           );
-          runtimeContext.set("temperature-scale", "celsius");
+          requestContext.set("temperature-scale", "celsius");
         },
       }),
     ],
@@ -185,21 +185,21 @@ In your Next.js app, install the required packages:
 <TabItem value="npm" label="npm">
 
 ```bash copy
-npm install @copilotkit/react-core @copilotkit/react-ui @copilotkit/runtime @ag-ui/mastra
+npm install @copilotkit/react-core @copilotkit/react-ui @copilotkit/runtime @ag-ui/mastra@beta
 ```
 
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
 ```bash copy
-yarn add @copilotkit/react-core @copilotkit/react-ui @copilotkit/runtime @ag-ui/mastra
+yarn add @copilotkit/react-core @copilotkit/react-ui @copilotkit/runtime @ag-ui/mastra@beta
 ```
 
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
 ```bash copy
-pnpm add @copilotkit/react-core @copilotkit/react-ui @copilotkit/runtime @ag-ui/mastra
+pnpm add @copilotkit/react-core @copilotkit/react-ui @copilotkit/runtime @ag-ui/mastra@beta
 ```
 
 </TabItem>
@@ -287,21 +287,21 @@ Install the Mastra Client SDK.
 <TabItem value="npm" label="npm">
 
 ```bash copy
-npm install @mastra/client-js
+npm install @mastra/client-js@beta
 ```
 
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
 ```bash copy
-yarn add @mastra/client-js
+yarn add @mastra/client-js@beta
 ```
 
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
 ```bash copy
-pnpm add @mastra/client-js
+pnpm add @mastra/client-js@beta
 ```
 
 </TabItem>
@@ -379,4 +379,4 @@ Start building the future!
 
 - [CopilotKit Documentation](https://docs.copilotkit.ai) - Complete CopilotKit reference
 - [React Hooks with CopilotKit](https://docs.copilotkit.ai/reference/hooks/useCoAgent) - Advanced React integration patterns
-- [Next.js Integration with Mastra](/docs/frameworks/web-frameworks/next-js) - Full-stack Next.js setup guide
+- [Next.js Integration with Mastra](/docs/v1/frameworks/web-frameworks/next-js) - Full-stack Next.js setup guide

package/.docs/raw/frameworks/agentic-uis/openrouter.mdx

@@ -17,7 +17,7 @@ Integrate OpenRouter with Mastra to leverage the numerous models available on Op
 The simplest way to get started with Mastra is to use the `mastra` CLI to initialize a new project:
 
 ```bash copy
-npx create-mastra@latest
+npx create-mastra@beta
 ```
 
 You'll be guided through prompts to set up your project. For this example, select:
@@ -65,6 +65,7 @@ const openrouter = createOpenRouter({
 });
 
 export const assistant = new Agent({
+  id: "assistant",
   name: "assistant",
   instructions: "You are a helpful assistant.",
   model: openrouter("anthropic/claude-sonnet-4"),
@@ -119,6 +120,7 @@ const openrouter = createOpenRouter({
 });
 
 export const assistant = new Agent({
+  id: "assistant",
   name: "assistant",
   instructions: "You are a helpful assistant.",
   model: openrouter("anthropic/claude-sonnet-4"),
@@ -138,6 +140,7 @@ const openrouter = createOpenRouter({
 });
 
 export const assistant = new Agent({
+  id: "assistant",
   name: "assistant",
   instructions: "You are a helpful assistant.",
   model: openrouter("anthropic/claude-sonnet-4", {

package/.docs/raw/frameworks/servers/express.mdx

@@ -18,15 +18,15 @@ In this guide you'll learn how to install the necessary Mastra dependencies, cre
 ## Prerequisites
 
 - An existing Express app set up with TypeScript
-- Node.js `v20.0` or higher
-- An API key from a supported [Model Provider](/models)
+- Node.js `v22.13.0` or later
+- An API key from a supported [Model Provider](/models/v1)
 
 ## Adding Mastra
 
-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).
+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@latest @mastra/core@latest @mastra/libsql@latest zod@^3.0.0 @ai-sdk/openai@^1.0.0
+npm install mastra@beta @mastra/core@beta @mastra/libsql@beta zod@^3.0.0 @ai-sdk/openai@^1.0.0
 ```
 
 If not existent yet, create an `.env` file and add your OpenAI API key:
@@ -44,7 +44,7 @@ Each LLM provider uses a different env var. See [Model Capabilities](https://sdk
 Create a Mastra configuration file at `src/mastra/index.ts`:
 
 ```ts title="src/mastra/index.ts" copy
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 
 export const mastra = new Mastra({});
 ```
@@ -80,13 +80,14 @@ import { Agent } from "@mastra/core/agent";
 import { weatherTool } from "../tools/weather-tool";
 
 export const weatherAgent = new Agent({
+  id: "weather-agent",
   name: "Weather Agent",
   instructions: `
       You are a helpful weather assistant that provides accurate weather information.
 
       Your primary function is to help users get weather details for specific locations. When responding:
       - Always ask for a location if none is provided
-      - If the location name isn’t in English, please translate it
+      - If the location name isn't in English, please translate it
       - If giving a location with multiple parts (e.g. "New York, NY"), use the most relevant part (e.g. "New York")
       - Include relevant details like humidity, wind conditions, and precipitation
       - Keep responses concise but informative
@@ -101,7 +102,7 @@ export const weatherAgent = new Agent({
 Lastly, add the `weatherAgent` to `src/mastra/index.ts`:
 
 ```ts title="src/mastra/index.ts" copy {2, 5}
-import { Mastra } from "@mastra/core/mastra";
+import { Mastra } from "@mastra/core";
 import { weatherAgent } from "./agents/weather-agent";
 
 export const mastra = new Mastra({
@@ -168,11 +169,11 @@ app.listen(port, () => {
 });
 ```
 
-By importing the `src/mastra/index.ts` file you can use methods like [`.getAgent()`](/reference/core/getAgent) to get programmatic access. With [`.generate()`](/reference/agents/generate) you then can interact with the respective agent.
+By importing the `src/mastra/index.ts` file you can use methods like [`.getAgent()`](/reference/v1/core/getAgent) to get programmatic access. With [`.generate()`](/reference/v1/agents/generate) you then can interact with the respective agent.
 
 :::note
 
-Read the [Agent reference docs](/reference/agents/agent) to learn more.
+Read the [Agent reference docs](/reference/v1/agents/agent) to learn more.
 
 :::
 
@@ -190,7 +191,7 @@ The weather in London is currently sunny. If you need more details like humidity
 
 ## Running the Agent Server
 
-In production it's not necessary to run Mastra alongside your Express server. But for development Mastra offers a [Local Development Environment](/docs/getting-started/studio) which you can use to improve and debug your agent.
+In production it's not necessary to run Mastra alongside your Express server. But for development Mastra offers a [Local Development Environment](/docs/v1/getting-started/studio) which you can use to improve and debug your agent.
 
 Add a script to your `package.json`:
 

package/.docs/raw/frameworks/web-frameworks/astro.mdx

@@ -37,28 +37,28 @@ Install the required Mastra packages:
 <TabItem value="npm" label="npm">
 
 ```bash copy
-npm install mastra@latest @mastra/core@latest @mastra/libsql@latest
+npm install mastra@beta @mastra/core@beta @mastra/libsql@beta
 ```
 
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
 ```bash copy
-yarn add mastra@latest @mastra/core@latest @mastra/libsql@latest
+yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta
 ```
 
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
 ```bash copy
-pnpm add mastra@latest @mastra/core@latest @mastra/libsql@latest
+pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta
 ```
 
 </TabItem>
 <TabItem value="bun" label="bun">
 
 ```bash copy
-bun add mastra@latest @mastra/core@latest @mastra/libsql@latest
+bun add mastra@beta @mastra/core@beta @mastra/libsql@beta
 ```
 
 </TabItem>
@@ -75,17 +75,17 @@ To integrate Mastra into your project, you have two options:
   Run the following command to quickly scaffold the default Weather agent with sensible defaults:
 
   ```bash copy
-  npx mastra@latest init --default
+  npx mastra@beta init --default
   ```
 
-  > See [mastra init](/reference/cli/create-mastra) for more information.
+  > See [mastra init](/reference/v1/cli/create-mastra) for more information.
 
 - Use the Interactive CLI
 
   If you prefer to customize the setup, run the `init` command and choose from the options when prompted:
 
   ```bash copy
-  npx mastra@latest init
+  npx mastra@beta init
   ```
 
 Add the `dev` and `build` scripts to `package.json`:
@@ -175,7 +175,7 @@ mastra dev:mastra
 </TabItem>
 </Tabs>
 
-> Once running, your agents are available locally. See [Local Development Environment](/docs/getting-started/studio) for more information.
+> Once running, your agents are available locally. See [Local Development Environment](/docs/v1/getting-started/studio) for more information.
 
 </StepItem>
 
@@ -215,7 +215,7 @@ export const server = {
       city: z.string(),
     }),
     handler: async (input) => {
-      const city = input.city;
+      const city = inputData.city;
       const agent = mastra.getAgent("weatherAgent");
 
       const result = await agent.generate(
@@ -330,28 +330,28 @@ Install the required Mastra packages:
 <TabItem value="npm" label="npm">
 
 ```bash copy
-npm install mastra@latest @mastra/core@latest @mastra/libsql@latest
+npm install mastra@beta @mastra/core@beta @mastra/libsql@beta
 ```
 
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
 ```bash copy
-yarn add mastra@latest @mastra/core@latest @mastra/libsql@latest
+yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta
 ```
 
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
 ```bash copy
-pnpm add mastra@latest @mastra/core@latest @mastra/libsql@latest
+pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta
 ```
 
 </TabItem>
 <TabItem value="bun" label="bun">
 
 ```bash copy
-bun add mastra@latest @mastra/core@latest @mastra/libsql@latest
+bun add mastra@beta @mastra/core@beta @mastra/libsql@beta
 ```
 
 </TabItem>
@@ -368,17 +368,17 @@ To integrate Mastra into your project, you have two options:
   Run the following command to quickly scaffold the default Weather agent with sensible defaults:
 
   ```bash copy
-  npx mastra@latest init --default
+  npx mastra@beta init --default
   ```
 
-  > See [mastra init](/reference/cli/create-mastra) for more information.
+  > See [mastra init](/reference/v1/cli/create-mastra) for more information.
 
 - Use the Interactive CLI
 
   If you prefer to customize the setup, run the `init` command and choose from the options when prompted:
 
   ```bash copy
-  npx mastra@latest init
+  npx mastra@beta init
   ```
 
 Add the `dev` and `build` scripts to `package.json`:
@@ -468,7 +468,7 @@ mastra dev:mastra
 </TabItem>
 </Tabs>
 
-> Once running, your agents are available locally. See [Local Development Environment](/docs/getting-started/studio) for more information.
+> Once running, your agents are available locally. See [Local Development Environment](/docs/v1/getting-started/studio) for more information.
 
 </StepItem>
 
@@ -598,5 +598,5 @@ Let me know if you need more information!
 
 ## Next Steps
 
-- [Deployment | With Astro on Vercel](/docs/deployment/web-framework#with-astro-on-vercel)
+- [Deployment | With Astro on Vercel](/docs/v1/deployment/web-framework#with-astro-on-vercel)
 - [Monorepo Deployment](../../deployment/monorepo)

package/.docs/raw/frameworks/web-frameworks/next-js.mdx

@@ -38,17 +38,17 @@ To integrate Mastra into your project, you have two options:
   Run the following command to quickly scaffold the default Weather agent with sensible defaults:
 
   ```bash copy
-  npx mastra@latest init --dir . --components agents,tools --example --llm openai
+  npx mastra@beta init --dir . --components agents,tools --example --llm openai
   ```
 
-  > See [mastra init](/reference/cli/create-mastra) for more information.
+  > See [mastra init](/reference/v1/cli/create-mastra) for more information.
 
 - Use the Interactive CLI
 
   If you prefer to customize the setup, run the `init` command and choose from the options when prompted:
 
   ```bash copy
-  npx mastra@latest init
+  npx mastra@beta init
   ```
 
   :::warning
@@ -225,17 +225,17 @@ To integrate Mastra into your project, you have two options:
   Run the following command to quickly scaffold the default Weather agent with sensible defaults:
 
   ```bash copy
-  npx mastra@latest init --dir . --components agents,tools --example --llm openai
+  npx mastra@beta init --dir . --components agents,tools --example --llm openai
   ```
 
-  > See [mastra init](/reference/cli/create-mastra) for more information.
+  > See [mastra init](/reference/v1/cli/create-mastra) for more information.
 
 - Use the Interactive CLI
 
   If you prefer to customize the setup, run the `init` command and choose from the options when prompted:
 
   ```bash copy
-  npx mastra@latest init
+  npx mastra@beta init
   ```
 
   :::warning
@@ -375,5 +375,5 @@ Let me know if you need more information!
 
 ## Next Steps
 
-- [Deployment | With Next.js on Vercel](/docs/deployment/web-framework#with-nextjs-on-vercel)
+- [Deployment | With Next.js on Vercel](/docs/v1/deployment/web-framework#with-nextjs-on-vercel)
 - [Monorepo Deployment](../../deployment/monorepo)

package/.docs/raw/frameworks/web-frameworks/sveltekit.mdx

@@ -32,22 +32,22 @@ Install the required Mastra packages:
 <Tabs>
   <TabItem value="npm" label="npm">
     ```bash copy
-    npm install mastra@latest @mastra/core@latest @mastra/libsql@latest
+    npm install mastra@beta @mastra/core@beta @mastra/libsql@beta
     ```
   </TabItem>
   <TabItem value="yarn" label="yarn">
     ```bash copy
-    yarn add mastra@latest @mastra/core@latest @mastra/libsql@latest
+    yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta
     ```
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
     ```bash copy
-    pnpm add mastra@latest @mastra/core@latest @mastra/libsql@latest
+    pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta
     ```
   </TabItem>
   <TabItem value="bun" label="bun">
     ```bash copy
-    bun add mastra@latest @mastra/core@latest @mastra/libsql@latest
+    bun add mastra@beta @mastra/core@beta @mastra/libsql@beta
     ```
   </TabItem>
 </Tabs>
@@ -63,17 +63,17 @@ To integrate Mastra into your project, you have two options:
   Run the following command to quickly scaffold the default Weather agent with sensible defaults:
 
   ```bash copy
-  npx mastra@latest init --default
+  npx mastra@beta init --default
   ```
 
-  > See [mastra init](/reference/cli/create-mastra) for more information.
+  > See [mastra init](/reference/v1/cli/create-mastra) for more information.
 
 - Use the Interactive CLI
 
   If you prefer to customize the setup, run the `init` command and choose from the options when prompted:
 
   ```bash copy
-  npx mastra@latest init
+  npx mastra@beta init
   ```
 
 Add the `dev` and `build` scripts to `package.json`:
@@ -161,7 +161,7 @@ Start the Mastra Dev Server to expose your agents as REST endpoints:
   </TabItem>
 </Tabs>
 
-> Once running, your agents are available locally. See [Local Development Environment](/docs/getting-started/studio) for more information.
+> Once running, your agents are available locally. See [Local Development Environment](/docs/v1/getting-started/studio) for more information.
 
 </StepItem>
 
@@ -263,22 +263,22 @@ Install the required Mastra packages:
 <Tabs>
   <TabItem value="npm" label="npm">
     ```bash copy
-    npm install mastra@latest @mastra/core@latest @mastra/libsql@latest
+    npm install mastra@beta @mastra/core@beta @mastra/libsql@beta
     ```
   </TabItem>
   <TabItem value="yarn" label="yarn">
     ```bash copy
-    yarn add mastra@latest @mastra/core@latest @mastra/libsql@latest
+    yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta
     ```
   </TabItem>
   <TabItem value="pnpm" label="pnpm">
     ```bash copy
-    pnpm add mastra@latest @mastra/core@latest @mastra/libsql@latest
+    pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta
     ```
   </TabItem>
   <TabItem value="bun" label="bun">
     ```bash copy
-    bun add mastra@latest @mastra/core@latest @mastra/libsql@latest
+    bun add mastra@beta @mastra/core@beta @mastra/libsql@beta
     ```
   </TabItem>
 </Tabs>
@@ -294,17 +294,17 @@ To integrate Mastra into your project, you have two options:
   Run the following command to quickly scaffold the default Weather agent with sensible defaults:
 
   ```bash copy
-  npx mastra@latest init --default
+  npx mastra@beta init --default
   ```
 
-  > See [mastra init](/reference/cli/create-mastra) for more information.
+  > See [mastra init](/reference/v1/cli/create-mastra) for more information.
 
 - Use the Interactive CLI
 
   If you prefer to customize the setup, run the `init` command and choose from the options when prompted:
 
   ```bash copy
-  npx mastra@latest init
+  npx mastra@beta init
   ```
 
 Add the `dev` and `build` scripts to `package.json`:
@@ -392,7 +392,7 @@ Start the Mastra Dev Server to expose your agents as REST endpoints:
   </TabItem>
 </Tabs>
 
-> Once running, your agents are available locally. See [Local Development Environment](/docs/getting-started/studio) for more information.
+> Once running, your agents are available locally. See [Local Development Environment](/docs/v1/getting-started/studio) for more information.
 
 </StepItem>
 

package/.docs/raw/frameworks/web-frameworks/vite-react.mdx

@@ -30,28 +30,28 @@ Install the required Mastra packages:
 <TabItem value="npm" label="npm">
 
 ```bash copy
-npm install mastra@latest @mastra/core@latest @mastra/libsql@latest @mastra/client-js@latest
+npm install mastra@beta @mastra/core@beta @mastra/libsql@beta @mastra/client-js@beta
 ```
 
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
 ```bash copy
-yarn add mastra@latest @mastra/core@latest @mastra/libsql@latest @mastra/client-js@latest
+yarn add mastra@beta @mastra/core@beta @mastra/libsql@beta @mastra/client-js@beta
 ```
 
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
 ```bash copy
-pnpm add mastra@latest @mastra/core@latest @mastra/libsql@latest @mastra/client-js@latest
+pnpm add mastra@beta @mastra/core@beta @mastra/libsql@beta @mastra/client-js@beta
 ```
 
 </TabItem>
 <TabItem value="bun" label="bun">
 
 ```bash copy
-bun add mastra@latest @mastra/core@latest @mastra/libsql@latest @mastra/client-js@latest
+bun add mastra@beta @mastra/core@beta @mastra/libsql@beta @mastra/client-js@beta
 ```
 
 </TabItem>
@@ -66,10 +66,10 @@ To integrate Mastra into your project, you have two options:
 Run the following command to quickly scaffold the default Weather agent with sensible defaults:
 
 ```bash copy
-npx mastra@latest init --dir . --components agents,tools --example --llm openai
+npx mastra@beta init --dir . --components agents,tools --example --llm openai
 ```
 
-> See [mastra init](/reference/cli/create-mastra) for more information.
+> See [mastra init](/reference/v1/cli/create-mastra) for more information.
 
 ### 2. Use the Interactive CLI
 
@@ -164,7 +164,7 @@ mastra dev:mastra
 </TabItem>
 </Tabs>
 
-> Once running, your agents are available locally. See [Local Development Environment](/docs/getting-started/studio) for more information.
+> Once running, your agents are available locally. See [Local Development Environment](/docs/v1/getting-started/studio) for more information.
 
 ## Start Vite Dev Server