@mastra/mcp-docs-server 0.13.4-alpha.0 → 0.13.5-alpha.0

package/.docs/organized/changelogs/mastra.md

@@ -1,5 +1,83 @@
 # mastra
 
+## 0.10.11-alpha.2
+
+### Patch Changes
+
+- ec77f83: Expose --inspect flag for mastra dev to start debugger
+- 565cc0c: fix redirection when clicking on the playground breadcrumbs
+- 4219597: add JSON input close to form input
+- 2873c7f: dependencies updates:
+  - Updated dependency [`dotenv@^16.6.1` ↗︎](https://www.npmjs.com/package/dotenv/v/16.6.1) (from `^16.5.0`, in `dependencies`)
+- Updated dependencies [2873c7f]
+- Updated dependencies [1c1c6a1]
+- Updated dependencies [2873c7f]
+- Updated dependencies [1c1c6a1]
+- Updated dependencies [d9b26b5]
+- Updated dependencies [f5ec3a4]
+- Updated dependencies [ab3bbff]
+- Updated dependencies [565cc0c]
+- Updated dependencies [18ca936]
+  - @mastra/core@0.10.11-alpha.2
+  - @mastra/deployer@0.10.11-alpha.2
+  - @mastra/mcp@0.10.6-alpha.0
+
+## 0.10.11-alpha.1
+
+### Patch Changes
+
+- a7a836a: Highlight send event button
+- Updated dependencies [7f6e403]
+  - @mastra/core@0.10.11-alpha.1
+  - @mastra/deployer@0.10.11-alpha.1
+
+## 0.10.11-alpha.0
+
+### Patch Changes
+
+- af9e40e: Map log level number to string value
+- a9f51e4: Fix plaground get tools not including x-mastra-dev-header"
+- 3322d00: Fix tools watcher in dev
+- b790fd1: Use SerializedStepFlowEntry in playground
+- Updated dependencies [bc40cdd]
+- Updated dependencies [f8ce2cc]
+- Updated dependencies [8c846b6]
+- Updated dependencies [b790fd1]
+- Updated dependencies [d7ed04d]
+- Updated dependencies [f36e4f1]
+  - @mastra/deployer@0.10.11-alpha.0
+  - @mastra/core@0.10.11-alpha.0
+
+## 0.10.10
+
+### Patch Changes
+
+- 6997af1: add send event to server, deployer, client-js and playground-ui
+- 4d3fbdf: Return tool error message rather than throw when a tool error happens for agent and tool playground page.
+- Updated dependencies [6e13b80]
+- Updated dependencies [25bf999]
+- Updated dependencies [6997af1]
+- Updated dependencies [4d3fbdf]
+  - @mastra/deployer@0.10.10
+  - @mastra/loggers@0.10.3
+  - @mastra/core@0.10.10
+
+## 0.10.10-alpha.2
+
+### Patch Changes
+
+- Updated dependencies [25bf999]
+  - @mastra/loggers@0.10.3-alpha.0
+
+## 0.10.10-alpha.1
+
+### Patch Changes
+
+- 6997af1: add send event to server, deployer, client-js and playground-ui
+- Updated dependencies [6997af1]
+  - @mastra/deployer@0.10.10-alpha.1
+  - @mastra/core@0.10.10-alpha.1
+
 ## 0.10.10-alpha.0
 
 ### Patch Changes
@@ -220,83 +298,5 @@
 
 ## 0.10.7-alpha.1
 
-### Patch Changes
-
-- 21ffb97: Make dynamic form handle schema better
-- Updated dependencies [d1baedb]
-- Updated dependencies [4d21bf2]
-- Updated dependencies [2097952]
-- Updated dependencies [4fb0cc2]
-- Updated dependencies [d2a7a31]
-- Updated dependencies [0e17048]
-  - @mastra/core@0.10.7-alpha.1
-  - @mastra/mcp@0.10.5-alpha.0
-  - @mastra/deployer@0.10.7-alpha.1
-
-## 0.10.7-alpha.0
-
-### Patch Changes
-
-- 9102d89: Fix final output not showing on playground for previously suspended steps
-- Updated dependencies [d8f2d19]
-- Updated dependencies [9d52b17]
-- Updated dependencies [8ba1b51]
-  - @mastra/core@0.10.7-alpha.0
-  - @mastra/deployer@0.10.7-alpha.0
-
-## 0.10.6
-
-### Patch Changes
 
-- 02560d4: lift evals fetching to the playground package instead
-- 084f6aa: Add logs to circular dependency to warn people when starting server might break
-- b29c802: Remove open browser
-- 5f2aa3e: Move workflow hooks to playground
-- 4051477: dependencies updates:
-  - Updated dependency [`@clack/prompts@^0.11.0` ↗︎](https://www.npmjs.com/package/@clack/prompts/v/0.11.0) (from `^0.8.2`, in `dependencies`)
-  - Updated dependency [`@opentelemetry/instrumentation@^0.202.0` ↗︎](https://www.npmjs.com/package/@opentelemetry/instrumentation/v/0.202.0) (from `^0.57.2`, in `dependencies`)
-  - Updated dependency [`posthog-node@4.18.0` ↗︎](https://www.npmjs.com/package/posthog-node/v/4.18.0) (from `4.16.0`, in `dependencies`)
-  - Updated dependency [`yocto-spinner@^0.2.3` ↗︎](https://www.npmjs.com/package/yocto-spinner/v/0.2.3) (from `^0.1.2`, in `dependencies`)
-  - Added dependency [`open@^10.1.2` ↗︎](https://www.npmjs.com/package/open/v/10.1.2) (to `dependencies`)
-- b40f365: dependencies updates:
-  - Updated dependency [`@clack/prompts@^0.11.0` ↗︎](https://www.npmjs.com/package/@clack/prompts/v/0.11.0) (from `^0.8.2`, in `dependencies`)
-  - Updated dependency [`@opentelemetry/instrumentation@^0.202.0` ↗︎](https://www.npmjs.com/package/@opentelemetry/instrumentation/v/0.202.0) (from `^0.57.2`, in `dependencies`)
-  - Updated dependency [`posthog-node@4.18.0` ↗︎](https://www.npmjs.com/package/posthog-node/v/4.18.0) (from `4.16.0`, in `dependencies`)
-  - Updated dependency [`yocto-spinner@^0.2.3` ↗︎](https://www.npmjs.com/package/yocto-spinner/v/0.2.3) (from `^0.1.2`, in `dependencies`)
-- 63f6b7d: dependencies updates:
-  - Updated dependency [`execa@^9.6.0` ↗︎](https://www.npmjs.com/package/execa/v/9.6.0) (from `^9.5.2`, in `dependencies`)
-  - Updated dependency [`json-schema-to-zod@^2.6.1` ↗︎](https://www.npmjs.com/package/json-schema-to-zod/v/2.6.1) (from `^2.6.0`, in `dependencies`)
-  - Updated dependency [`shell-quote@^1.8.3` ↗︎](https://www.npmjs.com/package/shell-quote/v/1.8.3) (from `^1.8.2`, in `dependencies`)
-  - Updated dependency [`strip-json-comments@^5.0.2` ↗︎](https://www.npmjs.com/package/strip-json-comments/v/5.0.2) (from `^5.0.1`, in `dependencies`)
-  - Updated dependency [`zod@^3.25.57` ↗︎](https://www.npmjs.com/package/zod/v/3.25.57) (from `^3.25.56`, in `dependencies`)
-- 143b4e4: Fix globbing of tools to only capture js/ts files
-- 44ba52d: Add proper error message when installation of mastra fails
-- 311132e: move useWorkflow to playground instead of playground-ui
-- 3270d9d: Fix runtime context being undefined
-- 906f992: CLI error log
-- 53d3c37: Get workflows from an agent if not found from Mastra instance #5083
-- fc677d7: For final result for a workflow
-- 47e7029: Add open browser functionality when running mastra dev
-- Updated dependencies [63f6b7d]
-- Updated dependencies [4051477]
-- Updated dependencies [2d12edd]
-- Updated dependencies [63f6b7d]
-- Updated dependencies [c28ed65]
-- Updated dependencies [63f6b7d]
-- Updated dependencies [12a95fc]
-- Updated dependencies [79b9909]
-- Updated dependencies [4b0f8a6]
-- Updated dependencies [51264a5]
-- Updated dependencies [8e6f677]
-- Updated dependencies [d70c420]
-- Updated dependencies [ee9af57]
-- Updated dependencies [ec7f824]
-- Updated dependencies [36f1c36]
-- Updated dependencies [084f6aa]
-- Updated dependencies [2a16996]
-- Updated dependencies [10d352e]
-- Updated dependencies [9589624]
-- Updated dependencies [bd1674f]
-- Updated dependencies [69f76f7]
-
-... 4141 more lines hidden. See full changelog in package directory.
+... 4219 more lines hidden. See full changelog in package directory.

package/.docs/organized/code-examples/bird-checker-with-express.md

@@ -6,7 +6,7 @@
     "@types/express": "^4.0.0",
     "@types/node": "^20.17.57",
     "concurrently": "^9.1.2",
-    "dotenv": "^16.5.0",
+    "dotenv": "^17.0.0",
     "express": "^4.21.2",
     "nodemon": "^3.1.9",
     "ts-node": "^10.9.2",

package/.docs/organized/code-examples/crypto-chatbot.md

@@ -10,16 +10,16 @@
     "@mastra/memory": "latest",
     "@mastra/pg": "latest",
     "@next/env": "^15.2.2",
-    "@radix-ui/react-alert-dialog": "^1.1.6",
-    "@radix-ui/react-dialog": "^1.1.6",
-    "@radix-ui/react-dropdown-menu": "^2.1.11",
+    "@radix-ui/react-alert-dialog": "^1.1.14",
+    "@radix-ui/react-dialog": "^1.1.14",
+    "@radix-ui/react-dropdown-menu": "^2.1.15",
     "@radix-ui/react-icons": "^1.3.2",
-    "@radix-ui/react-label": "^2.1.4",
-    "@radix-ui/react-select": "^2.1.6",
-    "@radix-ui/react-separator": "^1.1.2",
-    "@radix-ui/react-slot": "^1.1.2",
-    "@radix-ui/react-tooltip": "^1.1.8",
-    "@radix-ui/react-visually-hidden": "^1.1.2",
+    "@radix-ui/react-label": "^2.1.7",
+    "@radix-ui/react-select": "^2.2.5",
+    "@radix-ui/react-separator": "^1.1.7",
+    "@radix-ui/react-slot": "^1.2.3",
+    "@radix-ui/react-tooltip": "^1.2.7",
+    "@radix-ui/react-visually-hidden": "^1.2.3",
     "@typescript-eslint/parser": "^8.31.0",
     "@vercel/analytics": "^1.5.0",
     "@vercel/blob": "^1.0.0",

package/.docs/organized/code-examples/fireworks-r1.md

@@ -17,7 +17,7 @@
   },
   "devDependencies": {
     "@types/node": "^20.17.57",
-    "dotenv": "^16.5.0",
+    "dotenv": "^17.0.0",
     "mastra": "latest",
     "tsx": "^4.19.3",
     "typescript": "^5.8.2"

package/.docs/organized/code-examples/memory-per-resource-example.md

@@ -3,7 +3,7 @@
 {
   "name": "memory-per-resource-example",
   "dependencies": {
-    "@ai-sdk/openai": "^0.0.68",
+    "@ai-sdk/openai": "^1.3.22",
     "@mastra/core": "latest",
     "@mastra/memory": "latest",
     "@mastra/libsql": "latest",

package/.docs/organized/code-examples/memory-with-pg.md

@@ -9,7 +9,7 @@
     "@mastra/pg": "latest"
   },
   "devDependencies": {
-    "dotenv": "^16.5.0",
+    "dotenv": "^17.0.0",
     "tsx": "^4.19.3"
   }
 }

package/.docs/organized/code-examples/memory-with-upstash.md

@@ -10,7 +10,7 @@
     "@mastra/upstash": "latest"
   },
   "devDependencies": {
-    "dotenv": "^16.5.0",
+    "dotenv": "^17.0.0",
     "tsx": "^4.19.3"
   }
 }

package/.docs/organized/code-examples/openapi-spec-writer.md

@@ -9,10 +9,10 @@
     "@mastra/github": "latest",
     "@mastra/loggers": "latest",
     "@mastra/rag": "latest",
-    "@radix-ui/react-accordion": "^1.2.3",
-    "@radix-ui/react-dialog": "^1.1.6",
-    "@radix-ui/react-select": "^2.1.6",
-    "@radix-ui/react-slot": "^1.1.2",
+    "@radix-ui/react-accordion": "^1.2.11",
+    "@radix-ui/react-dialog": "^1.1.14",
+    "@radix-ui/react-select": "^2.2.5",
+    "@radix-ui/react-slot": "^1.2.3",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "lucide-react": "^0.454.0",

package/.docs/raw/client-js/overview.mdx

@@ -78,6 +78,22 @@ const client = new MastraClient({
 });
 ```
 
+## AbortSignal
+
+The Mastra Client SDK supports request cancellation using the standard Web API `AbortSignal`. Pass an `AbortSignal` to the client constructor to enable cancellation for all requests:
+
+```typescript
+const controller = new AbortController();
+
+const client = new MastraClient({
+  baseUrl: "http://localhost:4111",
+  abortSignal: controller.signal,
+});
+
+// Cancel all requests from this client
+controller.abort();
+```
+
 ## Example
 
 Once your MastraClient is initialized you can start making client calls via the type-safe

package/.docs/raw/deployment/cloud-providers/aws-lambda.mdx

@@ -0,0 +1,279 @@
+---
+title: "AWS Lambda"
+description: "Deploy your Mastra applications to AWS Lambda using Docker containers and the AWS Lambda Web Adapter."
+---
+
+import { Callout, Steps } from "nextra/components";
+
+## AWS Lambda
+
+Deploy your Mastra applications to AWS Lambda using Docker containers and the AWS Lambda Web Adapter.
+This approach allows you to run your Mastra server as a containerized Lambda function with automatic scaling.
+
+<Callout>
+  This guide assumes your Mastra application has been created using the default
+  `npx create-mastra@latest` command.
+  For more information on how to create a new Mastra application,
+  refer to our [getting started guide](/docs/getting-started/installation)
+</Callout>
+
+### Prerequisites
+
+Before deploying to AWS Lambda, ensure you have:
+
+- [AWS CLI](https://aws.amazon.com/cli/) installed and configured
+- [Docker](https://www.docker.com/) installed and running
+- An AWS account with appropriate permissions for Lambda, ECR, and IAM
+- Your Mastra application configured with appropriate memory storage
+
+### Memory Configuration
+
+<Callout>
+  AWS Lambda uses an ephemeral file system,
+  meaning that any files written to the file system are short-lived and may be lost.
+  Avoid using a Mastra storage provider that uses the file system,
+  such as `LibSQLStore` with a file URL.
+</Callout>
+
+Lambda functions have limitations with file system storage. Configure your Mastra application to use either in-memory or external storage providers:
+
+#### Option 1: In-Memory (Simplest)
+
+```typescript filename="src/mastra/index.ts" copy showLineNumbers
+import { LibSQLStore } from "@mastra/libsql";
+
+const storage = new LibSQLStore({
+  url: ":memory:", // in-memory storage
+});
+```
+
+#### Option 2: External Storage Providers
+
+For persistent memory across Lambda invocations, use external storage providers like `LibSQLStore` with Turso or other storage providers like `PostgreStore`:
+
+```typescript filename="src/mastra/index.ts" copy showLineNumbers
+import { LibSQLStore } from "@mastra/libsql";
+
+const storage = new LibSQLStore({
+  url: "libsql://your-database.turso.io", // External Turso database
+  authToken: process.env.TURSO_AUTH_TOKEN,
+});
+```
+
+For more memory configuration options, see the [Memory documentation](/docs/memory/overview).
+
+### Creating a Dockerfile
+
+<Steps>
+
+#### Create a Dockerfile in your project root
+
+Create a `Dockerfile` in your Mastra project root directory:
+
+```dockerfile filename="Dockerfile" copy showLineNumbers
+FROM node:22-alpine
+
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY src ./src
+RUN npx mastra build
+RUN apk add --no-cache gcompat
+
+COPY --from=public.ecr.aws/awsguru/aws-lambda-adapter:0.9.0 /lambda-adapter /opt/extensions/lambda-adapter
+RUN addgroup -g 1001 -S nodejs && \
+  adduser -S mastra -u 1001 && \
+  chown -R mastra:nodejs /app
+
+USER mastra
+
+ENV PORT=8080
+ENV NODE_ENV=production
+ENV READINESS_CHECK_PATH="/api"
+
+EXPOSE 8080
+
+CMD ["node", "--import=./.mastra/output/instrumentation.mjs", ".mastra/output/index.mjs"]
+```
+
+</Steps>
+
+### Building and Deploying
+
+<Steps>
+
+#### Set up environment variables
+
+Set up your environment variables for the deployment process:
+
+```bash copy
+export PROJECT_NAME="your-mastra-app"
+export AWS_REGION="us-east-1"
+export AWS_ACCOUNT_ID=$(aws sts get-caller-identity --query Account --output text)
+```
+
+#### Build the Docker image
+
+Build your Docker image locally:
+
+```bash copy
+docker build -t "$PROJECT_NAME" .
+```
+
+#### Create an ECR repository
+
+Create an Amazon ECR repository to store your Docker image:
+
+```bash copy
+aws ecr create-repository --repository-name "$PROJECT_NAME" --region "$AWS_REGION"
+```
+
+#### Authenticate Docker with ECR
+
+Log in to Amazon ECR:
+
+```bash copy
+aws ecr get-login-password --region "$AWS_REGION" | docker login --username AWS --password-stdin "$AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com"
+```
+
+#### Tag and push the image
+
+Tag your image with the ECR repository URI and push it:
+
+```bash copy
+docker tag "$PROJECT_NAME":latest "$AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/$PROJECT_NAME":latest
+docker push "$AWS_ACCOUNT_ID.dkr.ecr.$AWS_REGION.amazonaws.com/$PROJECT_NAME":latest
+```
+
+#### Create the Lambda function
+
+Create a Lambda function using the AWS Console:
+
+1. Navigate to the [AWS Lambda Console](https://console.aws.amazon.com/lambda/)
+2. Click **Create function**
+3. Select **Container image**
+4. Configure the function:
+   - **Function name**: Your function name (e.g., `mastra-app`)
+   - **Container image URI**: Click **Browse images** and select your ECR repository, then choose the `latest` tag
+   - **Architecture**: Select the architecture that matches your Docker build (typically `x86_64`)
+
+#### Configure Function URL
+
+Enable Function URL for external access:
+
+1. In the Lambda function configuration, go to **Configuration** > **Function URL**
+2. Click **Create function URL**
+3. Set **Auth type** to **NONE** (for public access)
+4. Configure **CORS** settings:
+   - **Allow-Origin**: `*` (restrict to your domain in production)
+   - **Allow-Headers**: `content-type`
+   - **Allow-Methods**: `*` (audit and restrict in production)
+5. Click **Save**
+
+#### Configure environment variables
+
+Add your environment variables in the Lambda function configuration:
+
+1. Go to **Configuration** > **Environment variables**
+2. Add the required variables for your Mastra application:
+   - `OPENAI_API_KEY`: Your OpenAI API key (if using OpenAI)
+   - `ANTHROPIC_API_KEY`: Your Anthropic API key (if using Anthropic)
+   - `TURSO_AUTH_TOKEN`: Your Turso auth token (if using LibSQL with Turso)
+   - Other provider-specific API keys as needed
+
+#### Adjust function settings
+
+Configure the function's memory and timeout settings:
+
+1. Go to **Configuration** > **General configuration**
+2. Set the following recommended values:
+   - **Memory**: 512 MB (adjust based on your application needs)
+   - **Timeout**: 30 seconds (adjust based on your application needs)
+   - **Ephemeral storage**: 512 MB (optional, for temporary files)
+
+</Steps>
+
+### Testing your deployment
+
+Once deployed, test your Lambda function:
+
+1. Copy the **Function URL** from the Lambda console
+2. Visit the URL in your browser to see your Mastra's server home screen
+3. Test your agents and workflows using the generated API endpoints
+
+For more information about available API endpoints, see the [Server documentation](/docs/deployment/server).
+
+### Connecting your client
+
+Update your client application to use the Lambda function URL:
+
+```typescript filename="src/client.ts" copy showLineNumbers
+import { MastraClient } from "@mastra/client-js";
+
+const mastraClient = new MastraClient({
+  baseUrl: "https://your-function-url.lambda-url.us-east-1.on.aws",
+});
+```
+
+### Troubleshooting
+
+#### Function timeout errors
+
+If your Lambda function times out:
+
+- Increase the timeout value in **Configuration** > **General configuration**
+- Optimize your Mastra application for faster cold starts
+- Consider using provisioned concurrency for consistent performance
+
+#### Memory issues
+
+If you encounter memory-related errors:
+
+- Increase the memory allocation in **Configuration** > **General configuration**
+- Monitor memory usage in CloudWatch Logs
+- Optimize your application's memory usage
+
+#### CORS issues
+
+If you encounter CORS errors when accessing endpoints but not the home page:
+
+- Verify CORS headers are properly set in your Mastra server configuration
+- Check the Lambda Function URL CORS configuration
+- Ensure your client is making requests to the correct URL
+
+#### Container image issues
+
+If the Lambda function fails to start:
+
+- Verify the Docker image builds successfully locally
+- Check that the `CMD` instruction in your Dockerfile is correct
+- Review CloudWatch Logs for container startup errors
+- Ensure the Lambda Web Adapter is properly installed in the container
+
+### Production considerations
+
+For production deployments:
+
+#### Security
+
+- Restrict CORS origins to your trusted domains
+- Use AWS IAM roles for secure access to other AWS services
+- Store sensitive environment variables in AWS Secrets Manager or Parameter Store
+
+#### Monitoring
+
+- Enable CloudWatch monitoring for your Lambda function
+- Set up CloudWatch alarms for errors and performance metrics
+- Use AWS X-Ray for distributed tracing
+
+#### Scaling
+
+- Configure provisioned concurrency for predictable performance
+- Monitor concurrent executions and adjust limits as needed
+- Consider using Application Load Balancer for more complex routing needs
+
+## Next steps
+
+- [Mastra Client SDK](/docs/client-js/overview)
+- [AWS Lambda documentation](https://docs.aws.amazon.com/lambda/)
+- [AWS Lambda Web Adapter](https://github.com/awslabs/aws-lambda-web-adapter)

package/.docs/raw/deployment/serverless-platforms/index.mdx

@@ -30,7 +30,6 @@ Before you begin, ensure you have:
 
 Specifically, ensure you've removed it from both `src/mastra/index.ts` and `src/mastra/agents/weather-agent.ts`:
 
-
 ```diff filename="src/mastra/index.ts" showLineNumbers
 export const mastra = new Mastra({
   // ...

package/.docs/raw/frameworks/agentic-uis/ai-sdk.mdx

@@ -189,6 +189,103 @@ export default function Page() {
 }
 ```
 
+### With additional data / RuntimeContext
+
+You can send additional data via the UI hooks that can be leveraged in Mastra as RuntimeContext using the `sendExtraMessageFields` option.
+
+#### Frontend: Using sendExtraMessageFields
+
+```typescript
+import { useChat } from '@ai-sdk/react';
+
+export function ChatComponent() {
+  const { messages, input, handleInputChange, handleSubmit } = useChat({
+    api: '/api/chat',
+    sendExtraMessageFields: true, // Enable sending extra fields
+  });
+
+  const handleFormSubmit = (e: React.FormEvent) => {
+        e.preventDefault();        
+        handleSubmit(e,{
+            // Add context data to the message
+            data: {
+                userId: 'user123',
+                preferences: { language: 'en', temperature: 'celsius' },
+            },
+        });
+  };
+
+  return (
+    <form onSubmit={handleFormSubmit}>
+      <input value={input} onChange={handleInputChange} />
+    </form>
+  );
+}
+```
+
+#### Backend: Handling in API Route
+
+```typescript filename="app/api/chat/route.ts" copy
+import { mastra } from "@/src/mastra";
+import { RuntimeContext } from "@mastra/core/runtime-context";
+
+export async function POST(req: Request) {
+  const { messages, data } = await req.json();
+  const myAgent = mastra.getAgent("weatherAgent");
+  
+  const runtimeContext = new RuntimeContext();
+  
+  if (data) {
+    Object.entries(data).forEach(([key, value]) => {
+      runtimeContext.set(key, value);
+    });
+  }
+  
+  const stream = await myAgent.stream(messages, { runtimeContext });
+  return stream.toDataStreamResponse();
+}
+```
+
+#### Alternative: Server Middleware
+
+You can also handle this at the server middleware level:
+
+```typescript filename="src/mastra/index.ts" copy
+import { Mastra } from "@mastra/core";
+
+export const mastra = new Mastra({
+  agents: { weatherAgent },
+  server: {
+    middleware: [
+      async (c, next) => {
+        const runtimeContext = c.get("runtimeContext");
+        
+        if (c.req.method === 'POST') {
+          try {
+            // Clone the request since reading the body can only be done once
+            const clonedReq = c.req.raw.clone();
+            const body = await clonedReq.json();
+            
+            
+            if (body?.data) {
+              Object.entries(body.data).forEach(([key, value]) => {
+                runtimeContext.set(key, value);
+              });
+            }
+          } catch {
+            // Continue without additional data
+          }
+        }
+        
+        await next();
+      },
+    ],
+  },
+});
+```
+
+You can then access this data in your tools via the `runtimeContext` parameter. See the [Runtime Context documentation](/docs/agents/runtime-variables) for more details.
+
 ## Tool Calling
 
 ### AI SDK Tool Format