@mastra/mcp-docs-server 1.0.0-beta.13 → 1.0.0-beta.15

package/.docs/raw/guides/getting-started/vite-react.mdx

@@ -27,25 +27,25 @@ Run the following command to [create a new React + Vite app](https://vite.dev/gu
 
 <Tabs groupId="pm">
 <TabItem value="npm" label="npm">
-```bash copy
+```bash
 npm create vite@latest mastra-react -- --template react-ts
 cd mastra-react
 ```
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
-```bash copy
+```bash
 pnpm create vite mastra-react --template react-ts
 cd mastra-react
 ```
 </TabItem>
 <TabItem value="yarn" label="yarn">
-```bash copy
+```bash
 yarn create vite mastra-react --template react-ts
 cd mastra-react
 ```
 </TabItem>
 <TabItem value="bun" label="bun">
-```bash copy
+```bash
 bun create vite mastra-react --template react-ts
 cd mastra-react
 ```
@@ -60,22 +60,22 @@ Next, install Tailwind:
 
 <Tabs groupId="pm">
 <TabItem value="npm" label="npm">
-```bash copy
+```bash
 npm install tailwindcss @tailwindcss/vite
 ```
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
-```bash copy
+```bash
 pnpm add tailwindcss @tailwindcss/vite
 ```
 </TabItem>
 <TabItem value="yarn" label="yarn">
-```bash copy
+```bash
 yarn add tailwindcss @tailwindcss/vite
 ```
 </TabItem>
 <TabItem value="bun" label="bun">
-```bash copy
+```bash
 bun add tailwindcss @tailwindcss/vite
 ```
 </TabItem>
@@ -138,12 +138,12 @@ Edit `tsconfig.app.json` to resolve paths:
 
 ## Initialize Mastra
 
-Run [`mastra init`](/reference/v1/cli/create-mastra). When prompted, choose a provider (e.g. OpenAI) and enter your key:
+Run [`mastra init`](/reference/v1/cli/mastra#mastra-init). When prompted, choose a provider (e.g. OpenAI) and enter your key:
 
 <Tabs groupId="pm">
 <TabItem value="npm" label="npm">
 
-```bash copy
+```bash
 cd mastra-react
 npx mastra@beta init
 ```
@@ -151,7 +151,7 @@ npx mastra@beta init
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
-```bash copy
+```bash
 cd mastra-react
 pnpm dlx mastra@beta init
 ```
@@ -159,7 +159,7 @@ pnpm dlx mastra@beta init
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
-```bash copy
+```bash
 cd mastra-react
 yarn dlx mastra@beta init
 ```
@@ -167,7 +167,7 @@ yarn dlx mastra@beta init
 </TabItem>
 <TabItem value="bun" label="bun">
 
-```bash copy
+```bash
 cd mastra-react
 bunx mastra@beta init
 ```
@@ -190,28 +190,28 @@ Install AI SDK UI along with the Mastra adapter:
 <Tabs groupId="pm">
 <TabItem value="npm" label="npm">
 
-```bash copy
+```bash
 npm install @mastra/ai-sdk@beta @ai-sdk/react ai
 ```
 
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
-```bash copy
+```bash
 pnpm add @mastra/ai-sdk@beta @ai-sdk/react ai
 ```
 
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
-```bash copy
+```bash
 yarn add @mastra/ai-sdk@beta @ai-sdk/react ai
 ```
 
 </TabItem>
 <TabItem value="bun" label="bun">
 
-```bash copy
+```bash
 bun add @mastra/ai-sdk@beta @ai-sdk/react ai
 ```
 
@@ -223,28 +223,28 @@ Next, initialize AI Elements. When prompted, choose the default options:
 <Tabs groupId="pm">
 <TabItem value="npm" label="npm">
 
-```bash copy
+```bash
 npx ai-elements@latest
 ```
 
 </TabItem>
 <TabItem value="pnpm" label="pnpm">
 
-```bash copy
+```bash
 pnpm dlx ai-elements@latest
 ```
 
 </TabItem>
 <TabItem value="yarn" label="yarn">
 
-```bash copy
+```bash
 yarn dlx ai-elements@latest
 ```
 
 </TabItem>
 <TabItem value="bun" label="bun">
 
-```bash copy
+```bash
 bunx ai-elements@latest
 ```
 

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

@@ -28,7 +28,7 @@ Set up the Workflow, define steps to extract and classify candidate data, and th
 
 Create a new file `src/mastra/workflows/candidate-workflow.ts` and define your workflow:
 
-```ts copy title="src/mastra/workflows/candidate-workflow.ts"
+```ts title="src/mastra/workflows/candidate-workflow.ts"
 import { createWorkflow, createStep } from "@mastra/core/workflows";
 import { z } from "zod";
 
@@ -56,7 +56,7 @@ You want to extract candidate details from the resume text and classify the pers
 
 To the existing `src/mastra/workflows/candidate-workflow.ts` file add the following:
 
-```ts copy title="src/mastra/workflows/candidate-workflow.ts"
+```ts title="src/mastra/workflows/candidate-workflow.ts"
 import { Agent } from "@mastra/core/agent";
 
 const recruiter = new Agent({
@@ -109,7 +109,7 @@ This step prompts a candidate who is identified as "technical" for more informat
 
 To the existing `src/mastra/workflows/candidate-workflow.ts` file add the following:
 
-```ts copy title="src/mastra/workflows/candidate-workflow.ts"
+```ts title="src/mastra/workflows/candidate-workflow.ts"
 const askAboutSpecialty = createStep({
   id: "askAboutSpecialty",
   inputSchema: z.object({
@@ -140,7 +140,7 @@ If the candidate is "non-technical", you want a different follow-up question. Th
 
 To the existing `src/mastra/workflows/candidate-workflow.ts` file add the following:
 
-```ts title="src/mastra/workflows/candidate-workflow.ts" copy
+```ts title="src/mastra/workflows/candidate-workflow.ts"
 const askAboutRole = createStep({
   id: "askAboutRole",
   inputSchema: z.object({
@@ -170,7 +170,7 @@ You now combine the steps to implement branching logic based on the candidate's
 
 To the existing `src/mastra/workflows/candidate-workflow.ts` file change the `candidateWorkflow` like so:
 
-```ts title="src/mastra/workflows/candidate-workflow.ts" copy {10-14}
+```ts title="src/mastra/workflows/candidate-workflow.ts" {10-14}
 export const candidateWorkflow = createWorkflow({
   id: "candidate-workflow",
   inputSchema: z.object({
@@ -199,7 +199,7 @@ export const candidateWorkflow = createWorkflow({
 
 In your `src/mastra/index.ts` file, register the workflow:
 
-```ts copy title="src/mastra/index.ts" {2, 5}
+```ts title="src/mastra/index.ts" {2, 5}
 import { Mastra } from "@mastra/core";
 import { candidateWorkflow } from "./workflows/candidate-workflow";
 
@@ -216,13 +216,13 @@ export const mastra = new Mastra({
 
 You can test your workflow inside [Studio](/docs/v1/getting-started/studio) by starting the development server:
 
-```bash copy
+```bash
 mastra dev
 ```
 
 In the sidebar, navigate to **Workflows** and select **candidate-workflow**. In the middle you'll see a graph view of your workflow and on the right sidebar the **Run** tab is selected by default. Inside this tab you can enter a resume text, for example:
 
-```text copy
+```text
 Knowledgeable Software Engineer with more than 10 years of experience in software development. Proven expertise in the design and development of software databases and optimization of user interfaces.
 ```
 
@@ -230,7 +230,7 @@ After entering the resume text, press the **Run** button. You should now see two
 
 You can also test the workflow programmatically by calling [`.createRun()`](/reference/v1/workflows/workflow-methods/create-run) and [`.start()`](/reference/v1/workflows/run-methods/start). Create a new file `src/test-workflow.ts` and add the following:
 
-```ts copy title="src/test-workflow.ts"
+```ts title="src/test-workflow.ts"
 import { mastra } from "./mastra";
 
 const run = await mastra.getWorkflow("candidateWorkflow").createRun();
@@ -256,7 +256,7 @@ if (res.status === "success") {
 
 Now, run the workflow and get output in your terminal:
 
-```bash copy
+```bash
 npx tsx src/test-workflow.ts
 ```
 

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

@@ -31,7 +31,7 @@ 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"
+```ts title="src/mastra/agents/chefAgent.ts"
 import { Agent } from "@mastra/core/agent";
 
 export const chefAgent = new Agent({
@@ -50,7 +50,7 @@ export const chefAgent = new Agent({
 
 In your `src/mastra/index.ts` file, register the agent:
 
-```ts copy title="src/mastra/index.ts" {2, 5}
+```ts title="src/mastra/index.ts" {2, 5}
 import { Mastra } from "@mastra/core";
 import { chefAgent } from "./agents/chefAgent";
 
@@ -73,7 +73,7 @@ Depending on your requirements you can interact and get responses from the agent
 
 Create a new file `src/index.ts` and add a `main()` function to it. Inside, craft a query to ask the agent and log its response.
 
-```ts copy title="src/index.ts"
+```ts title="src/index.ts"
 import { chefAgent } from "./mastra/agents/chefAgent";
 
 async function main() {
@@ -90,7 +90,7 @@ main();
 
 Afterwards, run the script:
 
-```bash copy
+```bash
 npx bun src/index.ts
 ```
 
@@ -108,7 +108,7 @@ Query: In my kitchen I have: pasta, canned tomatoes, garlic, olive oil, and some
 
 In the previous example you might have waited a bit for the response without any sign of progress. To show the agent's output as it creates it you should instead stream its response to the terminal.
 
-```ts copy title="src/index.ts"
+```ts title="src/index.ts"
 import { chefAgent } from "./mastra/agents/chefAgent";
 
 async function main() {
@@ -132,7 +132,7 @@ main();
 
 Afterwards, run the script again:
 
-```bash copy
+```bash
 npx bun src/index.ts
 ```
 
@@ -155,7 +155,7 @@ Instead of showing the agent's response to a human you might want to pass it alo
 
 Change your `src/index.ts` to the following:
 
-```ts copy title="src/index.ts"
+```ts title="src/index.ts"
 import { chefAgent } from "./mastra/agents/chefAgent";
 import { z } from "zod";
 
@@ -198,12 +198,10 @@ Query: I want to make lasagna, can you generate a lasagna recipe for me?
   ingredients: [
     { name: "Lasagna noodles", amount: "12 sheets" },
     { name: "Ground beef", amount: "1 pound" },
-    // ...
   ],
   steps: [
     "Preheat oven to 375°F (190°C).",
     "Cook the lasagna noodles according to package instructions.",
-    // ...
   ]
 }
 ```
@@ -222,7 +220,7 @@ Learn how to interact with your agent through Mastra's API.
 
 You can run your agent as a service using the `mastra dev` command:
 
-```bash copy
+```bash
 mastra dev
 ```
 
@@ -244,7 +242,7 @@ POST http://localhost:4111/api/agents/chefAgent/generate
 
 You can interact with the agent using `curl` from the command line:
 
-```bash copy
+```bash
 curl -X POST http://localhost:4111/api/agents/chefAgent/generate \
   -H "Content-Type: application/json" \
   -d '{

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

@@ -30,7 +30,7 @@ Before you can create an MCP server you first need to install additional depende
 
 Add `@mastra/mcp` to your project:
 
-```bash copy
+```bash
 npm install @mastra/mcp@beta
 ```
 
@@ -40,13 +40,13 @@ npm install @mastra/mcp@beta
 
 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
+```bash
 rm -rf src/mastra/agents src/mastra/workflows src/mastra/tools/weather-tool.ts
 ```
 
 You should also change the `src/mastra/index.ts` file like so:
 
-```ts copy title="src/mastra/index.ts"
+```ts title="src/mastra/index.ts"
 import { Mastra } from "@mastra/core";
 import { PinoLogger } from "@mastra/loggers";
 import { LibSQLStore } from "@mastra/libsql";
@@ -70,13 +70,13 @@ export const mastra = new Mastra({
 
 Create a dedicated directory for your MCP server's logic and a `notes` directory for your notes:
 
-```bash copy
+```bash
 mkdir notes src/mastra/mcp
 ```
 
 Create the following files:
 
-```bash copy
+```bash
 touch src/mastra/mcp/{server,resources,prompts}.ts
 ```
 
@@ -113,7 +113,7 @@ Let's add the MCP server!
 
 In `src/mastra/mcp/server.ts`, define the MCP server instance:
 
-```typescript copy title="src/mastra/mcp/server.ts"
+```typescript title="src/mastra/mcp/server.ts"
 import { MCPServer } from "@mastra/mcp";
 
 export const notes = new MCPServer({
@@ -126,7 +126,7 @@ export const notes = new MCPServer({
 
 Register this MCP server in your Mastra instance at `src/mastra/index.ts`. The key `notes` is the public identifier for your MCP server:
 
-```typescript copy title="src/mastra/index.ts" {4, 15-17}
+```typescript title="src/mastra/index.ts" {4, 15-17}
 import { Mastra } from "@mastra/core";
 import { PinoLogger } from "@mastra/loggers";
 import { LibSQLStore } from "@mastra/libsql";
@@ -154,7 +154,7 @@ export const mastra = new Mastra({
 
 Resource handlers allow clients to discover and read the content your server manages. Implement handlers to work with markdown files in the `notes` directory. Add to the `src/mastra/mcp/resources.ts` file:
 
-```typescript copy title="src/mastra/mcp/resources.ts"
+```typescript title="src/mastra/mcp/resources.ts"
 import fs from "fs/promises";
 import path from "path";
 import { fileURLToPath } from "url";
@@ -210,7 +210,7 @@ export const resourceHandlers: MCPServerResources = {
 
 Register these resource handlers in `src/mastra/mcp/server.ts`:
 
-```typescript copy title="src/mastra/mcp/server.ts" {2, 8}
+```typescript title="src/mastra/mcp/server.ts" {2, 8}
 import { MCPServer } from "@mastra/mcp";
 import { resourceHandlers } from "./resources";
 
@@ -230,7 +230,7 @@ export const notes = new MCPServer({
 Tools are the actions your server can perform. Let's create a `write` tool.
 First, define the tool in `src/mastra/tools/write-note.ts`:
 
-```typescript copy title="src/mastra/tools/write-note.ts"
+```typescript title="src/mastra/tools/write-note.ts"
 import { createTool } from "@mastra/core/tools";
 import { z } from "zod";
 import { fileURLToPath } from "url";
@@ -271,7 +271,7 @@ export const writeNoteTool = createTool({
 
 Register this tool in `src/mastra/mcp/server.ts`:
 
-```typescript copy title="src/mastra/mcp/server.ts"
+```typescript title="src/mastra/mcp/server.ts"
 import { MCPServer } from "@mastra/mcp";
 import { resourceHandlers } from "./resources";
 import { writeNoteTool } from "../tools/write-note";
@@ -299,13 +299,13 @@ Prompt handlers provide ready-to-use prompts for clients. You'll add these three
 
 This requires a few markdown-parsing libraries you need to install:
 
-```bash copy
+```bash
 npm install unified remark-parse gray-matter @types/unist
 ```
 
 Implement the prompts in `src/mastra/mcp/prompts.ts`:
 
-```typescript copy title="src/mastra/mcp/prompts.ts"
+```typescript title="src/mastra/mcp/prompts.ts"
 import type { MCPServerPrompts } from "@mastra/mcp";
 import { unified } from "unified";
 import remarkParse from "remark-parse";
@@ -413,7 +413,7 @@ export const promptHandlers: MCPServerPrompts = {
 
 Register these prompt handlers in `src/mastra/mcp/server.ts`:
 
-```typescript copy title="src/mastra/mcp/server.ts"
+```typescript title="src/mastra/mcp/server.ts"
 import { MCPServer } from "@mastra/mcp";
 import { resourceHandlers } from "./resources";
 import { writeNoteTool } from "../tools/write-note";
@@ -439,7 +439,7 @@ export const notes = new MCPServer({
 
 Great, you've authored your first MCP server! Now you can try it out by starting the Mastra dev server and opening [Studio](/docs/v1/getting-started/studio):
 
-```bash copy
+```bash
 npm run dev
 ```
 

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

@@ -10,7 +10,7 @@ import StepItem from "@site/src/components/StepItem";
 
 In this guide, you'll create an AI research assistant that can analyze academic papers and answer specific questions about their content using Retrieval Augmented Generation (RAG).
 
-You'll use the foundational Transformer paper ["Attention Is All You Need"](https://arxiv.org/html/1706.03762) as your example. As a database you'll use a local LibSQL database.
+You'll use the foundational Transformer paper ["Attention Is All You Need"](https://arxiv.org/html/1706.03762) as your example. As a database you'll use a local libSQL database.
 
 ## Prerequisites
 
@@ -59,7 +59,7 @@ Install additional dependencies
 
 After running the [installation guide](/guides/v1/getting-started/quickstart) you'll need to install additional dependencies:
 
-```bash copy
+```bash
 npm install @mastra/rag@beta ai@^4.0.0
 ```
 </StepItem>
@@ -74,7 +74,7 @@ Now you'll create your RAG-enabled research assistant. The agent uses:
 
 Create a new file `src/mastra/agents/researchAgent.ts` and define your agent:
 
-```ts copy title="src/mastra/agents/researchAgent.ts"
+```ts title="src/mastra/agents/researchAgent.ts"
 import { Agent } from "@mastra/core/agent";
 import { ModelRouterEmbeddingModel } from "@mastra/core/llm";
 import { createVectorQueryTool } from "@mastra/rag";
@@ -114,7 +114,7 @@ In the root of your project, grab the absolute path with the `pwd` command. The
 
 In your `src/mastra/index.ts` file, add the following to your existing file and configuration:
 
-```ts copy title="src/mastra/index.ts" {2, 4-6, 9}
+```ts title="src/mastra/index.ts" {2, 4-6, 9}
 import { Mastra } from "@mastra/core";
 import { LibSQLVector } from "@mastra/libsql";
 
@@ -133,7 +133,7 @@ For the `connectionUrl` use the absolute path you got from the `pwd` command. Th
 :::note
 
 For the purpose of this guide you are using a hardcoded absolute path to your
-local LibSQL file, however for production usage this won't work. You should
+local libSQL file, however for production usage this won't work. You should
 use a remote persistent database then.
 
 :::
@@ -144,7 +144,7 @@ use a remote persistent database then.
 
 In the `src/mastra/index.ts` file, add the agent to Mastra:
 
-```ts copy title="src/mastra/index.ts" {3, 10}
+```ts title="src/mastra/index.ts" {3, 10}
 import { Mastra } from "@mastra/core";
 import { LibSQLVector } from "@mastra/libsql";
 import { researchAgent } from "./agents/researchAgent";
@@ -176,7 +176,7 @@ In this step the research paper is retrieved by providing an URL, then converted
 
 Create a new file `src/store.ts` and add the following:
 
-```ts copy title="src/store.ts"
+```ts title="src/store.ts"
 import { MDocument } from "@mastra/rag";
 
 // Load the paper
@@ -198,7 +198,7 @@ console.log("Number of chunks:", chunks.length);
 
 Run the file in your terminal:
 
-```bash copy
+```bash
 npx bun src/store.ts
 ```
 
@@ -229,7 +229,7 @@ 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"
+```ts title="src/store.ts"
 import { MDocument } from "@mastra/rag";
 import { embedMany } from "ai";
 import { mastra } from "./mastra";
@@ -276,7 +276,7 @@ await vectorStore.upsert({
 
 Lastly, you'll now need to store the embeddings by running the script again:
 
-```bash copy
+```bash
 npx bun src/store.ts
 ```
 
@@ -292,7 +292,7 @@ Now that the vector database has all embeddings, you can test the research assis
 
 Create a new file `src/ask-agent.ts` and add different types of queries:
 
-```ts title="src/ask-agent.ts" copy
+```ts title="src/ask-agent.ts"
 import { mastra } from "./mastra";
 const agent = mastra.getAgent("researchAgent");
 
@@ -306,7 +306,7 @@ console.log("Response:", response1.text);
 
 Run the script:
 
-```bash copy
+```bash
 npx bun src/ask-agent.ts
 ```
 
@@ -323,7 +323,7 @@ Response: Sequence modeling with neural networks faces several key challenges:
 
 Try another question:
 
-```ts title="src/ask-agent.ts" copy
+```ts title="src/ask-agent.ts"
 import { mastra } from "./mastra";
 const agent = mastra.getAgent("researchAgent");
 

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

@@ -29,7 +29,7 @@ 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"
+```ts title="src/mastra/agents/stockAgent.ts"
 import { Agent } from "@mastra/core/agent";
 
 export const stockAgent = new Agent({
@@ -47,7 +47,7 @@ export const stockAgent = new Agent({
 
 In your `src/mastra/index.ts` file, register the agent:
 
-```ts copy title="src/mastra/index.ts" {2, 5}
+```ts title="src/mastra/index.ts" {2, 5}
 import { Mastra } from "@mastra/core";
 import { stockAgent } from "./agents/stockAgent";
 
@@ -103,7 +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" {9-11}
+```ts title="src/mastra/agents/stockAgent.ts" {9-11}
 import { Agent } from "@mastra/core/agent";
 import { stockPrices } from "../tools/stockPrices";
 
@@ -133,7 +133,7 @@ Learn how to interact with your agent through Mastra's API.
 
 You can run your agent as a service using the `mastra dev` command:
 
-```bash copy
+```bash
 mastra dev
 ```
 
@@ -155,7 +155,7 @@ POST http://localhost:4111/api/agents/stockAgent/generate
 
 You can interact with the agent using `curl` from the command line:
 
-```bash copy
+```bash
 curl -X POST http://localhost:4111/api/agents/stockAgent/generate \
   -H "Content-Type: application/json" \
   -d '{